Package org.geotools.coverage

Class CoverageFactoryFinder

Object

FactoryFinder

CoverageFactoryFinder

public final class CoverageFactoryFinder
extends FactoryFinder

Defines static methods used to access the application's default factory implementation.

Since:

2.4

Author:

Martin Desruisseaux

Field Summary

Fields inherited from class FactoryFinder

EMPTY_HINTS

Method Summary

Modifier and Type	Method	Description
static Set<GridCoverageFactory>	getGridCoverageFactories(Hints hints)	Returns a set of all available implementations for the GridCoverageFactory interface.
static GridCoverageFactory	getGridCoverageFactory(Hints hints)	Returns the first implementation of GridCoverageFactory matching the specified hints.
static void	scanForPlugins()	Scans for factory plug-ins on the application class path.

Methods inherited from class FactoryFinder

mergeSystemHints

Methods inherited from class Object

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

Method Detail

getGridCoverageFactory

public static GridCoverageFactory getGridCoverageFactory(Hints hints)
                                                  throws FactoryRegistryException

Returns the first implementation of GridCoverageFactory matching the specified hints. If no implementation matches, a new one is created if possible or an exception is thrown otherwise.

Parameters:

hints - An optional map of hints, or null if none.

Returns:

The first grid coverage factory that matches the supplied hints.

Throws:

FactoryRegistryException - if no implementation was found or can be created for the GridCoverageFactory interface.

See Also:

Hints.DEFAULT_COORDINATE_REFERENCE_SYSTEM, Hints#TILE_ENCODING

getGridCoverageFactories

public static Set<GridCoverageFactory> getGridCoverageFactories(Hints hints)

Returns a set of all available implementations for the GridCoverageFactory interface.

Parameters:

hints - An optional map of hints, or null if none.

Returns:

Set of available grid coverage factory implementations.

Since:

2.4

scanForPlugins

public static void scanForPlugins()

Scans for factory plug-ins on the application class path. This method is needed because the application class path can theoretically change, or additional plug-ins may become available. Rather than re-scanning the classpath on every invocation of the API, the class path is scanned automatically only on the first invocation. Clients can call this method to prompt a re-scan. Thus this method need only be invoked by sophisticated applications which dynamically make new plug-ins available at runtime.