org.gvsig.fmap.dal.impl

Class DefaultDataManager

java.lang.Object

org.gvsig.fmap.dal.impl.DefaultDataManager

All Implemented Interfaces:

DataManager, DataManagerProviderServices

public class DefaultDataManager
extends Object
implements DataManager, DataManagerProviderServices

Field Summary

Fields inherited from interface org.gvsig.fmap.dal.DataManager

CREATE_STORE_AUTHORIZATION, READ_STORE_AUTHORIZATION, WRITE_STORE_AUTHORIZATION

Constructor Summary

Constructors

Constructor and Description
DefaultDataManager()

Method Summary

Methods

Modifier and Type	Method and Description
DynObject	createCacheParameters(String name) Returns an instance of DataServerExplorerParameters corresponding to the given name used by the cache to create a store to save the retrieved data.
Evaluator	createExpresion(String expresion) Creates an instance of Evaluator that represents the given expression.
FeatureAttributeGetter	createFeatureAttributeGetter(String name) Creates a FeatureAttributeGetter by name.
FeatureCacheProvider	createFeatureCacheProvider(String name, DynObject parameters) Creates a FeatureCacheProvider from a name and the parameters to configure its data server explorer.
FeatureIndexProviderServices	createFeatureIndexProvider(String name, FeatureStore store, FeatureType type, String indexName, FeatureAttributeDescriptor attr) Returns a DataIndexProvider compatible with the attribute data type.
FeaturePagingHelper	createFeaturePagingHelper(FeatureStore featureStore, FeatureQuery featureQuery, int pageSize) Creates a FeaturePagingHelper to paginate data from a FeatureStore.
FeaturePagingHelper	createFeaturePagingHelper(FeatureStore featureStore, int pageSize) Creates a FeaturePagingHelper to paginate data from a FeatureStore.
EditableFeatureType	createFeatureType()
FeatureStore	createMemoryStore(String autoOrderAttributeName) Utility method to create the a FeatureStore based on the MemoryStoreProvider.
DataStoreParameters	createMemoryStoreParameters(String autoOrderAttributeName) Utility method to create the DataStoreParameters to create a FeatureStore based on the MemoryStoreProvider.
NewDataStoreParameters	createNewStoreParameters(String explorer, String provider) Creates, initializes and returns an instance of NewDataStoreParameters given the name with which their provider is registered.
DataStoreProvider	createProvider(DataStoreProviderServices providerServices, DataStoreParameters parameters) Creates a new instance of the provider associated to the passed parameters.
DataServerExplorer	createServerExplorer(DataServerExplorerParameters parameters) Deprecated. see openServerExplorer
DataServerExplorerParameters	createServerExplorerParameters(String name) Returns an instance of DataServerExplorerParameters corresponding to the given name.
DataStore	createStore(DataStoreParameters parameters) Deprecated. see openStore
DataStore	createStore(DynObject doparameters) Deprecated. see openStore
DataStoreParameters	createStoreParameters(DynStruct struct) Creates, initializes and fill an instance of DataStoreParameters from the tags of the DynStruct passed as parameter.
DataStoreParameters	createStoreParameters(String name) Creates, initializes and returns an instance of DataStoreParameters given the name with which their provider is registered.
DataStoreParameters	createStoreParameters(Tags tags)
DataServerExplorerPool	getDataServerExplorerPool()
List	getDataTypes()
String	getDefaultFeatureIndexProviderName(int dataType) Returns the default DataIndexProvider name, given a data type.
List	getExplorerProviders() Returns a list of String containing the names of the available DataServerExplorer providers.
List	getFeatureCacheProviders() Returns a list of String containing the names of the available cache providers.
List	getFeatureIndexProviders() Returns a list of String containing the names of the available index providers.
OpenErrorHandler	getOpenErrorHandler()
OperationManager	getOperationManager()
ResourceManager	getResourceManager()
DataStoreProviderFactory	getStoreProviderFactory(String name)
List	getStoreProviders() Returns a list of Strings containing the names of all available DataStore providers.
List	getStoreProviders(String name) Returns a list of Strings containing the names of all available DataStore providers for an explorer.
String	getTemporaryDirectory() Returns the default DAL's temporary directory
void	intializeDataStore(DataStore store, DataStoreParameters parameters)
void	newStore(String explorer, String provider, NewDataStoreParameters parameters, boolean overwrite) Create a new physical store
DataServerExplorer	openServerExplorer(String explorer, DataServerExplorerParameters parameters) Returns an instance of DataServerExplorer given its parameters.
DataStore	openStore(DynStruct struct)
DataStore	openStore(String provider, DataStoreParameters parameters)
DataStore	openStore(String provider, DynObject parameters) Creates, initializes and returns an instance of DataStore given the DataStoreParameters.
void	registerDefaultEvaluator(Class evaluatorClass) Registers the default expression evaluator.
void	registerDefaultRasterStore(Class rasterStoreClass) Este metodo es temporal hasta que se integre el nuevo raster en el core de gvSIG.
void	registerExplorerProvider(String name, Class explorerClass, Class parametersClass) Register a new provider of data server explorer FIXME
void	registerFeatureAttributeGetter(String name, Class clazz) Registers a class that can be used to create a FeatureAttributeGetter and associate it to a FeatureAttributeDescriptor.
void	registerFeatureCacheProvider(FeatureCacheProviderFactory providerFactory) Registers a new cache provider.
void	registerFeatureIndexProvider(String name, String description, Class clazz, int dataType) Registers a new feature index provider.
void	registerStoreFactory(String name, Class storeProviderClass) Registers a store factory.
void	registerStoreProvider(String name, Class storeProviderClass, Class parametersClass)
void	registerStoreProviderFactory(DataStoreProviderFactory factory)
void	setDataServerExplorerPool(DataServerExplorerPool pool)
void	setDefaultFeatureIndexProviderName(int dataType, String name) Sets the default DataIndexProvider for the given data type.
void	setOpenErrorHandler(OpenErrorHandler handler)
DataStoreParameters	toDataStoreParameters(String provider, DynObject doparams)

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultDataManager

