Module org.apache.sis.referencing

Package org.apache.sis.referencing.factory

Class MultiAuthoritiesFactory

Object

AbstractFactory

GeodeticAuthorityFactory

MultiAuthoritiesFactory

All Implemented Interfaces:

Authority­Factory, CRSAuthority­Factory, CSAuthority­Factory, Datum­Authority­Factory, Coordinate­Operation­Authority­Factory, Factory

public class MultiAuthoritiesFactory
extends GeodeticAuthorityFactory
implements CRSAuthorityFactory, CSAuthorityFactory, DatumAuthorityFactory, CoordinateOperationAuthorityFactory

A factory that delegates the object creation to another factory determined from the authority part in “authority:code” arguments. The list of factories to use as delegates can be specified at construction time.

This factory requires that every codes given to a create­Foo(String) method are prefixed by a namespace, for example "EPSG:4326" or "EPSG::4326". When a create­Foo(String) method is invoked, this class uses the authority part in the “authority:code” argument for locating a factory capable to create a geodetic object for the code part. If a factory is found in the list of factories given at construction time, then the work is delegated to that factory. Otherwise a No­Such­Authority­Factory­Exception is thrown.

URI syntax

This factory can also parse URNs or URLs of the following forms:

• "urn:ogc:def:type:authority:version:code"
• "http://www.opengis.net/def/type/authority/version/code"
• "http://www.opengis.net/gml/srs/authority.xml#code"

In such cases, the type specified in the URN may be used for invoking a more specific method. However, Multi­Authorities­Factory uses the type information in the URN only for delegating to a more specific method, never for delegating to a less specific method. An exception will be thrown if the type in the URN is incompatible with the invoked method.

Example

If create­Object("urn:ogc:def:crs:EPSG::4326") is invoked, then Multi­Authorities­Factory will delegate (indirectly, ignoring caching for this example) the object creation to EPSGData­Access.create­Coordinate­Reference­System(String) instead of EPSGData­Access.create­Object(String) because of the "crs" part in the URN. The more specific method gives better performances and avoid ambiguities.

Compound URIs

This class accepts also combined URIs of the following forms (only two components shown, but arbitrary number of components is allowed):

• "urn:ogc:def:type, type₁:authority₁:version₁:code₁, type₂:authority₂:version₂:code₂"
• "http://www.opengis.net/def/crs-compound?
1=http://www.opengis.net/def/crs/authority₁/version₁/code₁&
2=http://www.opengis.net/def/crs/authority₂/version₂/code₂"

Given such URIs, Multi­Authorities­Factory invokes create­Object(String) for each component and combines the result as described by the CRS.compound(Coordinate­Reference­System...) method. URNs (but not URLs) can also combine a geodetic datum with an ellipsoidal coordinate system for creating a new geographic CRS, or a base geographic CRS with a conversion and a Cartesian coordinate system for creating a new projected coordinate reference system, or coordinate operations for creating a concatenated operation.

Multiple versions for the same authority

Multi­Authorities­Factory accepts an arbitrary number of factories for the same authority, provided that those factories have different version numbers. If a create­Foo(String) method is invoked with a URN containing a version number different than zero, then Multi­Authorities­Factory will search for a factory with that exact version, or throw a No­Such­Authority­Factory­Exception if no suitable factory is found. If a create­Foo(String) method is invoked with the version number omitted, then Multi­Authorities­Factory will use the first factory in iteration order for the requested authority regardless of its version number.

Example

A Multi­Authorities­Factory instance could contain two EPSGFactory instances: one for version 8.2 and another one for version 7.9 of the EPSG dataset. A specific version can be requested in the URN given to create­Foo(String) methods, for example "urn:ogc:def:crs:EPSG:8.2:4326". If no version is given of if the given version is zero, then the first EPSG factory in iteration order is used regardless of its version number.

Multi-threading

This class is thread-safe if all delegate factories are themselves thread-safe. However, the factory providers, which are given to the constructor as Iterable instances, do not need to be thread-safe. See constructor Javadoc for more information.

Since:

0.7

See Also:

• CRS.get­Authority­Factory(String)

Constructor Summary

Constructors

