org.geotools.factory

Class CommonFactoryFinder

Object

FactoryFinder

CommonFactoryFinder

public final class CommonFactoryFinder
extends FactoryFinder

Defines static methods used to access the application's default implementation for some common factories. Those "common" factories comprise the style and filter factories. Note that some specialized factories finder like referencing and coverage are defined in specialized classes.

Tip: The BasicFactories classes provides an other way to access the various factories from a central point.

Since:

2.4

Author:

Martin Desruisseaux, Jody Garnett

Field Summary

Fields inherited from class FactoryFinder

EMPTY_HINTS

Method Summary

Modifier and Type	Method and Description
static FeatureCollections	getFeatureCollections() Returns the first implementation of FeatureCollections.
static FeatureCollections	getFeatureCollections(Hints hints) Returns the first implementation of FeatureCollections matching the specified hints.
static Set<FeatureCollections>	getFeatureCollectionsSet(Hints hints) Returns a set of all available implementations for the FeatureCollections interface.
static FeatureFactory	getFeatureFactory(Hints hints) Return the first implementation of FeatureFactory matching the specified hints.
static Set<FeatureLockFactory>	getFeatureLockFactories(Hints hints) Deprecated. FeatureLockFactory is no longer needed
static FeatureLockFactory	getFeatureLockFactory(Hints hints) Deprecated. FeautreLockFactory is no longer needed; please create a FeatureLock directly
static FeatureTypeFactory	getFeatureTypeFactory(Hints hints) Return the first implementation of FeatureTypeFactory matching the specified hints.
static Set<FileDataStoreFactorySpi>	getFileDataStoreFactories(Hints hints) Returns a set of all available implementations for the FileDataStoreFactorySpi interface.
static Set<FilterFactory>	getFilterFactories(Hints hints) Returns a set of all available implementations for the FilterFactory interface.
static FilterFactory	getFilterFactory() Returns the first implementation of FilterFactory.
static FilterFactory	getFilterFactory(Hints hints) Returns the first implementation of FilterFactory matching the specified hints.
static FilterFactory2	getFilterFactory2() Returns the first implementation of FilterFactory2.
static FilterFactory2	getFilterFactory2(Hints hints) Returns the first implementation of FilterFactory2 matching the specified hints.
static Set<FunctionFactory>	getFunctionFactories(Hints hints) Returns a set of all available implementations of FunctionFactory.
static Set<Function>	getFunctions(Hints hints) Returns a set of all available implementations for the Function interface.
static Set<StyleFactory>	getStyleFactories(Hints hints) Returns a set of all available implementations for the StyleFactory interface.
static StyleFactory	getStyleFactory() Returns the first implementation of StyleFactory.
static StyleFactory	getStyleFactory(Hints hints) Returns the first implementation of StyleFactory matching the specified hints.
static void	reset() Resets the factory finder and prepares for a new full scan of the SPI subsystems
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

getStyleFactory

public static StyleFactory getStyleFactory(Hints hints)
                                    throws FactoryRegistryException

Returns the first implementation of StyleFactory 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 style factory that matches the supplied hints.

Throws:

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

See Also:

Hints.STYLE_FACTORY

getStyleFactory

public static StyleFactory getStyleFactory()
                                    throws FactoryRegistryException

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

Returns:

The first style factory available

Throws:

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

See Also:

Hints.STYLE_FACTORY

getStyleFactories

public static Set<StyleFactory> getStyleFactories(Hints hints)

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

Parameters:

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

Returns:

Set of available style factory implementations.

getFunctions

public static Set<Function> getFunctions(Hints hints)

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

Parameters:

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

Returns:

Set of available function expression implementations.

getFunctionFactories

public static Set<FunctionFactory> getFunctionFactories(Hints hints)

Returns a set of all available implementations of FunctionFactory.

Parameters:

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

Returns:

Set of available function factory implementations.

getFeatureLockFactory

