001/*
002 *    GeoAPI - Java interfaces for OGC/ISO standards
003 *    Copyright © 2007-2024 Open Geospatial Consortium, Inc.
004 *    http://www.geoapi.org
005 *
006 *    Licensed under the Apache License, Version 2.0 (the "License");
007 *    you may not use this file except in compliance with the License.
008 *    You may obtain a copy of the License at
009 *
010 *        http://www.apache.org/licenses/LICENSE-2.0
011 *
012 *    Unless required by applicable law or agreed to in writing, software
013 *    distributed under the License is distributed on an "AS IS" BASIS,
014 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 *    See the License for the specific language governing permissions and
016 *    limitations under the License.
017 */
018package org.opengis.metadata.identification;
019
020import org.opengis.metadata.Identifier;
021import org.opengis.metadata.citation.Citation;
022import org.opengis.annotation.UML;
023
024import static org.opengis.annotation.Obligation.*;
025import static org.opengis.annotation.Specification.ISO_19115;
026
027
028/**
029 * Aggregate dataset information.
030 *
031 * @author  Ely Conn (Leica Geosystems Geospatial Imaging, LLC)
032 * @version 3.0
033 * @since   2.1
034 *
035 * @deprecated As of ISO 19115:2014, replaced by {@link AssociatedResource}.
036 */
037@Deprecated(since="3.1")
038@UML(identifier="MD_AggregateInformation", specification=ISO_19115, version=2003)
039public interface AggregateInformation extends AssociatedResource {
040    /**
041     * Citation information about the aggregate dataset.
042     *
043     * @return citation information about the aggregate dataset, or {@code null}.
044     *
045     * @condition {@linkplain #getAggregateDataSetIdentifier() Aggregate data set identifier} not provided.
046     *
047     * @deprecated As of ISO 19115:2014, replaced by {@link #getName()}.
048     */
049    @Deprecated(since="3.1")
050    @UML(identifier="aggregateDataSetName", obligation=CONDITIONAL, specification=ISO_19115, version=2003)
051    Citation getAggregateDataSetName();
052
053    /**
054     * Identification information about aggregate dataset.
055     *
056     * @return identification information about aggregate dataset, or {@code null}.
057     *
058     * @condition {@linkplain #getAggregateDataSetName() Aggregate data set name} not provided.
059     *
060     * @deprecated As of ISO 19115:2014, replaced by an identifier of {@link #getAggregateDataSetName()}.
061     */
062    @Deprecated(since="3.1")
063    @UML(identifier="aggregateDataSetIdentifier", obligation=CONDITIONAL, specification=ISO_19115, version=2003)
064    Identifier getAggregateDataSetIdentifier();
065}