org.gvsig.fmap.dal

Interface DataManager

All Superinterfaces:

Services

All Known Subinterfaces:

DataManagerProviderServices

All Known Implementing Classes:

DefaultDataManager

public interface DataManager
extends Services

There are two top level management roles within DAL: data access and resource management. This class is responsible of the data access management role. It provides ways for registering and instantiating DataServerExplorer(s), DataStore(s), Evaluator(s) and FeatureIndex(es).

See Also:

ResourceManager

Field Summary

Fields

Modifier and Type	Field and Description
static String	CREATE_STORE_AUTHORIZATION
static String	READ_STORE_AUTHORIZATION
static String	WRITE_STORE_AUTHORIZATION

Method Summary

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 expression) Creates an instance of Evaluator that represents the given expression.
ExpressionBuilder	createExpressionBuilder() Creates a default ExpressionBuilder.
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()
void	createFileStore(String providerName, NewDataStoreParameters params, boolean overwrite)
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.
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
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<DataType>	getDataTypes() Return a list of the DataTypes supported for the type of the feature attributes.
String	getDefaultFeatureIndexProviderName(int dataType) Returns the default DataIndexProvider name, given a data type.
List<String>	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<String>	getFeatureIndexProviders() Returns a list of String containing the names of the available index providers.
Register	getFeatureIndexRegister()
OpenErrorHandler	getOpenErrorHandler()
Register	getServerExplorerRegister()
DataStoreProviderFactory	getStoreProviderFactory(String name)
Register	getStoreProviderRegister()
List	getStoreProviders() Returns a list of Strings containing the names of all available DataStore providers.
List<String>	getStoreProviders(String name) Returns a list of Strings containing the names of all available DataStore providers for an explorer.
Register	getStoreRegister()
String	getTemporaryDirectory() Deprecated. use FoldersManager of org.gvsig.tools
void	newStore(String explorer, String provider, NewDataStoreParameters parameters, boolean overwrite) Create a new physical store
DataServerExplorer	openServerExplorer(String name, DataServerExplorerParameters parameters) Returns an instance of DataServerExplorer given its parameters.
DataServerExplorer	openServerExplorer(String explorerName, Object... arguments)
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.
DataStore	openStore(String providerName, Object... arguments)
void	registerDefaultEvaluator(EvaluatorFactory evaluatorFactory) Registers the default expression evaluator.
void	setDataServerExplorerPool(DataServerExplorerPool pool)
void	setDefaultFeatureIndexProviderName(int dataType, String name) Sets the default DataIndexProvider for the given data type.
void	setOpenErrorHandler(OpenErrorHandler handler)
void	setResourcesLoader(ClassLoader loader)
void	setResourcesLoader(File folder)

Field Detail

CREATE_STORE_AUTHORIZATION

static final String CREATE_STORE_AUTHORIZATION

See Also:

Constant Field Values

READ_STORE_AUTHORIZATION

static final String READ_STORE_AUTHORIZATION

See Also:

Constant Field Values

WRITE_STORE_AUTHORIZATION

static final String WRITE_STORE_AUTHORIZATION

See Also:

Constant Field Values

Method Detail

getTemporaryDirectory

String getTemporaryDirectory()

Deprecated. use FoldersManager of org.gvsig.tools

Returns the default DAL's temporary directory

Returns:

Temporary directory name

createStoreParameters

DataStoreParameters createStoreParameters(String name)
                                   throws InitializeException,
                                          ProviderNotRegisteredException

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

Parameters:

name - provider name

Returns:

the data store parameters

Throws:

ProviderNotRegisteredException - if the memory provider is not registered

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

createStoreParameters

DataStoreParameters createStoreParameters(DynStruct struct)
                                   throws InitializeException,
                                          ProviderNotRegisteredException

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

Parameters:

struct - structure from which tags were created ths parameters.

Returns:

the data store parameters

Throws:

ProviderNotRegisteredException - if the memory provider is not registered

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

createStoreParameters

DataStoreParameters createStoreParameters(Tags tags)
                                   throws InitializeException,
                                          ProviderNotRegisteredException

Throws:

InitializeException

ProviderNotRegisteredException

createNewStoreParameters

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

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

Parameters:

explorer -

provider -

Returns:

Throws:

InitializeException

ProviderNotRegisteredException

openStore

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

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

Parameters:

provider -

parameters - parameters used to instantiate and initialize the DataStore

Returns:

Throws:

ProviderNotRegisteredException - if the memory provider is not registered

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

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

openStore

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

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

openStore

DataStore openStore(String providerName,
                    Object... arguments)
             throws InitializeException,
                    ProviderNotRegisteredException,
                    ValidateDataParametersException

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

openStore

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

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

newStore

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

Create a new physical store