Constructor	Description
Multi­Authorities­Factory(Iterable<? extends CRSAuthority­Factory> crs­Factories, Iterable<? extends CSAuthority­Factory> cs­Factories, Iterable<? extends Datum­Authority­Factory> datum­Factories, Iterable<? extends Coordinate­Operation­Authority­Factory> cop­Factories)	Creates a new multi-factories instance using the given lists of factories.

Method Summary

Modifier and Type	Method	Description
Cartesian­CS	create­Cartesian­CS(String code)	Creates a 2- or 3-dimensional Cartesian coordinate system made of straight orthogonal axes.
Compound­CRS	create­Compound­CRS(String code)	Creates a CRS describing the position of points through two or more independent coordinate reference systems.
Coordinate­Operation	create­Coordinate­Operation(String code)	Creates an operation for transforming coordinates in the source CRS to coordinates in the target CRS.
Coordinate­Reference­System	create­Coordinate­Reference­System(String code)	Creates an arbitrary coordinate reference system from a code.
Coordinate­System	create­Coordinate­System(String code)	Creates an arbitrary coordinate system from a code.
Coordinate­System­Axis	create­Coordinate­System­Axis(String code)	Creates a coordinate system axis with name, direction, unit and range of values.
Cylindrical­CS	create­Cylindrical­CS(String code)	Creates a 3-dimensional coordinate system made of a polar coordinate system extended by a straight perpendicular axis.
Datum	create­Datum(String code)	Creates an arbitrary datum from a code.
Derived­CRS	create­Derived­CRS(String code)	Creates a CRS that is defined by its coordinate conversion from another CRS (not by a datum).
Ellipsoid	create­Ellipsoid(String code)	Creates a geometric figure that can be used to describe the approximate shape of the earth.
Ellipsoidal­CS	create­Ellipsoidal­CS(String code)	Creates a 2- or 3-dimensional coordinate system for geodetic latitude and longitude, sometimes with ellipsoidal height.
Engineering­CRS	create­Engineering­CRS(String code)	Creates a 1-, 2- or 3-dimensional contextually local coordinate reference system.
Engineering­Datum	create­Engineering­Datum(String code)	Creates a datum defining the origin of an engineering coordinate reference system.
Extent	create­Extent(String code)	Creates information about spatial, vertical, and temporal extent (usually a domain of validity) from a code.
Set<Coordinate­Operation>	create­From­Coordinate­Reference­System­Codes(String source­CRS, String target­CRS)	Creates operations from source and target coordinate reference system codes.
Geocentric­CRS	create­Geocentric­CRS(String code)	Creates a 3-dimensional coordinate reference system with the origin at the approximate centre of mass of the earth.
Geodetic­Datum	create­Geodetic­Datum(String code)	Creates a datum defining the location and orientation of an ellipsoid that approximates the shape of the earth.
Geographic­CRS	create­Geographic­CRS(String code)	Creates a 2- or 3-dimensional coordinate reference system based on an ellipsoidal approximation of the geoid.
Image­CRS	create­Image­CRS(String code)	Creates a 2-dimensional engineering coordinate reference system applied to locations in images.
Image­Datum	create­Image­Datum(String code)	Creates a datum defining the origin of an image coordinate reference system.
Identified­Object	create­Object(String code)	Creates an arbitrary object from a code.
Operation­Method	create­Operation­Method(String code)	Creates a description of the algorithm and parameters used to perform a coordinate operation.
Parameter­Descriptor<?>	create­Parameter­Descriptor(String code)	Creates a definition of a single parameter used by an operation method.
Polar­CS	create­Polar­CS(String code)	Creates a 2-dimensional coordinate system for coordinates represented by a distance from the origin and an angle from a fixed direction.
Prime­Meridian	create­Prime­Meridian(String code)	Creates a prime meridian defining the origin from which longitude values are determined.
Projected­CRS	create­Projected­CRS(String code)	Creates a 2-dimensional coordinate reference system used to approximate the shape of the earth on a planar surface.
Spherical­CS	create­Spherical­CS(String code)	Creates a 3-dimensional coordinate system with one distance measured from the origin and two angular coordinates.
Temporal­CRS	create­Temporal­CRS(String code)	Creates a 1-dimensional coordinate reference system used for the recording of time.
Temporal­Datum	create­Temporal­Datum(String code)	Creates a datum defining the origin of a temporal coordinate reference system.
Time­CS	create­Time­CS(String code)	Creates a 1-dimensional coordinate system for heights or depths of points.
Unit<?>	create­Unit(String code)	Creates an unit of measurement from a code.
Vertical­CRS	create­Vertical­CRS(String code)	Creates a 1-dimensional coordinate reference system used for recording heights or depths.
Vertical­CS	create­Vertical­CS(String code)	Creates a 1-dimensional coordinate system for heights or depths of points.
Vertical­Datum	create­Vertical­Datum(String code)	Creates a datum identifying a particular reference level surface used as a zero-height surface.
Citation	get­Authority()	Returns the database or specification that defines the codes recognized by this factory.
Set<String>	get­Authority­Codes(Class<? extends Identified­Object> type)	Returns the set of authority codes for objects of the given type.
final <T extends Authority­Factory> T	get­Authority­Factory(Class<T> type, String authority, String version)	Returns the factory identified by the given type, authority and version.
Set<String>	get­Code­Spaces()	Returns the code spaces of all factories given to the constructor.
International­String	get­Description­Text(String code)	Returns a description of the object corresponding to a code.
boolean	is­Lenient()	Returns whether this factory should relax some rules when processing a given authority code.
Identified­Object­Finder	new­Identified­Object­Finder()	Creates a finder which can be used for looking up unidentified objects.
void	reload()	Clears the cache and notifies this Multi­Authorities­Factory that all factories will need to be fetched again from the providers given at construction time.
void	set­Lenient(boolean lenient)	Sets whether this factory should relax some rules when processing a given code.