public DefaultDataManager()

Method Detail

getResourceManager

public ResourceManager getResourceManager()

Returns:

ResourceManager

getOperationManager

public OperationManager getOperationManager()

getTemporaryDirectory

public String getTemporaryDirectory()

Description copied from interface: DataManager

Returns the default DAL's temporary directory

Specified by:

getTemporaryDirectory in interface DataManager

Returns:

Temporary directory name

registerStoreProvider

public void registerStoreProvider(String name,
                         Class storeProviderClass,
                         Class parametersClass)

Specified by:

registerStoreProvider in interface DataManagerProviderServices

registerStoreProviderFactory

public void registerStoreProviderFactory(DataStoreProviderFactory factory)

Specified by:

registerStoreProviderFactory in interface DataManagerProviderServices

registerStoreFactory

public void registerStoreFactory(String name,
                        Class storeProviderClass)

Description copied from interface: DataManagerProviderServices

Registers a store factory.

Specified by:

registerStoreFactory in interface DataManagerProviderServices

createStoreParameters

public DataStoreParameters createStoreParameters(String name)
                                          throws InitializeException,
                                                 ProviderNotRegisteredException

Description copied from interface: DataManager

Creates, initializes and returns an instance of DataStoreParameters given the name with which their provider is registered.

Specified by:

createStoreParameters in interface DataManager

Parameters:

name - provider name

Returns:

the data store parameters

Throws:

InitializeException - if there is an error initializing the parameters for the memory provider

ProviderNotRegisteredException - if the memory provider is not registered

toDataStoreParameters

public DataStoreParameters toDataStoreParameters(String provider,
                                        DynObject doparams)
                                          throws InitializeException,
                                                 ProviderNotRegisteredException

Throws:

InitializeException

ProviderNotRegisteredException

registerDefaultRasterStore

public void registerDefaultRasterStore(Class rasterStoreClass)

Description copied from interface: DataManagerProviderServices

Este metodo es temporal hasta que se integre el nuevo raster en el core de gvSIG.

Specified by:

registerDefaultRasterStore in interface DataManagerProviderServices

openStore

public DataStore openStore(String provider,
                  DynObject parameters)
                    throws InitializeException,
                           ProviderNotRegisteredException,
                           ValidateDataParametersException

Description copied from interface: DataManager

Creates, initializes and returns an instance of DataStore given the DataStoreParameters.

Specified by:

openStore in interface DataManager

parameters - parameters used to instantiate and initialize the DataStore

Returns:

Throws:

InitializeException - if there is an error initializing the parameters for the memory provider

ProviderNotRegisteredException - if the memory provider is not registered

ValidateDataParametersException - if the parameters to open the memory based store are not valid

openStore

public DataStore openStore(String provider,
                  DataStoreParameters parameters)
                    throws InitializeException,
                           ProviderNotRegisteredException,
                           ValidateDataParametersException

Specified by:

openStore in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

createStore

public DataStore createStore(DynObject doparameters)
                      throws InitializeException,
                             ProviderNotRegisteredException,
                             ValidateDataParametersException

