org.geotoolkit.metadata.iso.identification
Class AbstractIdentification

Object
  AbstractMetadata
      ModifiableMetadata
          MetadataEntity
              AbstractIdentification

All Implemented Interfaces:

Serializable, Cloneable, LenientComparable, IdentifiedObject, Identification

Direct Known Subclasses:

DefaultDataIdentification, DefaultServiceIdentification

@ThreadSafe
public class AbstractIdentification
extends MetadataEntity
implements Identification

Basic information required to uniquely identify a resource or resources.

Since:

2.1

Version:

3.19

Author:

Martin Desruisseaux (IRD, Geomatys), Touraïvane (IRD), Cédric Briançon (Geomatys)

See Also:

Serialized Form

Module:

metadata/geotk-metadata (download)

View source code for this class

Field Summary

Fields inherited from class MetadataEntity

identifiers

Fields inherited from class AbstractMetadata

LOGGER

Constructor Summary

AbstractIdentification()
Constructs an initially empty identification.

AbstractIdentification(Citation citation, InternationalString abstracts)
Creates an identification initialized to the specified values.

AbstractIdentification(Identification source)
Constructs a metadata entity initialized with the values from the specified metadata.

Method Summary

static AbstractIdentification	castOrCopy(Identification object) Returns a Geotk metadata implementation with the same values than the given arbitrary implementation.
InternationalString	getAbstract() Returns a brief narrative summary of the content of the resource(s).
Collection<AggregateInformation>	getAggregationInfo() Provides aggregate dataset information.
Citation	getCitation() Returns the citation data for the resource(s).
Collection<String>	getCredits() Returns the recognition of those who contributed to the resource(s).
Collection<Keywords>	getDescriptiveKeywords() Provides category keywords, their type, and reference source.
Collection<BrowseGraphic>	getGraphicOverviews() Provides a graphic that illustrates the resource(s) (should include a legend for the graphic).
Collection<ResponsibleParty>	getPointOfContacts() Returns the identification of, and means of communication with, person(s) and organizations(s) associated with the resource(s).
InternationalString	getPurpose() Returns a summary of the intentions with which the resource(s) was developed.
Collection<Constraints>	getResourceConstraints() Provides information about constraints which apply to the resource(s).
Collection<Format>	getResourceFormats() Provides a description of the format of the resource(s).
Collection<MaintenanceInformation>	getResourceMaintenances() Provides information about the frequency of resource updates, and the scope of those updates.
Collection<Usage>	getResourceSpecificUsages() Provides basic information about specific application(s) for which the resource(s) has/have been or is being used by different users.
Collection<Progress>	getStatus() Returns the status of the resource(s).
void	setAbstract(InternationalString newValue) Sets a brief narrative summary of the content of the resource(s).
void	setAggregationInfo(Collection<? extends AggregateInformation> newValues) Sets aggregate dataset information.
void	setCitation(Citation newValue) Sets the citation data for the resource(s).
void	setCredits(Collection<? extends String> newValues) Sets the recognition of those who contributed to the resource(s).
void	setDescriptiveKeywords(Collection<? extends Keywords> newValues) Sets category keywords, their type, and reference source.
void	setGraphicOverviews(Collection<? extends BrowseGraphic> newValues) Sets a graphic that illustrates the resource(s).
void	setPointOfContacts(Collection<? extends ResponsibleParty> newValues) Sets the point of contacts.
void	setPurpose(InternationalString newValue) Sets a summary of the intentions with which the resource(s) was developed.
void	setResourceConstraints(Collection<? extends Constraints> newValues) Sets information about constraints which apply to the resource(s).
void	setResourceFormats(Collection<? extends Format> newValues) Sets a description of the format of the resource(s).
void	setResourceMaintenances(Collection<? extends MaintenanceInformation> newValues) Sets information about the frequency of resource updates, and the scope of those updates.
void	setResourceSpecificUsages(Collection<? extends Usage> newValues) Sets basic information about specific application(s).
void	setStatus(Collection<? extends Progress> newValues) Sets the status of the resource(s).

Methods inherited from class MetadataEntity

getIdentifier, getIdentifierMap, getIdentifiers, getStandard

Methods inherited from class ModifiableMetadata

checkWritePermission, clone, collectionType, copyCollection, copyList, copySet, freeze, isModifiable, nonNullCollection, nonNullList, nonNullSet, prune, unmodifiable

Methods inherited from class AbstractMetadata

asMap, asTree, asTreeTable, equals, equals, getInterface, hashCode, isEmpty, parse, toString

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AbstractIdentification

public AbstractIdentification()

Constructs an initially empty identification.

AbstractIdentification

public AbstractIdentification(Identification source)

Constructs a metadata entity initialized with the values from the specified metadata.

Parameters:

source - The metadata to copy, or null if none.

Since:

2.4

AbstractIdentification

public AbstractIdentification(Citation citation,
                              InternationalString abstracts)

Creates an identification initialized to the specified values.

Parameters:

citation - The citation data for the resource(s).

abstracts - A brief narrative summary of the content of the resource(s).

Method Detail

castOrCopy

public static AbstractIdentification castOrCopy(Identification object)

