001    //$HeadURL: svn+ssh://rbezema@svn.wald.intevation.org/deegree/base/branches/2.2_testing/src/org/deegree/graphics/sld/LayerFeatureConstraints.java $
002    /*----------------    FILE HEADER  ------------------------------------------
003    
004     This file is part of deegree.
005     Copyright (C) 2001-2008 by:
006     EXSE, Department of Geography, University of Bonn
007     http://www.giub.uni-bonn.de/deegree/
008     lat/lon GmbH
009     http://www.lat-lon.de
010    
011     This library is free software; you can redistribute it and/or
012     modify it under the terms of the GNU Lesser General Public
013     License as published by the Free Software Foundation; either
014     version 2.1 of the License, or (at your option) any later version.
015    
016     This library is distributed in the hope that it will be useful,
017     but WITHOUT ANY WARRANTY; without even the implied warranty of
018     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
019     Lesser General Public License for more details.
020    
021     You should have received a copy of the GNU Lesser General Public
022     License along with this library; if not, write to the Free Software
023     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
024    
025     Contact:
026    
027     Andreas Poth
028     lat/lon GmbH
029     Aennchenstr. 19
030     53115 Bonn
031     Germany
032     E-Mail: poth@lat-lon.de
033    
034     Prof. Dr. Klaus Greve
035     Department of Geography
036     University of Bonn
037     Meckenheimer Allee 166
038     53115 Bonn
039     Germany
040     E-Mail: greve@giub.uni-bonn.de
041    
042     
043     ---------------------------------------------------------------------------*/
044    package org.deegree.graphics.sld;
045    
046    import java.util.ArrayList;
047    import java.util.List;
048    
049    import org.deegree.framework.xml.Marshallable;
050    
051    /**
052     * The LayerFeatureConstraints element is optional in a NamedLayer and allows the user to specify
053     * constraints on what features of what feature types are to be selected by the named-layer
054     * reference. It is essentially a filter that allows the selection of fewer features than are
055     * present in the named layer.
056     * 
057     * 
058     * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
059     * @author last edited by: $Author: apoth $
060     * 
061     * @version. $Revision: 9340 $, $Date: 2007-12-27 13:32:12 +0100 (Do, 27 Dez 2007) $
062     */
063    public class LayerFeatureConstraints implements Marshallable {
064        private List<FeatureTypeConstraint> featureTypeConstraint = null;
065    
066        /**
067         * constructor initializing the class with the <LayerFeatureConstraints>
068         */
069        public LayerFeatureConstraints( FeatureTypeConstraint[] featureTypeConstraint ) {
070            this.featureTypeConstraint = new ArrayList<FeatureTypeConstraint>();
071            setFeatureTypeConstraint( featureTypeConstraint );
072        }
073    
074        /**
075         * A FeatureTypeConstraint element is used to identify a feature type by a well-known name,
076         * using the FeatureTypeName element.
077         * 
078         * @return the FeatureTypeConstraints as Array
079         * 
080         */
081        public FeatureTypeConstraint[] getFeatureTypeConstraint() {
082            return featureTypeConstraint.toArray( new FeatureTypeConstraint[featureTypeConstraint.size()] );
083        }
084    
085        /**
086         * sets the <FeatureTypeConstraint>
087         * 
088         * @param featureTypeConstraint
089         *            the <FeatureTypeConstraint>
090         */
091        public void setFeatureTypeConstraint( FeatureTypeConstraint[] featureTypeConstraint ) {
092            this.featureTypeConstraint.clear();
093    
094            if ( featureTypeConstraint != null ) {
095                for ( int i = 0; i < featureTypeConstraint.length; i++ ) {
096                    this.featureTypeConstraint.add( featureTypeConstraint[i] );
097                }
098            }
099        }
100    
101        /**
102         * adds the <FeatureTypeConstraint>
103         * 
104         * @param featureTypeConstraint
105         *            the <FeatureTypeConstraint>
106         */
107        public void addFeatureTypeConstraint( FeatureTypeConstraint featureTypeConstraint ) {
108            this.featureTypeConstraint.add( featureTypeConstraint );
109        }
110    
111        /**
112         * Removes a FeatureTypeConstraint.
113         * 
114         * @param featureTypeConstraint
115         *            the <FeatureTypeConstraint>
116         */
117        public void removeFeatureTypeConstraint( FeatureTypeConstraint featureTypeConstraint ) {
118            this.featureTypeConstraint.remove( this.featureTypeConstraint.indexOf( featureTypeConstraint ) );
119        }
120    
121        /**
122         * returns the LayerFeatureConstraints as String.
123         * 
124         * @return the LayerFeatureConstraints as String
125         */
126        public String toString() {
127            String ret = getClass().getName() + "\n";
128            ret = "featureTypeConstraint = " + featureTypeConstraint + "\n";
129    
130            return ret;
131        }
132    
133        /**
134         * exports the content of the Font as XML formated String
135         * 
136         * @return xml representation of the Font
137         */
138        public String exportAsXML() {
139    
140            StringBuffer sb = new StringBuffer( 1000 );
141            sb.append( "<LayerFeatureConstraints>" );
142            for ( int i = 0; i < featureTypeConstraint.size(); i++ ) {
143                sb.append( ( (Marshallable) featureTypeConstraint.get( i ) ).exportAsXML() );
144            }
145            sb.append( "</LayerFeatureConstraints>" );
146    
147            return sb.toString();
148        }
149    
150    }