org.geotools.coverage.io.impl

Class DefaultDriver

Object

DefaultDriver

All Implemented Interfaces:

Driver, Factory, OptionalFactory

Direct Known Subclasses:

DefaultFileDriver

public class DefaultDriver
extends Object
implements Driver

Base Implementation for the Driver interface.

Nested Class Summary

Nested classes/interfaces inherited from interface Driver

Driver.DriverCapabilities

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DefaultDriver(String name, String description, String title, EnumSet<Driver.DriverCapabilities> driverCapabilities, Hints implementationHints)

Method Summary

Modifier and Type	Method and Description
CoverageAccess	access(Driver.DriverCapabilities operation, Map<String,Serializable> params, Hints hints, ProgressListener listener) Simone: Return null in case the delete succeds.
boolean	canAccess(Driver.DriverCapabilities operation, Map<String,Serializable> params)
protected boolean	canConnect(Map<String,Serializable> params)
protected boolean	canCreate(Map<String,Serializable> params)
protected boolean	canDelete(Map<String,Serializable> params)
protected CoverageAccess	connect(Map<String,Serializable> params, Hints hints, ProgressListener listener)
protected CoverageAccess	create(Map<String,Serializable> params, Hints hints, ProgressListener listener)
protected Map<String,Parameter<?>>	defineConnectParameterInfo()
protected Map<String,Parameter<?>>	defineCreateParameterInfo()
protected Map<String,Parameter<?>>	defineDeleteParameterInfo()
protected CoverageAccess	delete(Map<String,Serializable> params, Hints hints, ProgressListener listener)
protected Map<String,Parameter<?>>	getConnectParameterInfo()
protected Map<String,Parameter<?>>	getCreateParameterInfo()
protected Map<String,Parameter<?>>	getDeleteParameterInfo()
InternationalString	getDescription() Describe the nature of this Driver implementation.
EnumSet<Driver.DriverCapabilities>	getDriverCapabilities()
Map<RenderingHints.Key,?>	getImplementationHints() Implementation hints provided during construction.
String	getName() Unique name (non human readable) that can be used to refer to this implementation.
Map<String,Parameter<?>>	getParameterInfo(Driver.DriverCapabilities operation)
InternationalString	getTitle() Human readable title for this Driver.
boolean	isAvailable() Test to see if this Driver is available, if it has all the appropriate dependencies (jars or libraries).

Methods inherited from class Object

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

Constructor Detail

DefaultDriver

protected DefaultDriver(String name,
                        String description,
                        String title,
                        EnumSet<Driver.DriverCapabilities> driverCapabilities,
                        Hints implementationHints)

Method Detail

getName

public String getName()

Description copied from interface: Driver

Unique name (non human readable) that can be used to refer to this implementation.

While the Title and Description will change depending on the users local this name will be consistent. Please note that a given file may be readable by several Drivers (the description of each implementation should be provided to the user so they can make an intellegent choice in the matter).

Specified by:

getName in interface Driver

Returns:

name of this Driver

getTitle

public InternationalString getTitle()

Description copied from interface: Driver

Human readable title for this Driver.

Specified by:

getTitle in interface Driver

Returns:

human readable title for presentation in user interfaces

getImplementationHints

public Map<RenderingHints.Key,?> getImplementationHints()

Implementation hints provided during construction.

Often these hints are configuration and factory settings used to intergrate the driver with application services.

Specified by:

getImplementationHints in interface Factory

Returns:

The map of hints, or an empty map if none.

getDescription

public InternationalString getDescription()

Description copied from interface: Driver

Describe the nature of this Driver implementation.

A description of this Driver type; the description should indicate the format or service being made available in human readable terms.

Specified by:

getDescription in interface Driver

Returns:

A human readable description that is suitable for inclusion in a list of available Drivers.

canAccess

public boolean canAccess(Driver.DriverCapabilities operation,
                         Map<String,Serializable> params)

Specified by:

canAccess in interface Driver

access

public CoverageAccess access(Driver.DriverCapabilities operation,
                             Map<String,Serializable> params,
                             Hints hints,
                             ProgressListener listener)
                      throws IOException

Description copied from interface: Driver

Simone: Return null in case the delete succeds. TODO think about a neater approach

Specified by:

access in interface Driver

Throws:

IOException

getConnectParameterInfo

protected Map<String,Parameter<?>> getConnectParameterInfo()

getDeleteParameterInfo

protected Map<String,Parameter<?>> getDeleteParameterInfo()

getCreateParameterInfo

protected Map<String,Parameter<?>> getCreateParameterInfo()

getParameterInfo

public Map<String,Parameter<?>> getParameterInfo(Driver.DriverCapabilities operation)

Specified by:

getParameterInfo in interface Driver

canConnect

protected boolean canConnect(Map<String,Serializable> params)

canCreate

protected boolean canCreate(Map<String,Serializable> params)

canDelete

protected boolean canDelete(Map<String,Serializable> params)

connect

protected CoverageAccess connect(Map<String,Serializable> params,
                                 Hints hints,
                                 ProgressListener listener)
                          throws IOException

Throws:

IOException

create

protected CoverageAccess create(Map<String,Serializable> params,
                                Hints hints,
                                ProgressListener listener)
                         throws IOException

Throws:

IOException

defineConnectParameterInfo

protected Map<String,Parameter<?>> defineConnectParameterInfo()

defineCreateParameterInfo

protected Map<String,Parameter<?>> defineCreateParameterInfo()

defineDeleteParameterInfo

protected Map<String,Parameter<?>> defineDeleteParameterInfo()

delete

protected CoverageAccess delete(Map<String,Serializable> params,
                                Hints hints,
                                ProgressListener listener)
                         throws IOException

Throws:

IOException

getDriverCapabilities

public EnumSet<Driver.DriverCapabilities> getDriverCapabilities()

Specified by:

getDriverCapabilities in interface Driver

isAvailable

public boolean isAvailable()

Description copied from interface: Driver

Test to see if this Driver is available, if it has all the appropriate dependencies (jars or libraries).

One may ask how this is different than #canConnect(Map), and basically available can be used by finder mechanisms to list available Drivers.

Specified by:

isAvailable in interface Driver

Specified by:

isAvailable in interface OptionalFactory

Returns:

true if and only if this factory has all the appropriate dependencies on the classpath to create DataStores.