Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
Implementations of metadata derived from ISO 19115. This module provides both an implementation
of the metadata interfaces defined in GeoAPI, and a framework for handling those metadata through
Java reflection.
/*
* Geotoolkit.org - An Open Source Java GIS Toolkit
* http://www.geotoolkit.org
*
* (C) 2004-2012, Open Source Geospatial Foundation (OSGeo)
* (C) 2009-2012, Geomatys
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* This package contains documentation from OpenGIS specifications.
* OpenGIS consortium's work is fully acknowledged here.
*/
package org.geotoolkit.metadata.iso.lineage;
import java.util.Collection;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;
import net.jcip.annotations.ThreadSafe;
import org.opengis.util.InternationalString;
import org.opengis.metadata.lineage.Source;
import org.opengis.metadata.lineage.Lineage;
import org.opengis.metadata.lineage.ProcessStep;
import org.opengis.metadata.maintenance.ScopeCode;
import org.geotoolkit.metadata.iso.MetadataEntity;
import org.geotoolkit.metadata.iso.quality.DefaultScope;
/**
* Information about the events or source data used in constructing the data specified by
* the scope or lack of knowledge about lineage.
*
* Only one of {@linkplain #getStatement statement}, {@linkplain #getProcessSteps process steps}
* and {@link #getSources sources} should be provided.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @author Touraïvane (IRD)
* @author Cédric Briançon (Geomatys)
* @version 3.19
*
* @since 2.1
* @module
*/
@ThreadSafe
@XmlType(name = "LI_Lineage_Type", propOrder={
"statement",
"processSteps",
"sources"
})
@XmlRootElement(name = "LI_Lineage")
public class DefaultLineage extends MetadataEntity implements Lineage {
/**
* Serial number for inter-operability with different versions.
*/
private static final long serialVersionUID = 3351230301999744987L;
/**
* General explanation of the data producer's knowledge about the lineage of a dataset.
* Should be provided only if {@linkplain DefaultScope#getLevel scope level} is
* {@linkplain ScopeCode#DATASET dataset} or {@linkplain ScopeCode#SERIES series}.
*/
private InternationalString statement;
/**
* Information about an event in the creation process for the data specified by the scope.
*/
private Collection processSteps;
/**
* Information about the source data used in creating the data specified by the scope.
*/
private Collection sources;
/**
* Constructs an initially empty lineage.
*/
public DefaultLineage() {
}
/**
* Constructs a metadata entity initialized with the values from the specified metadata.
*
* @param source The metadata to copy, or {@code null} if none.
*
* @since 2.4
*/
public DefaultLineage(final Lineage source) {
super(source);
}
/**
* Returns a Geotk metadata implementation with the same values than the given arbitrary
* implementation. If the given object is {@code null}, then this method returns {@code 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).
*
* @param object The object to get as a Geotk implementation, or {@code null} if none.
* @return A Geotk implementation containing the values of the given object (may be the
* given object itself), or {@code null} if the argument was null.
*
* @since 3.18
*/
public static DefaultLineage castOrCopy(final Lineage object) {
return (object == null) || (object instanceof DefaultLineage)
? (DefaultLineage) object : new DefaultLineage(object);
}
/**
* Returns the general explanation of the data producer's knowledge about the lineage
* of a dataset. Should be provided only if {@linkplain DefaultScope#getLevel scope level}
* is {@linkplain ScopeCode#DATASET dataset} or {@linkplain ScopeCode#SERIES series}.
*/
@Override
@XmlElement(name = "statement")
public synchronized InternationalString getStatement() {
return statement;
}
/**
* Sets the general explanation of the data producers knowledge about the lineage
* of a dataset.
*
* @param newValue The new statement.
*/
public synchronized void setStatement(final InternationalString newValue) {
checkWritePermission();
statement = newValue;
}
/**
* Returns the information about an event in the creation process for the data
* specified by the scope.
*/
@Override
@XmlElement(name = "processStep")
public synchronized Collection getProcessSteps() {
return processSteps = nonNullCollection(processSteps, ProcessStep.class);
}
/**
* Sets information about an event in the creation process for the data specified
* by the scope.
*
* @param newValues The new process steps.
*/
public synchronized void setProcessSteps(final Collection newValues) {
processSteps = copyCollection(newValues, processSteps, ProcessStep.class);
}
/**
* Returns information about the source data used in creating the data specified by the scope.
*/
@Override
@XmlElement(name = "source")
public synchronized Collection getSources() {
return sources = nonNullCollection(sources, Source.class);
}
/**
* Sets information about the source data used in creating the data specified by the scope.
*
* @param newValues The new sources.
*/
public synchronized void setSources(final Collection newValues) {
sources = copyCollection(newValues, sources, Source.class);
}
}