Deprecated. see openStore

Specified by:

createStore in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

createStore

public DataStore createStore(DataStoreParameters parameters)
                      throws InitializeException,
                             ProviderNotRegisteredException,
                             ValidateDataParametersException

Deprecated. see openStore

Specified by:

createStore in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

getStoreProviders

public List getStoreProviders()

Description copied from interface: DataManager

Returns a list of Strings containing the names of all available DataStore providers.

Specified by:

getStoreProviders in interface DataManager

Returns:

list of String containing available DataStore provider names

getStoreProviderFactory

public DataStoreProviderFactory getStoreProviderFactory(String name)

Specified by:

getStoreProviderFactory in interface DataManager

getStoreProviders

public List getStoreProviders(String name)

Description copied from interface: DataManager

Returns a list of Strings containing the names of all available DataStore providers for an explorer.

Specified by:

getStoreProviders in interface DataManager

createNewStoreParameters

public NewDataStoreParameters createNewStoreParameters(String explorer,
                                              String provider)
                                                throws InitializeException,
                                                       ProviderNotRegisteredException

Description copied from interface: DataManager

Creates, initializes and returns an instance of NewDataStoreParameters given the name with which their provider is registered.

Specified by:

createNewStoreParameters in interface DataManager

Returns:

Throws:

InitializeException

ProviderNotRegisteredException

newStore

public void newStore(String explorer,
            String provider,
            NewDataStoreParameters parameters,
            boolean overwrite)
              throws InitializeException,
                     ProviderNotRegisteredException,
                     ValidateDataParametersException

Description copied from interface: DataManager

Create a new physical store

Specified by:

newStore in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

registerExplorerProvider

public void registerExplorerProvider(String name,
                            Class explorerClass,
                            Class parametersClass)

Description copied from interface: DataManagerProviderServices

Register a new provider of data server explorer FIXME

Specified by:

registerExplorerProvider in interface DataManagerProviderServices

explorerClass - class of provider

parametersClass - parameters class of provider

createServerExplorerParameters

public DataServerExplorerParameters createServerExplorerParameters(String name)
                                                            throws InitializeException,
                                                                   ProviderNotRegisteredException

Description copied from interface: DataManager

Returns an instance of DataServerExplorerParameters corresponding to the given name.

Specified by:

createServerExplorerParameters in interface DataManager

Parameters:

name - name of a registered server explorer provider

Throws:

InitializeException - if parameter initialization causes an error.

ProviderNotRegisteredException - if could not find a provider by the given name.

openServerExplorer

public DataServerExplorer openServerExplorer(String explorer,
                                    DataServerExplorerParameters parameters)
                                      throws InitializeException,
                                             ProviderNotRegisteredException,
                                             ValidateDataParametersException

Description copied from interface: DataManager

Returns an instance of DataServerExplorer given its parameters.

Specified by:

openServerExplorer in interface DataManager

parameters - parameters used to instantiate and initialize the DataServerExplorer.

Returns:

an instance of DataServerExplorer.

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

createServerExplorer

public DataServerExplorer createServerExplorer(DataServerExplorerParameters parameters)
                                        throws InitializeException,
                                               ProviderNotRegisteredException,
                                               ValidateDataParametersException

Deprecated. see openServerExplorer

Specified by:

createServerExplorer in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

getExplorerProviders

public List getExplorerProviders()

Description copied from interface: DataManager

Returns a list of String containing the names of the available DataServerExplorer providers.

Specified by:

getExplorerProviders in interface DataManager

Returns:

list of String containing the names of the available DataServerExplorer providers.

createExpresion

public Evaluator createExpresion(String expresion)
                          throws InitializeException

Description copied from interface: DataManager

Creates an instance of Evaluator that represents the given expression.

Specified by:

createExpresion in interface DataManager

Parameters:

expresion - String containing a CQL expression.

Returns:

instance of Evaluator representing the given expression.

Throws:

InitializeException

registerDefaultEvaluator

public void registerDefaultEvaluator(Class evaluatorClass)

Description copied from interface: DataManager

Registers the default expression evaluator. It is used by DAL to evaluate and resolve query filters and expressions.

Specified by:

registerDefaultEvaluator in interface DataManager

Parameters:

evaluatorClass - Class that will be called to evaluate the expression. It must implement Evaluator.

getFeatureIndexProviders

public List getFeatureIndexProviders()

Description copied from interface: DataManager

Returns a list of String containing the names of the available index providers.

Specified by:

getFeatureIndexProviders in interface DataManager

Returns:

list of strings with the names of the available index providers

