org.geotools.jdbc

Class JDBCJNDIDataStoreFactory

Object

JDBCDataStoreFactory

JDBCJNDIDataStoreFactory

All Implemented Interfaces:

DataAccessFactory, DataStoreFactorySpi, Factory

Direct Known Subclasses:

DB2NGJNDIDataStoreFactory, H2JNDIDataStoreFactory, HanaJNDIDataStoreFactory, MySQLJNDIDataStoreFactory, OracleNGJNDIDataStoreFactory, PostgisNGJNDIDataStoreFactory, SQLServerJNDIDataStoreFactory, TeradataJNDIDataStoreFactory

public abstract class JDBCJNDIDataStoreFactory
extends JDBCDataStoreFactory

Abstract implementation of DataStoreFactory for jdbc datastores which obtain a JNDI connection.

Subclasses should not need to override any methods, only just call the parent constructor passing in the non JNDI datastore factory to delegate to.

Author:

Christian Mueller

Nested Class Summary

Nested classes/interfaces inherited from interface DataAccessFactory

DataAccessFactory.Param

Field Summary

Fields

Modifier and Type	Field and Description
protected JDBCDataStoreFactory	delegate regular datastore factory to delegate to.
static String	J2EERootContext
static DataAccessFactory.Param	JNDI_REFNAME JNDI data source name

Fields inherited from class JDBCDataStoreFactory

BATCH_INSERT_SIZE, CALLBACK_FACTORY, DATABASE, DATASOURCE, DBTYPE, EVICTOR_TESTS_PER_RUN, EXPOSE_PK, FETCHSIZE, HOST, MAX_OPEN_PREPARED_STATEMENTS, MAXCONN, MAXWAIT, MIN_EVICTABLE_TIME, MINCONN, NAMESPACE, PASSWD, PK_METADATA_TABLE, PORT, SCHEMA, SQL_ON_BORROW, SQL_ON_RELEASE, TEST_WHILE_IDLE, TIME_BETWEEN_EVICTOR_RUNS, USER, VALIDATECONN

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JDBCJNDIDataStoreFactory(JDBCDataStoreFactory delegate)

Method Summary

Modifier and Type	Method and Description
protected boolean	checkDBType(Map<String,?> params)
protected DataSource	createDataSource(Map<String,?> params, SQLDialect dialect) Override to create the datasource from the external JNDI conection.
protected JDBCDataStore	createDataStoreInternal(JDBCDataStore dataStore, Map<String,?> params) Subclass hook to do additional initialization of a newly created datastore.
DataStore	createNewDataStore(Map<String,?> params)
protected SQLDialect	createSQLDialect(JDBCDataStore dataStore) Creates the dialect that the datastore uses for communication with the underlying database.
protected String	getDatabaseID() Returns a string to identify the type of the database.
String	getDescription() Describe the nature of the datasource constructed by this factory.
String	getDisplayName() Name suitable for display to end user.
protected String	getDriverClassName() Override which explicitly returns null because with a JNDI connection the driver is not known ahead of time.
Map<RenderingHints.Key,?>	getImplementationHints() Returns the implementation hints for the datastore.
protected String	getJDBCUrl(Map<String,?> params) Override which explicitly returns null since there is no jdbc url, the connection is identified by the JNDI name.
protected String	getValidationQuery() Override which explicitly returns null, validation queries are not supported, my be part of the external data source configuration
boolean	isAvailable() Determines if the datastore is available.
protected void	setupParameters(Map<String,Object> parameters) Override to omit all those parameters which define the creation of the connection.

Methods inherited from class JDBCDataStoreFactory

canProcess, checkDBType, createDataSource, createDataStore, createSQLDialect, getParametersInfo

Methods inherited from class Object

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

Field Detail

J2EERootContext

public static final String J2EERootContext

See Also:

Constant Field Values

JNDI_REFNAME

public static final DataAccessFactory.Param JNDI_REFNAME

JNDI data source name

delegate

protected JDBCDataStoreFactory delegate

regular datastore factory to delegate to.

Constructor Detail

JDBCJNDIDataStoreFactory

protected JDBCJNDIDataStoreFactory(JDBCDataStoreFactory delegate)

Method Detail

getDriverClassName