Returns a Geotk metadata implementation with the same values than the given arbitrary implementation. If the given object is null, then this method returns null. Otherwise if the given object is already a Geotk implementation, then the given object is returned unchanged. Otherwise a new Geotk implementation is created and initialized to the attribute values of the given object, using a shallow copy operation (i.e. attributes are not cloned).

This method checks for the DataIdentification and ServiceIdentification sub-interfaces. If one of those interfaces is found, then this method delegates to the corresponding castOrCopy static method. If the given object implements more than one of the above-cited interfaces, then the castOrCopy method to be used is unspecified.

Parameters:

object - The object to get as a Geotk implementation, or null if none.

Returns:

A Geotk implementation containing the values of the given object (may be the given object itself), or null if the argument was null.

Since:

3.18

getCitation

public Citation getCitation()

Returns the citation data for the resource(s).

Specified by:

getCitation in interface Identification

setCitation

public void setCitation(Citation newValue)

Sets the citation data for the resource(s).

Parameters:

newValue - The new citation.

getAbstract

public InternationalString getAbstract()

Returns a brief narrative summary of the content of the resource(s).

Specified by:

getAbstract in interface Identification

setAbstract

public void setAbstract(InternationalString newValue)

Sets a brief narrative summary of the content of the resource(s).

Parameters:

newValue - The new abstract.

getPurpose

public InternationalString getPurpose()

Returns a summary of the intentions with which the resource(s) was developed.

Specified by:

getPurpose in interface Identification

setPurpose

public void setPurpose(InternationalString newValue)

Sets a summary of the intentions with which the resource(s) was developed.

Parameters:

newValue - The new purpose.

getCredits

public Collection<String> getCredits()

Returns the recognition of those who contributed to the resource(s).

Specified by:

getCredits in interface Identification

setCredits

public void setCredits(Collection<? extends String> newValues)

Sets the recognition of those who contributed to the resource(s).

Parameters:

newValues - The new credits.

getStatus

public Collection<Progress> getStatus()

Returns the status of the resource(s).

Specified by:

getStatus in interface Identification

setStatus

public void setStatus(Collection<? extends Progress> newValues)

Sets the status of the resource(s).

Parameters:

newValues - The new status.

getPointOfContacts

public Collection<ResponsibleParty> getPointOfContacts()

Returns the identification of, and means of communication with, person(s) and organizations(s) associated with the resource(s).

Specified by:

getPointOfContacts in interface Identification

setPointOfContacts

public void setPointOfContacts(Collection<? extends ResponsibleParty> newValues)

Sets the point of contacts.

Parameters:

newValues - The new points of contacts.

getResourceMaintenances

public Collection<MaintenanceInformation> getResourceMaintenances()

Provides information about the frequency of resource updates, and the scope of those updates.

Specified by:

getResourceMaintenances in interface Identification

setResourceMaintenances

public void setResourceMaintenances(Collection<? extends MaintenanceInformation> newValues)

Sets information about the frequency of resource updates, and the scope of those updates.

Parameters:

newValues - The new resource maintenance info.

getGraphicOverviews

public Collection<BrowseGraphic> getGraphicOverviews()

Provides a graphic that illustrates the resource(s) (should include a legend for the graphic).

Specified by:

getGraphicOverviews in interface Identification

setGraphicOverviews

public void setGraphicOverviews(Collection<? extends BrowseGraphic> newValues)

Sets a graphic that illustrates the resource(s).

Parameters:

newValues - The new graphics overviews.

getResourceFormats

public Collection<Format> getResourceFormats()

Provides a description of the format of the resource(s).

Specified by:

getResourceFormats in interface Identification

setResourceFormats

public void setResourceFormats(Collection<? extends Format> newValues)

Sets a description of the format of the resource(s).

Parameters:

newValues - The new resource format.

getDescriptiveKeywords

public Collection<Keywords> getDescriptiveKeywords()

Provides category keywords, their type, and reference source.

Specified by:

getDescriptiveKeywords in interface Identification

setDescriptiveKeywords

public void setDescriptiveKeywords(Collection<? extends Keywords> newValues)

Sets category keywords, their type, and reference source.

Parameters:

newValues - The new descriptive keywords.

getResourceSpecificUsages

public Collection<Usage> getResourceSpecificUsages()

Provides basic information about specific application(s) for which the resource(s) has/have been or is being used by different users.

Specified by:

getResourceSpecificUsages in interface Identification

setResourceSpecificUsages

public void setResourceSpecificUsages(Collection<? extends Usage> newValues)

Sets basic information about specific application(s).

Parameters:

newValues - The new resource specific usages.

getResourceConstraints

public Collection<Constraints> getResourceConstraints()

Provides information about constraints which apply to the resource(s).

Specified by:

getResourceConstraints in interface Identification

setResourceConstraints

public void setResourceConstraints(Collection<? extends Constraints> newValues)

Sets information about constraints which apply to the resource(s).

Parameters:

newValues - The new resource constraints.

getAggregationInfo

public Collection<AggregateInformation> getAggregationInfo()

Provides aggregate dataset information.

Specified by:

getAggregationInfo in interface Identification

Since:

2.4

setAggregationInfo

public void setAggregationInfo(Collection<? extends AggregateInformation> newValues)

Sets aggregate dataset information.

Parameters:

newValues - The new aggregation info.

Since:

2.4