Package org.locationtech.proj4j.geoapi
Wraps the PROJ4J classes behind the equivalent GeoAPI interfaces.
This module provides a public class,
Wrappers
,
with overloaded geoapi(…)
methods. Those methods expected a PROJ4J object in
argument and returns a view of that object as a GeoAPI type.
Dependency to a Unit of Measurement library
This module requires a JSR-385 (Units of Measurement) implementation to be present on the class-path or module-path. The choice of an implementation is left to the user. Some implementations are Indriya, Seshat and Apache SIS. The two latter support EPSG codes for units of measurement.Mutability
No information is copied. All methods of the views delegate their work to the PROJ4J implementation. Consequently, since PROJ4J objects are mutable, changes to the wrapped PROJ4J object are immediately reflected in the view. However, it is not recommended to change a wrapped PROJ4J object as CRS should be immutable.There is one exception to the above paragraph: whether an object is a geographic or projected CRS.
Because the type of a Java object cannot change dynamically, whether a CRS is geographic or projected
is determined at geoapi(CoordinateReferenceSystem)
invocation time.
Serialization
The serialization details are not committed API. Serialization is okay for exchanging objects between JVM running the same version of PROJ4J, but is not guaranteed to be compatible between different versions of PROJ4J. This module does not defineserialVersionUID
because the backing PROJ4J objects do not define those UID anyway.-
Class Summary Class Description AbstractCRS Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.Alias An alternative name for an object.AuthorityFactoryWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.Axis A coordinate system axis.DatumWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.EllipsoidWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.GeographicCRSWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.IdentifierEPSG A simple EPSG identifier made of only a code and a code space.Importer Builder of PROJ4J objects from GeoAPI objects.LocalizedString A string in a specific locale.OperationFactoryWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.OperationMethodWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.ParameterAccessor Description of a PROJ4J parameter, together with method for getting and setting the value.ParameterWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.PositionWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.PrimeMeridianWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.ProjectedCRSWrapper Wraps a PROJ4J implementation behind the equivalent GeoAPI interface.ProjectionWrapper2D Wraps a PROJ4J transform behind the equivalent GeoAPI interface for the two-dimensional case of a map projection.ProjectionWrapper3D Wraps a PROJ4J transform behind the equivalent GeoAPI interface for the three-dimensional case of a map projection.Services Default implementations of referencing services backed by PROJ4J.SimpleCitation A citation containing only a title, an organization name and a URL.TransformWrapper Base class of two-dimensional or three-dimensional coordinate operation.TransformWrapper2D Wraps a PROJ4J transform behind the equivalent GeoAPI interface for the two-dimensional case.TransformWrapper3D Wraps a PROJ4J transform behind the equivalent GeoAPI interface for the three-dimensional case.Units Predefined constants for the units of measurement.Wrapper Base class for wrappers around PROJ4J implementations.Wrappers Views of PROJ4J implementation classes as GeoAPI objects. -
Exception Summary Exception Description UnconvertibleInstanceException Thrown byWrapper.proj4j(…)
when a GeoAPI object cannot be unwrapped or copied to a PROJ4J implementation.