setDefaultFeatureIndexProviderName

public void setDefaultFeatureIndexProviderName(int dataType,
                                      String name)

Description copied from interface: DataManager

Sets the default DataIndexProvider for the given data type.

Specified by:

setDefaultFeatureIndexProviderName in interface DataManager

Parameters:

dataType - one of the data types defined in DataTypes.

name - Provider's name

getDefaultFeatureIndexProviderName

public String getDefaultFeatureIndexProviderName(int dataType)

Description copied from interface: DataManager

Returns the default DataIndexProvider name, given a data type. Data types are defined in DataTypes.

Specified by:

getDefaultFeatureIndexProviderName in interface DataManager

Parameters:

dataType - one of the constants in DataTypes.

Returns:

the name of the default FeatureIndexProvider if there is anyone available for the given data type.

createFeatureIndexProvider

public FeatureIndexProviderServices createFeatureIndexProvider(String name,
                                                      FeatureStore store,
                                                      FeatureType type,
                                                      String indexName,
                                                      FeatureAttributeDescriptor attr)
                                                        throws InitializeException,
                                                               ProviderNotRegisteredException

Description copied from interface: DataManagerProviderServices

Returns a DataIndexProvider compatible with the attribute data type.

Specified by:

createFeatureIndexProvider in interface DataManagerProviderServices

store - associated FeatureStore

type - associated FeatureType

attr - associated FeatureAttributeDescriptor

Returns:

empty DataIndexProvider, initialized and ready to use

Throws:

InitializeException

ProviderNotRegisteredException

registerFeatureIndexProvider

public void registerFeatureIndexProvider(String name,
                                String description,
                                Class clazz,
                                int dataType)

Description copied from interface: DataManagerProviderServices

Registers a new feature index provider.

Specified by:

registerFeatureIndexProvider in interface DataManagerProviderServices

Parameters:

name - provider's name

description - provider's description

clazz - a custom FeatureIndexProvider implementation

dataType - one of the constants in DataTypes. This means that this provider can build indexes based on attributes of this type.

intializeDataStore

public void intializeDataStore(DataStore store,
                      DataStoreParameters parameters)
                        throws InitializeException,
                               ProviderNotRegisteredException

Throws:

InitializeException

ProviderNotRegisteredException

createProvider

public DataStoreProvider createProvider(DataStoreProviderServices providerServices,
                               DataStoreParameters parameters)
                                 throws InitializeException,
                                        ProviderNotRegisteredException

Description copied from interface: DataManagerProviderServices

Creates a new instance of the provider associated to the passed parameters.

Specified by:

createProvider in interface DataManagerProviderServices

Returns:

Throws:

InitializeException

ProviderNotRegisteredException

registerFeatureCacheProvider

public void registerFeatureCacheProvider(FeatureCacheProviderFactory providerFactory)

Description copied from interface: DataManagerProviderServices

Registers a new cache provider.

Specified by:

registerFeatureCacheProvider in interface DataManagerProviderServices

createFeatureCacheProvider

public FeatureCacheProvider createFeatureCacheProvider(String name,
                                              DynObject parameters)
                                                throws DataException

Description copied from interface: DataManagerProviderServices

Creates a FeatureCacheProvider from a name and the parameters to configure its data server explorer. The cache provider creates new stores using the DataServerExplorerParameters.

Specified by:

createFeatureCacheProvider in interface DataManagerProviderServices

Parameters:

name - provider's name.

parameters - parameters used to create a explorer.

Returns:

A cache provider

Throws:

DataException

getFeatureCacheProviders

public List getFeatureCacheProviders()

Description copied from interface: DataManager

Returns a list of String containing the names of the available cache providers.

Specified by:

getFeatureCacheProviders in interface DataManager

Returns:

list of strings with the names of the available cache providers

createCacheParameters

public DynObject createCacheParameters(String name)
                                throws InitializeException,
                                       ProviderNotRegisteredException

Description copied from interface: DataManager

Returns an instance of DataServerExplorerParameters corresponding to the given name used by the cache to create a store to save the retrieved data.

Specified by:

createCacheParameters in interface DataManager

Parameters:

name - name of a registered feature cache provider

Throws:

InitializeException - if parameter initialization causes an error.

ProviderNotRegisteredException - if could not find a cache provider by the given name.

createMemoryStoreParameters

public DataStoreParameters createMemoryStoreParameters(String autoOrderAttributeName)
                                                throws InitializeException

Description copied from interface: DataManager

Utility method to create the DataStoreParameters to create a FeatureStore based on the MemoryStoreProvider.

Specified by:

