org.jpox.store
Interface DatastoreAdapter

All Superinterfaces:

ExpressionConversionAdapter, ExpressionLogicSetAdapter, ExpressionMethodAdapter, ExpressionOperatorAdapter, ExpressionPatternAdapter, ExpressionSupportedFeaturesAdapter

All Known Subinterfaces:

RDBMSAdapter

All Known Implementing Classes:

AbstractDatastoreAdapter, DatabaseAdapter

public interface DatastoreAdapter
extends ExpressionConversionAdapter, ExpressionOperatorAdapter, ExpressionMethodAdapter, ExpressionSupportedFeaturesAdapter, ExpressionPatternAdapter, ExpressionLogicSetAdapter

Definition of a datastore adapter.

Version:

$Revision: 1.30 $

Method Summary

long	getAdapterTime(java.sql.Timestamp time) Utility to return the adapter time in case there are rounding issues with millisecs etc.
int	getDatastoreMajorVersion() Accessor for the datastore major version number.
int	getDatastoreMinorVersion() Accessor for the datastore minor version number.
java.lang.String	getIdentifierQuoteString() Accessor for the quote string to use when quoting identifiers.
JavaTypeMapping	getMapping(java.lang.Class c, boolean serialised, boolean embedded, StoreManager storeMgr, ClassLoaderResolver clr) Accessor for the mapping for the specified class.
JavaTypeMapping	getMapping(java.lang.Class c, boolean serialised, boolean embedded, java.lang.String fieldName, StoreManager storeMgr) Accessor for the mapping for the specified class.
JavaTypeMapping	getMapping(java.lang.Class c, StoreManager storeMgr) Accessor for the mapping for the specified class.
JavaTypeMapping	getMapping(java.lang.Class c, StoreManager storeMgr, ClassLoaderResolver clr) Convenience accessor for the mapping for the specified class.
MappingManager	getMappingManager() Accessor for the Mapping Manager for field mapping management.
java.lang.String	getVendorID() Accessor for the Vendor ID for this datastore.
void	initialiseDatastore(java.lang.Object conn) Creates the auxiliary functions/procedures in the datastore
boolean	isAutoIncrementingDataType(java.lang.String columnDef) Verifies if the given columnDef is auto incremented by the datastore.
boolean	isReservedKeyword(java.lang.String word) Method to check if a word is reserved for this datastore.
boolean	isStoresLowerCaseIdentifiers() Accessor for whether this adapter stores lower case identifiers.
boolean	isStoresLowerCaseQuotedIdentifiers() Accessor for whether this adapter stores "lowercase" identifiers.
boolean	isStoresMixedCaseIdentifiers() Accessor for whether this adapter stores MixedCase identifiers.
boolean	isStoresMixedCaseQuotedIdentifiers() Accessor for whether this adapter "MixedCase" identifiers.
boolean	isStoresUpperCaseIdentifiers() Accessor for whether this adapter stores UPPERCASE identifiers.
boolean	isStoresUpperCaseQuotedIdentifiers() Accessor for whether this adapter stores "UPPERCASE" identifiers.
void	loadDatastoreMapping(PluginManager mgr, ClassLoaderResolver clr) Load the datastore mappings declared as Plug-in
NumericExpression	modOperator(ScalarExpression operand1, ScalarExpression operand2) Method to generate a modulus expression.
QueryExpression	newQueryStatement(DatastoreContainerObject container, ClassLoaderResolver clr) Accessor for a new query statement.
QueryExpression	newQueryStatement(DatastoreContainerObject container, DatastoreIdentifier rangeVar, ClassLoaderResolver clr) Accessor for a new query statement.
boolean	supportsAutoIncrementFields() Whether this datastore adapter support auto-incrementing fields.
boolean	supportsQueryFetchSizeLowerThanOne() Whether the datastore supports setting a fetch size lower than one.
boolean	supportsSequences() Whether this datastore adapter supports sequences.
java.lang.String	toString() Method to return this object as a string.