Methods inherited from class GeodeticAuthorityFactory

create­Parametric­CRS, create­Parametric­CS, create­Parametric­Datum, to­String, trim­Namespace

Methods inherited from class AbstractFactory

get­Vendor

Methods inherited from class Object

clone, equals, finalize, get­Class, hash­Code, notify, notify­All, wait, wait, wait

Methods inherited from interface Factory

get­Vendor

Constructor Details

MultiAuthoritiesFactory

public MultiAuthoritiesFactory(Iterable<? extends CRSAuthorityFactory> crsFactories,
 Iterable<? extends CSAuthorityFactory> csFactories,
 Iterable<? extends DatumAuthorityFactory> datumFactories,
 Iterable<? extends CoordinateOperationAuthorityFactory> copFactories)

Creates a new multi-factories instance using the given lists of factories. Calls to create­Foo(String) methods will scan the supplied factories in their iteration order when first needed. The first factory having the requested namespace will be used.

Requirements

Multi­Authorities­Factory may iterate over the same Iterable more than once. Each iteration shall return the same instances than previous iterations, unless reload() has been invoked.

The Iterables do not need to be thread-safe. Multi­Authorities­Factory will use them only in blocks synchronized on the Iterable instance. For example, all usages of crs­Factory will be done inside a synchronized(crs­Factory) block.

Name collision

If an Iterable contains more than one factory for the same namespace and version, then only the first occurrence will be used. All additional factories for the same namespace and version will be ignored, after a warning has been logged.

Caching

Multi­Authorities­Factory caches the factories found from the given Iterables, but does not cache the objects created by those factories. This constructor assumes that the given factories already do their own caching.

Parameters:

crs­Factories - the factories for creating Coordinate­Reference­System objects, or null if none.

cs­Factories - the factories for creating Coordinate­System objects, or null if none.

datum­Factories - the factories for creating Datum objects, or null if none.

cop­Factories - the factories for creating Coordinate­Operation objects, or null if none.

Method Details

isLenient

public boolean isLenient()

Returns whether this factory should relax some rules when processing a given authority code. If this value is true, then the behavior of this Multi­Authorities­Factory is changed as below:

• If a version is specified in a URN but there is no factory for that specific version, then fallback on a factory for the same authority but the default version.

The default value is false, which means that an exception will be thrown if there is no factory specifically for the requested version.

Returns:

whether this factory should relax some rules when processing a given authority code.

setLenient

public void setLenient(boolean lenient)

Sets whether this factory should relax some rules when processing a given code.

Parameters:

