Revision 852 org.gvsig.proj/branches/refactor2018/org.gvsig.proj/org.gvsig.proj.catalog/org.gvsig.proj.catalog.api/src/main/java/org/gvsig/proj/catalog/CRSCatalogManager.java

View differences:

CRSCatalogManager.java
25 25

  
26 26
import java.io.File;
27 27
import java.text.ParseException;
28
import java.util.Collection;
28 29
import java.util.List;
29 30

  
30 31
import org.gvsig.proj.catalog.exception.CoordinateReferenceSystemException;
31 32
import org.gvsig.proj.catalog.exception.UnsupportedCoordinateReferenceSystemException;
32 33
import org.gvsig.proj.catalog.exception.UnsupportedFormatException;
33 34
import org.gvsig.proj.catalog.exception.UnsupportedTransformationException;
35
import org.gvsig.proj.catalog.extent.Extent;
36
import org.gvsig.proj.catalog.extent.GeographicBoundingBox;
37
import org.gvsig.proj.catalog.extent.VerticalExtent;
34 38

  
35 39
/**
36 40
 * This class is responsible of the management of the CRSCatalog
......
87 91
	 * Depending on the implementation of the catalog, it may only search for
88 92
	 * codes or it may search on several CRS fields (name, description,
89 93
	 * area description, etc)
90
	 * 
94
	 *
95
	 * @param authority Include only CRSs of the provided authority
91 96
	 * @param searchString
92 97
	 * @return
93 98
	 */
94 99
	List<String> search(String authority, String searchString);
95 100
	
96 101
	/**
102
	 * Returns a list of codes that match the provided search string.
103
	 * Examples of valid searchString: "4326", "EPSG:4326", "ESRI:4326", etc.
104
	 * Depending on the implementation of the catalog, it may only search for
105
	 * codes or it may search on several CRS fields (name, description,
106
	 * area description, etc)
107
	 * 
108
	 * @param authority Include only CRSs of the provided authority
109
	 * @param searchString
110
	 * @param includeTypes Include only CRSs whose type is one of the provided {@code CRSType}s. If {@code null} or
111
	 * an empty array is provided, all CRSs are included
112
	 * @param excludeTypes Exclude CRSs whose type is one of the provided {@code CRSType}s. If a CRS is provided in
113
	 * both {@code includeTypes} and {@code excludeTypes}, then it is excluded from results. 
114
	 * conflict with 
115
	 * @return
116
	 */
117
	List<String> search(String authority, String searchString, CRSType[] includeTypes, CRSType[] excludeTypes);
118
	
119
	
120
	/**
97 121
	 * Gets the CRSDefinition for the provided code
98 122
	 * @param code The CRS code (e.g. "EPSG:4326", "ESRI:4326")
99 123
	 * 
......
374 398
	 * @return
375 399
	 */
376 400
	List<TextSerialization.Format> getSupportedFormats();
401
	
402
	/**
403
	 * Creates a GeographicBoundingBox, defining a rectangular extent in WGS84
404
	 * coordinates.
405
	 * 
406
	 * @param westBoundLongitude
407
	 * @param eastBoundLongitude
408
	 * @param northBoundLatitude
409
	 * @param southBoundLatitude
410
	 * @return
411
	 */
412
	GeographicBoundingBox createBoundingBox(
413
			double westBoundLongitude,
414
			double eastBoundLongitude,
415
			double northBoundLatitude,
416
			double southBoundLatitude
417
			);
418
	
419
	/**
420
	 * Creates a vertical extent
421
	 * @param crs The coordinate reference system that the vertical coordinates are
422
	 * referred to.
423
	 * @param minValue The minimum coordinate value
424
	 * @param maxValue The maximum coordinate value
425
	 * @return
426
	 */
427
	VerticalExtent createVerticalExtent(
428
			CRSDefinition crs,
429
			double minValue,
430
			double maxValue);
431

  
432
	/**
433
	 * Creates an extent definition, which can be composed of a textual description,
434
	 * a collection of horizontal bounding box and a collection of vertical extents.
435
	 * 
436
	 * @param description
437
	 * @param horizontalBoundingBoxList
438
	 * @param verticalBoundingBoxList
439
	 * @return
440
	 */
441
	Extent createExtent(String description, Collection<GeographicBoundingBox> horizontalBoundingBoxList,
442
			Collection<VerticalExtent> verticalBoundingBoxList);
377 443
}

Also available in: Unified diff