Class AbstractIdentification
Object
AbstractMetadata
ModifiableMetadata
ISOMetadata
AbstractIdentification
- All Implemented Interfaces:
- Serializable,- Emptiable,- LenientComparable,- IdentifiedObject,- Identification
- Direct Known Subclasses:
- DefaultDataIdentification,- DefaultServiceIdentification
Basic information required to uniquely identify a resource or resources.
 The following properties are mandatory or conditional (i.e. mandatory under some circumstances)
 in a well-formed metadata according ISO 19115:
 
 
MD_Identification
   ├─citation……………………………………… Citation data for the resource(s).
   │   ├─title…………………………………… Name by which the cited resource is known.
   │   └─date……………………………………… Reference date for the cited resource.
   ├─abstract……………………………………… Brief narrative summary of the content of the resource(s).
   ├─extent…………………………………………… Bounding polygon, vertical, and temporal extent of the dataset.
   │   ├─description…………………… The spatial and temporal extent for the referring object.
   │   ├─geographicElement…… Geographic component of the extent of the referring object.
   │   ├─temporalElement………… Temporal component of the extent of the referring object.
   │   └─verticalElement………… Vertical component of the extent of the referring object.
   └─topicCategory………………………… Main theme(s) of the dataset.Limitations
- Instances of this class are not synchronized for multi-threading. Synchronization, if needed, is caller's responsibility.
- Serialized objects of this class are not guaranteed to be compatible with future Apache SIS releases.
       Serialization support is appropriate for short term storage or RMI between applications running the
       same version of Apache SIS. For long term storage, use XMLinstead.
- Since:
- 0.3
- See Also:
Defined in the sis-metadata module
- 
Nested Class SummaryNested classes/interfaces inherited from class ModifiableMetadataModifiableMetadata.State
- 
Field SummaryFields inherited from class ISOMetadataidentifiers
- 
Constructor SummaryConstructorsConstructorDescriptionConstructs an initially empty identification.AbstractIdentification(Citation citation, CharSequence abstracts) Creates an identification initialized to the specified values.Constructs a new instance initialized with the values from the specified metadata object.
- 
Method SummaryModifier and TypeMethodDescriptionstatic AbstractIdentificationcastOrCopy(Identification object) Returns a SIS metadata implementation with the values of the given arbitrary implementation.Returns a brief narrative summary of the resource(s).Returns other documentation associated with the resource.Deprecated.Provides associated resource information.Returns the citation for the resource(s).Returns the recognition of those who contributed to the resource(s).Provides category keywords, their type, and reference source.Returns the spatial and temporal extent of the resource.Provides a graphic that illustrates the resource(s) (should include a legend for the graphic).Returns the identification of, and means of communication with, person(s) and organizations(s) associated with the resource(s).Returns code(s) that identifies the level of processing in the producers coding system of a resource.Returns a summary of the intentions with which the resource(s) was developed.Provides information about constraints which apply to the resource(s).Provides a description of the format of the resource(s).Provides information about the frequency of resource updates, and the scope of those updates.Provides basic information about specific application(s) for which the resource(s) has/have been or is being used by different users.Returns the methods used to spatially represent geographic information.Returns the factor which provides a general understanding of the density of spatial data in the resource(s).Returns the status of the resource(s).Returns the main theme(s) of the resource.voidsetAbstract(InternationalString newValue) Sets a brief narrative summary of the resource(s).voidsetAdditionalDocumentations(Collection<? extends Citation> newValues) Sets other documentation associated with the resource.voidsetAggregationInfo(Collection<? extends AggregateInformation> newValues) Deprecated.As of ISO 19115:2014, replaced bysetAssociatedResources(Collection).voidsetAssociatedResources(Collection<? extends DefaultAssociatedResource> newValues) Sets associated resource information.voidsetCitation(Citation newValue) Sets the citation for the resource(s).voidsetCredits(Collection<? extends String> newValues) Sets the recognition of those who contributed to the resource(s).voidsetDescriptiveKeywords(Collection<? extends Keywords> newValues) Sets category keywords, their type, and reference source.voidsetExtents(Collection<? extends Extent> newValues) Sets the spatial and temporal extent of the resource.voidsetGraphicOverviews(Collection<? extends BrowseGraphic> newValues) Sets a graphic that illustrates the resource(s).voidsetPointOfContacts(Collection<? extends ResponsibleParty> newValues) Sets the means of communication with persons(s) and organizations(s) associated with the resource(s).voidsetProcessingLevel(Identifier newValue) Sets code that identifies the level of processing in the producers coding system of a resource.voidsetPurpose(InternationalString newValue) Sets a summary of the intentions with which the resource(s) was developed.voidsetResourceConstraints(Collection<? extends Constraints> newValues) Sets information about constraints which apply to the resource(s).voidsetResourceFormats(Collection<? extends Format> newValues) Sets a description of the format of the resource(s).voidsetResourceMaintenances(Collection<? extends MaintenanceInformation> newValues) Sets information about the frequency of resource updates, and the scope of those updates.voidsetResourceSpecificUsages(Collection<? extends Usage> newValues) Sets basic information about specific application(s).voidsetSpatialRepresentationTypes(Collection<? extends SpatialRepresentationType> newValues) Sets the method used to spatially represent geographic information.voidsetSpatialResolutions(Collection<? extends Resolution> newValues) Sets the factor which provides a general understanding of the density of spatial data in the resource(s).voidsetStatus(Collection<? extends Progress> newValues) Sets the status of the resource(s).voidsetTopicCategories(Collection<? extends TopicCategory> newValues) Sets the main theme(s) of the resource.Methods inherited from class ISOMetadatagetIdentifier, getIdentifierMap, getIdentifiers, getStandard, setIdentifier, transitionToMethods inherited from class ModifiableMetadatacheckWritePermission, collectionType, copyCollection, copyList, copyMap, copySet, deepCopy, nonNullCollection, nonNullList, nonNullMap, nonNullSet, singleton, state, writeCollection, writeList, writeMap, writeSetMethods inherited from class AbstractMetadataasMap, asTreeTable, equals, equals, getInterface, hashCode, isEmpty, prune, toString
- 
Constructor Details- 
AbstractIdentificationpublic AbstractIdentification()Constructs an initially empty identification.
- 
AbstractIdentificationCreates an identification initialized to the specified values.- Parameters:
- citation- the citation data for the resource(s), or- nullif none.
- abstracts- a brief narrative summary of the content of the resource(s), or- nullif none.
 
- 
AbstractIdentificationConstructs a new instance initialized with the values from the specified metadata object. This is a shallow copy constructor, because the other metadata contained in the given object are not recursively copied.- Parameters:
- object- the metadata to copy values from, or- nullif none.
- See Also:
 
 
- 
- 
Method Details- 
castOrCopyReturns a SIS metadata implementation with the values of the given arbitrary implementation. This method performs the first applicable action in the following choices:- If the given object is null, then this method returnsnull.
- Otherwise if the given object is an instance of DataIdentificationorServiceIdentification, then this method delegates to thecastOrCopy(…)method of the corresponding SIS subclass. Note that if the given object implements more than one of the above-cited interfaces, then thecastOrCopy(…)method to be used is unspecified.
- Otherwise if the given object is already an instance of
       AbstractIdentification, then it is returned unchanged.
- Otherwise a new AbstractIdentificationinstance is created using the copy constructor and returned. Note that this is a shallow copy operation, because the other metadata contained in the given object are not recursively copied.
 - Parameters:
- object- the object to get as a SIS implementation, or- nullif none.
- Returns:
- a SIS implementation containing the values of the given object (may be the
         given object itself), or nullif the argument was null.
 
- If the given object is 
- 
getCitationReturns the citation for the resource(s).- Specified by:
- getCitationin interface- Identification
- Returns:
- citation for the resource(s).
 
- 
setCitationSets the citation for the resource(s).- Parameters:
- newValue- the new citation.
 
- 
getAbstractReturns a brief narrative summary of the resource(s).- Specified by:
- getAbstractin interface- Identification
- Returns:
- brief narrative summary of the resource(s).
 
- 
setAbstractSets a brief narrative summary of the resource(s).- Parameters:
- newValue- the new summary of resource(s).
 
