| java.lang.Object
 org.geotools.data.oracle.OracleOCIDataStoreFactory
| OracleOCIDataStoreFactory | | public class OracleOCIDataStoreFactory implements DataStoreFactorySpi(Code) | | Creates an Oracle datastore based on a thick OCI client connection, instead
of the traditional (thin) jdbc connection. The thin JDBC connection was designed
for clients requiring no more classes than just the classes12.jar (or ojdbc14.jar).
The OCI JDBC drivers are based on the Oracle client software and rely mostly on the
very fast C/C++ based OCI (Oracle Call Interface) runtime.
This leads to an easy way to speed up GeoTools when gt2 is running on the same computer
as the oracle install, as the OCI drivers are already there. And I believe if a computer
has the OCI correctly installed and configure it can be used on remote computers, with
the faster connection. This just takes more work by the admin. Server applications like
GeoServer will often be on the same computer as the databse, so it makes sense to offer
admins the advantage of using the OCI jdbc driver.
Instead of the instance, host, port requirments of the normal oracle factory this driver
just requires the 'alias', which refers to values defined by the Oracle Net Configuration
assistant and stored in $ORACLE_HOME/NETWORK/ADMIN/tnsnames.ora. We have also had luck
on the same computer with just leaving 'alias' as an empty string, and it seems to have
a reasonable default behavior.
This factory should be registered in the META-INF/ folder, under services/
in the DataStoreFactorySpi file.
author:
Chris Holmes, TOPP
author:
Bernard de Terwangne, star.be |
| Method Summary | |
| public boolean | canProcess(Map params)
Determines whether DataStore created by this factory can process the
parameters.
Required Parameters are:
-
dbtype - must equal "oracle"
-
host
-
port
-
user
-
passwd
-
instance
There are no defaults since each parameter must be explicitly defined by
the user, or another DataSourceFactorySpi should be used. | | public DataStore | createDataStore(Map params)
Construct a postgis data store using the params.
Parameters:
params - The full set of information needed to construct a livedata source. | | public DataStore | createNewDataStore(Map params)
Oracle cannot create a new database. | | public static DataSource | getDefaultDataSource(String alias, String user, String passwd, int maxActive, int minIdle, boolean validate)
| | public String | getDescription()
Describe the nature of the datastore constructed by this factory. | | public String | getDisplayName()
| | public Map | getImplementationHints()
Returns the implementation hints. | | public Param[] | getParametersInfo()
Describe parameters. | | public boolean | isAvailable()
Returns whether the OracleDataStoreFactory would actually be able to
generate a DataStore. |
| ALIAS | | final static Param ALIAS(Code) | | |
| DBTYPE | | final static Param DBTYPE(Code) | | |
| INSTANCE | | final static Param INSTANCE(Code) | | |
| MAXCONN | | final public static Param MAXCONN(Code) | | |
| MINCONN | | final public static Param MINCONN(Code) | | |
| NAMESPACE | | final static Param NAMESPACE(Code) | | |
| PASSWD | | final static Param PASSWD(Code) | | |
| PORT | | final static Param PORT(Code) | | |
| SCHEMA | | final static Param SCHEMA(Code) | | Apparently Schema must be uppercase
|
| USER | | final static Param USER(Code) | | |
| VALIDATECONN | | final public static Param VALIDATECONN(Code) | | |
| OracleOCIDataStoreFactory | | public OracleOCIDataStoreFactory()(Code) | | Creates a new instance of OracleOCIDataStoreFactory
|
| canProcess | | public boolean canProcess(Map params)(Code) | | Determines whether DataStore created by this factory can process the
parameters.
Required Parameters are:
-
dbtype - must equal "oracle"
-
host
-
port
-
user
-
passwd
-
instance
There are no defaults since each parameter must be explicitly defined by
the user, or another DataSourceFactorySpi should be used. This
behaviour is defined in the DataStoreFactorySpi contract.
Parameters:
params - The parameter to check. True if all the required parameters are supplied. |
| createDataStore | | public DataStore createDataStore(Map params) throws IOException(Code) | | Construct a postgis data store using the params.
Parameters:
params - The full set of information needed to construct a livedata source. Should have dbtype equal to postgis, as well ashost, user, passwd, database, and table. The created DataSource, this may be null if the requiredresource was not found or if insufficent parameters were given.Note that canProcess() should have returned false if theproblem is to do with insuficent parameters.
throws:
IOException - DOCUMENT ME!
throws:
DataSourceException - Thrown if there were any problems creatingor connecting the datasource. |
| getDescription | | public String getDescription()(Code) | | Describe the nature of the datastore constructed by this factory.
A human readable description that is suitable for inclusion in alist of available datasources. |
| getImplementationHints | | public Map getImplementationHints()(Code) | | Returns the implementation hints. The default implementation returns en empty map.
|
| isAvailable | | public boolean isAvailable()(Code) | | Returns whether the OracleDataStoreFactory would actually be able to
generate a DataStore. Depends on whether the appropriate libraries are
on the classpath. For now just checks for the presence of the JDBC
driver, should probably check for SDOAPI as well.
True if the classes to make an oracle connection are present. |
|
|