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 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
All Methods Static Methods Concrete Methods Modifier and Type Method Description static FeatureFactory
getFeatureFactory(Hints hints)
Return an implementation ofFeatureFactory
matching the specified hint FEATURE_FACTORY.static FeatureTypeFactory
getFeatureTypeFactory(Hints hints)
Return the first implementation ofFeatureTypeFactory
matching the specified hints.static Set<FileDataStoreFactorySpi>
getFileDataStoreFactories(Hints hints)
Returns a set of all available implementations for theFileDataStoreFactorySpi
interface.static Set<FilterFactory>
getFilterFactories(Hints hints)
Returns a set of all available implementations for theFilterFactory
interface.static FilterFactory
getFilterFactory()
Returns the first implementation ofFilterFactory
.static FilterFactory
getFilterFactory(Hints hints)
Returns the first implementation ofFilterFactory
matching the specified hints.static Set<FunctionFactory>
getFunctionFactories(Hints hints)
Returns a set of all available implementations ofFunctionFactory
.static Set<Function>
getFunctions(Hints hints)
Returns a set of all available implementations for theFunction
interface.static Set<StyleFactory>
getStyleFactories(Hints hints)
Returns a set of all available implementations for theStyleFactory
interface.static StyleFactory
getStyleFactory()
Returns the first implementation ofStyleFactory
.static StyleFactory
getStyleFactory(Hints hints)
Returns the first implementation ofStyleFactory
matching the specified hints.static void
reset()
Resets the factory finder and prepares for a new full scan of the SPI subsystemsstatic void
scanForPlugins()
Scans for factory plug-ins on the application class path.-
Methods inherited from class FactoryFinder
mergeSystemHints
-
-
-
-
Method Detail
-
getStyleFactory
public static StyleFactory getStyleFactory(Hints hints) throws FactoryRegistryException
Returns the first implementation ofStyleFactory
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, ornull
if none.- Returns:
- The first style factory that matches the supplied hints.
- Throws:
FactoryRegistryException
- if no implementation was found or can be created for theStyleFactory
interface.- See Also:
Hints.STYLE_FACTORY
-
getStyleFactory
public static StyleFactory getStyleFactory() throws FactoryRegistryException
Returns the first implementation ofStyleFactory
. 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 theStyleFactory
interface.- See Also:
Hints.STYLE_FACTORY
-
getStyleFactories
public static Set<StyleFactory> getStyleFactories(Hints hints)
Returns a set of all available implementations for theStyleFactory
interface.- Parameters:
hints
- An optional map of hints, ornull
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 theFunction
interface.- Parameters:
hints
- An optional map of hints, ornull
if none.- Returns:
- Set of available function expression implementations.
-
getFunctionFactories
public static Set<FunctionFactory> getFunctionFactories(Hints hints)
Returns a set of all available implementations ofFunctionFactory
.- Parameters:
hints
- An optional map of hints, ornull
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 theFileDataStoreFactorySpi
interface.- Parameters:
hints
- An optional map of hints, ornull
if none.- Returns:
- Set of available file data store factory implementations.
-
getFeatureFactory
public static FeatureFactory getFeatureFactory(Hints hints)
Return an implementation ofFeatureFactory
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; ornull
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 ofFeatureTypeFactory
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; ornull
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 ofFilterFactory
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, ornull
if none.- Returns:
- The first filter factory that matches the supplied hints.
- Throws:
FactoryRegistryException
- if no implementation was found or can be created for theFilterFactory
interface.- See Also:
Hints.FILTER_FACTORY
-
getFilterFactory
public static FilterFactory getFilterFactory() throws FactoryRegistryException
Returns the first implementation ofFilterFactory
. 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 theFilterFactory
interface.- See Also:
Hints.FILTER_FACTORY
-
getFilterFactories
public static Set<FilterFactory> getFilterFactories(Hints hints)
Returns a set of all available implementations for theFilterFactory
interface.- Parameters:
hints
- An optional map of hints, ornull
if none.- Returns:
- Set of available filter factory implementations.
-
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
-
-