EclipseLink 2.0.0, build 'v20091127-r5931' API Reference

org.eclipse.persistence.eis
Class EISPlatform

java.lang.Object
  extended by org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform
      extended by org.eclipse.persistence.eis.EISPlatform
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, org.eclipse.persistence.internal.databaseaccess.Platform
Direct Known Subclasses:
JMSPlatform, XMLFilePlatform

public class EISPlatform
extends org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform

An EISPlatform defines any EIS adapter specific behavior. This may include:

EISPlatform also supports behavior for specifying the record types supported and automatic data-conversion to strings.

Although use of the generic EISPlatform may be sufficient, some adapters may require that a specific platform be defined.

See Also:
Serialized Form
Author:
James
Since:
OracleAS TopLink 10g (10.0.3)

Field Summary
protected  java.lang.reflect.Method domMethod
          Used to reflectively provide XML record support as DOMRecord is not part of the JCA-CCI spec.
protected  boolean isDOMRecordSupported
           
protected  boolean isIndexedRecordSupported
           
protected  boolean isMappedRecordSupported
           
protected  RecordConverter recordConverter
          Can be used to convert from an adapter specific record.
protected  boolean requiresAutoCommit
          Can be used if a commit is required after every interaction outside of a local transaction.
protected  boolean shouldConvertDataToStrings
          Can be used for adapters that only support String data/XML.
protected  boolean supportsLocalTransactions
          Allows for usage of transaction to be disabled if not supported.
protected  org.eclipse.persistence.internal.oxm.XMLConversionManager xmlConversionManager
          For XML usage, an XMLConversionManager instance is required
 
Fields inherited from class org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform
conversionManager, dataTypesConvertedFromAClass, dataTypesConvertedToAClass, defaultSequence, endDelimiter, platformOperators, sequences, startDelimiter, tableQualifier, timestampQuery
 
Constructor Summary
EISPlatform()
          Default constructor.
 
Method Summary
 void appendParameter(Call call, java.io.Writer writer, java.lang.Object parameter)
          Add the parameter.
 javax.resource.cci.InteractionSpec buildInteractionSpec(EISInteraction interaction)
          Allow the platform to build the interaction spec based on properties defined in the interaction.
 org.eclipse.persistence.internal.sessions.AbstractRecord buildRow(javax.resource.cci.Record record, EISInteraction interaction, EISAccessor accessor)
          INTERNAL: Allow the platform to handle record ro row conversion.
 java.util.Vector buildRows(javax.resource.cci.Record record, EISInteraction interaction, EISAccessor accessor)
          Allow the platform to handle record ro row conversion.
 org.eclipse.persistence.internal.sessions.AbstractRecord createDatabaseRowFromDOMRecord(javax.resource.cci.Record record, EISInteraction call, EISAccessor accessor)
          INTERNAL: Allow the platform to handle the creation of the Record for the DOM record.
 javax.resource.cci.Record createDOMRecord(java.lang.String recordName, EISAccessor accessor)
          Allow the platform to handle the creation of the DOM record.
 javax.resource.cci.Record createInputRecord(EISInteraction interaction, EISAccessor accessor)
          Allow the platform to create the appropiate type of record for the interaction.
 javax.resource.cci.Record createOutputRecord(EISInteraction interaction, EISAccessor accessor)
          Allow the platform to create the appropiate type of record for the interaction.
 org.eclipse.persistence.internal.helper.ConversionManager getConversionManager()
          The platform holds its own instance of conversion manager to allow customization.
 RecordConverter getRecordConverter()
          Return the record converter.
 java.lang.Object getValueFromRecord(java.lang.String key, javax.resource.cci.MappedRecord record, EISAccessor accessor)
          Retrieves the field value from the record.
 boolean isDOMRecordSupported()
          Return if this platform supports XML/DOM Records.
 boolean isIndexedRecordSupported()
          Return if this platform supports JCA IndexedRecord.
 boolean isMappedRecordSupported()
          Return if this platform supports JCA MappedRecord.
 boolean requiresAutoCommit()
          Return if this platform requires auto commit of the local transaction for interactions outside of an interaction.
 void setDOMInRecord(org.w3c.dom.Element dom, javax.resource.cci.Record record, EISInteraction call, EISAccessor accessor)
          Stores the XML DOM value into the record.
 void setIsDOMRecordSupported(boolean isDOMRecordSupported)
          Set if this platform supports XML/DOM Records.
 void setIsIndexedRecordSupported(boolean isIndexedRecordSupported)
          Set if this platform supports JCA IndexedRecord.
 void setIsMappedRecordSupported(boolean isMappedRecordSupported)
          Set if this platform supports JCA MappedRecord.
 void setRecordConverter(RecordConverter recordConverter)
          Set the record converter.
 void setRequiresAutoCommit(boolean requiresAutoCommit)
          Set if this platform requires auto commit of the local transaction for interactions outside of an interaction.
 void setShouldConvertDataToStrings(boolean shouldConvertDataToStrings)
          Set if all data set into the adapter should be first converted to strings.
 void setSupportsLocalTransactions(boolean supportsLocalTransactions)
          Set if this platform supports local transactions.
 void setValueInRecord(java.lang.String key, java.lang.Object value, javax.resource.cci.MappedRecord record, EISAccessor accessor)
          Stores the field value into the record.
 boolean shouldConvertDataToStrings()
          Return if all data set into the adapter should be first converted to strings.
 boolean supportsLocalTransactions()
          Return if this platform supports local transactions.
 
