org.gvsig.raster.wms.io

Class WMSServerExplorer

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.spi.AbstractDataServerExplorer

org.gvsig.raster.wms.io.WMSServerExplorer

All Implemented Interfaces:

RasterDataServerExplorer, DataFactoryUnit, DataServerExplorer, DataServerExplorer_v2, DataServerExplorerProvider, Disposable, PropertiesSupport

public class WMSServerExplorer
extends AbstractDataServerExplorer
implements RasterDataServerExplorer, DataServerExplorerProvider

Explorer for a WMS server

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Fields inherited from class org.gvsig.fmap.dal.spi.AbstractDataServerExplorer

LOGGER

Fields inherited from interface org.gvsig.fmap.dal.coverage.store.RasterDataServerExplorer

TIME

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

FILESYSTEM_SERVER_EXPLORER_NAME, MODE_ALL, MODE_FEATURE, MODE_GEOMETRY, MODE_RASTER

Constructor Summary

Constructors

Constructor and Description
WMSServerExplorer(WMSServerExplorerParameters parameters, DataServerExplorerProviderServices services)

Method Summary

Modifier and Type	Method and Description
boolean	add(java.lang.String provider, NewDataStoreParameters parameters, boolean overwrite) Creates a new DataStore in this server.
boolean	canAdd() Indicates whether this DataServerExplorer can create a new DataStore in the server.
boolean	canAdd(java.lang.String storeName) Indicates whether this DataServerExplorer can create a new DataStore in the server, given the store name.
void	connect(ICancellable cancellable) Connect to the server
void	connect(ICancellable cancellable, boolean updateCache) Connects to the server and throws a getCapabilities.
DataStoreParameters	get(java.lang.String layerName)
java.lang.String	getAbstract() Gets the description of this service
NewDataStoreParameters	getAddParameters(java.lang.String storeName) Given the store's name, returns its parameters for creation.
java.awt.geom.Rectangle2D	getBoundingBox(java.lang.String[] layerNames, java.lang.String srs)
java.lang.String	getDataStoreProviderName() Gets the provider's name
java.util.List<java.lang.String>	getDataStoreProviderNames() Return the list of provider names that this server allow.
java.lang.String	getDescription()
java.lang.String[]	getFormats() Gets the list of raster formats supported by the server
java.lang.String	getHost() Gets the host URI
java.lang.String[]	getInfoFormats() Gets the list of raster information formats supported by the server
WMSLayerNode	getLayer(java.lang.String layerName) Gets a layer using its name
java.awt.geom.Rectangle2D	getLayersExtent(java.lang.String[] layerName, java.lang.String srs)
WMSLayerNode	getLayerTree() Gets a tree of nodes which represents the server information
java.util.Hashtable	getOnlineResources() Gets the online resources
WMSServerExplorerParameters	getParameters() Returns this DataServerExplorer parameters
java.lang.Object	getProperty(java.lang.String name)
java.lang.String	getProviderName() Returns the DataServerExplorer's name
DataServerExplorerProviderServices	getServerExplorerProviderServices()
java.lang.String	getServerType() Gets the server title
java.lang.String	getServiceTitle()
DataStoreParameters	getStoredParameters() Returns the internal parameters, that is, the parameters that are not tiled.
java.lang.String	getTitle() Gets the title
java.lang.String	getVersion() Gets the protocol supported by the server
boolean	isConnected() Returns true if this provider is connected to the server
boolean	isHostReachable() Checks if the network and host are reachable
boolean	isHostReachable(int timeout) Checks if the network and host are reachable
boolean	isQueryable()
java.util.List<DataStoreParameters>	list() Provides a list of available stores in the server.
java.util.List<DataStoreParameters>	list(int mode) Provides a list of available stores in the server of a type.
void	open() Open connection to the server
DataStore	open(DataStoreParameters par) Open a store defined by dsp
void	remove(DataStoreParameters parameters) Removes a store from the server given its DataStoreParameters.

Methods inherited from class org.gvsig.fmap.dal.spi.AbstractDataServerExplorer