lenient - whether this factory should relax some rules when processing a given authority code.

getAuthority

public Citation getAuthority()

Returns the database or specification that defines the codes recognized by this factory. The default implementation returns null since Multi­Authorities­Factory is not about a particular authority.

Specified by:

get­Authority in interface Authority­Factory

Specified by:

get­Authority in class Geodetic­Authority­Factory

Returns:

the organization responsible for definition of the database, or null if unknown.

See Also:

• Abstract­Factory.get­Vendor()

getAuthorityCodes

public Set<String> getAuthorityCodes(Class<? extends IdentifiedObject> type)
                              throws FactoryException

Returns the set of authority codes for objects of the given type. This method returns the union of codes returned by all factories specified at construction time.

The Set.contains(Object) method of the returned set is lenient: it accepts various ways to format a code even if the iterator returns only one form. For example, the contains(Object) method may return true for "EPSG:4326", "EPSG::4326", "urn:ogc:def:crs:EPSG::4326", etc. even if the iterator returns only "EPSG:4326".

Warnings:

• Callers should not retain a reference to the returned collection for a long time, since it may be backed by database connections (depending on the factory implementations).
• The returned set is not thread-safe. Each thread should ask its own instance and let the garbage collector disposes it as soon as the collection is not needed anymore.
• Call to the Set.size() method on the returned collection should be avoided since it may be costly.

Specified by:

get­Authority­Codes in interface Authority­Factory

Parameters:

type - the spatial reference objects type.

Returns:

the set of authority codes for spatial reference objects of the given type.

Throws:

Factory­Exception - if access to an underlying factory failed.

getCodeSpaces

public Set<String> getCodeSpaces()

Returns the code spaces of all factories given to the constructor.

Performance note

The current implementation may be relatively costly because it implies instantiation of all factories.

Overrides:

get­Code­Spaces in class Geodetic­Authority­Factory

Returns:

the code spaces of all factories.

getAuthorityFactory

public final <T extends AuthorityFactory> T getAuthorityFactory(Class<T> type,
 String authority,
 String version)
                                                         throws NoSuchAuthorityFactoryException

Returns the factory identified by the given type, authority and version.

Type Parameters:

T - the compile-time value of type.

Parameters:

type - the type of the desired factory as one of the CRSAuthority­Factory, CSAuthority­Factory, Datum­Authority­Factory or Coordinate­Operation­Factory interfaces.

authority - the namespace or authority identifier of the desired factory. Examples: "EPSG", "CRS" or "AUTO2".

version - the version of the desired factory, or null for the default version.

Returns:

the factory for the given type, authority and version.

Throws:

No­Such­Authority­Factory­Exception - if no suitable factory has been found.

getDescriptionText

public InternationalString getDescriptionText(String code)
                                       throws FactoryException

Returns a description of the object corresponding to a code. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:type:authority:version:code
• http://www.opengis.net/def/type/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

get­Description­Text in interface Authority­Factory

Overrides:

get­Description­Text in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

a description of the object, or null if the object corresponding to the specified code has no description.

Throws:

Factory­Exception - if an error occurred while fetching the description.

createObject

public IdentifiedObject createObject(String code)
                              throws FactoryException

Creates an arbitrary object from a code. The given code can use any of the following patterns, where version is optional:

• authority:code — note that this form is ambiguous
• authority:version:code — note that this form is ambiguous
• urn:ogc:def:type:authority:version:code
• http://www.opengis.net/def/type/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

The two first formats are ambiguous when used with this create­Object(String) method because different kinds of objects can have the same code.

Specified by:

create­Object in interface Authority­Factory

Specified by:

create­Object in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the object for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Abstract­Identified­Object

createCoordinateReferenceSystem

public CoordinateReferenceSystem createCoordinateReferenceSystem(String code)
                                                          throws FactoryException

Creates an arbitrary coordinate reference system from a code. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Coordinate­Reference­System in interface CRSAuthority­Factory

Overrides:

create­Coordinate­Reference­System in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Abstract­CRS
• CRS.for­Code(String)

createGeographicCRS

public GeographicCRS createGeographicCRS(String code)
                                  throws FactoryException

Creates a 2- or 3-dimensional coordinate reference system based on an ellipsoidal approximation of the geoid. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Geographic­CRS in interface CRSAuthority­Factory

Overrides:

create­Geographic­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Geographic­CRS
• Common­CRS.geographic()
• Common­CRS.geographic3D()

createGeocentricCRS

public GeocentricCRS createGeocentricCRS(String code)
                                  throws FactoryException

Creates a 3-dimensional coordinate reference system with the origin at the approximate centre of mass of the earth. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Geocentric­CRS in interface CRSAuthority­Factory

Overrides:

create­Geocentric­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Geocentric­CRS
• Common­CRS.geocentric()

createProjectedCRS

public ProjectedCRS createProjectedCRS(String code)
                                throws FactoryException

Creates a 2-dimensional coordinate reference system used to approximate the shape of the earth on a planar surface. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Projected­CRS in interface CRSAuthority­Factory

Overrides:

create­Projected­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Projected­CRS

createVerticalCRS

public VerticalCRS createVerticalCRS(String code)
                              throws FactoryException

Creates a 1-dimensional coordinate reference system used for recording heights or depths. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Vertical­CRS in interface CRSAuthority­Factory

Overrides:

create­Vertical­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Vertical­CRS
• Common­CRS.Vertical.crs()

createTemporalCRS

public TemporalCRS createTemporalCRS(String code)
                              throws FactoryException

Creates a 1-dimensional coordinate reference system used for the recording of time. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Temporal­CRS in interface CRSAuthority­Factory

Overrides:

create­Temporal­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Temporal­CRS
• Common­CRS.Temporal.crs()

createCompoundCRS

public CompoundCRS createCompoundCRS(String code)
                              throws FactoryException

Creates a CRS describing the position of points through two or more independent coordinate reference systems. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Compound­CRS in interface CRSAuthority­Factory

Overrides:

create­Compound­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Compound­CRS

createDerivedCRS

public DerivedCRS createDerivedCRS(String code)
                            throws FactoryException

Creates a CRS that is defined by its coordinate conversion from another CRS (not by a datum). The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Derived­CRS in interface CRSAuthority­Factory

Overrides:

create­Derived­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Derived­CRS

createEngineeringCRS

public EngineeringCRS createEngineeringCRS(String code)
                                    throws FactoryException

Creates a 1-, 2- or 3-dimensional contextually local coordinate reference system. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Engineering­CRS in interface CRSAuthority­Factory

Overrides:

create­Engineering­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Engineering­CRS

createImageCRS

public ImageCRS createImageCRS(String code)
                        throws FactoryException

Creates a 2-dimensional engineering coordinate reference system applied to locations in images. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:crs:authority:version:code
• http://www.opengis.net/def/crs/authority/version/code
• http://www.opengis.net/gml/srs/authority.xml#code

Specified by:

create­Image­CRS in interface CRSAuthority­Factory

Overrides:

create­Image­CRS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate reference system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Image­CRS

createDatum

public Datum createDatum(String code)
                  throws FactoryException

Creates an arbitrary datum from a code. The returned object will typically be an The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Datum in interface Datum­Authority­Factory

Overrides:

create­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Abstract­Datum

createGeodeticDatum

public GeodeticDatum createGeodeticDatum(String code)
                                  throws FactoryException

Creates a datum defining the location and orientation of an ellipsoid that approximates the shape of the earth. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Geodetic­Datum in interface Datum­Authority­Factory

Overrides:

create­Geodetic­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Geodetic­Datum
• Common­CRS.datum()

createVerticalDatum

public VerticalDatum createVerticalDatum(String code)
                                  throws FactoryException

Creates a datum identifying a particular reference level surface used as a zero-height surface. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Vertical­Datum in interface Datum­Authority­Factory

Overrides:

create­Vertical­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Vertical­Datum
• Common­CRS.Vertical.datum()

createTemporalDatum

public TemporalDatum createTemporalDatum(String code)
                                  throws FactoryException

Creates a datum defining the origin of a temporal coordinate reference system. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Temporal­Datum in interface Datum­Authority­Factory

Overrides:

create­Temporal­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Temporal­Datum
• Common­CRS.Temporal.datum()

createEngineeringDatum

public EngineeringDatum createEngineeringDatum(String code)
                                        throws FactoryException

