com.webobjects.jdbcadaptor

Class _H2PlugIn

java.lang.Object

com.webobjects.jdbcadaptor.JDBCPlugIn

com.webobjects.jdbcadaptor._H2PlugIn

Direct Known Subclasses:

H2PlugIn

public class _H2PlugIn
extends JDBCPlugIn

WO runtime plugin with support for H2.

See Also:

http://www.h2database.com

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	_H2PlugIn.H2Expression
static class	_H2PlugIn.H2SynchronizationFactory

Nested classes/interfaces inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

JDBCPlugIn.LobEntry

Field Summary

Fields

Modifier and Type	Field and Description
protected static NSMutableDictionary<String,String>	sequenceNameOverrides

Fields inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

_adaptor, _expressionClass, _expressionFactory, _pkTableName, _subprotocolRegistry, _syncFactory, DefaultPlugInClassName, DefaultPlugInSuffix

Constructor Summary

Constructors

Constructor and Description
_H2PlugIn(JDBCAdaptor adaptor)

Method Summary

Modifier and Type	Method and Description
protected static String	_sequenceNameForEntity(EOEntity entity) Utility method that returns the name of the sequence associated with the given entity.
com.webobjects.eoaccess.synchronization.EOSchemaSynchronizationFactory	createSchemaSynchronizationFactory()
String	databaseProductName()
String	defaultDriverName()
Class<? extends JDBCExpression>	defaultExpressionClass()
Object	fetchBLOB(ResultSet rs, int column, EOAttribute attribute, boolean materialize)
Object	fetchCLOB(ResultSet rs, int column, EOAttribute attribute, boolean materialize)
NSDictionary<String,Object>	jdbcInfo() This is usually extracted from the the database using JDBC, but this is really inconvenient for users who are trying to generate SQL at some.
String	name()
NSArray<NSDictionary<String,Object>>	newPrimaryKeys(int count, EOEntity entity, JDBCChannel channel) Overrides the parent implementation to provide a more efficient mechanism for generating primary keys, while generating the primary key support on the fly.
protected static String	quoteTableName(String name)
protected static void	setSequenceNameOverride(String defaultName, String h2Name) Sets the sequence name to be used in H2 instead of the default WO sequence name.
protected boolean	shouldUseBundledJdbcInfo() This method returns true by default unless the connection URL for the database has useBundledJdbcInfo=false on it which indicates to the system that the jdbcInfo which has been bundled into the plugin is not acceptable to use and instead it should fetch a fresh copy from the database.

Methods inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

_attributeForPath, _couldIgnoreException, _relationshipForPath, _takeValueForKeyPath, adaptor, assignTypeForAttribute, canDescribeStoredProcedure, connectionPropertiesForConnectionDictionary, connectionURL, createAttributeForRow, createExpressionFactory, createSynchronizationFactory, databaseInformation, expressionFactory, isDroppedConnectionException, isPseudoColumnName, jdbcTypeForUnknownExternalType, newPrimaryKeySelectString, plugInNameForURL, plugInValueForValue, primaryKeyLockString, primaryKeyTableCreateString, primaryKeyTableName, removePlugInNameForSubprotocol, schemaNameForEntity, schemaSynchronizationFactory, setPlugInNameForSubprotocol, sqlStatementForGettingProcedureNames, sqlStatementForGettingTableNames, sqlStatementForTableNamed, storedProcedureCatalogPattern, storedProcedureNamed, storedProcedureSchemaPattern, synchronizationFactory, tableTypes, updateLOBs, wildcardPatternForAttributes, wildcardPatternForSchema, wildcardPatternForTables

Methods inherited from class java.lang.Object

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

Field Detail

sequenceNameOverrides

protected static NSMutableDictionary<String,String> sequenceNameOverrides

Constructor Detail

_H2PlugIn

public _H2PlugIn(JDBCAdaptor adaptor)

Method Detail

quoteTableName

protected static String quoteTableName(String name)

_sequenceNameForEntity

protected static String _sequenceNameForEntity(EOEntity entity)

Utility method that returns the name of the sequence associated with the given entity.

Parameters:

entity - the entity

Returns:

the name of the sequence

setSequenceNameOverride

protected static void setSequenceNameOverride(String defaultName,
                                              String h2Name)

Sets the sequence name to be used in H2 instead of the default WO sequence name. This is needed if the sequence has been created outside of WO and its name is differing from the default WO schema as H2 does not yet support renaming of sequences.

Parameters:

defaultName - WO default sequence name

h2Name - sequence name in H2

fetchBLOB

public Object fetchBLOB(ResultSet rs,
                        int column,
                        EOAttribute attribute,
                        boolean materialize)
                 throws SQLException

Overrides:

fetchBLOB in class JDBCPlugIn

Throws:

SQLException

fetchCLOB

public Object fetchCLOB(ResultSet rs,
                        int column,
                        EOAttribute attribute,
                        boolean materialize)
                 throws SQLException

Overrides:

fetchCLOB in class JDBCPlugIn

Throws:

SQLException

createSchemaSynchronizationFactory

public com.webobjects.eoaccess.synchronization.EOSchemaSynchronizationFactory createSchemaSynchronizationFactory()

Overrides:

createSchemaSynchronizationFactory in class JDBCPlugIn

databaseProductName

public String databaseProductName()

Overrides:

databaseProductName in class JDBCPlugIn

defaultDriverName

public String defaultDriverName()

Overrides:

defaultDriverName in class JDBCPlugIn

defaultExpressionClass

public Class<? extends JDBCExpression> defaultExpressionClass()

Overrides:

defaultExpressionClass in class JDBCPlugIn

jdbcInfo

public NSDictionary<String,Object> jdbcInfo()

This is usually extracted from the the database using JDBC, but this is really inconvenient for users who are trying to generate SQL at some. A specific version of the data has been written into the property list of the framework and this can be used as a hard-coded equivalent.

Provide system property h2.updateJDBCInfo=true to cause H2JDBCInfo.plist to be written out to the platform temp dir.

Overrides:

jdbcInfo in class JDBCPlugIn

name

public String name()

Overrides:

name in class JDBCPlugIn

shouldUseBundledJdbcInfo

protected boolean shouldUseBundledJdbcInfo()

This method returns true by default unless the connection URL for the database has useBundledJdbcInfo=false on it which indicates to the system that the jdbcInfo which has been bundled into the plugin is not acceptable to use and instead it should fetch a fresh copy from the database.

Returns:

true if bundled jdbcInfo should be used

newPrimaryKeys

public NSArray<NSDictionary<String,Object>> newPrimaryKeys(int count,
                                                           EOEntity entity,
                                                           JDBCChannel channel)

Overrides the parent implementation to provide a more efficient mechanism for generating primary keys, while generating the primary key support on the fly.

Overrides:

newPrimaryKeys in class JDBCPlugIn

Parameters:

count - the batch size

entity - the entity requesting primary keys

channel - open JDBCChannel

Returns:

NSArray of NSDictionary where each dictionary corresponds to a unique primary key value