Parameters:

explorer -

provider -

parameters -

overwrite -

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

getStoreProviders

List getStoreProviders()

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

Returns:

list of String containing available DataStore provider names

getStoreProviders

List<String> getStoreProviders(String name)

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

Parameters:

name -

Returns:

createServerExplorerParameters

DataServerExplorerParameters createServerExplorerParameters(String name)
                                                     throws InitializeException,
                                                            ProviderNotRegisteredException

Returns an instance of DataServerExplorerParameters corresponding to the given name.

Parameters:

name - name of a registered server explorer provider

Returns:

Throws:

InitializeException - if parameter initialization causes an error.

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

openServerExplorer

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

Returns an instance of DataServerExplorer given its parameters.

Parameters:

name -

parameters - parameters used to instantiate and initialize the DataServerExplorer.

Returns:

an instance of DataServerExplorer.

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

openServerExplorer

DataServerExplorer openServerExplorer(String explorerName,
                                      Object... arguments)
                               throws InitializeException,
                                      ProviderNotRegisteredException,
                                      ValidateDataParametersException

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

createServerExplorer

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

Deprecated. see openServerExplorer

Parameters:

parameters -

Returns:

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

createStore

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

Deprecated. see openStore

Parameters:

parameters -

Returns:

Throws:

InitializeException

ProviderNotRegisteredException

ValidateDataParametersException

getExplorerProviders

List<String> getExplorerProviders()

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

Returns:

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

registerDefaultEvaluator

void registerDefaultEvaluator(EvaluatorFactory evaluatorFactory)

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

Parameters:

evaluatorFactory -

createExpresion

Evaluator createExpresion(String expression)
                   throws InitializeException

Creates an instance of Evaluator that represents the given expression.

Parameters:

expression - String containing a CQL expression.

Returns:

instance of Evaluator representing the given expression.

Throws:

InitializeException

getFeatureIndexProviders

List<String> getFeatureIndexProviders()

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

Returns:

list of strings with the names of the available index providers

setDefaultFeatureIndexProviderName

void setDefaultFeatureIndexProviderName(int dataType,
                                        String name)

Sets the default DataIndexProvider for the given data type.

Parameters:

dataType - one of the data types defined in DataTypes.

name - Provider's name

getDefaultFeatureIndexProviderName

String getDefaultFeatureIndexProviderName(int dataType)

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

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.

createMemoryStoreParameters

DataStoreParameters createMemoryStoreParameters(String autoOrderAttributeName)
                                         throws InitializeException

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

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

FeatureStore createMemoryStore(String autoOrderAttributeName)
                        throws InitializeException

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

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

FeaturePagingHelper createFeaturePagingHelper(FeatureStore featureStore,
                                              int pageSize)
                                       throws BaseException

Creates a FeaturePagingHelper to paginate data from a FeatureStore.

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

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

Creates a FeaturePagingHelper to paginate data from a FeatureStore.

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

void setOpenErrorHandler(OpenErrorHandler handler)

getOpenErrorHandler

OpenErrorHandler getOpenErrorHandler()

getStoreProviderFactory

DataStoreProviderFactory getStoreProviderFactory(String name)

createFeatureType

EditableFeatureType createFeatureType()

getDataServerExplorerPool

DataServerExplorerPool getDataServerExplorerPool()

setDataServerExplorerPool

void setDataServerExplorerPool(DataServerExplorerPool pool)

setResourcesLoader

void setResourcesLoader(ClassLoader loader)

setResourcesLoader

void setResourcesLoader(File folder)

getDataTypes

List<DataType> getDataTypes()

Return a list of the DataTypes supported for the type of the feature attributes. The list is only informative.

Returns:

getStoreRegister

Register getStoreRegister()

getStoreProviderRegister

Register getStoreProviderRegister()

getServerExplorerRegister

Register getServerExplorerRegister()

getFeatureIndexRegister

Register getFeatureIndexRegister()

createExpressionBuilder

ExpressionBuilder createExpressionBuilder()

Creates a default ExpressionBuilder. This ExpressionBuilder is not dependent on a data source, and is not advisable to use it.

Returns:

the ExpressionBuilder

getFeatureCacheProviders

List getFeatureCacheProviders()

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

Returns:

list of strings with the names of the available cache providers

createCacheParameters

DynObject createCacheParameters(String name)
                         throws InitializeException,
                                ProviderNotRegisteredException

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

Parameters:

name - name of a registered feature cache provider

Returns:

Throws:

InitializeException - if parameter initialization causes an error.

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

createFileStore

void createFileStore(String providerName,
                     NewDataStoreParameters params,
                     boolean overwrite)
              throws DataException

Parameters:

providerName -

params -

overwrite -

Throws:

DataException