org.geotoolkit.xml
Interface IdentifierSpace<T>

Type Parameters:

T - The type of object used as identifier values.

All Superinterfaces:

Citation

public interface IdentifierSpace<T>
extends Citation

Some identifier namespaces that are handled in a special way. The identifier namespaces are usually defined as authorities in the Citations class. However a few identifiers defined in the gco:ObjectIdentification XML attribute group are handled in a special way. For example identifiers associated to the HREF space are marshalled in the outer property element, as in the example below:

<gmd:CI_Citation>
  <gmd:series xlink:href="http://myReference">
    <gmd:CI_Series>
      <gmd:name>...</gmd:name>
    </gmd:CI_Series>
  </gmd:series>
</gmd:CI_Citation>

The values defined in this interface can be used as keys in the map returned by IdentifiedObject.getIdentifierMap().

Since:

3.18

Version:

3.19

Author:

Martin Desruisseaux (Geomatys)

See Also:

Citations, IdentifiedObject, IdentifierMap

Module:

utility/geotk-xml-base (download)

View source code for this class

Field Summary

static IdentifierSpace<URI>	HREF An optional attribute for URN to an external resources, or to an other part of a XML document, or an identifier.
static IdentifierSpace<String>	ID A standard GML attribute available on every object-with-identity.
static IdentifierSpace<UUID>	UUID An optional attribute available on every object-with-identity provided in the GMD schemas that implement ISO 19115 in XML.
static IdentifierSpace<XLink>	XLINK Any XML attributes defined by OGC in the xlink schema.

Method Summary

String

getName() Returns the name of this identifier space.

Methods inherited from interface Citation

getAlternateTitles, getCitedResponsibleParties, getCollectiveTitle, getDates, getEdition, getEditionDate, getIdentifiers, getISBN, getISSN, getOtherCitationDetails, getPresentationForms, getSeries, getTitle

Field Detail

ID

static final IdentifierSpace<String> ID

A standard GML attribute available on every object-with-identity. Its type is "xs:ID" - i.e. it is a fragment identifier, unique within document scope only, for internal cross-references. It is not useful by itself as a persistent unique identifier.

The XML attribute name is "gml:id".

See Also:

XmlID

UUID

static final IdentifierSpace<UUID> UUID

An optional attribute available on every object-with-identity provided in the GMD schemas that implement ISO 19115 in XML. May be used as a persistent unique identifier, but only available within GMD context.

The XML attribute name is "gco:uuid".

See Also:

UUID

HREF

static final IdentifierSpace<URI> HREF

An optional attribute for URN to an external resources, or to an other part of a XML document, or an identifier. This is one of the many attributes available in the XLINK identifier space, but is provided as a special constant because href is the most frequently used xlink attribute.

The XML attribute name is "xlink:href".

See Also:

XLink.getHRef()

XLINK

static final IdentifierSpace<XLink> XLINK

Any XML attributes defined by OGC in the xlink schema. Note that the above HREF identifier space is a special case of this xlink identifier space.

Since:

3.19

See Also:

XLink

Method Detail

getName

String getName()

Returns the name of this identifier space.

• For the constants defined in this IdentifierSpace interface, this is the XML attribute name with its prefix. Attribute names can be "gml:id", "gco:uuid" or "xlink:href".

• For the constants defined in the Citations class, this is the identifier namespace. They usually not XML attribute name because those identifiers marshalled as <MD_Identifier> XML elements rather than attributes.

Returns:

The name of this identifier space (may be XML attribute name).