org.gvsig.fmap.dal.raster.impl

Class DefaultCoverageStore

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.raster.impl.DefaultCoverageStore

All Implemented Interfaces:

DataFactoryUnit, DataStore, CoverageStore, CoverageStoreProviderServices, DataStoreInitializer, DataStoreProviderServices, Metadata, Disposable, DynObject, DynObject_v2, ComplexObservable, ComplexWeakReferencingObservable, Observable, WeakReferencingObservable, Persistent, Services, Visitable

public class DefaultCoverageStore
extends AbstractDisposable
implements CoverageStore, CoverageStoreProviderServices, DataStoreInitializer

Field Summary

Fields inherited from interface org.gvsig.fmap.dal.spi.DataStoreProviderServices

BASE_NEWPARAMETERS_PROVIDER_DEFINITION_FULLNAME, BASE_NEWPARAMETERS_PROVIDER_DEFINITION_NAME, BASE_PARAMETERS_PROVIDER_DEFINITION_FULLNAME, BASE_PARAMETERS_PROVIDER_DEFINITION_NAME, PROVIDER_PARAMTER_FULLNAME, PROVIDER_PARAMTER_NAME

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

FEATURE_METADATA_DEFINITION_NAME, METADATA_CONTAINERNAME, METADATA_CRS, METADATA_DEFINITION_NAME, METADATA_ENVELOPE, METADATA_FEATURETYPE, METADATA_PROVIDER, SPATIAL_METADATA_DEFINITION_NAME

Constructor Summary

Constructors

Constructor and Description
DefaultCoverageStore()

Method Summary

Modifier and Type	Method and Description
void	accept(Visitor visitor) Provides each value of this Store to the provided Visitor.
void	accept(Visitor visitor, DataQuery dataQuery) Provides each value of this Store to the provided Visitor.
void	addObserver(Observer o)
boolean	allowWrite()
void	beginComplexNotification() Sets the Observable in complex notification mode.
void	clear()
void	close()
CoverageSelection	createDefaultCoverageSelection()
DataQuery	createQuery() Returns a new instance of a DataQuery.
DataSet	createSelection() Creates a new selection.
void	delegate(DynObject dynObject)
void	deleteObserver(Observer o)
void	deleteObservers()
void	disableNotifications() Disable the notification of events to registered Observers.
protected void	doDispose() Internal implementation for the AbstractDisposable.dispose() method, to be implemented by child classes.
void	enableNotifications() Enable (default) the notification of events to registered Observers.
void	endComplexNotification() Ends the complex notification mode.
Iterator	getChildren() Returns an iterator over this store children
CoverageStore	getCoverageStore()
DataSet	getDataSet() Returns all available data.
DataSet	getDataSet(DataQuery dataQuery) Returns a subset of data taking into account the properties and restrictions of the DataQuery.
void	getDataSet(DataQuery dataQuery, Observer observer) Loads a subset of data taking into account the properties and restrictions of the DataQuery.
void	getDataSet(Observer observer) Loads all available data and notifies the observer for each loaded block of data.
DynClass	getDynClass()
Object	getDynValue(String name)
DataServerExplorer	getExplorer() Returns the DataServerExplorer to which this DataStore belongs, if there is any.
String	getFullName() Returns a more descriptive name for the store that getName.
Interval	getInterval() Gets the Interval of the store, that means the temporal interval where the store has valid data.
DataManager	getManager()
Set	getMetadataChildren() Returns an unsorted set of child Metadata objects.
Object	getMetadataID() Returns the unique identifier of the Metadata.
String	getMetadataName() Returns the name of the Metadata, which allows to identify the type in the Metadata registry.
String	getName() Returns the name associated to the store.
DataStoreParameters	getParameters() Return the of parameters of this store
CoverageStoreProvider	getProvider()
DataStoreProviderFactory	getProviderFactory()
String	getProviderName() Return the provider name that use this store.
DataSet	getSelection() Returns the selected set of data
PersistentState	getState()
DataStore	getStore() Return the Store instance
Collection	getTimes() Gets all the possible values of time for which the store has data.
Collection	getTimes(Interval interval) Gets all the possible values of time for which the store has data and intersects with an interval.
boolean	hasDynMethod(String name)
boolean	hasDynValue(String name)
void	implement(DynClass dynClass)
void	intializePhase1(DataManager dataManager, DataStoreParameters parameters)
void	intializePhase2(DataStoreProvider provider)
Object	invokeDynMethod(int code, Object[] args)
Object	invokeDynMethod(String name, Object[] args)
void	loadFromState(PersistentState state) Set the state of the object from the state passed as parameter.
void	notifyChange(String notification)
void	notifyChange(String notification, Command command)
void	notifyChange(String notification, Resource resource)
void	open()
void	refresh() Refreshes this store state.
void	saveToState(PersistentState state) Saves the internal state of the object on the provided PersistentState object.
void	setDynValue(String name, Object value)
void	setSelection(DataSet selection) Sets the current data selection with the given data set.
void	useCache(String providerName, DynObject parameters)