Methods inherited from interface org.jpox.store.expression.ExpressionConversionAdapter

toNumericExpression, toStringExpression, toStringExpression

Methods inherited from interface org.jpox.store.expression.ExpressionOperatorAdapter

concatOperator, getOperatorConcat

Methods inherited from interface org.jpox.store.expression.ExpressionMethodAdapter

absMethod, acosMethod, asinMethod, atanMethod, ceilMethod, cosMethod, endsWithMethod, expMethod, floorMethod, getDayMethod, getHourMethod, getMinuteMethod, getMonthMethod, getSecondMethod, getYearMethod, indexOfMethod, lengthMethod, logMethod, matchesMethod, sinMethod, sqrtMethod, startsWithMethod, substringMethod, substringMethod, tanMethod, trimMethod

Methods inherited from interface org.jpox.store.expression.ExpressionSupportedFeaturesAdapter

supportsBooleanComparison, supportsEscapeExpressionInLikePredicate

Methods inherited from interface org.jpox.store.expression.ExpressionPatternAdapter

getEscapeCharacter, getEscapedPatternExpression, getEscapePatternExpression, getPatternExpressionAnyCharacter, getPatternExpressionZeroMoreCharacters

Methods inherited from interface org.jpox.store.expression.ExpressionLogicSetAdapter

cartersianProduct

Method Detail

getMappingManager

MappingManager getMappingManager()

Accessor for the Mapping Manager for field mapping management.

Returns:

The Mapping Manager.

getVendorID

java.lang.String getVendorID()

Accessor for the Vendor ID for this datastore.

Returns:

Vendor id for this datastore

loadDatastoreMapping

void loadDatastoreMapping(PluginManager mgr,
                          ClassLoaderResolver clr)

Load the datastore mappings declared as Plug-in

Parameters:

mgr - the PluginManager

clr - the ClassLoaderResolver

isReservedKeyword

boolean isReservedKeyword(java.lang.String word)

Method to check if a word is reserved for this datastore.

Parameters:

word - The word

Returns:

Whether it is reserved

initialiseDatastore

void initialiseDatastore(java.lang.Object conn)

Creates the auxiliary functions/procedures in the datastore

Parameters:

conn - the connection to the datastore

getIdentifierQuoteString

java.lang.String getIdentifierQuoteString()

Accessor for the quote string to use when quoting identifiers.

Returns:

The quote string for the identifier

newQueryStatement

QueryExpression newQueryStatement(DatastoreContainerObject container,
                                  ClassLoaderResolver clr)

Accessor for a new query statement.

Parameters:

container - The table to query

clr - the ClassLoaderResolver

Returns:

The Query Statement

newQueryStatement

QueryExpression newQueryStatement(DatastoreContainerObject container,
                                  DatastoreIdentifier rangeVar,
                                  ClassLoaderResolver clr)

Accessor for a new query statement.

Parameters:

container - The table to query

rangeVar - A range variable for the query

clr - the ClassLoaderResolver

Returns:

The Query Statement

getMapping

JavaTypeMapping getMapping(java.lang.Class c,
                           StoreManager storeMgr)

Accessor for the mapping for the specified class.

Parameters:

c - Java type

storeMgr - the StoreManager

Returns:

The mapping for the class.

getMapping

JavaTypeMapping getMapping(java.lang.Class c,
                           boolean serialised,
                           boolean embedded,
                           java.lang.String fieldName,
                           StoreManager storeMgr)

Accessor for the mapping for the specified class.

Parameters:

c - Java type

serialised - Whether the type is serialised

embedded - Whether the type is embedded

fieldName - Name of field (for logging only)

storeMgr - the StoreManager

Returns:

The mapping for the class.

getMapping

JavaTypeMapping getMapping(java.lang.Class c,
                           StoreManager storeMgr,
                           ClassLoaderResolver clr)

Convenience accessor for the mapping for the specified class. Simply directs the request to the same method taking serialised and embedded as false.

