public class DefaultFormat extends ISOMetadata implements Format
MD_Format
└─formatSpecificationCitation……
Citation/URL of the specification format.
├─title……………………………………………………
Name by which the cited resource is known.
└─date………………………………………………………
Reference date for the cited resource.Format
instance should contain a reference
to the format specification, for example "PNG (Portable Network Graphics) Specification".
The specification often has an abbreviation (for example "PNG") which can be stored as an
alternate title.
Apache SIS provides pre-defined metadata structures for some commonly-used formats.
A pre-defined format can be obtained by a call to
lookup(Format.class,
abbreviation)
where abbreviation can be one of the values listed below:
Abbreviation | Specification title |
---|---|
CSV | Common Format and MIME Type for Comma-Separated Values (CSV) Files |
GeoTIFF | GeoTIFF Coverage Encoding Profile |
NetCDF | NetCDF Classic and 64-bit Offset Format |
PNG | PNG (Portable Network Graphics) Specification |
Limitations:
XML
instead.Defined in the sis-metadata
module
identifiers
Constructor and Description |
---|
DefaultFormat()
Constructs an initially empty format.
|
DefaultFormat(CharSequence name,
CharSequence version)
Deprecated.
This constructor had a straightforward meaning in ISO 19115:2003, but became confusing
with the ISO 19115:2014 update because of differences in the
Format model.
Consider using MetadataSource.lookup(Class, String) instead. |
DefaultFormat(Format object)
Constructs a new instance initialized with the values from the specified metadata object.
|
Modifier and Type | Method and Description |
---|---|
static DefaultFormat |
castOrCopy(Format object)
Returns a SIS metadata implementation with the values of the given arbitrary implementation.
|
InternationalString |
getAmendmentNumber()
Returns the amendment number of the format version.
|
InternationalString |
getFileDecompressionTechnique()
Returns recommendations of algorithms or processes that can be applied to read or
expand resources to which compression techniques have been applied.
|
Collection<Distributor> |
getFormatDistributors()
Provides information about the distributor's format.
|
Citation |
getFormatSpecificationCitation()
Returns the citation / URL of the specification format.
|
Collection<Medium> |
getMedia()
Returns the media used by the format.
|
InternationalString |
getName()
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().getAlternateTitles() . Note that citation alternate titles are often used for abbreviations. |
InternationalString |
getSpecification()
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().getTitle() . |
InternationalString |
getVersion()
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().getEdition() . |
void |
setAmendmentNumber(InternationalString newValue)
Sets the amendment number of the format version.
|
void |
setFileDecompressionTechnique(InternationalString newValue)
Sets recommendations of algorithms or processes that can be applied to read or
expand resources to which compression techniques have been applied.
|
void |
setFormatDistributors(Collection<? extends Distributor> newValues)
Sets information about the distributor's format.
|
void |
setFormatSpecificationCitation(Citation newValue)
Sets the citation / URL of the specification format.
|
void |
setMedia(Collection<? extends Medium> newValues)
Sets the media used by the format.
|
void |
setName(InternationalString newValue)
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().setAlternateTitles(Collection) . |
void |
setSpecification(InternationalString newValue)
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().setTitle(InternationalString) . |
void |
setVersion(InternationalString newValue)
Deprecated.
As of ISO 19115:2014, replaced by
getFormatSpecificationCitation().setEdition(InternationalString) . |
freeze, getIdentifierMap, getIdentifiers, getStandard
checkWritePermission, clone, collectionType, copyCollection, copyList, copySet, isModifiable, nonNullCollection, nonNullList, nonNullSet, singleton, unmodifiable, writeCollection, writeList, writeSet
asMap, asTreeTable, equals, equals, getInterface, hashCode, isEmpty, prune, toString
public DefaultFormat()
@Deprecated public DefaultFormat(CharSequence name, CharSequence version)
Format
model.
Consider using MetadataSource.lookup(Class, String)
instead.name
- the abbreviated name of the data transfer format, or null
.version
- the version of the format (date, number, etc.), or null
.public DefaultFormat(Format object)
object
- the metadata to copy values from, or null
if none.castOrCopy(Format)
public static DefaultFormat castOrCopy(Format object)
null
, then this method returns null
.DefaultFormat
, then it is returned unchanged.DefaultFormat
instance is created using the
copy constructor
and returned. Note that this is a shallow copy operation, since the other
metadata contained in the given object are not recursively copied.object
- the object to get as a SIS implementation, or null
if none.null
if the argument was null.@UML(identifier="formatSpecificationCitation", obligation=MANDATORY, specification=ISO_19115) public Citation getFormatSpecificationCitation()
public void setFormatSpecificationCitation(Citation newValue)
newValue
- the new specification format.@Deprecated public InternationalString getSpecification()
getFormatSpecificationCitation().getTitle()
.getSpecification
in interface Format
null
.@Deprecated public void setSpecification(InternationalString newValue)
getFormatSpecificationCitation().setTitle(InternationalString)
.newValue
- the new specification.@Deprecated public InternationalString getName()
getFormatSpecificationCitation().getAlternateTitles()
. Note that citation alternate titles are often used for abbreviations.@Deprecated public void setName(InternationalString newValue)
getFormatSpecificationCitation().setAlternateTitles(Collection)
.newValue
- the new name.@Deprecated public InternationalString getVersion()
getFormatSpecificationCitation().getEdition()
.getVersion
in interface Format
null
.@Deprecated public void setVersion(InternationalString newValue)
getFormatSpecificationCitation().setEdition(InternationalString)
.newValue
- the new version.public InternationalString getAmendmentNumber()
getAmendmentNumber
in interface Format
null
.public void setAmendmentNumber(InternationalString newValue)
newValue
- the new amendment number.public InternationalString getFileDecompressionTechnique()
getFileDecompressionTechnique
in interface Format
null
.public void setFileDecompressionTechnique(InternationalString newValue)
newValue
- the new file decompression technique.@UML(identifier="medium", obligation=OPTIONAL, specification=ISO_19115) public Collection<Medium> getMedia()
public void setMedia(Collection<? extends Medium> newValues)
newValues
- the new media.public Collection<Distributor> getFormatDistributors()
getFormatDistributors
in interface Format
public void setFormatDistributors(Collection<? extends Distributor> newValues)
newValues
- the new format distributors.Copyright © 2010–2017 The Apache Software Foundation. All rights reserved.