Revision 793 org.gvsig.proj/branches/refactor2018/org.gvsig.proj/org.gvsig.proj.lib/org.gvsig.proj.lib.api/src/main/java/org/gvsig/proj/CoordinateReferenceSystemManager.java
| CoordinateReferenceSystemManager.java | ||
|---|---|---|
| 23 | 23 |
*/ |
| 24 | 24 |
package org.gvsig.proj; |
| 25 | 25 |
|
| 26 |
import java.util.List;
|
|
| 27 |
|
|
| 26 |
import org.gvsig.proj.catalogue.CRSDefinition;
|
|
| 27 |
import org.gvsig.proj.catalogue.CoordinateOperationDefinition; |
|
| 28 | 28 |
import org.gvsig.tools.dynobject.DynObject; |
| 29 | 29 |
|
| 30 | 30 |
/** |
| ... | ... | |
| 38 | 38 |
*/ |
| 39 | 39 |
public interface CoordinateReferenceSystemManager {
|
| 40 | 40 |
|
| 41 |
/** |
|
| 42 |
* Returns a List of String values with the available authority names. |
|
| 43 |
* |
|
| 44 |
* @return the available authority names |
|
| 45 |
*/ |
|
| 46 |
List getAuthorityNames(); |
|
| 41 |
/** |
|
| 42 |
* Returns a Coordinate Reference System. |
|
| 43 |
* @param wkt |
|
| 44 |
* a WKT definition or a CRS code using the |
|
| 45 |
* AUTHORITY:CODE format. |
|
| 46 |
*/ |
|
| 47 |
CoordinateReferenceSystem getCoordinateReferenceSystem( |
|
| 48 |
String wkt) |
|
| 49 |
throws CoordinateReferenceSystemNotFoundException; |
|
| 47 | 50 |
|
| 48 |
/** |
|
| 49 |
* Returns a List of String values with the codes available for a given |
|
| 50 |
* Authority, |
|
| 51 |
* |
|
| 52 |
* @param authorityName |
|
| 53 |
* name of the authority to get the codes of |
|
| 54 |
* @return the list of available codes |
|
| 55 |
*/ |
|
| 56 |
List getCodes(String authorityName); |
|
| 51 |
/** |
|
| 52 |
* Returns a Coordinate Reference System. |
|
| 53 |
* |
|
| 54 |
* @param authorityName |
|
| 55 |
* name of the Authority who defines de Coordinate Reference |
|
| 56 |
* System |
|
| 57 |
* @param code |
|
| 58 |
* the code used by the Authority to identify the Coordinate |
|
| 59 |
* Reference System |
|
| 60 |
* @return the projection |
|
| 61 |
* @throws CoordinateReferenceSystemNotFoundException |
|
| 62 |
* if there is not any Coordinate Reference System available in |
|
| 63 |
* the library with the given reference |
|
| 64 |
*/ |
|
| 65 |
CoordinateReferenceSystem getCoordinateReferenceSystem( |
|
| 66 |
String authorityName, String code) |
|
| 67 |
throws CoordinateReferenceSystemNotFoundException; |
|
| 68 |
|
|
| 69 |
/** |
|
| 70 |
* Returns a Coordinate Reference System. |
|
| 71 |
* |
|
| 72 |
* @param definition |
|
| 73 |
*/ |
|
| 74 |
CoordinateReferenceSystem getCoordinateReferenceSystem( |
|
| 75 |
CRSDefinition definition) |
|
| 76 |
throws CoordinateReferenceSystemNotFoundException; |
|
| 57 | 77 |
|
| 58 |
/** |
|
| 59 |
* Returns a Coordinate Reference System. |
|
| 60 |
* |
|
| 61 |
* @param authorityName |
|
| 62 |
* name of the Authority who defines de Coordinate Reference |
|
| 63 |
* System |
|
| 64 |
* @param code |
|
| 65 |
* the code used by the Authority to identify the Coordinate |
|
| 66 |
* Reference System |
|
| 67 |
* @return the projection |
|
| 68 |
* @throws CoordinateReferenceSystemNotFoundException |
|
| 69 |
* if there is not any Coordinate Reference System available in |
|
| 70 |
* the library with the given reference |
|
| 71 |
*/ |
|
| 72 |
CoordinateReferenceSystem getCoordinateReferenceSystem( |
|
| 73 |
String authorityName, String code) |
|
| 74 |
throws CoordinateReferenceSystemNotFoundException; |
|
| 78 |
/** |
|
| 79 |
* Returns a Coordinate Operation |
|
| 80 |
* @param authorityName |
|
| 81 |
* @param code |
|
| 82 |
* @return |
|
| 83 |
* @throws CoordinateReferenceSystemNotFoundException |
|
| 84 |
*/ |
|
| 85 |
CoordinateOperation getCoordinateOperation( |
|
| 86 |
String authorityName, String code) |
|
| 87 |
throws CoordinateOperationNotFoundException; |
|
| 88 |
|
|
| 89 |
/** |
|
| 90 |
* Returns a Coordinate Operation |
|
| 91 |
* |
|
| 92 |
* @param definition |
|
| 93 |
*/ |
|
| 94 |
CoordinateOperation getCoordinateOperation( |
|
| 95 |
CoordinateOperationDefinition definition) |
|
| 96 |
throws CoordinateOperationNotFoundException; |
|
| 97 |
|
|
| 98 |
|
|
| 99 |
/** |
|
| 100 |
* Creates the parameters needed to initialize the manager. |
|
| 101 |
* |
|
| 102 |
* @return the initialization parameters |
|
| 103 |
*/ |
|
| 104 |
DynObject createParameters(); |
|
| 75 | 105 |
|
| 76 |
/** |
|
| 77 |
* TODO: allow user defined projections |
|
| 78 |
*/ |
|
| 79 |
// CoordinateReferenceSystem getCoordinateReferenceSystem(String |
|
| 80 |
// authorityName, String |
|
| 81 |
// code, |
|
| 82 |
// String definition, String description); |
|
| 83 |
|
|
| 84 |
/* |
|
| 85 |
* TODO: allow code or user registered CoordinateReferenceSystem. In current |
|
| 86 |
* version |
|
| 87 |
* available projections will be fixed. |
|
| 88 |
*/ |
|
| 89 |
// public void register(CoordinateReferenceSystem proj); |
|
| 90 |
|
|
| 91 |
/** |
|
| 92 |
* Creates the parameters needed to initialize the manager. |
|
| 93 |
* |
|
| 94 |
* @return the initialization parameters |
|
| 95 |
*/ |
|
| 96 |
DynObject createParameters(); |
|
| 97 |
|
|
| 98 |
/** |
|
| 99 |
* Initializes the manager with the given parameters. |
|
| 100 |
* |
|
| 101 |
* @param parameters |
|
| 102 |
* to initialize the manager |
|
| 103 |
*/ |
|
| 104 |
void initialize(DynObject parameters); |
|
| 106 |
/** |
|
| 107 |
* Initializes the manager with the given parameters. |
|
| 108 |
* |
|
| 109 |
* @param parameters |
|
| 110 |
* to initialize the manager |
|
| 111 |
*/ |
|
| 112 |
void initialize(DynObject parameters); |
|
| 105 | 113 |
} |
Also available in: Unified diff