Methods inherited from class org.gvsig.tools.dispose.impl.AbstractDisposable

dispose, dispose

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Constructor Detail

DefaultCoverageStore

public DefaultCoverageStore()

Method Detail

intializePhase1

public void intializePhase1(DataManager dataManager,
                            DataStoreParameters parameters)
                     throws InitializeException

Specified by:

intializePhase1 in interface DataStoreInitializer

Throws:

InitializeException

intializePhase2

public void intializePhase2(DataStoreProvider provider)
                     throws InitializeException

Specified by:

intializePhase2 in interface DataStoreInitializer

Throws:

InitializeException

createSelection

public DataSet createSelection()
                        throws DataException

Description copied from interface: DataStore

Creates a new selection.

Specified by:

createSelection in interface DataStore

Returns:

DataSet that contains the selection

Throws:

DataException

getChildren

public Iterator getChildren()

Description copied from interface: DataStore

Returns an iterator over this store children

Specified by:

getChildren in interface DataStore

Returns:

Iterator over this DataStore children

getDataSet

public DataSet getDataSet()
                   throws DataException

Description copied from interface: DataStore

Returns all available data.

Specified by:

getDataSet in interface DataStore

Returns:

a set of data

Throws:

DataException - if there is any error while loading the data

getDataSet

public DataSet getDataSet(DataQuery dataQuery)
                   throws DataException

Description copied from interface: DataStore

Returns a subset of data taking into account the properties and restrictions of the DataQuery.

Specified by:

getDataSet in interface DataStore

Parameters:

dataQuery - defines the properties of the requested data

Returns:

a set of data

Throws:

DataException - if there is any error while loading the data

accept

public void accept(Visitor visitor)
            throws BaseException

Description copied from interface: DataStore

Provides each value of this Store to the provided Visitor. The values received through the Visitor.visit(Object) method may be transient, reused or externally modifiable, so they can't be used to be stored in any external form out of the visit method. If you need to store any of the values out of the Visitor.visit(Object) method execution, create a copy or clone the received value in order to be stored.

Specified by:

accept in interface DataStore

Specified by:

accept in interface Visitable

Parameters:

visitor - the visitor to apply to each value.

Throws:

BaseException - if there is an error while performing the visit

accept

public void accept(Visitor visitor,
                   DataQuery dataQuery)
            throws BaseException

Description copied from interface: DataStore

Provides each value of this Store to the provided Visitor. The values received through the Visitor.visit(Object) method may be transient, reused or externally modifiable, so they can't be used to be stored in any external form out of the visit method. If you need to store any of the values out of the Visitor.visit(Object) method execution, create a copy or clone the received value in order to be stored.

Specified by:

accept in interface DataStore

Parameters:

visitor - the visitor to apply to each value.

dataQuery - defines the properties of the data to visit

Throws:

BaseException - if there is an error while performing the visit

getDataSet

public void getDataSet(Observer observer)
                throws DataException

Description copied from interface: DataStore

Loads all available data and notifies the observer for each loaded block of data.

Specified by:

getDataSet in interface DataStore

Parameters:

observer - to be notified for each block of data loaded

Throws:

DataException - if there is any error while loading the data

getDataSet

public void getDataSet(DataQuery dataQuery,
                       Observer observer)
                throws DataException

Description copied from interface: DataStore

Loads a subset of data taking into account the properties and restrictions of the DataQuery. Data loading is performed by calling the Observer, once each data block is loaded.

Specified by:

getDataSet in interface DataStore

Parameters:

dataQuery - defines the properties of the requested data

observer - to be notified for each block of data loaded

Throws:

DataException - if there is any error while loading the data

getExplorer

public DataServerExplorer getExplorer()
                               throws DataException,
                                      ValidateDataParametersException

Description copied from interface: DataStore

Returns the DataServerExplorer to which this DataStore belongs, if there is any.

