public interface IdentifiedObject
String
in
a namespace identified by a Citation
. The namespace can be some organization like
EPSG for Coordinate Reference System objects, or a
well-known acronym like ISBN for International Standard Book Number.
When an identified object is marshalled in a ISO 19139 compliant XML document, some identifiers
are handled in a special way: they appear as gml:id
, gco:uuid
or xlink:href
attributes of the XML element. Those identifiers can be specified using the IdentifierSpace
enum values as below:
IdentifiedObject object = ...; object.getIdentifierMap().put(IdentifierSpace.ID, "myID");
Instrument
, Platform
,
Operation
, Processing
,
etc.) have an explicit single identifier attribute, while other GeoAPI objects
(Citation
, Objective
,
referencing IdentifiedObject
, etc.) allow an arbitrary
number of identifiers. However GeoAPI does not define explicit methods for handling the id
,
uuid
or href
attributes, since they are specific to XML marshalling (they do not
appear in OGC/ISO abstract specifications). This IdentifiedObject
interface provides a
way to handle those identifiers.
Note that GeoAPI defines a similar interface, also named IdentifiedObject
.
However that GeoAPI interface is not of general use, since it contains methods like
toWKT()
that are specific to referencing
or geometric objects. In addition, the GeoAPI interface defines some attributes
(name,
alias,
remarks) that are not needed
for the purpose of handling XML id
, uuid
or href
attributes.
IdentifierSpace
,
ISOMetadata
,
ReferenceResolver.newIdentifiedObject(MarshalContext, Class, Identifier[])
Defined in the sis-utility
module
Modifier and Type | Method and Description |
---|---|
IdentifierMap |
getIdentifierMap()
A map view of the identifiers collection
as (authority, code) entries.
|
Collection<? extends Identifier> |
getIdentifiers()
Returns all identifiers associated to this object.
|
Collection<? extends Identifier> getIdentifiers()
DefaultCitation.getIdentifiers()
,
DefaultObjective.getIdentifiers()
,
AbstractIdentifiedObject.getIdentifiers()
IdentifierMap getIdentifierMap()
There is usually a one-to-one relationship between the map entries and the identifier elements, but not always:
Map
view.Citation
interface defines separated attributes for ISBN, ISSN and other identifiers. This map
view may choose to unify all those attributes in a single view.put
operations
if and only if this IdentifiedObject
is modifiable.Copyright © 2010–2017 The Apache Software Foundation. All rights reserved.