public static FeatureLockFactory getFeatureLockFactory(Hints hints)

Deprecated. FeautreLockFactory is no longer needed; please create a FeatureLock directly

Returns the first implementation of FeatureLockFactory 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 feature lock factory that matches the supplied hints.

Throws:

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

See Also:

Hints.FEATURE_LOCK_FACTORY

getFeatureLockFactories

public static Set<FeatureLockFactory> getFeatureLockFactories(Hints hints)

Deprecated. FeatureLockFactory is no longer needed

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

Parameters:

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

Returns:

Set of available style factory implementations.

getFileDataStoreFactories

public static Set<FileDataStoreFactorySpi> getFileDataStoreFactories(Hints hints)

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

Parameters:

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

Returns:

Set of available file data store factory implementations.

getFeatureFactory

public static FeatureFactory getFeatureFactory(Hints hints)

Return the first implementation of FeatureFactory matching the specified hints.

If no implementation matches, a new one is created if possible or an exception is thrown.

Parameters:

hints - An optional map of hints; or null if none

Returns:

Instance of FeatureFactory matching the supplied hints

Throws:

FactoryRegistryException - if no implementation could be provided

See Also:

Hints.FEATURE_FACTORY

getFeatureTypeFactory

public static FeatureTypeFactory getFeatureTypeFactory(Hints hints)

Return the first implementation of FeatureTypeFactory matching the specified hints.

If no implementation matches, a new one is created if possible or an exception is thrown.

Parameters:

hints - An optional map of hints; or null if none

Returns:

Instance of FeatureTypeFactory matching the supplied hints

Throws:

FactoryRegistryException - if no implementation could be provided

See Also:

Hints.FEATURE_TYPE_FACTORY

getFeatureCollections

public static FeatureCollections getFeatureCollections(Hints hints)

Returns the first implementation of FeatureCollections 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 feature collections that matches the supplied hints.

Throws:

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

See Also:

Hints.FEATURE_COLLECTIONS

getFeatureCollections

public static FeatureCollections getFeatureCollections()

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

Returns:

The first feature collections implementation

Throws:

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

See Also:

Hints.FEATURE_COLLECTIONS

getFeatureCollectionsSet

public static Set<FeatureCollections> getFeatureCollectionsSet(Hints hints)

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

Parameters:

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

Returns:

Set of available feature collections implementations.

getFilterFactory

public static FilterFactory getFilterFactory(Hints hints)
                                      throws FactoryRegistryException

Returns the first implementation of FilterFactory 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 filter factory that matches the supplied hints.

Throws:

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

See Also:

Hints.FILTER_FACTORY

getFilterFactory

public static FilterFactory getFilterFactory()
                                      throws FactoryRegistryException

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

Returns:

The first filter factory implementation

Throws:

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

See Also:

Hints.FILTER_FACTORY

getFilterFactories

public static Set<FilterFactory> getFilterFactories(Hints hints)

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

Parameters:

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

Returns:

Set of available filter factory implementations.

getFilterFactory2

public static FilterFactory2 getFilterFactory2(Hints hints)
                                        throws FactoryRegistryException

Returns the first implementation of FilterFactory2 matching the specified hints. This is a convenience method invoking getFilterFactory(org.geotools.util.factory.Hints) with a hint value set for requerying a FactoryFilter2 implementation.

Parameters:

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

Returns:

The first filter factory that matches the supplied hints.

Throws:

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

See Also:

Hints.FILTER_FACTORY

getFilterFactory2

public static FilterFactory2 getFilterFactory2()
                                        throws FactoryRegistryException

Returns the first implementation of FilterFactory2. This is a convenience method invoking getFilterFactory(org.geotools.util.factory.Hints) with a hint value set for requerying a FactoryFilter2 implementation.

Returns:

The first filter factory implementation

Throws:

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

See Also:

Hints.FILTER_FACTORY

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.

reset

public static void reset()

Resets the factory finder and prepares for a new full scan of the SPI subsystems