|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectAbstractDataStoreFactory
JDBCDataStoreFactory
public abstract class JDBCDataStoreFactory
Abstract implementation of DataStoreFactory for jdbc datastores.
modules/library/jdbc (gt-jdbc.jar)
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface DataAccessFactory |
---|
DataAccessFactory.Param |
Field Summary | |
---|---|
static DataAccessFactory.Param |
DATABASE
parameter for database instance |
static DataAccessFactory.Param |
DATASOURCE
parameter for data source |
static DataAccessFactory.Param |
DBTYPE
parameter for database type |
static DataAccessFactory.Param |
FETCHSIZE
If connections should be validated before using them |
static DataAccessFactory.Param |
HOST
parameter for database host |
static DataAccessFactory.Param |
MAXCONN
Maximum number of connections in the connection pool |
static DataAccessFactory.Param |
MAXWAIT
Maximum amount of time the pool will wait when trying to grab a new connection |
static DataAccessFactory.Param |
MINCONN
Minimum number of connections in the connection pool |
static DataAccessFactory.Param |
NAMESPACE
parameter for namespace of the datastore |
static DataAccessFactory.Param |
PASSWD
parameter for database password |
static DataAccessFactory.Param |
PORT
parameter for database port |
static DataAccessFactory.Param |
SCHEMA
parameter for database schema |
static DataAccessFactory.Param |
USER
parameter for database user |
static DataAccessFactory.Param |
VALIDATECONN
If connections should be validated before using them |
Constructor Summary | |
---|---|
JDBCDataStoreFactory()
|
Method Summary | |
---|---|
boolean |
canProcess(Map params)
Default implementation verifies the Map against the Param information. |
BasicDataSource |
createDataSource(Map params)
DataSource access allowing SQL use: intended to allow client code to query available schemas. |
protected DataSource |
createDataSource(Map params,
SQLDialect dialect)
Creates the datasource for the data store. |
JDBCDataStore |
createDataStore(Map params)
Construct a live DataAccess using the connection parameters provided. |
protected JDBCDataStore |
createDataStoreInternal(JDBCDataStore dataStore,
Map params)
Subclass hook to do additional initialization of a newly created datastore. |
DataStore |
createNewDataStore(Map params)
|
protected abstract SQLDialect |
createSQLDialect(JDBCDataStore dataStore)
Creates the dialect that the datastore uses for communication with the underlying database. |
protected abstract String |
getDatabaseID()
Returns a string to identify the type of the database. |
String |
getDisplayName()
Default Implementation abuses the naming convention. |
protected abstract String |
getDriverClassName()
Returns the fully qualified class name of the jdbc driver. |
Map<RenderingHints.Key,?> |
getImplementationHints()
Returns the implementation hints for the datastore. |
protected String |
getJDBCUrl(Map params)
Builds up the JDBC url in a jdbc: |
DataAccessFactory.Param[] |
getParametersInfo()
MetaData about the required Parameters (for createDataStore). |
protected abstract String |
getValidationQuery()
Override this to return a good validation query (a very quick one, such as one that asks the database what time is it) or return null if the factory does not support validation. |
boolean |
isAvailable()
Determines if the datastore is available. |
protected void |
setupParameters(Map parameters)
Sets up the database connection parameters. |
Methods inherited from class AbstractDataStoreFactory |
---|
getParameters |
Methods inherited from class Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface DataAccessFactory |
---|
getDescription |
Field Detail |
---|
public static final DataAccessFactory.Param DBTYPE
public static final DataAccessFactory.Param HOST
public static final DataAccessFactory.Param PORT
public static final DataAccessFactory.Param DATABASE
public static final DataAccessFactory.Param SCHEMA
public static final DataAccessFactory.Param USER
public static final DataAccessFactory.Param PASSWD
public static final DataAccessFactory.Param NAMESPACE
public static final DataAccessFactory.Param DATASOURCE
public static final DataAccessFactory.Param MAXCONN
public static final DataAccessFactory.Param MINCONN
public static final DataAccessFactory.Param VALIDATECONN
public static final DataAccessFactory.Param FETCHSIZE
public static final DataAccessFactory.Param MAXWAIT
Constructor Detail |
---|
public JDBCDataStoreFactory()
Method Detail |
---|
public String getDisplayName()
AbstractDataStoreFactory
Will return Foo
for
org.geotools.data.foo.FooFactory
.
getDisplayName
in interface DataAccessFactory
getDisplayName
in class AbstractDataStoreFactory
public boolean canProcess(Map params)
AbstractDataStoreFactory
It will ensure that:
Why would you ever want to override this method? If you want to check that a expected file exists and is a directory.
Overrride:
public boolean canProcess( Map params ) {
if( !super.canProcess( params ) ){
return false; // was not in agreement with getParametersInfo
}
// example check
File file = (File) DIRECTORY.lookup( params ); // DIRECTORY is a param
return file.exists() && file.isDirectory();
}
canProcess
in interface DataAccessFactory
canProcess
in class AbstractDataStoreFactory
params
- The full set of information needed to construct a live
data source.
public final JDBCDataStore createDataStore(Map params) throws IOException
DataAccessFactory
You can think of this class as setting up a connection to the back end data source. The required parameters are described by the getParameterInfo() method.
Magic Params: the following params are magic and are honoured by convention by the GeoServer and uDig application.
params
- The full set of information needed to construct a live
data store. Typical key values for the map include: url -
location of a resource, used by file reading datasources. dbtype
- the type of the database to connect to, e.g. postgis, mysql
IOException
- if there were any problems setting up (creating or
connecting) the datasource.protected JDBCDataStore createDataStoreInternal(JDBCDataStore dataStore, Map params) throws IOException
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.
dataStore
- The newly created datastore.params
- THe datastore parameters.
IOException
public DataStore createNewDataStore(Map params) throws IOException
IOException
public final DataAccessFactory.Param[] getParametersInfo()
DataAccessFactory
Interpretation of FeatureDescriptor values:
This should be the same as:
Object params = factory.getParameters();
BeanInfo info = getBeanInfo( params );
return info.getPropertyDescriptors();
protected void setupParameters(Map parameters)
Subclasses may extend, but should not override. This implementation registers the following parameters.
Subclass implementation may remove any parameters from the map, or may overrwrite any parameters in the map.
parameters
- Map of Param
objects.public boolean isAvailable()
Subclasses may with to override or extend this method. This implementation
checks whether the jdbc driver class (provided by getDriverClassName()
can be loaded.
isAvailable
in interface DataAccessFactory
isAvailable
in class AbstractDataStoreFactory
true
, override to check for drivers etc...public Map<RenderingHints.Key,?> getImplementationHints()
Subclasses may override, this implementation returns null
.
getImplementationHints
in interface Factory
getImplementationHints
in class AbstractDataStoreFactory
protected abstract String getDatabaseID()
Example: 'postgis'.
protected abstract String getDriverClassName()
For example: org.postgresql.Driver
protected abstract SQLDialect createSQLDialect(JDBCDataStore dataStore)
dataStore
- The datastore.protected DataSource createDataSource(Map params, SQLDialect dialect) throws IOException
This method creates a BasicDataSource
instance and populates it
as follows:
getDriverClassName()
getDatabaseID()
>://<HOST
>/<DATABASE
>'
USER
>
PASSWD
>
IOException
public BasicDataSource createDataSource(Map params) throws IOException
This DataSource is the clients responsibility to close() when they are finished using it.
params
- Map of connection parameter.
IOException
protected abstract String getValidationQuery()
protected String getJDBCUrl(Map params) throws IOException
params
-
IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |