/*
* Geotoolkit.org - An Open Source Java GIS Toolkit
* http://www.geotoolkit.org
*
* (C) 2004-2012, Open Source Geospatial Foundation (OSGeo)
* (C) 2009-2012, Geomatys
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
/**
* {@linkplain org.opengis.referencing.AuthorityFactory Authority factories} for CRS parsed from
* <cite><a href="http://www.geoapi.org/snapshot/javadoc/org/opengis/referencing/doc-files/WKT.html">Well
* Known Text</a></cite> (WKT). This package contains two main implementations:
* <p>
* <ul>
* <li>{@link org.geotoolkit.referencing.factory.wkt.PropertyAuthorityFactory} (and its
* {@link org.geotoolkit.referencing.factory.epsg.PropertyEpsgFactory} specialization)
* for parsing CRS from a {@linkplain java.util.Properties property file}.</li>
* <li>{@link org.geotoolkit.referencing.factory.wkt.DirectPostgisFactory} for parsing CRS
* from the {@value org.geotoolkit.referencing.factory.wkt.DirectPostgisFactory#TABLE}
* table of a PostGIS database:.</li>
* </ul>
* <p>
* The public implementations provided in this package does not cache the CRS - each call to a
* {@code createFoo} method will trig a new WKT parsing. In order to get implementations that
* cache the CRS, the {@link org.geotoolkit.referencing.factory.wkt.AuthorityFactoryProvider}
* convenience class can be used.
* <p>
* By default, the classes defined in this package are <strong>not</strong> registered for use
* though the {@link org.geotoolkit.factory.FactoryFinder}. The only subclass automatically
* registered is {@link org.geotoolkit.referencing.factory.epsg.PropertyEpsgFactory}, which
* is defined in another package. For all other classes, users shall either instantiate and
* use a class directly, or create a subclass and
* <a href="../../../factory/package-summary.html#package_description">register</a> it themselves.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @author Jody Garnett (Refractions)
* @author Rueben Schulz (UBC)
* @version 3.10
*
* @since 3.10 (derived from 2.1)
* @module
*/
package org.geotoolkit.referencing.factory.wkt;