Specified by:

getExplorer in interface DataStore

Returns:

DataServerExplorer to which this DataStore belongs, or null if this was not accessed through any DataServerExplorer.

Throws:

DataException

ValidateDataParametersException

getParameters

public DataStoreParameters getParameters()

Description copied from interface: DataStore

Return the of parameters of this store

Specified by:

getParameters in interface DataStore

Returns:

parameters of this store

getSelection

public DataSet getSelection()
                     throws DataException

Description copied from interface: DataStore

Returns the selected set of data

Specified by:

getSelection in interface DataStore

Returns:

DataSet

Throws:

DataException

refresh

public void refresh()
             throws DataException

Description copied from interface: DataStore

Refreshes this store state.

Specified by:

refresh in interface DataStore

Throws:

DataException

setSelection

public void setSelection(DataSet selection)
                  throws DataException

Description copied from interface: DataStore

Sets the current data selection with the given data set.

Specified by:

setSelection in interface DataStore

Throws:

DataException

beginComplexNotification

public void beginComplexNotification()

Description copied from interface: ComplexObservable

Sets the Observable in complex notification mode. All notifications must be stored, until the mode ends, and then notify all Observers with all the notifications.

Specified by:

beginComplexNotification in interface ComplexObservable

disableNotifications

public void disableNotifications()

Description copied from interface: ComplexObservable

Disable the notification of events to registered Observers.

Specified by:

disableNotifications in interface ComplexObservable

enableNotifications

public void enableNotifications()

Description copied from interface: ComplexObservable

Enable (default) the notification of events to registered Observers.

Specified by:

enableNotifications in interface ComplexObservable

endComplexNotification

public void endComplexNotification()

Description copied from interface: ComplexObservable

Ends the complex notification mode. All notifications stored while in complex notification mode, will be notified to the registered Observers.

If a observer is a ComplexObserver, it will be notified with a single DefaultComplexNotification instead of each of the notifications.

Some important notes to take into account when calling this method.

• Observers must not rely in the order used to perform the notifications. The notifications order is maintained, but the notification to all the observers might be performed for each notification to all observers, or for each observer all notifications.
• The notification process works as an atomic action, so if while an Observer is processing a notification another Observer is registered to the source Observable, it won't get any of the notifications currently being notified, but future ones.

Specified by:

endComplexNotification in interface ComplexObservable

addObserver

public void addObserver(Observer o)

Specified by:

addObserver in interface Observable

deleteObserver

public void deleteObserver(Observer o)

Specified by:

deleteObserver in interface Observable

deleteObservers

public void deleteObservers()

Specified by:

deleteObservers in interface Observable

getState

public PersistentState getState()
                         throws PersistenceException

Throws:

PersistenceException

saveToState

public void saveToState(PersistentState state)
                 throws PersistenceException

Description copied from interface: Persistent

Saves the internal state of the object on the provided PersistentState object.

Specified by:

saveToState in interface Persistent

Throws:

PersistenceException

loadFromState

public void loadFromState(PersistentState state)
                   throws PersistenceException

Description copied from interface: Persistent

Set the state of the object from the state passed as parameter.

Specified by:

loadFromState in interface Persistent

Throws:

PersistenceException

getMetadataID

public Object getMetadataID()

Description copied from interface: Metadata

Returns the unique identifier of the Metadata.

Specified by:

getMetadataID in interface Metadata

Returns:

the Metadata identifier

delegate

public void delegate(DynObject dynObject)

Specified by:

delegate in interface DynObject

getDynClass

public DynClass getDynClass()

Specified by:

getDynClass in interface DynObject

getDynValue

public Object getDynValue(String name)
                   throws DynFieldNotFoundException

Specified by:

getDynValue in interface DynObject

Throws:

DynFieldNotFoundException

hasDynValue

public boolean hasDynValue(String name)

Specified by:

hasDynValue in interface DynObject

hasDynMethod

public boolean hasDynMethod(String name)

Specified by:

hasDynMethod in interface DynObject_v2

implement

public void implement(DynClass dynClass)

Specified by:

implement in interface DynObject

invokeDynMethod

public Object invokeDynMethod(String name,
                              Object[] args)
                       throws DynMethodException

Specified by:

invokeDynMethod in interface DynObject

Throws:

DynMethodException

invokeDynMethod

public Object invokeDynMethod(int code,
                              Object[] args)
                       throws DynMethodException

Specified by:

