Package | Description |
---|---|
org.springframework.dao |
Exception hierarchy enabling sophisticated error handling independent
of the data access approach in use.
|
org.springframework.dao.support |
Support classes for DAO implementations,
providing miscellaneous utility methods.
|
org.springframework.jca.cci |
This package contains Spring's support for the Common Client Interface (CCI),
as defined by the J2EE Connector Architecture.
|
org.springframework.jca.cci.core |
Provides the core JCA CCI support, based on CciTemplate
and its associated callback interfaces.
|
org.springframework.jca.cci.object |
The classes in this package represent EIS operations as threadsafe,
reusable objects.
|
Modifier and Type | Class and Description |
---|---|
class |
CannotAcquireLockException
Exception thrown on failure to acquire a lock during an update,
for example during a "select for update" statement.
|
class |
CannotSerializeTransactionException
Exception thrown on failure to complete a transaction in serialized mode
due to update conflicts.
|
class |
CleanupFailureDataAccessException
Exception thrown when we couldn't cleanup after a data access operation,
but the actual operation went OK.
|
class |
ConcurrencyFailureException
Exception thrown on concurrency failure.
|
class |
DataAccessResourceFailureException
Data access exception thrown when a resource fails completely:
for example, if we can't connect to a database using JDBC.
|
class |
DataIntegrityViolationException
Exception thrown when an attempt to insert or update data
results in violation of an integrity constraint.
|
class |
DataRetrievalFailureException
Exception thrown if certain expected data could not be retrieved, e.g.
|
class |
DeadlockLoserDataAccessException
Generic exception thrown when the current process was
a deadlock loser, and its transaction rolled back.
|
class |
DuplicateKeyException
Exception thrown when an attempt to insert or update data
results in violation of an primary key or unique constraint.
|
class |
EmptyResultDataAccessException
Data access exception thrown when a result was expected to have at least
one row (or element) but zero rows (or elements) were actually returned.
|
class |
IncorrectResultSizeDataAccessException
Data access exception thrown when a result was not of the expected size,
for example when expecting a single row but getting 0 or more than 1 rows.
|
class |
IncorrectUpdateSemanticsDataAccessException
Data access exception thrown when something unintended appears to have
happened with an update, but the transaction hasn't already been rolled back.
|
class |
InvalidDataAccessApiUsageException
Exception thrown on incorrect usage of the API, such as failing to
"compile" a query object that needed compilation before execution.
|
class |
InvalidDataAccessResourceUsageException
Root for exceptions thrown when we use a data access resource incorrectly.
|
class |
NonTransientDataAccessException
Root of the hierarchy of data access exceptions that are considered non-transient -
where a retry of the same operation would fail unless the cause of the Exception
is corrected.
|
class |
NonTransientDataAccessResourceException
Data access exception thrown when a resource fails completely and the failure is permanent.
|
class |
OptimisticLockingFailureException
Exception thrown on an optimistic locking violation.
|
class |
PermissionDeniedDataAccessException
Exception thrown when the underlying resource denied a permission
to access a specific element, such as a specific database table.
|
class |
PessimisticLockingFailureException
Exception thrown on a pessimistic locking violation.
|
class |
QueryTimeoutException
Exception to be thrown on a query timeout.
|
class |
RecoverableDataAccessException
Data access exception thrown when a previously failed operation might be able
to succeed if the application performs some recovery steps and retries the entire
transaction or in the case of a distributed transaction, the transaction branch.
|
class |
TransientDataAccessException
Root of the hierarchy of data access exceptions that are considered transient -
where a previously failed operation might be able to succeed when the operation
is retried without any intervention by application-level functionality.
|
class |
TransientDataAccessResourceException
Data access exception thrown when a resource fails temporarily
and the operation can be retried.
|
class |
TypeMismatchDataAccessException
Exception thrown on mismatch between Java type and database type:
for example on an attempt to set an object of the wrong type
in an RDBMS column.
|
class |
UncategorizedDataAccessException
Normal superclass when we can't distinguish anything more specific
than "something went wrong with the underlying resource": for example,
an SQLException from JDBC we can't pinpoint more precisely.
|
Modifier and Type | Method and Description |
---|---|
DataAccessException |
ChainedPersistenceExceptionTranslator.translateExceptionIfPossible(RuntimeException ex) |
DataAccessException |
PersistenceExceptionTranslator.translateExceptionIfPossible(RuntimeException ex)
Translate the given runtime exception thrown by a persistence framework to a
corresponding exception from Spring's generic
DataAccessException hierarchy, if possible. |
Modifier and Type | Class and Description |
---|---|
class |
CannotCreateRecordException
Exception thrown when the creating of a CCI Record failed
for connector-internal reasons.
|
class |
CannotGetCciConnectionException
Fatal exception thrown when we can't connect to an EIS using CCI.
|
class |
CciOperationNotSupportedException
Exception thrown when the connector doesn't support a specific CCI operation.
|
class |
InvalidResultSetAccessException
Exception thrown when a ResultSet has been accessed in an invalid fashion.
|
class |
RecordTypeNotSupportedException
Exception thrown when the creating of a CCI Record failed because
the connector doesn't support the desired CCI Record type.
|
Modifier and Type | Method and Description |
---|---|
IndexedRecord |
CciTemplate.createIndexedRecord(String name)
Create an indexed Record through the ConnectionFactory's RecordFactory.
|
MappedRecord |
CciTemplate.createMappedRecord(String name)
Create a mapped Record from the ConnectionFactory's RecordFactory.
|
protected Record |
CciTemplate.createRecord(RecordCreator recordCreator)
Invoke the given RecordCreator, converting JCA ResourceExceptions
to Spring's DataAccessException hierarchy.
|
Record |
RecordCreator.createRecord(RecordFactory recordFactory)
Create a CCI Record instance, usually based on the passed-in CCI RecordFactory.
|
protected <T> T |
CciTemplate.doExecute(InteractionSpec spec,
Record inputRecord,
Record outputRecord,
RecordExtractor<T> outputExtractor)
Execute the specified interaction on an EIS with CCI.
|
T |
ConnectionCallback.doInConnection(Connection connection,
ConnectionFactory connectionFactory)
Gets called by
CciTemplate.execute with an active CCI Connection. |
T |
InteractionCallback.doInInteraction(Interaction interaction,
ConnectionFactory connectionFactory)
Gets called by
CciTemplate.execute with an active CCI Interaction. |
<T> T |
CciOperations.execute(ConnectionCallback<T> action)
Execute a request on an EIS with CCI, implemented as callback action
working on a CCI Connection.
|
<T> T |
CciTemplate.execute(ConnectionCallback<T> action) |
<T> T |
CciOperations.execute(InteractionCallback<T> action)
Execute a request on an EIS with CCI, implemented as callback action
working on a CCI Interaction.
|
<T> T |
CciTemplate.execute(InteractionCallback<T> action) |
Record |
CciOperations.execute(InteractionSpec spec,
Record inputRecord)
Execute the specified interaction on an EIS with CCI.
|
Record |
CciTemplate.execute(InteractionSpec spec,
Record inputRecord) |
Record |
CciOperations.execute(InteractionSpec spec,
RecordCreator inputCreator)
Execute the specified interaction on an EIS with CCI.
|
Record |
CciTemplate.execute(InteractionSpec spec,
RecordCreator inputCreator) |
<T> T |
CciOperations.execute(InteractionSpec spec,
RecordCreator inputCreator,
RecordExtractor<T> outputExtractor)
Execute the specified interaction on an EIS with CCI.
|
<T> T |
CciTemplate.execute(InteractionSpec spec,
RecordCreator inputCreator,
RecordExtractor<T> outputExtractor) |
void |
CciOperations.execute(InteractionSpec spec,
Record inputRecord,
Record outputRecord)
Execute the specified interaction on an EIS with CCI.
|
void |
CciTemplate.execute(InteractionSpec spec,
Record inputRecord,
Record outputRecord) |
<T> T |
CciOperations.execute(InteractionSpec spec,
Record inputRecord,
RecordExtractor<T> outputExtractor)
Execute the specified interaction on an EIS with CCI.
|
<T> T |
CciTemplate.execute(InteractionSpec spec,
Record inputRecord,
RecordExtractor<T> outputExtractor) |
T |
RecordExtractor.extractData(Record record)
Process the data in the given Record, creating a corresponding result object.
|
Modifier and Type | Method and Description |
---|---|
protected abstract Object |
MappingCommAreaOperation.bytesToObject(byte[] bytes)
Method used to convert the COMMAREA's bytes to an object.
|
protected abstract Record |
MappingRecordOperation.createInputRecord(RecordFactory recordFactory,
Object inputObject)
Subclasses must implement this method to generate an input Record
from an input object passed into the
execute method. |
Record |
MappingRecordOperation.RecordCreatorImpl.createRecord(RecordFactory recordFactory) |
Object |
MappingRecordOperation.execute(Object inputObject)
Execute the interaction encapsulated by this operation object.
|
Record |
SimpleRecordOperation.execute(Record inputRecord)
Execute the CCI interaction encapsulated by this operation object.
|
void |
SimpleRecordOperation.execute(Record inputRecord,
Record outputRecord)
Execute the CCI interaction encapsulated by this operation object.
|
Object |
MappingRecordOperation.RecordExtractorImpl.extractData(Record record) |
protected Object |
MappingCommAreaOperation.extractOutputData(Record record) |
protected abstract Object |
MappingRecordOperation.extractOutputData(Record outputRecord)
Subclasses must implement this method to convert the Record returned
by CCI execution into a result object for the
execute method. |
protected abstract byte[] |
MappingCommAreaOperation.objectToBytes(Object inObject)
Method used to convert an object into COMMAREA bytes.
|