- 
getPurposeReturns a summary of the intentions with which the resource(s) was developed.- Specified by:
- getPurposein interface- Identification
- Returns:
- the intentions with which the resource(s) was developed, or null.
 
- 
setPurposeSets a summary of the intentions with which the resource(s) was developed.- Parameters:
- newValue- the new summary of intention.
 
- 
getCreditsReturns the recognition of those who contributed to the resource(s).Upcoming API change — generalization
 The element type may be changed to theInternationalStringinterface in GeoAPI 4.0.- Specified by:
- getCreditsin interface- Identification
- Returns:
- recognition of those who contributed to the resource(s).
 
- 
setCreditsSets the recognition of those who contributed to the resource(s).Upcoming API change — generalization
 The element type may be changed to theInternationalStringinterface in GeoAPI 4.0.- Parameters:
- newValues- the new credits.
 
- 
getStatusReturns the status of the resource(s).- Specified by:
- getStatusin interface- Identification
- Returns:
- status of the resource(s), or null.
 
- 
setStatusSets the status of the resource(s).- Parameters:
- newValues- the new status.
 
- 
getPointOfContactsReturns the identification of, and means of communication with, person(s) and organizations(s) associated with the resource(s).Upcoming API change — generalization
 As of ISO 19115:2014,ResponsiblePartyis replaced by theResponsibilityparent interface. This change may be applied in GeoAPI 4.0.- Specified by:
- getPointOfContactsin interface- Identification
- Returns:
- means of communication with person(s) and organizations(s) associated with the resource(s).
- See Also:
 
- 
setPointOfContactsSets the means of communication with persons(s) and organizations(s) associated with the resource(s).Upcoming API change — generalization
 As of ISO 19115:2014,ResponsiblePartyis replaced by theResponsibilityparent interface. This change may be applied in GeoAPI 4.0.- Parameters:
- newValues- the new points of contacts.
 
- 
getSpatialRepresentationTypes@UML(identifier="spatialRepresentationType", obligation=OPTIONAL, specification=ISO_19115) public Collection<SpatialRepresentationType> getSpatialRepresentationTypes()Returns the methods used to spatially represent geographic information.- Returns:
- methods used to spatially represent geographic information.
- Since:
- 0.5
 
- 
setSpatialRepresentationTypespublic void setSpatialRepresentationTypes(Collection<? extends SpatialRepresentationType> newValues) Sets the method used to spatially represent geographic information.- Parameters:
- newValues- the new spatial representation types.
- Since:
- 0.5
 
- 
getSpatialResolutions@UML(identifier="spatialResolution", obligation=OPTIONAL, specification=ISO_19115) public Collection<Resolution> getSpatialResolutions()Returns the factor which provides a general understanding of the density of spatial data in the resource(s). This element should be repeated when describing upper and lower range.- Returns:
- factor which provides a general understanding of the density of spatial data.
- Since:
- 0.5
 
- 
setSpatialResolutionsSets the factor which provides a general understanding of the density of spatial data in the resource(s).- Parameters:
- newValues- the new spatial resolutions.
- Since:
- 0.5
 
- 
getTopicCategories@UML(identifier="topicCategory", obligation=CONDITIONAL, specification=ISO_19115) public Collection<TopicCategory> getTopicCategories()Returns the main theme(s) of the resource.- Returns:
- main theme(s).
- Since:
- 0.5
 
- 
setTopicCategoriesSets the main theme(s) of the resource.- Parameters:
- newValues- the new topic categories.
- Since:
- 0.5
 
- 
getExtents@UML(identifier="extent", obligation=CONDITIONAL, specification=ISO_19115) public Collection<Extent> getExtents()Returns the spatial and temporal extent of the resource.- Returns:
- spatial and temporal extent of the resource.
- Since:
- 0.5
 
- 
setExtentsSets the spatial and temporal extent of the resource.- Parameters:
- newValues- the new extents
- Since:
- 0.5
 
- 
getAdditionalDocumentations@UML(identifier="additionalDocumentation", obligation=OPTIONAL, specification=ISO_19115) public Collection<Citation> getAdditionalDocumentations()Returns other documentation associated with the resource.- Returns:
- other documentation associated with the resource.
- Since:
- 0.5
 
