com.force.sdk.jpa
Class ForceStoreManager

java.lang.Object
  org.datanucleus.store.AbstractStoreManager
      com.force.sdk.jpa.ForceStoreManager

All Implemented Interfaces:

org.datanucleus.store.StoreManager

public class ForceStoreManager
extends org.datanucleus.store.AbstractStoreManager

Store manager that holds all the persistence.xml properties.

Author:

Fiaz Hossain

Field Summary

static String

FORCE_KEY Store manager type for Force.com JPA.

Fields inherited from class org.datanucleus.store.AbstractStoreManager

autoStartMechanism, connectionMgr, fixedDatastore, LOCALISER, nontxConnectionFactoryName, omfContext, persistenceHandler2, readOnlyDatastore, schemaHandler, starter, starterInitialised, storeDataMgr, storeManagerKey, storeManagerRuntime, txConnectionFactoryName, valueGenerationMgr

Constructor Summary

ForceStoreManager(org.datanucleus.ClassLoaderResolver clr, org.datanucleus.OMFContext omfContext)
Creates a store manager for use with the Force.com API.

Method Summary

TableImpl	addTable(org.datanucleus.metadata.AbstractClassMetaData acmd, ForceManagedConnection mconn) Registers a table with the schema handler.
TableImpl	addVirtualTable(org.datanucleus.metadata.AbstractClassMetaData acmd) Registers a virtual table with the schema handler (a table not backed by an actual object but is still needed for JPA queries, e.g.
void	close() Releases resources.
ForceManagedConnection	createConnection() Creates a ForceManagedConnection for connection to Force.com.
ForceConnectorConfig	getConfig()
String	getConnectionURL() Looks into system variable and environment variables if url is in ${...} format.
ForceMetaDataListener	getMetaDataListener()
org.datanucleus.store.NucleusConnection	getNucleusConnection(org.datanucleus.store.ExecutionContext om)
int	getPoolMinEvictableIdleTimeMillis()
int	getPoolTimeBetweenEvictionRunsMillis()
ForceSchemaWriter	getSchemaWriter()
Collection	getSupportedOptions() Accessor for the supported options in string form.
TableImpl	getTable(org.datanucleus.metadata.AbstractClassMetaData acmd) Retrieves Force.com table information from JPA class metadata.
boolean	isAutoCreateColumns() Specifies whether fields should be created automatically on app startup.
boolean	isAutoCreateTables() Specifies whether objects should be created automatically on app startup.
boolean	isAutoCreateWarnOnError() Used for schema mismatches.
boolean	isEnableOptimisticTransactions() Specifies whether optimistic locking is enabled for this persistence unit.
boolean	isForDelete() Specifies whether this application has been started up with the flag to delete schema rather than create/upsert it.
protected void	registerConnectionMgr()

Methods inherited from class org.datanucleus.store.AbstractStoreManager

addClass, addClasses, assertReadOnlyForUpdateOfObject, clearAutoStarter, deregisterAllStoreData, getApiAdapter, getBackingStoreForField, getClassNameForObjectID, getConnection, getConnection, getConnection, getConnectionDriverName, getConnectionFactory, getConnectionFactory2, getConnectionFactory2Name, getConnectionFactoryName, getConnectionManager, getConnectionPassword, getConnectionUserName, getDatastoreDate, getExtent, getMetaDataManager, getNucleusSequence, getOMFContext, getPersistenceHandler, getPropertiesForGenerator, getQueryCacheKey, getRuntimeManager, getSchemaHandler, getStoreManagerKey, getStrategyForNative, getStrategyValue, getStrategyValueForGenerator, getSubClassesForClass, getValueGenerationManager, initialiseAutoStart, isStrategyDatastoreAttributed, logConfiguration, manageClassForIdentity, managesClass, newStoreData, notifyObjectIsOutdated, performVersionCheck, printInformation, registerConnectionFactory, registerStoreData, removeAllClasses, supportsQueryLanguage, supportsValueStrategy, transactionCommitted, transactionRolledBack, transactionStarted

Methods inherited from class java.lang.Object

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

Field Detail

FORCE_KEY

public static final String FORCE_KEY

Store manager type for Force.com JPA.

See Also:

Constant Field Values

Constructor Detail

ForceStoreManager

public ForceStoreManager(org.datanucleus.ClassLoaderResolver clr,
                         org.datanucleus.OMFContext omfContext)
                  throws NoSuchFieldException,
                         IllegalAccessException

Creates a store manager for use with the Force.com API. Set up the API connection configs, set some default properties and read in values from persistence.xml

Parameters:

clr - the class loader resolver

omfContext - the corresponding object manager factory context

Throws:

NoSuchFieldException - thrown if there is a problem setting up the plugin manager

IllegalAccessException - thrown if there is a problem setting up the plugin manager

Method Detail

getConnectionURL

public String getConnectionURL()

Looks into system variable and environment variables if url is in ${...} format.

Specified by:

getConnectionURL in interface org.datanucleus.store.StoreManager

Overrides:

getConnectionURL in class org.datanucleus.store.AbstractStoreManager

Returns:

Connection URL

registerConnectionMgr

protected void registerConnectionMgr()

Overrides:

registerConnectionMgr in class org.datanucleus.store.AbstractStoreManager

getConfig

public ForceConnectorConfig getConfig()

close

public void close()

Releases resources.

Specified by:

close in interface org.datanucleus.store.StoreManager

Overrides:

close in class org.datanucleus.store.AbstractStoreManager

getNucleusConnection

public org.datanucleus.store.NucleusConnection getNucleusConnection(org.datanucleus.store.ExecutionContext om)

Specified by:

getNucleusConnection in interface org.datanucleus.store.StoreManager

Overrides:

getNucleusConnection in class org.datanucleus.store.AbstractStoreManager

getSupportedOptions

public Collection getSupportedOptions()

Accessor for the supported options in string form.

Specified by:

getSupportedOptions in interface org.datanucleus.store.StoreManager

Overrides:

getSupportedOptions in class org.datanucleus.store.AbstractStoreManager

isAutoCreateColumns

public boolean isAutoCreateColumns()

Specifies whether fields should be created automatically on app startup.

Returns:

true if fields should be created

isAutoCreateTables

public boolean isAutoCreateTables()

Specifies whether objects should be created automatically on app startup.

Returns:

true if objects should be created

isAutoCreateWarnOnError

public boolean isAutoCreateWarnOnError()

Used for schema mismatches. For example, a column or table is specified in an application, but the column or table doesn't exist in the Force.com organization, and schema creation is turned OFF for field or columns. Value defaults to false but can be set in persistence.xml, if true warnings will be logged, exceptions will not be thrown.

Returns:

true if schema mismatches should log warnings, false if they should throw errors

getPoolMinEvictableIdleTimeMillis

public int getPoolMinEvictableIdleTimeMillis()

getPoolTimeBetweenEvictionRunsMillis

public int getPoolTimeBetweenEvictionRunsMillis()

getTable

public TableImpl getTable(org.datanucleus.metadata.AbstractClassMetaData acmd)

Retrieves Force.com table information from JPA class metadata.

Parameters:

acmd - JPA class metadata

Returns:

Force.com table information

addTable

public TableImpl addTable(org.datanucleus.metadata.AbstractClassMetaData acmd,
                          ForceManagedConnection mconn)

Registers a table with the schema handler.

Parameters:

acmd - the class metadata of the table to register

mconn - the managed connection to the Force.com APIs

Returns:

the created TableImpl for this object

addVirtualTable

public TableImpl addVirtualTable(org.datanucleus.metadata.AbstractClassMetaData acmd)

Registers a virtual table with the schema handler (a table not backed by an actual object but is still needed for JPA queries, e.g. ForceOwner)

Parameters:

acmd - the class metadata of the virtual table to register

Returns:

the TableImpl for this object

isEnableOptimisticTransactions

public boolean isEnableOptimisticTransactions()

Specifies whether optimistic locking is enabled for this persistence unit. Optimistic transactions prevent two separate transactions from updating the same record at the same time, thus overwriting one transaction's update

Returns:

true if optimistic transactions are enabled

getMetaDataListener

public ForceMetaDataListener getMetaDataListener()

createConnection

public ForceManagedConnection createConnection()

Creates a ForceManagedConnection for connection to Force.com.

Returns:

the created managed connection to Force.com

getSchemaWriter

public ForceSchemaWriter getSchemaWriter()

isForDelete

public boolean isForDelete()

Specifies whether this application has been started up with the flag to delete schema rather than create/upsert it.

Returns:

true if this application should delete schema