| org.geotools.referencing.factory.DeferredAuthorityFactory
 org.geotools.referencing.factory.epsg.FactoryUsingWKT
All known Subclasses: org.geotools.referencing.factory.epsg.UnnamedExtension, org.geotools.referencing.factory.epsg.EsriExtension,
| FactoryUsingWKT | | public class FactoryUsingWKT extends DeferredAuthorityFactory implements CRSAuthorityFactory(Code) | | Authority factory for
beyong the one defined in the EPSG database. This factory is used as a fallback when a
requested code is not found in the EPSG database, or when there is no connection at all
to the EPSG database. The additional CRS are defined as Well Known Text in
a property file located by default in the
org.geotools.referencing.factory.epsg package, and whose name should be
. If no property file is found, the
factory won't be activated. The property file can also be located in a custom directory;
See
FactoryUsingWKT.getDefinitionsURL() for more details.
This factory can also be used to provide custom extensions or overrides to a main EPSG factory.
In order to provide a custom extension file, override the
FactoryUsingWKT.getDefinitionsURL() method.
In order to make the factory be an override, change the default priority by using the
two arguments constructor (this factory defaults to
ThreadedEpsgFactory.PRIORITY - 10,
so it's used as an extension).
since:
2.1
version:
$Id: FactoryUsingWKT.java 27848 2007-11-12 13:10:32Z desruisseaux $
author:
Martin Desruisseaux
author:
Jody Garnett
author:
Rueben Schulz
author:
Andrea Aime |
| Constructor Summary | |
| public | FactoryUsingWKT()
Constructs an authority factory using the default set of factories. | | public | FactoryUsingWKT(Hints userHints)
Constructs an authority factory using a set of factories created from the specified hints. | | protected | FactoryUsingWKT(Hints userHints, int priority)
Constructs an authority factory using the specified hints and priority. |
| DEFAULT_PRIORITY | | final protected static int DEFAULT_PRIORITY(Code) | | Default priority for this factory.
since:
2.4 |
| FILENAME | | final public static String FILENAME(Code) | | The default filename to read. The default
FactoryUsingWKT implementation will
search for the first occurence of this file in the following places:
- In the directory specified by the
system
property.
- In every
org/geotools/referencing/factory/espg directories found on the
classpath.
The filename part before the extension (
"epsg" ) denotes the authority namespace
where to register the content of this file. The user-directory given by the system property
may contains other property files for other authorities, like
"esri.properties" ,
but those additional authorities are not handled by the default
FactoryUsingWKT class.
See Also: FactoryUsingWKT.getDefinitionsURL |
| FactoryUsingWKT | | public FactoryUsingWKT()(Code) | | Constructs an authority factory using the default set of factories.
|
| FactoryUsingWKT | | protected FactoryUsingWKT(Hints userHints, int priority)(Code) | | Constructs an authority factory using the specified hints and priority.
|
| createBackingStore | | protected AbstractAuthorityFactory createBackingStore() throws FactoryException(Code) | | Creates the backing store authority factory.
The backing store to uses in createXXX(...) methods.
throws:
FactoryNotFoundException - if the no epsg.properties file has been found.
throws:
FactoryException - if the constructor failed to find or read the file.This exception usually has an IOException as its cause. |
| getAuthorities | | protected Citation[] getAuthorities()(Code) | | Returns the set of authorities to use as
for the CRS to be created. This set is given to the
.
The default implementation returns a singleton containing only
. Subclasses should override this method in order to enumerate all relevant authorities,
with
in last position. For example
EsriExtension returns {
,
}.
since:
2.4 |
| getDefinitionsURL | | protected URL getDefinitionsURL()(Code) | | Returns the URL to the property file that contains CRS definitions.
The default implementation performs the following search path:
- If a value is set for the
system property key,
then the
file will be searched in this directory.
- If no value is set for the above-cited system property, or if no
file was found in that directory, then the first
file found in
any
org/geotools/referencing/factory/epsg directory on the classpath will
be used.
- If no file was found on the classpath neither, then this factory will be disabled.
The URL, or null if none. |
| main | | public static void main(String[] args) throws FactoryException(Code) | | Prints a list of codes that duplicate the ones provided in the
ThreadedEpsgFactory .
The factory tested is the one registered in
ReferencingFactoryFinder . By default,
this is this
FactoryUsingWKT class backed by the
property file.
This method can be invoked from the command line in order to check the content of the
property file. Valid arguments are:
|
-test | Try to instantiate all CRS and reports any failure
to do so. |
|
-duplicated | List all codes from the WKT factory that are
duplicating a code from the SQL factory. |
Parameters:
args - Command line arguments.
throws:
FactoryException - if an error occured.
since:
2.4 |
| reportDuplicatedCodes | | protected Set reportDuplicatedCodes(PrintWriter out) throws FactoryException(Code) | | Prints a list of codes that duplicate the ones provided by
ThreadedEpsgFactory .
This is used for implementation of
in order to check
the content of the
file (or whatever property file used as backing
store for this factory) from the command line.
Parameters:
out - The writer where to print the report. The set of duplicated codes.
throws:
FactoryException - if an error occured.
since:
2.4 |
| reportInstantiationFailures | | protected Set reportInstantiationFailures(PrintWriter out) throws FactoryException(Code) | | Prints a list of CRS that can't be instantiated. This is used for implementation of
in order to check the content of the
file (or whatever property file used as backing store for this factory) from the command
line.
Parameters:
out - The writer where to print the report. The set of codes that can't be instantiated.
throws:
FactoryException - if an error occured while.
since:
2.4 |
|
|