public interface Resource
DataStore
. The ISO 19115 specification defines resource as
an “identifiable asset or means that fulfills a requirement”. For example a resource can be a
coverage of Sea Surface Temperature, or a coverage of water salinity, or the set of all buoys in a harbor,
or an aggregation of all the above. A resource is not necessarily digital; it can be a paper document or an
organization, in which case only metadata are provided. If the resource is digital, then Resource
s
should be instances of sub-types like Aggregate
or FeatureSet
.
DataStore
s are themselves closeable resources.
If the data store contains resources for many feature types or coverages, then the data store will be an
instance of Aggregate
. The components of an aggregate can be
themselves other aggregates, thus forming a tree.
DS_Resource
type defined by ISO 19115.
The Apache SIS type differs from the ISO type by being more closely related to data extraction,
as can been seen from the checked DataStoreException
thrown by most methods.
Convenience methods for frequently requested information – for example DataSet.getEnvelope()
– were added.
The sub-types performing the actual data extraction – for example FeatureSet
– are specific to Apache SIS.
Aggregate.components()
Defined in the sis-storage
module
Modifier and Type | Method and Description |
---|---|
Metadata |
getMetadata()
Returns information about this resource.
|
Metadata getMetadata() throws DataStoreException
Aggregate
, then the metadata may enumerate characteristics
(spatio-temporal extents, feature types, range dimensions, etc.) of all
components in the aggregate, or summarize them (for example by omitting
extents that are fully included in larger extents).
If this resource is a DataSet
, then the metadata shall contain only the information that apply to that
particular dataset, optionally with a reference to the parent metadata (see below).
Some relationships between metadata and resources are:
metadata
/
parentMetadata
/
title
:DataStore.getMetadata()
(if not redundant with this metadata).metadata
/
identificationInfo
/
citation
/
title
:metadata
/
identificationInfo
/
associatedResource
/
name
/
title
:metadata
/
metadataScope
/
resourceScope
:ScopeCode.DATASET
if the resource is a DataSet
, or
ScopeCode.SERVICE
if the resource is a web service, or
ScopeCode.SERIES
or
ScopeCode.INITIATIVE
if the resource is an Aggregate
other than a transfer aggregate.metadata
/
contentInfo
/
featureType
/
featureTypeName
:metadata
/
contentInfo
/
attributeGroup
/
attribute
/
sequenceIdentifier
:null
.DataStoreException
- if an error occurred while reading the metadata.DataStore.getMetadata()
Copyright © 2010–2017 The Apache Software Foundation. All rights reserved.