org.opengis.referencing
Interface Factory

All Known Subinterfaces:

CoordinateOperationFactory, CRSFactory, CSFactory, DatumFactory, MathTransformFactory

public interface Factory

Base interface for all factories of Info objects. Factories build up complex objects from simpler objects or values. Factory allows applications to make coordinate systems, Datum or coordinate reference systems that cannot be created by an AuthorityFactory. This factory is very flexible, whereas the authority factory is easier to use.

Object properties

Most factory methods expect a Map argument. The map is often (but is not required to be) a Properties instance. The map shall contains at least a "name" property. In the common case where the name is the only property, the map may be constructed with Collections.singletonMap("name", theName) where theName is an arbitrary name as free text. Additionally, implementations are encouraged to recognize at least the properties listed in the following table. More implementation-specific properties may be added as well. In any case, unknown properties will be ignored.

Property name	Value type	Value given to
"name"	String	Info.getName(java.util.Locale)
"remarks"	String	Info.getRemarks(java.util.Locale)
"authority"	String or Citation	Identifier.getAuthority() on the first identifier
"code"	String	Identifier.getCode() on the first identifier
"codeSpace"	String	Identifier.getCodeSpace() on the first identifier
"version"	String	Identifier.getVersion() on the first identifier
"identifiers"	Identifier[]	Info.getIdentifiers()

The "name" property is mandatory. All others are optional. Additionally, all localizable attributes like "name" and "remarks" may have a language and country code suffix. For example the "remarks_fr" property stands for remarks in French and the "remarks_fr_CA" property stands for remarks in French Canadian.

Version:

Implementation specification 1.0

Author:

OpenGIS® consortium

Method Summary

Citation

getVendor() Returns the vendor responsible for creating this factory implementation.

Method Detail

getVendor

Citation getVendor()

Returns the vendor responsible for creating this factory implementation. Many implementations may be available for the same factory interface. Implementations are usually managed by a service registry.

Returns:

The vendor for this factory implementation.