createMemoryStoreParameters in interface DataManager

Parameters:

autoOrderAttributeName - the name of the Feature attribute to be used to order the store Features by default. Set to null if you don't want any order by default

Returns:

the parameters for the memory based store

Throws:

InitializeException - if there is an error initializing the parameters for the memory provider

createMemoryStore

public FeatureStore createMemoryStore(String autoOrderAttributeName)
                               throws InitializeException

Description copied from interface: DataManager

Utility method to create the a FeatureStore based on the MemoryStoreProvider.

Specified by:

createMemoryStore in interface DataManager

Parameters:

autoOrderAttributeName - the name of the Feature attribute to be used to order the store Features by default. Set to null if you don't want any order by default

Returns:

the the memory based store

Throws:

InitializeException - if there is an error initializing the parameters for the memory provider

createFeaturePagingHelper

public FeaturePagingHelper createFeaturePagingHelper(FeatureStore featureStore,
                                            int pageSize)
                                              throws BaseException

Description copied from interface: DataManager

Creates a FeaturePagingHelper to paginate data from a FeatureStore.

Specified by:

createFeaturePagingHelper in interface DataManager

Parameters:

featureStore - to get the Features from

pageSize - the page size

Returns:

a FeaturePagingHelper

Throws:

BaseException - if there is an error creating the helper

createFeaturePagingHelper

public FeaturePagingHelper createFeaturePagingHelper(FeatureStore featureStore,
                                            FeatureQuery featureQuery,
                                            int pageSize)
                                              throws BaseException

Description copied from interface: DataManager

Creates a FeaturePagingHelper to paginate data from a FeatureStore.

Specified by:

createFeaturePagingHelper in interface DataManager

Parameters:

featureStore - to get the Features from

featureQuery - to filter and/or order the data

pageSize - the page size

Returns:

a FeaturePagingHelper

Throws:

BaseException - if there is an error creating the helper

setOpenErrorHandler

public void setOpenErrorHandler(OpenErrorHandler handler)

Specified by:

setOpenErrorHandler in interface DataManager

getOpenErrorHandler

public OpenErrorHandler getOpenErrorHandler()

Specified by:

getOpenErrorHandler in interface DataManager

createFeatureType

public EditableFeatureType createFeatureType()

Specified by:

createFeatureType in interface DataManager

getDataTypes

public List getDataTypes()

Specified by:

getDataTypes in interface DataManager

registerFeatureAttributeGetter

public void registerFeatureAttributeGetter(String name,
                                  Class clazz)

Description copied from interface: DataManager

Registers a class that can be used to create a FeatureAttributeGetter and associate it to a FeatureAttributeDescriptor.

Specified by:

registerFeatureAttributeGetter in interface DataManager

Parameters:

name - the name used to register the class.

clazz - it has to be an instance of FeatureAttributeDescriptor

createFeatureAttributeGetter

public FeatureAttributeGetter createFeatureAttributeGetter(String name)
                                                    throws InitializeException

Description copied from interface: DataManager

Creates a FeatureAttributeGetter by name. If there is not any class registered with this name or if there is any error an exception is thrown.

Specified by:

createFeatureAttributeGetter in interface DataManager

Parameters:

name - the name that was used to register the class

Returns:

a FeatureAttributeGetter

Throws:

InitializeException - if there is any error creating the object

getDataServerExplorerPool

public DataServerExplorerPool getDataServerExplorerPool()

Specified by:

getDataServerExplorerPool in interface DataManager

setDataServerExplorerPool

public void setDataServerExplorerPool(DataServerExplorerPool pool)

Specified by:

setDataServerExplorerPool in interface DataManager

createStoreParameters

public DataStoreParameters createStoreParameters(DynStruct struct)
                                          throws InitializeException,
                                                 ProviderNotRegisteredException

Description copied from interface: DataManager

Creates, initializes and fill an instance of DataStoreParameters from the tags of the DynStruct passed as parameter.

Specified by:

createStoreParameters in interface DataManager

Parameters:

struct - structure from which tags were created ths parameters.

Returns:

the data store parameters

Throws:

InitializeException - if there is an error initializing the parameters for the memory provider

ProviderNotRegisteredException - if the memory provider is not registered

createStoreParameters

public DataStoreParameters createStoreParameters(Tags tags)
                                          throws InitializeException,
                                                 ProviderNotRegisteredException

Specified by:

createStoreParameters in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

openStore

public DataStore openStore(DynStruct struct)
                    throws InitializeException,
                           ProviderNotRegisteredException,
                           ValidateDataParametersException

Specified by:

openStore in interface DataManager

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException