com.isomorphic.datasource

Class BasicDataSource

com.isomorphic.datasource.DataSource

com.isomorphic.datasource.BasicDataSource

All Implemented Interfaces:

IToJSON

Direct Known Subclasses:

HibernateDataSource, JPADataSource, SQLDataSource

public class BasicDataSource
extends DataSource

A BasicDataSource is a DataSource that can create itself from configuration information expressed in XML.

BasicDataSource is the right class to extend when creating a custom DataSource connector.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.isomorphic.datasource.DataSource

inInitState, OP_ADD, OP_CLIENT_EXPORT, OP_CUSTOM, OP_FETCH, OP_REMOVE, OP_UPDATE, OP_VALIDATE

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getProperty(java.lang.Object key) Returns a property from the DataSource config.
boolean	shouldAutoJoinTransaction(DSRequest req) Returns true if the parameter DSRequest should automatically join an existing transaction, taking into account the DSRequest-specific override provided by DSRequest.setJoinTransaction, the transaction policy of the controlling RPCManager (if there is one), and autoJoinTransactions settings at the operationBinding, DataSource, dbName and global system levels.
boolean	shouldAutoStartTransaction(DSRequest req, boolean ignoreExistingTransaction) Returns true if the parameter DSRequest should automatically start a new transaction, taking into account the DSRequest-specific override provided by DSRequest.setJoinTransaction, the transaction policy of the controlling RPCManager (if there is one), and autoJoinTransactions settings at the operationBinding, DataSource, dbName and global system levels

Methods inherited from class com.isomorphic.datasource.DataSource

add, addDynamicDSGenerator, addDynamicDSGenerator, addDynamicDSGenerator, clearDynamicDSGenerators, execute, executeAdd, executeClientExport, executeCustom, executeFetch, executeRemove, executeUpdate, fetch, fetch, fetchById, fetchSingle, fetchSingle, filter, filter, fromXML, fromXML, fromXML, fromXML, fromXML, fromXML, fromXML, fromXML, getEnumConstantProperty, getEnumOrdinalProperty, getEnumTranslateStrategy, getField, getFieldNames, getListProperties, getListProperties, getPrimaryKey, getProperties, getProperties, getProperties, getPropertyJavaClass, getRecordXPath, getTransactionObject, getTransactionObject, hasRecord, hasRecord, initialized, isModificationOperation, remove, removeDynamicDSGenerator, removeDynamicDSGenerator, removeDynamicDSGenerator, setEnumConstantProperty, setEnumOrdinalProperty, setEnumTranslateStrategy, setProperties, update, validate

Methods inherited from interface com.isomorphic.js.IToJSON

toJSON

Method Detail

getProperty

public java.lang.String getProperty(java.lang.Object key)

Returns a property from the DataSource config. This method allows a custom DataSource implementation to be configuration-driven like the built-in DataSource implementations are. So, if you add

    myNewProperty="some useful value"
 

to the <DataSource> tag in your .ds.xml definition file, calling this method with a parameter of "myNewProperty" will return "some useful value" - the value you assigned in the DataSource definition.

Parameters:

key - The key to look up

Returns:

The property value as a String (non-String objects are converted using toString())

shouldAutoStartTransaction

public boolean shouldAutoStartTransaction(DSRequest req,
                                 boolean ignoreExistingTransaction)
                                   throws java.lang.Exception

Returns true if the parameter DSRequest should automatically start a new transaction, taking into account the DSRequest-specific override provided by DSRequest.setJoinTransaction, the transaction policy of the controlling RPCManager (if there is one), and autoJoinTransactions settings at the operationBinding, DataSource, dbName and global system levels

This method is part of the Automatic Transactions feature, which is effective only in Power edition and above.

Parameters:

req - The DSRequest to check

ignoreExistingTransaction - If true, indicates that we should not take into account any existing transaction for this RPCManager when deciding if a transaction should be autoStarted. This is useful if you want to know if a request would have started a new transaction if one hadn't already been started.

Throws:

java.lang.Exception

shouldAutoJoinTransaction

public boolean shouldAutoJoinTransaction(DSRequest req)
                                  throws java.lang.Exception

Returns true if the parameter DSRequest should automatically join an existing transaction, taking into account the DSRequest-specific override provided by DSRequest.setJoinTransaction, the transaction policy of the controlling RPCManager (if there is one), and autoJoinTransactions settings at the operationBinding, DataSource, dbName and global system levels.

This method is part of the Automatic Transactions feature, which is effective only in Power edition and above.

Parameters:

req - The DSRequest to check

Throws:

java.lang.Exception