|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Constructs a live DataStore from a set of parameters.
An instance of this interface should exist for all data stores which want to take advantage of the dynamic plugin system. In addition to implementing this interface datastores should have a services file:
META-INF/services/org.geotools.data.DataStoreFactorySpi
The file should contain a single line which gives the full name of the implementing class.
example:e.g.
org.geotools.data.mytype.MyTypeDataSourceFacotry
The factories are never called directly by client code, instead the DataStoreFinder class is used.
The following example shows how a user might connect to a PostGIS database, and maintain the resulting datastore in a registry:
HashMap params = new HashMap();
params.put("namespace", "leeds");
params.put("dbtype", "postgis");
params.put("host","feathers.leeds.ac.uk");
params.put("port", "5432");
params.put("database","postgis_test");
params.put("user","postgis_ro");
params.put("passwd","postgis_ro");
DefaultRegistry registry = new DefaultRegistry();
registry.addDataStore("leeds", params);
DataStore postgis = registry.getDataStore( "leeds" );
FeatureSource = postgis.getFeatureSource( "table" );
Nested Class Summary | |
static class |
DataStoreFactorySpi.Param
Data class used to capture Parameter requirements. |
Method Summary | |
boolean |
canProcess(java.util.Map params)
Test to see if this factory is suitable for processing the data pointed to by the params map. |
DataStore |
createDataStore(java.util.Map params)
Construct a live data source using the params specifed. |
DataStore |
createNewDataStore(java.util.Map params)
|
java.lang.String |
getDescription()
Describe the nature of the datasource constructed by this factory. |
java.lang.String |
getDisplayName()
Name suitable for display to end user. |
DataStoreFactorySpi.Param[] |
getParametersInfo()
MetaData about the required Parameters (for createDataStore). |
boolean |
isAvailable()
Test to see if this datastore is available, if it has all the appropriate libraries to construct a datastore. |
Methods inherited from interface org.geotools.factory.Factory |
getImplementationHints |
Method Detail |
public DataStore createDataStore(java.util.Map params) throws java.io.IOException
You can think of this as setting up a connection to the back end data source.
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.public DataStore createNewDataStore(java.util.Map params) throws java.io.IOException
java.io.IOException
public java.lang.String getDisplayName()
A non localized display name for this data store type.
public java.lang.String getDescription()
A non localized description of this data store type.
public DataStoreFactorySpi.Param[] getParametersInfo()
Interpretation of FeatureDescriptor values:
This should be the same as:
Object params = factory.getParameters();
BeanInfo info = getBeanInfo( params );
return info.getPropertyDescriptors();
public boolean canProcess(java.util.Map params)
If this datasource requires a number of parameters then this mehtod should check that they are all present and that they are all valid. If the datasource is a file reading data source then the extentions or mime types of any files specified should be checked. For example, a Shapefile datasource should check that the url param ends with shp, such tests should be case insensative.
params
- The full set of information needed to construct a live
data source.
public boolean isAvailable()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |