org.springframework.jca.cci.object
Class MappingCommAreaOperation

java.lang.Object
  org.springframework.jca.cci.object.EisOperation
      org.springframework.jca.cci.object.MappingRecordOperation
          org.springframework.jca.cci.object.MappingCommAreaOperation

All Implemented Interfaces:

InitializingBean

public abstract class MappingCommAreaOperation
extends MappingRecordOperation

EIS operation object for access to COMMAREA records. Subclass of the generic MappingRecordOperation class.

Since:

1.2

Author:

Thierry Templier

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.jca.cci.object.MappingRecordOperation

MappingRecordOperation.RecordCreatorImpl, MappingRecordOperation.RecordExtractorImpl

Constructor Summary

MappingCommAreaOperation()
Create a new MappingCommAreaQuery.

MappingCommAreaOperation(ConnectionFactory connectionFactory, InteractionSpec interactionSpec)
Create a new MappingCommAreaQuery.

Method Summary

protected abstract Object	bytesToObject(byte[] bytes) Method used to convert the COMMAREA's bytes to an object.
protected Record	createInputRecord(RecordFactory recordFactory, Object inObject) Subclasses must implement this method to generate an input Record from an input object passed into the execute method.
protected Object	extractOutputData(Record record) Subclasses must implement this method to convert the Record returned by CCI execution into a result object for the execute method.
protected abstract byte[]	objectToBytes(Object inObject) Method used to convert an object into COMMAREA bytes.

Methods inherited from class org.springframework.jca.cci.object.MappingRecordOperation

execute, setOutputRecordCreator

Methods inherited from class org.springframework.jca.cci.object.EisOperation

afterPropertiesSet, getCciTemplate, getInteractionSpec, setCciTemplate, setConnectionFactory, setInteractionSpec

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MappingCommAreaOperation

public MappingCommAreaOperation()

Create a new MappingCommAreaQuery.

See Also:

EisOperation.setConnectionFactory(javax.resource.cci.ConnectionFactory), EisOperation.setInteractionSpec(javax.resource.cci.InteractionSpec)

MappingCommAreaOperation

public MappingCommAreaOperation(ConnectionFactory connectionFactory,
                                InteractionSpec interactionSpec)

Create a new MappingCommAreaQuery.

Parameters:

connectionFactory - ConnectionFactory to use to obtain connections

interactionSpec - specification to configure the interaction

Method Detail

createInputRecord

protected final Record createInputRecord(RecordFactory recordFactory,
                                         Object inObject)

Description copied from class: MappingRecordOperation

Subclasses must implement this method to generate an input Record from an input object passed into the execute method.

Specified by:

createInputRecord in class MappingRecordOperation

inObject - the passed-in input object

Returns:

the CCI input Record

See Also:

MappingRecordOperation.execute(Object)

extractOutputData

protected final Object extractOutputData(Record record)
                                  throws DataAccessException

Description copied from class: MappingRecordOperation

Subclasses must implement this method to convert the Record returned by CCI execution into a result object for the execute method.

Specified by:

extractOutputData in class MappingRecordOperation

Parameters:

record - the Record returned by CCI execution

Returns:

the result object

Throws:

DataAccessException

See Also:

MappingRecordOperation.execute(Object)

objectToBytes

protected abstract byte[] objectToBytes(Object inObject)
                                 throws IOException,
                                        DataAccessException

Method used to convert an object into COMMAREA bytes.

Parameters:

inObject - the input data

Returns:

the COMMAREA's bytes

Throws:

IOException - if thrown by I/O methods

DataAccessException - if conversion failed

bytesToObject

protected abstract Object bytesToObject(byte[] bytes)
                                 throws IOException,
                                        DataAccessException

Method used to convert the COMMAREA's bytes to an object.

Parameters:

bytes - the COMMAREA's bytes

Returns:

the output data

Throws:

IOException - if thrown by I/O methods

DataAccessException - if conversion failed