Package 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	Description
static FeatureFactory	getFeatureFactory(Hints hints)	Return an implementation of FeatureFactory matching the specified hint FEATURE_FACTORY.
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.

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 an implementation of FeatureFactory matching the specified hint FEATURE_FACTORY.

If no hint is specified, LenientFeatureFactoryImpl will be used.

Uses lookup functionality to get an instance of the factory.

Parameters:

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

Returns:

Instance of FeatureFactory

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

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