blob: add3b230d9379a43b44ecd07abed8fe6743a9167 [file] [log] [blame]
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Information about the sources and production processes of a dataset.
* An explanation for this package is provided in the {@linkplain org.opengis.metadata.lineage OpenGIS® javadoc}.
* The remaining discussion on this page is specific to the SIS implementation.
*
* <div class="section">Overview</div>
* For a global overview of metadata in SIS, see the {@link org.apache.sis.metadata} package javadoc.
*
* <table class="sis">
* <caption>Package overview</caption>
* <tr>
* <th>Class hierarchy</th>
* <th class="sep">Aggregation hierarchy</th>
* </tr><tr><td style="width: 50%; white-space: nowrap">
* {@linkplain org.apache.sis.metadata.iso.ISOMetadata ISO 19115 metadata}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultLineage Lineage}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessStep Process step}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultSource Source}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultNominalResolution Nominal resolution}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessing Processing}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultAlgorithm Algorithm}<br>
* {@code  └─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessStepReport Process step report}<br>
* </td><td class="sep" style="width: 50%; white-space: nowrap">
* {@linkplain org.apache.sis.metadata.iso.lineage.DefaultLineage Lineage}<br>
* {@code  ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultSource Source}<br>
* {@code  │   └─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultNominalResolution Nominal resolution}<br>
* {@code  └─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessStep Process step}<br>
* {@code      ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultSource Source}<br>
* {@code      ├─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessing Processing}<br>
* {@code      │   └─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultAlgorithm Algorithm}<br>
* {@code      └─} {@linkplain org.apache.sis.metadata.iso.lineage.DefaultProcessStepReport Process step report}<br>
* </td></tr></table>
*
* <div class="section">Null values, nil objects and collections</div>
* All constructors and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
*
* <p>Unless otherwise noted in the Javadoc, all getter methods may return an empty collection,
* an empty array or {@code null} if the type is neither a collection or an array.
* Note that non-null values may be {@link org.apache.sis.xml.NilObject}s.</p>
*
* <p>Unless the metadata object has been marked as unmodifiable and unless otherwise noted in the Javadoc,
* all collections returned by getter methods are <cite>live</cite>: adding new elements in the collection
* modify directly the underlying metadata object.</p>
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @author Touraïvane (IRD)
* @author Cédric Briançon (Geomatys)
* @author Cullen Rombach (Image Matters)
* @version 1.0
* @since 0.3
* @module
*/
@XmlSchema(location="http://standards.iso.org/iso/19115/-3/mrl/1.0/mrl.xsd",
elementFormDefault=XmlNsForm.QUALIFIED, namespace=Namespaces.MRL,
xmlns = {
@XmlNs(prefix = "mrl", namespaceURI = Namespaces.MRL), // Metadata for Resource Lineage
@XmlNs(prefix = "mcc", namespaceURI = Namespaces.MCC), // Metadata Common Classes
@XmlNs(prefix = "gmd", namespaceURI = LegacyNamespaces.GMD)
})
@XmlAccessorType(XmlAccessType.NONE)
@XmlJavaTypeAdapters({
@XmlJavaTypeAdapter(CI_Citation.class),
@XmlJavaTypeAdapter(CI_ResponsibleParty.class),
@XmlJavaTypeAdapter(EX_Extent.class),
@XmlJavaTypeAdapter(GO_Real.class),
@XmlJavaTypeAdapter(GO_DateTime.class),
@XmlJavaTypeAdapter(LE_Algorithm.class),
@XmlJavaTypeAdapter(LE_NominalResolution.class),
@XmlJavaTypeAdapter(LE_Processing.class),
@XmlJavaTypeAdapter(LE_ProcessStepReport.class),
@XmlJavaTypeAdapter(LI_ProcessStep.class),
@XmlJavaTypeAdapter(LI_Source.class),
@XmlJavaTypeAdapter(MD_Identifier.class),
@XmlJavaTypeAdapter(MD_RepresentativeFraction.class),
// Java types, primitive types and basic OGC types handling
@XmlJavaTypeAdapter(InternationalStringAdapter.class)
})
package org.apache.sis.metadata.iso.lineage;
import javax.xml.bind.annotation.XmlNs;
import javax.xml.bind.annotation.XmlNsForm;
import javax.xml.bind.annotation.XmlSchema;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapters;
import org.apache.sis.xml.Namespaces;
import org.apache.sis.internal.xml.LegacyNamespaces;
import org.apache.sis.internal.jaxb.gco.*;
import org.apache.sis.internal.jaxb.metadata.*;