Creates a datum defining the origin of an engineering coordinate reference system. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Engineering­Datum in interface Datum­Authority­Factory

Overrides:

create­Engineering­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Engineering­Datum

createImageDatum

public ImageDatum createImageDatum(String code)
                            throws FactoryException

Creates a datum defining the origin of an image coordinate reference system. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:datum:authority:version:code
• http://www.opengis.net/def/datum/authority/version/code

Specified by:

create­Image­Datum in interface Datum­Authority­Factory

Overrides:

create­Image­Datum in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the datum for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Image­Datum

createEllipsoid

public Ellipsoid createEllipsoid(String code)
                          throws FactoryException

Creates a geometric figure that can be used to describe the approximate shape of the earth. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:ellipsoid:authority:version:code
• http://www.opengis.net/def/ellipsoid/authority/version/code

Specified by:

create­Ellipsoid in interface Datum­Authority­Factory

Overrides:

create­Ellipsoid in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the ellipsoid for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Ellipsoid
• Common­CRS.ellipsoid()

createPrimeMeridian

public PrimeMeridian createPrimeMeridian(String code)
                                  throws FactoryException

Creates a prime meridian defining the origin from which longitude values are determined. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:meridian:authority:version:code
• http://www.opengis.net/def/meridian/authority/version/code

Specified by:

create­Prime­Meridian in interface Datum­Authority­Factory

Overrides:

create­Prime­Meridian in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the prime meridian for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Prime­Meridian
• Common­CRS.prime­Meridian()

createExtent

public Extent createExtent(String code)
                    throws FactoryException

Creates information about spatial, vertical, and temporal extent (usually a domain of validity) from a code. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code

Overrides:

create­Extent in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the extent for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Extent

createCoordinateSystem

public CoordinateSystem createCoordinateSystem(String code)
                                        throws FactoryException

Creates an arbitrary coordinate system from a code. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Coordinate­System in interface CSAuthority­Factory

Overrides:

create­Coordinate­System in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Abstract­CS
• Coordinate­Systems.get­Epsg­Code(Unit, Axis­Direction...)

createEllipsoidalCS

public EllipsoidalCS createEllipsoidalCS(String code)
                                  throws FactoryException

Creates a 2- or 3-dimensional coordinate system for geodetic latitude and longitude, sometimes with ellipsoidal height. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Ellipsoidal­CS in interface CSAuthority­Factory

Overrides:

create­Ellipsoidal­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Ellipsoidal­CS

createVerticalCS

public VerticalCS createVerticalCS(String code)
                            throws FactoryException

Creates a 1-dimensional coordinate system for heights or depths of points. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Vertical­CS in interface CSAuthority­Factory

Overrides:

create­Vertical­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Vertical­CS

createTimeCS

public TimeCS createTimeCS(String code)
                    throws FactoryException

Creates a 1-dimensional coordinate system for heights or depths of points. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Time­CS in interface CSAuthority­Factory

Overrides:

create­Time­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Time­CS

createCartesianCS

public CartesianCS createCartesianCS(String code)
                              throws FactoryException

Creates a 2- or 3-dimensional Cartesian coordinate system made of straight orthogonal axes. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Cartesian­CS in interface CSAuthority­Factory

Overrides:

create­Cartesian­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Cartesian­CS

createSphericalCS

public SphericalCS createSphericalCS(String code)
                              throws FactoryException

Creates a 3-dimensional coordinate system with one distance measured from the origin and two angular coordinates. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Spherical­CS in interface CSAuthority­Factory

Overrides:

create­Spherical­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Spherical­CS

createCylindricalCS

public CylindricalCS createCylindricalCS(String code)
                                  throws FactoryException

Creates a 3-dimensional coordinate system made of a polar coordinate system extended by a straight perpendicular axis. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Cylindrical­CS in interface CSAuthority­Factory

Overrides:

create­Cylindrical­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Cylindrical­CS

createPolarCS

public PolarCS createPolarCS(String code)
                      throws FactoryException

Creates a 2-dimensional coordinate system for coordinates represented by a distance from the origin and an angle from a fixed direction. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:cs:authority:version:code
• http://www.opengis.net/def/cs/authority/version/code

Specified by:

