001    /*
002     *    GeoAPI - Java interfaces for OGC/ISO standards
003     *    http://www.geoapi.org
004     *
005     *    Copyright (C) 2004-2012 Open Geospatial Consortium, Inc.
006     *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal
007     *
008     *    Permission to use, copy, and modify this software and its documentation, with
009     *    or without modification, for any purpose and without fee or royalty is hereby
010     *    granted, provided that you include the following on ALL copies of the software
011     *    and documentation or portions thereof, including modifications, that you make:
012     *
013     *    1. The full text of this NOTICE in a location viewable to users of the
014     *       redistributed or derivative work.
015     *    2. Notice of any changes or modifications to the OGC files, including the
016     *       date changes were made.
017     *
018     *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
019     *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
020     *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
021     *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
022     *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
023     *
024     *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
025     *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
026     *
027     *    The name and trademarks of copyright holders may NOT be used in advertising or
028     *    publicity pertaining to the software without specific, written prior permission.
029     *    Title to copyright in this software and any associated documentation will at all
030     *    times remain with copyright holders.
031     */
032    package org.opengis.geometry.primitive;
033    
034    import org.opengis.annotation.UML;
035    
036    import static org.opengis.annotation.Obligation.*;
037    import static org.opengis.annotation.Specification.*;
038    
039    
040    /**
041     * The boundary of {@linkplain Solid solids}. Solid boundaries are similar to
042     * {@linkplain SurfaceBoundary surface boundaries}. In normal 3-dimensional Euclidean
043     * space, one {@linkplain Shell shell} is distinguished as the exterior. In the more
044     * general case, this is not always possible.
045     *
046     * <blockquote><font size=2>
047     * <strong>NOTE:</strong> An alternative use of solids with no external shell would be to define
048     * "complements" of finite solids. These infinite solids would have only interior boundaries. If
049     * this specification is extended to 4D Euclidean space, or if 3D compact manifolds are used
050     * (probably not in geographic information), then other examples of bounded solids without exterior
051     * boundaries are possible.
052     * </font></blockquote>
053     *
054     * @version <A HREF="http://www.opengeospatial.org/standards/as">ISO 19107</A>
055     * @author Martin Desruisseaux (IRD)
056     * @since GeoAPI 1.0
057     *
058     * @see SurfaceBoundary
059     */
060    @UML(identifier="GM_SolidBoundary", specification=ISO_19107)
061    public interface SolidBoundary extends PrimitiveBoundary {
062        /**
063         * Returns the exterior shell, or {@code null} if none.
064         *
065         * @return The exterior shell, or {@code null}.
066         */
067        @UML(identifier="exterior", obligation=MANDATORY, specification=ISO_19107)
068        Shell getExterior();
069    
070        /**
071         * Returns the interior shells.
072         *
073         * @return The interior shells. Never {@code null}, but may be an empty array.
074         */
075        @UML(identifier="interior", obligation=MANDATORY, specification=ISO_19107)
076        Shell[] getInteriors();
077    }