invokeDynMethod in interface DynObject

Throws:

DynMethodException

setDynValue

public void setDynValue(String name,
                        Object value)
                 throws DynFieldNotFoundException

Specified by:

setDynValue in interface DynObject

Throws:

DynFieldNotFoundException

getMetadataChildren

public Set getMetadataChildren()

Description copied from interface: Metadata

Returns an unsorted set of child Metadata objects.

Specified by:

getMetadataChildren in interface Metadata

Returns:

an unsorted set of child Metadata objects

getMetadataName

public String getMetadataName()

Description copied from interface: Metadata

Returns the name of the Metadata, which allows to identify the type in the Metadata registry.

Specified by:

getMetadataName in interface Metadata

Returns:

the Metadata name

createDefaultCoverageSelection

public CoverageSelection createDefaultCoverageSelection()
                                                 throws DataException

Specified by:

createDefaultCoverageSelection in interface CoverageStoreProviderServices

Throws:

DataException

getManager

public DataManager getManager()

Specified by:

getManager in interface CoverageStoreProviderServices

getProvider

public CoverageStoreProvider getProvider()

Specified by:

getProvider in interface CoverageStoreProviderServices

notifyChange

public void notifyChange(String notification)

Specified by:

notifyChange in interface CoverageStoreProviderServices

notifyChange

public void notifyChange(String notification,
                         Command command)

Specified by:

notifyChange in interface CoverageStoreProviderServices

notifyChange

public void notifyChange(String notification,
                         Resource resource)

Specified by:

notifyChange in interface CoverageStoreProviderServices

open

public void open()
          throws OpenException

Throws:

OpenException

close

public void close()
           throws CloseException

Throws:

CloseException

doDispose

protected void doDispose()
                  throws BaseException

Description copied from class: AbstractDisposable

Internal implementation for the AbstractDisposable.dispose() method, to be implemented by child classes.

Specified by:

doDispose in class AbstractDisposable

Throws:

BaseException

See Also:

AbstractDisposable.dispose()

allowWrite

public boolean allowWrite()

createQuery

public DataQuery createQuery()

Description copied from interface: DataStore

Returns a new instance of a DataQuery.

Specified by:

createQuery in interface DataStore

Returns:

new DataQuery instance.

getStore

public DataStore getStore()

Description copied from interface: DataStoreProviderServices

Return the Store instance

Specified by:

getStore in interface DataStoreProviderServices

Returns:

getCoverageStore

public CoverageStore getCoverageStore()

Specified by:

getCoverageStore in interface CoverageStoreProviderServices

clear

public void clear()

Specified by:

clear in interface DynObject

getProviderName

public String getProviderName()

Description copied from interface: DataStore

Return the provider name that use this store.

Specified by:

getProviderName in interface DataStore

Returns:

provider name of this store

getName

public String getName()

Description copied from interface: DataStore

Returns the name associated to the store. This name is provided for informational purposes only. Explamples: In a dbf the filename without the path In a DDBB table the name of the table In a WFS layer the name of the layer.

Specified by:

getName in interface DataStore

Returns:

String containing this store's name.

getFullName

public String getFullName()

Description copied from interface: DataStore

Returns a more descriptive name for the store that getName. This name is provided for informational purposes only. Explamples: In a file based store may return the full name of the filename, path and filename. In a data base based store may return "server:dbname:tablename" In a WFS layer based store may return "server:layername"

Specified by:

getFullName in interface DataStore

Returns:

String Containing the full name of the store

getInterval

public Interval getInterval()

Description copied from interface: DataStore

Gets the Interval of the store, that means the temporal interval where the store has valid data.

Specified by:

getInterval in interface DataStore

Returns:

a time interval or null if there is not time support

getTimes

public Collection getTimes()

Description copied from interface: DataStore

Gets all the possible values of time for which the store has data.

Specified by:

getTimes in interface DataStore

Returns:

a collection of Time objects.

getTimes

public Collection getTimes(Interval interval)

Description copied from interface: DataStore

Gets all the possible values of time for which the store has data and intersects with an interval.

Specified by:

getTimes in interface DataStore

Parameters:

interval - the interval of time

Returns:

a collection of Time objects.

useCache

public void useCache(String providerName,
                     DynObject parameters)
              throws DataException

Specified by:

useCache in interface DataStore

Throws:

DataException

getProviderFactory

public DataStoreProviderFactory getProviderFactory()

Specified by:

getProviderFactory in interface DataStore