Parameters:

c - Class to query

storeMgr - The Store Manager

clr - The ClassLoaderResolver

Returns:

The mapping for the class.

getMapping

JavaTypeMapping getMapping(java.lang.Class c,
                           boolean serialised,
                           boolean embedded,
                           StoreManager storeMgr,
                           ClassLoaderResolver clr)

Accessor for the mapping for the specified class.

Parameters:

c - Class to query

serialised - Whether the type is serialised

embedded - Whether the type is embedded

storeMgr - The Store Manager

clr - The ClassLoaderResolver

Returns:

The mapping for the class.

getAdapterTime

long getAdapterTime(java.sql.Timestamp time)

Utility to return the adapter time in case there are rounding issues with millisecs etc.

Parameters:

time - The timestamp

Returns:

The time in millisecs

getDatastoreMajorVersion

int getDatastoreMajorVersion()

Accessor for the datastore major version number.

Returns:

Major version number

getDatastoreMinorVersion

int getDatastoreMinorVersion()

Accessor for the datastore minor version number.

Returns:

Minor version number

modOperator

NumericExpression modOperator(ScalarExpression operand1,
                              ScalarExpression operand2)

Method to generate a modulus expression. The binary % operator is said to yield the remainder of its operands from an implied division; the left-hand operand is the dividend and the right-hand operand is the divisor.

Specified by:

modOperator in interface ExpressionOperatorAdapter

Parameters:

operand1 - the left expression

operand2 - the right expression

Returns:

The Expression for modulus

isAutoIncrementingDataType

boolean isAutoIncrementingDataType(java.lang.String columnDef)

Verifies if the given columnDef is auto incremented by the datastore.

Parameters:

columnDef - the datastore type name

Returns:

true when the columnDef has values auto incremented by the datastore

supportsAutoIncrementFields

boolean supportsAutoIncrementFields()

Whether this datastore adapter support auto-incrementing fields. The column could be things like "AUTOINCREMENT", "IDENTITY", "SERIAL" in SQL.

Returns:

whether autoincrementing fields are supported.

supportsSequences

boolean supportsSequences()

Whether this datastore adapter supports sequences.

Returns:

whether sequences are supported.

supportsQueryFetchSizeLowerThanOne

boolean supportsQueryFetchSizeLowerThanOne()

Whether the datastore supports setting a fetch size lower than one. Usually, the datastore should ignore settting fetch size lower than one.

Returns:

whether we support fetch size lower than one

isStoresLowerCaseIdentifiers

boolean isStoresLowerCaseIdentifiers()

Accessor for whether this adapter stores lower case identifiers.

Returns:

Whether lowercase identifiers are stored

isStoresLowerCaseQuotedIdentifiers

boolean isStoresLowerCaseQuotedIdentifiers()

Accessor for whether this adapter stores "lowercase" identifiers.

Returns:

Whether "lowercase" identifiers are stored

isStoresMixedCaseIdentifiers

boolean isStoresMixedCaseIdentifiers()

Accessor for whether this adapter stores MixedCase identifiers.

Returns:

Whether MixedCase identifiers are stored

isStoresMixedCaseQuotedIdentifiers

boolean isStoresMixedCaseQuotedIdentifiers()

Accessor for whether this adapter "MixedCase" identifiers.

Returns:

Whether "MixedCase" identifiers are stored

isStoresUpperCaseIdentifiers

boolean isStoresUpperCaseIdentifiers()

Accessor for whether this adapter stores UPPERCASE identifiers.

Returns:

Whether UPPERCASE identifiers are stored

isStoresUpperCaseQuotedIdentifiers

boolean isStoresUpperCaseQuotedIdentifiers()

Accessor for whether this adapter stores "UPPERCASE" identifiers.

Returns:

Whether "UPPERCASE" identifiers are stored

toString

java.lang.String toString()

Method to return this object as a string.

Overrides:

toString in class java.lang.Object

Returns:

String version of this object.