01: /*
02: * GeoTools - OpenSource mapping toolkit
03: * http://geotools.org
04: * (C) 2004-2006, GeoTools Project Managment Committee (PMC)
05: *
06: * This library is free software; you can redistribute it and/or
07: * modify it under the terms of the GNU Lesser General Public
08: * License as published by the Free Software Foundation;
09: * version 2.1 of the License.
10: *
11: * This library is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * Lesser General Public License for more details.
15: */
16: package org.geotools.data.crs;
17:
18: import java.io.IOException;
19: import java.util.Set;
20:
21: import org.geotools.factory.Factory;
22: import org.opengis.referencing.crs.CoordinateReferenceSystem;
23: import org.opengis.referencing.crs.CRSAuthorityFactory;
24:
25: /**
26: * This is a marker used to allow CRSService to dynamically locate
27: * implementations of CoordinateSystemAuthorityFactory.
28: * <p>
29: * When the time comes CRSService can switch over to
30: * org.geotools.referencing.Factory - that time is not now.
31: * </p>
32: * @author Jody Garnett
33: *
34: * @deprecated Now replaced by {@link CRSAuthorityFactory}.
35: * @source $URL: http://svn.geotools.org/geotools/tags/2.4.1/modules/library/main/src/main/java/org/geotools/data/crs/CRSAuthoritySpi.java $
36: */
37: public interface CRSAuthoritySpi extends Factory {
38: /**
39: * Provides the complete set of codes managed by this CRSAuthority.
40: * <p>
41: * Note these codes are will include any authority information such
42: * as EPSG or AUTO.
43: * </p>
44: *
45: * @return Set of codes used to identify CRS provided by this Factory.
46: */
47: public Set getCodes();
48:
49: /**
50: * Provide access to the low-level decoding system provided by this Factory.
51: * <p>
52: * This method is provided to allow access to parser (WKT/XML/?) used by
53: * this Authority in a seemless manner.
54: * </p>
55: * <p>
56: * What purpose this servers is unclear to me since the EPSG code will not be
57: * known for the resulting CoordinateReferenceSystem.
58: * </p>
59: *
60: * @param encoding
61: * @return CoordinateReferenceSystem for the encoding or null if encoding was unsuitable
62: * @throws IOException If the encoding should of been parsable but contained an error
63: *
64: * @deprecated Replaced by {@link CRSAuthorityFactory#createCoordinateReferenceSystem}.
65: */
66: public CoordinateReferenceSystem decode(String encoding)
67: throws IOException;
68:
69: }
|