Methods inherited from class org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform
addOperator, addSequence, clone, convertObject, copyInto, createConnectionCustomizer, createPlatformDefaultSequence, createSequences, getCustomModifyValueForCall, getDataTypesConvertedFrom, getDataTypesConvertedTo, getDefaultSequence, getDefaultSequenceToWrite, getEndDelimiter, getIdentifierQuoteCharacter, getOperator, getPlatformOperators, getSelectSequenceQuery, getSequence, getSequencePreallocationSize, getSequences, getSequencesToWrite, getStartDelimiter, getTableQualifier, getTimestampFromServer, getTimestampQuery, getUpdateSequenceQuery, hasDefaultSequence, initialize, initializePlatformOperators, isAccess, isAttunity, isCloudscape, isDB2, isDBase, isDerby, isFirebird, isH2, isHSQL, isInformix, isMySQL, isODBC, isOracle, isOracle9, isPointBase, isPostgreSQL, isSQLAnywhere, isSQLServer, isSybase, isTimesTen, isTimesTen7, removeAllSequences, removeSequence, sequencesAfterCloneCleanup, setConversionManager, setDefaultSequence, setEndDelimiter, setSelectSequenceNumberQuery, setSequencePreallocationSize, setSequences, setStartDelimiter, setTableQualifier, setTimestampQuery, setUpdateSequenceQuery, shouldUseCustomModifyForCall, toString, usesPlatformDefaultSequence
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

isIndexedRecordSupported

protected boolean isIndexedRecordSupported

isMappedRecordSupported

protected boolean isMappedRecordSupported

isDOMRecordSupported

protected boolean isDOMRecordSupported

shouldConvertDataToStrings

protected boolean shouldConvertDataToStrings
Can be used for adapters that only support String data/XML.


supportsLocalTransactions

protected boolean supportsLocalTransactions
Allows for usage of transaction to be disabled if not supported.


requiresAutoCommit

protected boolean requiresAutoCommit
Can be used if a commit is required after every interaction outside of a local transaction.


recordConverter

protected RecordConverter recordConverter
Can be used to convert from an adapter specific record.


domMethod

protected java.lang.reflect.Method domMethod
Used to reflectively provide XML record support as DOMRecord is not part of the JCA-CCI spec.


xmlConversionManager

protected org.eclipse.persistence.internal.oxm.XMLConversionManager xmlConversionManager
For XML usage, an XMLConversionManager instance is required

Constructor Detail

EISPlatform

public EISPlatform()
Default constructor.

Method Detail

getRecordConverter

public RecordConverter getRecordConverter()
Return the record converter.


setRecordConverter

public void setRecordConverter(RecordConverter recordConverter)
Set the record converter. Can be used to convert from an adapter specific record.


requiresAutoCommit

public boolean requiresAutoCommit()
Return if this platform requires auto commit of the local transaction for interactions outside of an interaction.


setRequiresAutoCommit

public void setRequiresAutoCommit(boolean requiresAutoCommit)
Set if this platform requires auto commit of the local transaction for interactions outside of an interaction.


supportsLocalTransactions

public boolean supportsLocalTransactions()
Return if this platform supports local transactions.


setSupportsLocalTransactions

public void setSupportsLocalTransactions(boolean supportsLocalTransactions)
Set if this platform supports local transactions.


isIndexedRecordSupported