create­Polar­CS in interface CSAuthority­Factory

Overrides:

create­Polar­CS in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the coordinate system for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Polar­CS

createCoordinateSystemAxis

public CoordinateSystemAxis createCoordinateSystemAxis(String code)
                                                throws FactoryException

Creates a coordinate system axis with name, direction, unit and range of values. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:axis:authority:version:code
• http://www.opengis.net/def/axis/authority/version/code

Specified by:

create­Coordinate­System­Axis in interface CSAuthority­Factory

Overrides:

create­Coordinate­System­Axis in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the axis for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Coordinate­System­Axis

createUnit

public Unit<?> createUnit(String code)
                   throws FactoryException

Creates an unit of measurement from a code. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:uom:authority:version:code
• http://www.opengis.net/def/uom/authority/version/code

Specified by:

create­Unit in interface CSAuthority­Factory

Overrides:

create­Unit in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the unit of measurement for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Units.value­Of­EPSG(int)

createParameterDescriptor

public ParameterDescriptor<?> createParameterDescriptor(String code)
                                                 throws FactoryException

Creates a definition of a single parameter used by an operation method. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:parameter:authority:version:code
• http://www.opengis.net/def/parameter/authority/version/code

Overrides:

create­Parameter­Descriptor in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the parameter descriptor for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Parameter­Descriptor
• Apache SIS™ Coordinate Operation Methods

createOperationMethod

public OperationMethod createOperationMethod(String code)
                                      throws FactoryException

Creates a description of the algorithm and parameters used to perform a coordinate operation. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:method:authority:version:code
• http://www.opengis.net/def/method/authority/version/code

Specified by:

create­Operation­Method in interface Coordinate­Operation­Authority­Factory

Overrides:

create­Operation­Method in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the operation method for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Default­Operation­Method
• Apache SIS™ Coordinate Operation Methods

createCoordinateOperation

public CoordinateOperation createCoordinateOperation(String code)
                                              throws FactoryException

Creates an operation for transforming coordinates in the source CRS to coordinates in the target CRS. The given code can use any of the following patterns, where version is optional:

• authority:code
• authority:version:code
• urn:ogc:def:coordinate­Operation:authority:version:code
• http://www.opengis.net/def/coordinate­Operation/authority/version/code

Specified by:

create­Coordinate­Operation in interface Coordinate­Operation­Authority­Factory

Overrides:

create­Coordinate­Operation in class Geodetic­Authority­Factory

Parameters:

code - value allocated by authority.

Returns:

the operation for the given code.

Throws:

Factory­Exception - if the object creation failed.

See Also:

• Abstract­Coordinate­Operation

createFromCoordinateReferenceSystemCodes

public Set<CoordinateOperation> createFromCoordinateReferenceSystemCodes(String sourceCRS,
 String targetCRS)
                                                                  throws FactoryException

Creates operations from source and target coordinate reference system codes. If the authority for the two given CRS is handled by the same factory, then this method delegates to that factory. Otherwise this method returns an empty set.

Specified by:

create­From­Coordinate­Reference­System­Codes in interface Coordinate­Operation­Authority­Factory

Overrides:

create­From­Coordinate­Reference­System­Codes in class Geodetic­Authority­Factory

Parameters:

source­CRS - coded value of source coordinate reference system.

target­CRS - coded value of target coordinate reference system.

Returns:

the operations from source­CRS to target­CRS.

Throws:

Factory­Exception - if the object creation failed.

newIdentifiedObjectFinder

public IdentifiedObjectFinder newIdentifiedObjectFinder()
                                                 throws FactoryException

Creates a finder which can be used for looking up unidentified objects. The default implementation delegates the lookups to the underlying factories.

Overrides:

new­Identified­Object­Finder in class Geodetic­Authority­Factory

Returns:

a finder to use for looking up unidentified objects.

Throws:

Factory­Exception - if the finder cannot be created.

See Also:

• Identified­Objects.new­Finder(String)

reload

public void reload()

Clears the cache and notifies this Multi­Authorities­Factory that all factories will need to be fetched again from the providers given at construction time. In addition, all providers that are instances of Service­Loader will have their reload() method invoked.

This method is intended for use in situations in which new factories can be installed into a running Java virtual machine.