Package com.opencloud.slee.resources.dbquery
Asynchronous queries
See the DatabaseQueryActivity
documentation for details on how to
send non-transactional asynchronous queries and DatabaseQueryTransactionalActivity
for details on how to send transactional asynchronous queries.
Synchronous queries
See the DatabaseQueryProvider
documentation for details on how to send
a synchronous queries.
QueryInfo objects
The examples linked to above mention that the QueryInfo
object should
contain a copy of the values to set as parameters. Another way of stating this rule is that the QueryInfo
object must not directly or indirectly reference fields or methods
of an SBB.
The reason for this rule is that the QueryInfo
object will be used by
the resource adaptor at an unspecified time, when the SBB object may not exist, or may not represent the same SBB
entity.
See the QueryInfo
documentation for an implementation example.
-
Interface Summary Interface Description DatabaseFutureResult A "future" for retrieving database results when they are available.DatabaseQueryActivity The query activity on which result and failure events are fired.DatabaseQueryActivityContextInterfaceFactory Interface implemented by the SLEE to get activity context interfaces forDatabaseQueryActivity
objects.DatabaseQueryFailureEvent A failure event.DatabaseQueryProvider Defines the provider interface used by services to send queries using the Database Query resource adaptor.DatabaseQueryTransactionalActivity The query activity on which result and failure events are fired.DatabaseResultEvent The result event.DatabaseTransaction Defines an interface for synchronous queries to interact with a explicit transaction.QueryInfo A callback interface implemented by SBBs to set the SQL statement and parameters for the query. -
Class Summary Class Description Query This is a convenience abstract class for creating a QueryInfo with a QUERY ExecuteTypeUpdateQuery This is a convenience abstract class for creating a QueryInfo with an UPDATE ExecuteType -
Enum Summary Enum Description QueryFailureReason Enumeration of failure reasons.QueryInfo.ExecuteType The type of execute method to call on the prepared statement.QueryInfo.RetryBehaviour Retry behaviour options in the case of multiple data sources.QueryInfo.StatementType The type of Statement. -
Exception Summary Exception Description DatabaseQueryException Thrown by the Database Query resource adaptor for any exception that is not caused by a database problem (whereSQLException
is used) or a timeout (TimeoutException
) or no DataSources being available (NoDataSourcesAvailableException
).InsufficientResourcesException Thrown by the Database Query resource adaptor when there are insufficient resources (worker threads, connections) to process a request.NoDataSourcesAvailableException Thrown by the Database Query resource adaptor when none of the configured DataSources are available.