close, createSQLBuilder, doDispose, exists, getProperties, getResourcePath, getResourcesStorage, getResourcesStorage, getResourcesStorage, setProperty

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.fmap.dal.DataServerExplorer

exists, getResourcePath, getResourcesStorage, getResourcesStorage, getResourcesStorage

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

dispose

Field Detail

NAME

public static final java.lang.String NAME

Constructor Detail

WMSServerExplorer

public WMSServerExplorer(WMSServerExplorerParameters parameters,
                         DataServerExplorerProviderServices services)
                  throws InitializeException

Throws:

InitializeException

Method Detail

getDataStoreProviderName

public java.lang.String getDataStoreProviderName()

Gets the provider's name

Returns:

getDescription

public java.lang.String getDescription()

add

public boolean add(java.lang.String provider,
                   NewDataStoreParameters parameters,
                   boolean overwrite)
            throws DataException

Description copied from interface: DataServerExplorer

Creates a new DataStore in this server.

Specified by:

add in interface DataServerExplorer

parameters - , an instance of DataStoreParameters from DataServerExplorer.getAddParameters(String) that describes the new DataStore.

overwrite - if the store already exists

Returns:

true if the DataStoreParameters were successfully added, false otherwise.

Throws:

DataException

canAdd

public boolean canAdd()

Description copied from interface: DataServerExplorer

Indicates whether this DataServerExplorer can create a new DataStore in the server.

Specified by:

canAdd in interface DataServerExplorer

Returns:

true if this DataServerExplorer can be created or false otherwise.

canAdd

public boolean canAdd(java.lang.String storeName)
               throws DataException

Description copied from interface: DataServerExplorer

Indicates whether this DataServerExplorer can create a new DataStore in the server, given the store name.

Specified by:

canAdd in interface DataServerExplorer

Parameters:

storeName - store name.

Returns:

true if this DataServerExplorer can create a new store or false otherwise.

Throws:

DataException

getAddParameters

public NewDataStoreParameters getAddParameters(java.lang.String storeName)
                                        throws DataException

Description copied from interface: DataServerExplorer

Given the store's name, returns its parameters for creation.

Specified by:

getAddParameters in interface DataServerExplorer

Returns:

parameters to create a store

Throws:

DataException

getDataStoreProviderNames

public java.util.List<java.lang.String> getDataStoreProviderNames()

Description copied from interface: DataServerExplorer

Return the list of provider names that this server allow.

Specified by:

getDataStoreProviderNames in interface DataServerExplorer

Returns:

List of provider names

getParameters

public WMSServerExplorerParameters getParameters()

Description copied from interface: DataServerExplorer

Returns this DataServerExplorer parameters

Specified by:

getParameters in interface DataServerExplorer

Overrides:

getParameters in class AbstractDataServerExplorer

Returns:

an instance of DataServerExplorerParameters containing this DataServerExplorer parameters.

list

public java.util.List<DataStoreParameters> list()
                                         throws DataException

Description copied from interface: DataServerExplorer

Provides a list of available stores in the server.

Specified by:

list in interface DataServerExplorer

Returns:

list of DataStoreParameters

Throws:

DataException

list

public java.util.List<DataStoreParameters> list(int mode)
                                         throws DataException

Description copied from interface: DataServerExplorer

Provides a list of available stores in the server of a type.

Specified by:

list in interface DataServerExplorer

Parameters:

mode - , filter store from a type: DataServerExplorer.MODE_ALL, DataServerExplorer.MODE_FEATURE, #MODE_FEATURE_GEOMETRY, DataServerExplorer.MODE_RASTER

Returns:

list of DataStoreParameters

Throws:

DataException

remove

public void remove(DataStoreParameters parameters)
            throws DataException

Description copied from interface: DataServerExplorer

Removes a store from the server given its DataStoreParameters. If the store is a file then this method deletes the file, if it is a table in a database then this method drops the table, and so on.

Specified by:

remove in interface DataServerExplorer

Throws:

DataException

getProviderName

public java.lang.String getProviderName()