protected String getDriverClassName()

Override which explicitly returns null because with a JNDI connection the driver is not known ahead of time.

Specified by:

getDriverClassName in class JDBCDataStoreFactory

getValidationQuery

protected String getValidationQuery()

Override which explicitly returns null, validation queries are not supported, my be part of the external data source configuration

Specified by:

getValidationQuery in class JDBCDataStoreFactory

getJDBCUrl

protected String getJDBCUrl(Map<String,?> params)
                     throws IOException

Override which explicitly returns null since there is no jdbc url, the connection is identified by the JNDI name.

Overrides:

getJDBCUrl in class JDBCDataStoreFactory

Throws:

IOException

createDataSource

protected DataSource createDataSource(Map<String,?> params,
                                      SQLDialect dialect)
                               throws IOException

Override to create the datasource from the external JNDI conection.

Overrides:

createDataSource in class JDBCDataStoreFactory

Throws:

IOException

isAvailable

public boolean isAvailable()

Determines if the datastore is available.

Check in an Initial Context is available, that is all what can be done Checking for the right jdbc jars in the classpath is not possible here

Specified by:

isAvailable in interface DataAccessFactory

Overrides:

isAvailable in class JDBCDataStoreFactory

Returns:

true if and only if this factory has all the appropriate jars on the classpath to create DataStores.

setupParameters

protected void setupParameters(Map<String,Object> parameters)

Override to omit all those parameters which define the creation of the connection.

Overrides:

setupParameters in class JDBCDataStoreFactory

Parameters:

parameters - Map of Param objects.

getDatabaseID

protected String getDatabaseID()

Description copied from class: JDBCDataStoreFactory

Returns a string to identify the type of the database.

Example: 'postgis'.

Specified by:

getDatabaseID in class JDBCDataStoreFactory

getDisplayName

public String getDisplayName()

Description copied from interface: DataAccessFactory

Name suitable for display to end user.

A non localized display name for this data store type.

Specified by:

getDisplayName in interface DataAccessFactory

Overrides:

getDisplayName in class JDBCDataStoreFactory

Returns:

A short name suitable for display in a user interface.

getDescription

public String getDescription()

Description copied from interface: DataAccessFactory

Describe the nature of the datasource constructed by this factory.

A non localized description of this data store type.

Returns:

A human readable description that is suitable for inclusion in a list of available datasources.

createDataStoreInternal

protected JDBCDataStore createDataStoreInternal(JDBCDataStore dataStore,
                                                Map<String,?> params)
                                         throws IOException

Description copied from class: JDBCDataStoreFactory

Subclass hook to do additional initialization of a newly created datastore.

Typically subclasses will want to override this method in the case where they provide additional datastore parameters, those should be processed here.

This method is provided with an instance of the datastore. In some cases subclasses may wish to create a new instance of the datastore, for instance in order to wrap the original instance. This is supported but the new datastore must be returned from this method. If not is such the case this method should still return the original passed in.

Overrides:

createDataStoreInternal in class JDBCDataStoreFactory

Parameters:

dataStore - The newly created datastore.

params - THe datastore parameters.

Throws:

IOException

createNewDataStore

public DataStore createNewDataStore(Map<String,?> params)
                             throws IOException

Specified by:

createNewDataStore in interface DataStoreFactorySpi

Overrides:

createNewDataStore in class JDBCDataStoreFactory

Throws:

IOException

getImplementationHints

public Map<RenderingHints.Key,?> getImplementationHints()

Description copied from class: JDBCDataStoreFactory

Returns the implementation hints for the datastore.

Subclasses may override, this implementation returns null.

Specified by:

getImplementationHints in interface Factory

Overrides:

getImplementationHints in class JDBCDataStoreFactory

Returns:

The map of hints, or an empty map if none.

createSQLDialect

protected SQLDialect createSQLDialect(JDBCDataStore dataStore)

Description copied from class: JDBCDataStoreFactory

Creates the dialect that the datastore uses for communication with the underlying database.

Specified by:

createSQLDialect in class JDBCDataStoreFactory

Parameters:

dataStore - The datastore.

checkDBType

protected boolean checkDBType(Map<String,?> params)

Overrides:

checkDBType in class JDBCDataStoreFactory