org.opengis.go.display.primitive.store
Interface GraphicStoreFactory


public interface GraphicStoreFactory

The GraphicStoreFactory class/interface...


Method Summary
 boolean canProcess(URI provider)
          Indicates this GraphicStoreFactory communicate with the indicated provider or service.
 boolean canProcess(URI provider, Map<String,Object> params)
          Indicates this GraphicStoreFactory communicate with the indicated provider or service.
 GraphicStore createGraphicStore(URI provider, Map<String,Object> params)
          Ask for a GraphicStore connecting to the indicated provider or service.
 GraphicStore createNewGraphicStore(URI provider, Map<String,Object> params)
          Ask for a new GraphicStore connecting to the indicated provider or service.
 InternationalString getDescription()
          Description of this type of GraphicStore.
 InternationalString getDisplayName()
          Display name used to communicate this type of GraphicStore to end users.
 URI getIcon()
          Icon representing this category of GraphicStores.
 Map<String,Class> getParametersInfo()
          Gets an Object array relating to the parameters needed (beyond the URI) to instantiate a GraphicStore.
 boolean isAvailable()
          Allows a GraphicStoreFactory to ensure all its preconditions are met, such as the presense of required libraries.
 

Method Detail

createGraphicStore

GraphicStore createGraphicStore(URI provider,
                                Map<String,Object> params)
                                throws IOException,
                                       GraphicStoreException
Ask for a GraphicStore connecting to the indicated provider or service. The returned GraphicStore may have been previously cached.

Additional hints or configuration information may be provided according to the metadata indicated by getParametersInfo(). This information often includes security information such as username and password.

Parameters:
provider - Often a URI or JDBC URI locating the service to connect to.
params - Map of hints or configuration information.
Returns:
GraphicStore connected to the indicated provider or service.
Throws:
IOException - if the GraphicStore cannot connect to its source.
GraphicStoreException - if anything else goes wrong while creating the GraphicStore.

createNewGraphicStore

GraphicStore createNewGraphicStore(URI provider,
                                   Map<String,Object> params)
                                   throws IOException,
                                          GraphicStoreException
Ask for a new GraphicStore connecting to the indicated provider or service.

Additional hints or configuration information may be provided according to the metadata indicated by getParametersInfo(). This information often includes security information such as username and password.

Parameters:
provider - Often a URI or JDBC URI locating the service to connect to.
params - Map of hints or configuration information.
Returns:
GraphicStore connected to the newly created provider or service.
Throws:
IOException - if the GraphicStore cannot connect to its source.
GraphicStoreException - if anything else goes wrong while creating the GraphicStore.

getIcon

URI getIcon()
Icon representing this category of GraphicStores.

Returns:
the icon.
TODO:
Assumed to point to a 16x16 icon?

getDisplayName

InternationalString getDisplayName()
Display name used to communicate this type of GraphicStore to end users.


getDescription

InternationalString getDescription()
Description of this type of GraphicStore.


getParametersInfo

Map<String,Class> getParametersInfo()
Gets an Object array relating to the parameters needed (beyond the URI) to instantiate a GraphicStore.

TODO:
Should be replaced with a Param[] based on ISO standards (ISO 19119).

canProcess

boolean canProcess(URI provider)
Indicates this GraphicStoreFactory communicate with the indicated provider or service.

This method should not fail, if a connection needs to be made to parse a GetCapabilities file or negotiate WMS versions any IO problems simply indicate the inability to process.

This method may be considered the same as: canProcess(provider, hints) where hints was generated by using all the default values specified by the getParametersInfo() method.

Parameters:
provider - Provider or Server of spatial information.

canProcess

boolean canProcess(URI provider,
                   Map<String,Object> params)
Indicates this GraphicStoreFactory communicate with the indicated provider or service.

This method differs from canProcess(URI) in that additional configuration information may be supplied.

Parameters:
provider - Provider or Server of spatial information.
params - additional configuration information.
Returns:
true if this factory can communicate with the provider.

isAvailable

boolean isAvailable()
Allows a GraphicStoreFactory to ensure all its preconditions are met, such as the presense of required libraries.

Returns:
true if available


Copyright © 1994-2008 Open Geospatial Consortium. All Rights Reserved.