- 
setAdditionalDocumentationsSets other documentation associated with the resource.- Parameters:
- newValues- the documentation to associate with the resource.
- Since:
- 0.5
 
- 
getProcessingLevel@UML(identifier="processingLevel", obligation=OPTIONAL, specification=ISO_19115) public Identifier getProcessingLevel()Returns code(s) that identifies the level of processing in the producers coding system of a resource.- Returns:
- code(s) that identifies the level of processing in the producers coding system of a resource.
- Since:
- 0.5
 
- 
setProcessingLevelSets code that identifies the level of processing in the producers coding system of a resource.- Parameters:
- newValue- New code that identifies the level of processing.
- Since:
- 0.5
 
- 
getResourceMaintenancesProvides information about the frequency of resource updates, and the scope of those updates.- Specified by:
- getResourceMaintenancesin interface- Identification
- Returns:
- frequency and scope of resource updates.
 
- 
setResourceMaintenancesSets information about the frequency of resource updates, and the scope of those updates.- Parameters:
- newValues- the new resource maintenance info.
 
- 
getGraphicOverviewsProvides a graphic that illustrates the resource(s) (should include a legend for the graphic).- Specified by:
- getGraphicOverviewsin interface- Identification
- Returns:
- a graphic that illustrates the resource(s).
 
- 
setGraphicOverviewsSets a graphic that illustrates the resource(s).- Parameters:
- newValues- the new graphics overviews.
 
- 
getResourceFormatsProvides a description of the format of the resource(s).- Specified by:
- getResourceFormatsin interface- Identification
- Returns:
- description of the format.
- See Also:
 
- 
setResourceFormatsSets a description of the format of the resource(s).- Parameters:
- newValues- the new resource format.
- See Also:
 
- 
getDescriptiveKeywordsProvides category keywords, their type, and reference source.- Specified by:
- getDescriptiveKeywordsin interface- Identification
- Returns:
- category keywords, their type, and reference source.
 
- 
setDescriptiveKeywordsSets category keywords, their type, and reference source.- Parameters:
- newValues- the new descriptive keywords.
 
- 
getResourceSpecificUsagesProvides basic information about specific application(s) for which the resource(s) has/have been or is being used by different users.- Specified by:
- getResourceSpecificUsagesin interface- Identification
- Returns:
- information about specific application(s) for which the resource(s) has/have been or is being used.
 
- 
setResourceSpecificUsagesSets basic information about specific application(s).- Parameters:
- newValues- the new resource specific usages.
 
- 
getResourceConstraintsProvides information about constraints which apply to the resource(s).- Specified by:
- getResourceConstraintsin interface- Identification
- Returns:
- constraints which apply to the resource(s).
 
- 
setResourceConstraintsSets information about constraints which apply to the resource(s).- Parameters:
- newValues- the new resource constraints.
 
- 
getAssociatedResources@UML(identifier="associatedResource", obligation=OPTIONAL, specification=ISO_19115) public Collection<DefaultAssociatedResource> getAssociatedResources()Provides associated resource information.Upcoming API change — generalization
 The element type will be changed to theAssociatedResourceinterface when GeoAPI will provide it (tentatively in GeoAPI 3.1).- Returns:
- associated resource information.
- Since:
- 0.5
 
- 
setAssociatedResourcesSets associated resource information.Upcoming API change — generalization
 The element type will be changed to theAssociatedResourceinterface when GeoAPI will provide it (tentatively in GeoAPI 3.1).- Parameters:
- newValues- the new associated resources.
- Since:
- 0.5
 
- 
getAggregationInfoDeprecated.As of ISO 19115:2014, replaced bygetAssociatedResources().Provides aggregate dataset information.- Specified by:
- getAggregationInfoin interface- Identification
- Returns:
- aggregate dataset information.
 
- 
setAggregationInfoDeprecated.As of ISO 19115:2014, replaced bysetAssociatedResources(Collection).Sets aggregate dataset information.- Parameters:
- newValues- the new aggregation info.
 
 
- 
getAssociatedResources().