Description copied from interface: DataServerExplorer

Returns the DataServerExplorer's name

Specified by:

getProviderName in interface DataServerExplorer

Returns:

String containing this DataServerExplorer's name

get

public DataStoreParameters get(java.lang.String layerName)

Specified by:

get in interface DataServerExplorer

Overrides:

get in class AbstractDataServerExplorer

getStoredParameters

public DataStoreParameters getStoredParameters()

Description copied from interface: RasterDataServerExplorer

Returns the internal parameters, that is, the parameters that are not tiled.

Specified by:

getStoredParameters in interface RasterDataServerExplorer

Returns:

open

public void open()
          throws OpenException

Description copied from interface: DataServerExplorer_v2

Open connection to the server

Specified by:

open in interface DataServerExplorer_v2

Overrides:

open in class AbstractDataServerExplorer

Throws:

OpenException

connect

public void connect(ICancellable cancellable)
             throws ConnectException

Description copied from interface: RasterDataServerExplorer

Connect to the server

Specified by:

connect in interface RasterDataServerExplorer

Throws:

ConnectException

connect

public void connect(ICancellable cancellable,
                    boolean updateCache)
             throws ConnectException

Connects to the server and throws a getCapabilities. This loads the basic information to make requests.

Throws:

RemoteServiceException

ConnectException

isHostReachable

public boolean isHostReachable(int timeout)

Checks if the network and host are reachable

Specified by:

isHostReachable in interface RasterDataServerExplorer

Parameters:

timeout - for the host

Returns:

true if both are reachable and false if they are not

isHostReachable

public boolean isHostReachable()

Checks if the network and host are reachable

Specified by:

isHostReachable in interface RasterDataServerExplorer

Returns:

true if both are reachable and false if they are not

isConnected

public boolean isConnected()

Returns true if this provider is connected to the server

Returns:

getAbstract

public java.lang.String getAbstract()

Gets the description of this service

Returns:

getFormats

public java.lang.String[] getFormats()

Gets the list of raster formats supported by the server

Returns:

getInfoFormats

public java.lang.String[] getInfoFormats()

Gets the list of raster information formats supported by the server

Returns:

getLayerTree

public WMSLayerNode getLayerTree()

Gets a tree of nodes which represents the server information

Returns:

getServerType

public java.lang.String getServerType()

Gets the server title

Returns:

getOnlineResources

public java.util.Hashtable getOnlineResources()

Gets the online resources

Returns:

getVersion

public java.lang.String getVersion()

Gets the protocol supported by the server

Returns:

getLayersExtent

public java.awt.geom.Rectangle2D getLayersExtent(java.lang.String[] layerName,
                                                 java.lang.String srs)

getLayer

public WMSLayerNode getLayer(java.lang.String layerName)

Gets a layer using its name

Parameters:

layerName -

Returns:

getHost

public java.lang.String getHost()

Gets the host URI

Returns:

getBoundingBox

public java.awt.geom.Rectangle2D getBoundingBox(java.lang.String[] layerNames,
                                                java.lang.String srs)

isQueryable

public boolean isQueryable()

getTitle

public java.lang.String getTitle()

Gets the title

Returns:

getServiceTitle

public java.lang.String getServiceTitle()

Returns:

The title of the service offered by the WMS server.

getServerExplorerProviderServices

public DataServerExplorerProviderServices getServerExplorerProviderServices()

Specified by:

getServerExplorerProviderServices in interface DataServerExplorerProvider

Overrides:

getServerExplorerProviderServices in class AbstractDataServerExplorer

open

public DataStore open(DataStoreParameters par)
               throws DataException

Description copied from interface: DataServerExplorer_v2

Open a store defined by dsp

Specified by:

open in interface DataServerExplorer_v2

Overrides:

open in class AbstractDataServerExplorer

Returns:

Throws:

DataException

getProperty

public java.lang.Object getProperty(java.lang.String name)

Specified by:

getProperty in interface PropertiesSupport

Overrides:

getProperty in class AbstractDataServerExplorer