001    /*
002     *    GeoAPI - Java interfaces for OGC/ISO standards
003     *    http://www.geoapi.org
004     *
005     *    Copyright (C) 2008-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.sld;
033    
034    import java.util.List;
035    import org.opengis.annotation.Extension;
036    import org.opengis.annotation.XmlElement;
037    import org.opengis.style.Style;
038    
039    
040    /**
041     * Since a layer is defined as a collection of potentially mixed-type features, the UserLayer
042     * element must provide the means to identify the features to be used. 
043     * 
044     * @version <A HREF="http://www.opengeospatial.org/standards/sld">Implementation specification 1.1.0</A>
045     * @author Open Geospatial Consortium
046     * @author Johann Sorel (Geomatys)
047     * @since GeoAPI 2.2
048     */
049    @XmlElement("UserLayer")
050    public interface UserLayer extends Layer{
051    
052        /**
053         * All features to be rendered are assumed to be fetched from a Web Feature Server (WFS) or a Web
054         * Coverage Service (WCS, in which case the term “features” is used loosely). Alternatively
055         * they can be supplied in-line in the SLD document. This alternative is only recommended
056         * for small numbers of features of transient nature.
057         * 
058         * @return InlineFeature or RemoteOWS
059         */
060        @XmlElement("InlineFeature,RemoteOWS")
061        public Source getSource();
062    
063        /**
064         * Constraints to apply on the features.
065         * 
066         * @return LayerFeatureConstraints or LayerCoverageConstraints
067         */
068        @XmlElement("LayerFeatureConstraints,LayerCoverageConstraints")
069        public Constraints getConstraints();
070    
071        /**
072         * Styles to apply on the features.
073         */
074        @XmlElement("UserStyle")
075        public List<? extends Style> styles();
076        
077        /**
078         * calls the visit method of a SLDVisitor
079         *
080         * @param visitor the sld visitor
081         */
082        @Extension
083        Object accept(SLDVisitor visitor, Object extraData);
084    
085    }