Class GazetteerFactory
Object
AbstractFactory
GazetteerFactory
- All Implemented Interfaces:
- Factory
A factory of reference systems by identifiers implemented by the SIS library.
 Current implementation can instantiate shared instances of
 
MilitaryGridReferenceSystem and
 GeohashReferenceSystem.
 MGRS and Geohash are not really "gazetteers", but we handle them in this class
 for having a unique framework for referencing by identifiers.
 Real gazetteers may be added in a future version.- Since:
- 1.3
Defined in the sis-referencing-by-identifiers module
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionReturns a shared instance of the reference system identified by the given name.forNameIfKnown(String name) Optionally returns a shared instance of the reference system identified by the given name.Returns the name of referencing systems known to this factory.Methods inherited from class AbstractFactorygetVendor
- 
Constructor Details- 
GazetteerFactorypublic GazetteerFactory()Creates a new factory.
 
- 
- 
Method Details- 
getSupportedNamesReturns the name of referencing systems known to this factory.- Returns:
- names of known reference systems.
 
- 
forNameReturns a shared instance of the reference system identified by the given name. The current implementation recognizes the following names (case-sensitive):Supported reference systems by identifiers Name Reference system class MGRS MilitaryGridReferenceSystemGeohash GeohashReferenceSystem- Parameters:
- name- name of the reference system to obtain.
- Returns:
- shared instance of the reference system for the given name.
- Throws:
- GazetteerException- if the reference system cannot be obtained.
 
- 
forNameIfKnownOptionally returns a shared instance of the reference system identified by the given name. This method performs the same work thanforName(String)but without throwing an exception if the given name is unknown.- Parameters:
- name- name of the reference system to obtain.
- Returns:
- shared instance of the reference system for the given name.
- Throws:
- GazetteerException- if the reference system cannot be obtained.
 
 
-