public boolean isIndexedRecordSupported()
Return if this platform supports JCA IndexedRecord.


setIsIndexedRecordSupported

public void setIsIndexedRecordSupported(boolean isIndexedRecordSupported)
Set if this platform supports JCA IndexedRecord.


isMappedRecordSupported

public boolean isMappedRecordSupported()
Return if this platform supports JCA MappedRecord.


setIsMappedRecordSupported

public void setIsMappedRecordSupported(boolean isMappedRecordSupported)
Set if this platform supports JCA MappedRecord.


isDOMRecordSupported

public boolean isDOMRecordSupported()
Return if this platform supports XML/DOM Records.


setIsDOMRecordSupported

public void setIsDOMRecordSupported(boolean isDOMRecordSupported)
Set if this platform supports XML/DOM Records.


shouldConvertDataToStrings

public boolean shouldConvertDataToStrings()
Return if all data set into the adapter should be first converted to strings.


setShouldConvertDataToStrings

public void setShouldConvertDataToStrings(boolean shouldConvertDataToStrings)
Set if all data set into the adapter should be first converted to strings.


buildInteractionSpec

public javax.resource.cci.InteractionSpec buildInteractionSpec(EISInteraction interaction)
Allow the platform to build the interaction spec based on properties defined in the interaction.


createInputRecord

public javax.resource.cci.Record createInputRecord(EISInteraction interaction,
                                                   EISAccessor accessor)
Allow the platform to create the appropiate type of record for the interaction.


createOutputRecord

public javax.resource.cci.Record createOutputRecord(EISInteraction interaction,
                                                    EISAccessor accessor)
Allow the platform to create the appropiate type of record for the interaction. If an output record is not required then null is returned.


buildRow

public org.eclipse.persistence.internal.sessions.AbstractRecord buildRow(javax.resource.cci.Record record,
                                                                         EISInteraction interaction,
                                                                         EISAccessor accessor)
INTERNAL: Allow the platform to handle record ro row conversion.


buildRows

public java.util.Vector buildRows(javax.resource.cci.Record record,
                                  EISInteraction interaction,
                                  EISAccessor accessor)
Allow the platform to handle record ro row conversion.


createDOMRecord

public javax.resource.cci.Record createDOMRecord(java.lang.String recordName,
                                                 EISAccessor accessor)
Allow the platform to handle the creation of the DOM record. By default create a mapped record an assume it implements DOM as well.


createDatabaseRowFromDOMRecord

public org.eclipse.persistence.internal.sessions.AbstractRecord createDatabaseRowFromDOMRecord(javax.resource.cci.Record record,
                                                                                               EISInteraction call,
                                                                                               EISAccessor accessor)
INTERNAL: Allow the platform to handle the creation of the Record for the DOM record. By default instantiate an EISDOMRecord which introspects the record for a getDOM method.


getValueFromRecord

public java.lang.Object getValueFromRecord(java.lang.String key,
                                           javax.resource.cci.MappedRecord record,
                                           EISAccessor accessor)
Retrieves the field value from the record. This allows for the platform to perform any platform specific translation or conversion.


setDOMInRecord

public void setDOMInRecord(org.w3c.dom.Element dom,
                           javax.resource.cci.Record record,
                           EISInteraction call,
                           EISAccessor accessor)
Stores the XML DOM value into the record. This must be implemented by the platform if it support XML/DOM records.


setValueInRecord

public void setValueInRecord(java.lang.String key,
                             java.lang.Object value,
                             javax.resource.cci.MappedRecord record,
                             EISAccessor accessor)
Stores the field value into the record. This allows for the platform to perform any platform specific translation or conversion.


appendParameter

public void appendParameter(Call call,
                            java.io.Writer writer,
                            java.lang.Object parameter)
Add the parameter. Convert the parameter to a string and write it. Convert rows to XML strings.

Specified by:
appendParameter in interface org.eclipse.persistence.internal.databaseaccess.Platform
Overrides:
appendParameter in class org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform

getConversionManager

public org.eclipse.persistence.internal.helper.ConversionManager getConversionManager()
The platform holds its own instance of conversion manager to allow customization.

Specified by:
getConversionManager in interface org.eclipse.persistence.internal.databaseaccess.Platform
Overrides:
getConversionManager in class org.eclipse.persistence.internal.databaseaccess.DatasourcePlatform

EclipseLink 2.0.0, build 'v20091127-r5931' API Reference