001/*
002 *    GeoAPI - Java interfaces for OGC/ISO standards
003 *    Copyright © 2004-2023 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.constraint;
019
020import java.util.Collection;
021import java.util.Collections;
022import org.opengis.util.InternationalString;
023import org.opengis.annotation.UML;
024
025import static org.opengis.annotation.Obligation.*;
026import static org.opengis.annotation.Specification.*;
027
028
029/**
030 * Restrictions and legal prerequisites for accessing and using the resource.
031 *
032 * <p><b>Conditional properties:</b></p>
033 * All methods in this interface have default methods. But despite that, at least one of
034 * {@linkplain #getAccessConstraints() access constraints},
035 * {@linkplain #getUseConstraints() use constraints},
036 * {@linkplain #getUseLimitations() use limitations},
037 * {@linkplain #getOtherConstraints() other constraints} and
038 * {@linkplain #getReleasability() releasibility} shall be provided.
039 *
040 * @author  Martin Desruisseaux (IRD)
041 * @author  Cory Horner (Refractions Research)
042 * @version 3.1
043 * @since   2.0
044 */
045@UML(identifier="MD_LegalConstraints", specification=ISO_19115)
046public interface LegalConstraints extends Constraints {
047    /**
048     * Access constraints applied to assure the protection of privacy or intellectual property,
049     * and any special restrictions or limitations on obtaining the resource or metadata.
050     *
051     * @return access constraints applied to assure the protection of privacy or intellectual property.
052     *
053     * @condition Mandatory if
054     * {@linkplain #getUseConstraints() use constraints},
055     * {@linkplain #getOtherConstraints() other constraints},
056     * {@linkplain #getUseLimitations() use limitations} and
057     * {@linkplain #getReleasability() releasibility} are null or empty.
058     */
059    @UML(identifier="accessConstraints", obligation=CONDITIONAL, specification=ISO_19115)
060    default Collection<Restriction> getAccessConstraints() {
061        return Collections.emptyList();
062    }
063
064    /**
065     * Constraints applied to assure the protection of privacy or intellectual property, and any
066     * special restrictions or limitations or warnings on using the resource or metadata.
067     *
068     * @return constraints applied to assure the protection of privacy or intellectual property.
069     *
070     * @condition Mandatory if
071     * {@linkplain #getAccessConstraints() access constraints},
072     * {@linkplain #getOtherConstraints() other constraints},
073     * {@linkplain #getUseLimitations() use limitations} and
074     * {@linkplain #getReleasability() releasibility} are null or empty.
075     */
076    @UML(identifier="useConstraints", obligation=CONDITIONAL, specification=ISO_19115)
077    default Collection<Restriction> getUseConstraints() {
078        return Collections.emptyList();
079    }
080
081    /**
082     * Other restrictions and legal prerequisites for accessing and using the resource or metadata.
083     *
084     * @return other restrictions and legal prerequisites for accessing and using the resource.
085     *
086     * @condition Mandatory if the {@linkplain #getAccessConstraints() access constraints} or
087     *            {@linkplain #getUseConstraints() use constraints} contain {@link Restriction#OTHER_RESTRICTIONS}.
088     */
089    @UML(identifier="otherConstraints", obligation=CONDITIONAL, specification=ISO_19115)
090    default Collection<? extends InternationalString> getOtherConstraints() {
091        return Collections.emptyList();
092    }
093}