/[schmitzm]/trunk/src/skrueger/geotools/StyledLayerUtil.java
ViewVC logotype

Diff of /trunk/src/skrueger/geotools/StyledLayerUtil.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/src/skrueger/geotools/StyledMapUtil.java revision 111 by alfonx, Tue May 12 23:33:14 2009 UTC trunk/src/skrueger/geotools/StyledLayerUtil.java revision 788 by alfonx, Tue Apr 6 12:18:52 2010 UTC
# Line 1  Line 1 
1  package skrueger.geotools;  /*******************************************************************************
2     * Copyright (c) 2009 Martin O. J. Schmitz.
3  import java.text.DecimalFormat;   *
4  import java.util.Map;   * This file is part of the SCHMITZM library - a collection of utility
5  import java.util.HashMap;   * classes based on Java 1.6, focusing (not only) on Java Swing
6  import java.util.List;   * and the Geotools library.
7  import java.util.SortedMap;   *
8  import java.util.TreeMap;   * The SCHMITZM project is hosted at:
9  import java.net.URL;   * http://wald.intevation.org/projects/schmitzm/
10     *
11  import org.geotools.feature.FeatureCollection;   * This program is free software; you can redistribute it and/or
12  import org.geotools.map.MapLayer;   * modify it under the terms of the GNU Lesser General Public License
13  import org.geotools.map.DefaultMapLayer;   * as published by the Free Software Foundation; either version 3
14  import org.geotools.coverage.grid.GridCoverage2D;   * of the License, or (at your option) any later version.
15  import org.geotools.coverage.grid.io.AbstractGridCoverage2DReader;   *
16  import org.geotools.data.FeatureSource;   * This program is distributed in the hope that it will be useful,
17  import org.geotools.styling.ColorMap;   * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  import org.geotools.styling.ColorMapEntry;   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  import org.geotools.styling.Style;   * GNU General Public License for more details.
20     *
21  import org.apache.log4j.Logger;   * You should have received a copy of the GNU Lesser General Public License (license.txt)
22     * along with this program; if not, write to the Free Software
23  import org.jdom.Element;   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
24  import org.jdom.Document;   * or try this link: http://www.gnu.org/licenses/lgpl.html
25  import org.jdom.input.SAXBuilder;   *
26  import org.jdom.output.XMLOutputter;   * Contributors:
27     *     Martin O. J. Schmitz - initial API and implementation
28  import schmitzm.geotools.styling.StylingUtil;   *     Stefan A. Krüger - additional utility classes
29  import skrueger.AttributeMetaData;   ******************************************************************************/
30  import skrueger.RasterLegendData;  package skrueger.geotools;
31  import skrueger.i8n.Translation;  
32  import schmitzm.io.IOUtil;  import java.awt.Color;
33  import java.io.File;  import java.awt.Dimension;
34  import java.io.FileNotFoundException;  import java.awt.Graphics2D;
35  import schmitzm.lang.LangUtil;  import java.awt.Rectangle;
36  import schmitzm.swing.SwingUtil;  import java.awt.geom.AffineTransform;
37    import java.awt.image.BufferedImage;
38  import java.io.FileWriter;  import java.awt.image.ColorModel;
39    import java.awt.image.ComponentColorModel;
40  /**  import java.awt.image.DataBuffer;
41   * This class provides static helper methods for dealing with  import java.io.File;
42   * {@link StyledMapInterface} stuff.  import java.io.FileNotFoundException;
43   * @author <a href="mailto:[email protected]">Martin Schmitz</a> (University of Bonn/Germany)  import java.io.FileWriter;
44   * @version 1.0  import java.net.URL;
45   */  import java.text.DecimalFormat;
46  public class StyledMapUtil {  import java.util.ArrayList;
47    private static final Logger LOGGER = Logger.getLogger(StyledMapUtil.class.getName());  import java.util.List;
48    private static final SAXBuilder SAX_BUILDER = new SAXBuilder();  import java.util.Map;
49    private static final XMLOutputter XML_OUTPUTTER = new XMLOutputter();  import java.util.Set;
50    
51    /** URL for Atlas XML schema */  import javax.swing.BorderFactory;
52    public static final String AMLURI = "http://www.wikisquare.de/AtlasML";  import javax.swing.ImageIcon;
53    /** Name of the XML Element for the attribute meta data map */  import javax.swing.JComponent;
54    public static final String ELEM_NAME_AMD = "attributeMetaData";  import javax.swing.JLabel;
55    /** Name of the XML Element for the raster legend data */  
56    public static final String ELEM_NAME_RLD = "rasterLegendData";  import net.miginfocom.swing.MigLayout;
57    /** Name of the XML Element for an attribute meta data map entry */  
58    public static final String ELEM_NAME_ATTRIBUTE = "dataAttribute";  import org.apache.log4j.Logger;
59    /** Name of the XML Element for an raster legend data entry */  import org.geotools.coverage.grid.GeneralGridEnvelope;
60    public static final String ELEM_NAME_RASTERLEGEND = "rasterLegendItem";  import org.geotools.coverage.grid.GridCoverage2D;
61    /** Name of the XML Element for a translation */  import org.geotools.coverage.grid.GridGeometry2D;
62    public static final String ELEM_NAME_TRANSLATION = "translation";  import org.geotools.coverage.grid.io.AbstractGridCoverage2DReader;
63    import org.geotools.coverage.grid.io.AbstractGridFormat;
64    /**  import org.geotools.feature.FeatureCollection;
65     * Creates a Geotools {@link MapLayer} from an object. If the object is a  import org.geotools.feature.NameImpl;
66     * {@link StyledMapInterface} then its sytle is used. In case of direct  import org.geotools.geometry.jts.ReferencedEnvelope;
67     * Geotools objects ({@link GridCoverage2D}, {@link AbstractGridCoverage2DReader},  import org.geotools.map.DefaultMapLayer;
68     * {@link FeatureCollection}) a default style is generated.  import org.geotools.map.MapLayer;
69     * @param object an Object  import org.geotools.parameter.Parameter;
70     * @exception Exception if {@code null} is given as object or an error occurs during layer creation  import org.geotools.renderer.lite.gridcoverage2d.GridCoverageRenderer;
71     */  import org.geotools.styling.ColorMap;
72    public static MapLayer createMapLayer(Object object) throws Exception {  import org.geotools.styling.ColorMapEntry;
73      return createMapLayer(object,null);  import org.geotools.styling.FeatureTypeStyle;
74    }  import org.geotools.styling.RasterSymbolizer;
75    import org.geotools.styling.Rule;
76    /**  import org.geotools.styling.Style;
77     * Creates a Geotools {@link MapLayer} from an object. If the object is a  import org.jdom.Document;
78     * {@link StyledMapInterface} then its sytle is used. In case of direct  import org.jdom.Element;
79     * Geotools objects ({@link GridCoverage2D}, {@link AbstractGridCoverage2DReader},  import org.jdom.input.SAXBuilder;
80     * {@link FeatureCollection}) a default style is generated.  import org.jdom.output.XMLOutputter;
81     * @param object an Object  import org.opengis.feature.simple.SimpleFeature;
82     * @param forcedStyle (SLD-)Style to force for the object  import org.opengis.feature.simple.SimpleFeatureType;
83     * @exception Exception if {@code null} is given as object or an error occurs during layer creation  import org.opengis.feature.type.AttributeDescriptor;
84     */  import org.opengis.feature.type.GeometryDescriptor;
85    public static MapLayer createMapLayer(Object object, Style forcedStyle) throws Exception {  import org.opengis.feature.type.Name;
86      MapLayer layer     = null;  import org.opengis.parameter.GeneralParameterValue;
87      Style    style     = null;  
88      if ( object instanceof StyledMapInterface ) {  import schmitzm.geotools.JTSUtil;
89        style =  ((StyledMapInterface<?>)object).getStyle();  import schmitzm.geotools.feature.FeatureUtil;
90        object = ((StyledMapInterface<?>)object).getGeoObject();  import schmitzm.geotools.styling.StylingUtil;
91      }  import schmitzm.io.IOUtil;
92      if ( forcedStyle != null )  import schmitzm.lang.LangUtil;
93        style = forcedStyle;  import schmitzm.swing.JPanel;
94      if ( style == null )  import schmitzm.swing.SwingUtil;
95        style = StylingUtil.createDefaultStyle(object);  import skrueger.AttributeMetadataImpl;
96    import skrueger.AttributeMetadataInterface;
97      if (object instanceof GridCoverage2D)  import skrueger.RasterLegendData;
98        layer = new DefaultMapLayer( (GridCoverage2D) object, style);  import skrueger.i8n.Translation;
99      if (object instanceof AbstractGridCoverage2DReader)  
100        layer = new DefaultMapLayer( (AbstractGridCoverage2DReader) object, style);  /**
101      if (object instanceof FeatureCollection)   * This class provides static helper methods for dealing with
102        layer = new DefaultMapLayer( (FeatureCollection) object, style);   * {@link StyledLayerInterface} stuff.
103     *
104      if ( layer == null )   * @author <a href="mailto:[email protected]">Martin Schmitz</a>
105        throw new Exception("Can not create MapLayer from "+(object == null ? "null" : object.getClass()));   *         (University of Bonn/Germany)
106     * @version 1.0
107      return layer;   */
108    }  public class StyledLayerUtil {
109            private static final Logger LOGGER = Logger.getLogger(StyledLayerUtil.class
110    /**                          .getName());
111     * Creates an default instance of {@link StyledMapInterface} for a Geotools          private static final SAXBuilder SAX_BUILDER = new SAXBuilder();
112     * object ({@link GridCoverage2D}, {@link FeatureCollection}) with a default          private static final XMLOutputter XML_OUTPUTTER = new XMLOutputter();
113     * style.  
114     * @param object an Object          /** URL for Atlas XML schema */
115     * @param title  title for the object          public static final String AMLURI = "http://www.wikisquare.de/AtlasML";
116     * @exception UnsupportedOperationException if {@code null} is given as object or an error occurs during creation          /** Name of the XML Element for the attribute meta data map */
117     */          public static final String ELEM_NAME_AMD = "attributeMetaData";
118    public static StyledMapInterface<?> createStyledMap(Object object, String title) {          /** Name of the XML Element for the raster legend data */
119       return createStyledMap(object, title, null);          public static final String ELEM_NAME_RLD = "rasterLegendData";
120    }          /** Name of the XML Element for an attribute meta data map entry */
121            public static final String ELEM_NAME_ATTRIBUTE = "dataAttribute";
122    /**          /** Name of the XML Element for an raster legend data entry */
123     * Creates an default instance of {@link StyledMapInterface} for a Geotools          public static final String ELEM_NAME_RASTERLEGEND = "rasterLegendItem";
124     * object ({@link GridCoverage2D}, {@link FeatureCollection}) with a given          /** Name of the XML Element for a translation */
125     * style.          public static final String ELEM_NAME_TRANSLATION = "translation";
126     * @param object an Object  
127     * @param title  title for the object          /**
128     * @param style  style and meta data for the object           * Creates a Geotools {@link MapLayer} from an object. If the object is a
129     * @exception UnsupportedOperationException if {@code null} is given as object or an error occurs during creation           * {@link StyledLayerInterface} then its sytle is used. In case of direct
130     */           * Geotools objects ({@link GridCoverage2D},
131    public static StyledMapInterface<?> createStyledMap(Object object, String title, StyledMapStyle style) {           * {@link AbstractGridCoverage2DReader}, {@link FeatureCollection}) a
132      StyledMapInterface<?> styledObject = null;           * default style is generated.
133             *
134      String id = (title != null) ? title : "defaultID";           * @param object
135             *            an Object
136      if ( object instanceof GridCoverage2D )           * @exception Exception
137        styledObject = new StyledGridCoverage(           *                if {@code null} is given as object or an error occurs
138            (GridCoverage2D)object,           *                during layer creation
139            id,           */
140            title,          public static MapLayer createMapLayer(final Object object) throws Exception {
141            style                  return createMapLayer(object, null);
142        );          }
143      else if ( object instanceof AbstractGridCoverage2DReader )  
144             styledObject = new StyledGridCoverageReader(          /**
145                 (AbstractGridCoverage2DReader)object,           * Creates a Geotools {@link MapLayer} from an object. If the object is a
146                 id,           * {@link StyledLayerInterface} then its sytle is used. In case of direct
147                 title,           * Geotools objects ({@link GridCoverage2D},
148                 style           * {@link AbstractGridCoverage2DReader}, {@link FeatureCollection}) a
149             );           * default style is generated.
150      else if ( object instanceof FeatureCollection )           *
151        styledObject = new StyledFeatureCollection(           * @param object
152            (FeatureCollection)object,           *            an Object
153            id,           * @param forcedStyle
154            title,           *            (SLD-)Style to force for the object
155            style           * @exception Exception
156        );           *                if {@code null} is given as object or an error occurs
157                 *                during layer creation
158      if ( styledObject == null )           */
159        throw new UnsupportedOperationException("Can not create StyledMapInterface object from "+(object == null ? "null" : object.getClass()));          public static MapLayer createMapLayer(Object object, final Style forcedStyle)
160                            throws Exception {
161      return styledObject;                  MapLayer layer = null;
162    }                  Style style = null;
163                    if (object instanceof StyledLayerInterface) {
164    /**                          style = ((StyledLayerInterface<?>) object).getStyle();
165     * Return only the visible or invisible entries of an AttributeMetaData-Map.                          object = ((StyledLayerInterface<?>) object).getGeoObject();
166     * @param amdMap AttributeMetaData-Map                  }
167     * @param visible indicated whether the visible or invisible entries are                  if (forcedStyle != null)
168     *                returned                          style = forcedStyle;
169     */                  if (style == null)
170    public static SortedMap<Integer,AttributeMetaData> getVisibleAttributeMetaData(Map<Integer,AttributeMetaData> amdMap, boolean visible) {                          style = StylingUtil.createDefaultStyle(object);
171      SortedMap<Integer,AttributeMetaData> filteredMap = new TreeMap<Integer,AttributeMetaData>();  
172      for (AttributeMetaData amd : amdMap.values())                  if (object instanceof GridCoverage2D)
173        if ( amd.isVisible() )                          layer = new DefaultMapLayer((GridCoverage2D) object, style);
174          filteredMap.put(amd.getColIdx(), amd);                  if (object instanceof AbstractGridCoverage2DReader)
175                                layer = new DefaultMapLayer((AbstractGridCoverage2DReader) object,
176      return filteredMap;                                          style);
177    }                  if (object instanceof FeatureCollection)
178                              layer = new DefaultMapLayer((FeatureCollection) object, style);
179      
180    /**                  if (layer == null)
181     * Parses a {@link AttributeMetaData} object from an JDOM-{@link Element}.                          throw new Exception("Can not create MapLayer from "
182     * This method works like {@link AMLImport#parseDataAttribute(org.w3c.dom.Node},                                          + (object == null ? "null" : object.getClass()));
183     * but for JDOM.  
184     * @param element {@link Element} to parse                  return layer;
185     */          }
186    public static AttributeMetaData parseAttributeMetaData(final Element element) {  
187      final Integer col = Integer.valueOf(element.getAttributeValue("col"));          /**
188      final Boolean visible = Boolean.valueOf(element.getAttributeValue("visible"));           * Creates an default instance of {@link StyledLayerInterface} for a
189      final String unit = element.getAttributeValue("unit");           * Geotools object ({@link GridCoverage2D}, {@link FeatureCollection}) with
190             * a default style.
191      Translation name = new Translation();           *
192      Translation desc = new Translation();           * @param object
193      for (final Element childElement : (List<Element>)element.getChildren()) {           *            an Object
194        if (childElement.getName() == null)           * @param title
195          continue;           *            title for the object
196             * @exception UnsupportedOperationException
197        if (childElement.getName().equals("name"))           *                if {@code null} is given as object or an error occurs
198          name = parseTranslation(childElement);           *                during creation
199        else if (childElement.getName().equals("desc"))           */
200          desc = parseTranslation(childElement);          public static StyledLayerInterface<?> createStyledLayer(
201      }                          final Object object, final String title) {
202      return new AttributeMetaData(col, visible, name, desc, unit);                  return createStyledLayer(object, title, null);
203    }          }
204    
205    /**          /**
206     * Parses a {@link AttributeMetaData} map from an JDOM-{@link Element}           * Creates an default instance of {@link StyledLayerInterface} for a
207     * with {@code <attribute>}-childs.           * Geotools object ({@link GridCoverage2D}, {@link FeatureCollection}) with
208     * @param element {@link Element} to parse           * a given style.
209     */           *
210    public static Map<Integer,AttributeMetaData> parseAttributeMetaDataMap(final Element element) {           * @param object
211      HashMap<Integer,AttributeMetaData> metaData = new HashMap<Integer,AttributeMetaData>();           *            an Object
212      List<Element> attributesElements = element.getChildren( ELEM_NAME_ATTRIBUTE );           * @param title
213      for (Element attibuteElement : attributesElements)           *            title for the object
214      {           * @param style
215        AttributeMetaData attrMetaData = parseAttributeMetaData( attibuteElement );           *            style and meta data for the object
216        metaData.put( attrMetaData.getColIdx(), attrMetaData );           * @exception UnsupportedOperationException
217      }           *                if {@code null} is given as object or an error occurs
218      return metaData;           *                during creation
219    }           */
220            public static StyledLayerInterface<?> createStyledLayer(
221    /**                          final Object object, final String title,
222     * Loads a {@link AttributeMetaData} object from an URL.                          final StyledLayerStyle style) {
223     * @param documentUrl {@link URL} to parse                  StyledLayerInterface<?> styledLayer = null;
224     * @see #parseAttributeMetaData(Element)  
225     */                  final String id = (title != null) ? title : "defaultID";
226    public static Map<Integer,AttributeMetaData> loadAttributeMetaDataMap(final URL documentUrl) throws Exception {  
227      Document document = SAX_BUILDER.build(documentUrl);                  if (object instanceof GridCoverage2D)
228      return parseAttributeMetaDataMap( document.getRootElement() );                          styledLayer = new StyledGridCoverage((GridCoverage2D) object, id,
229    }                                          title, style);
230                    else if (object instanceof AbstractGridCoverage2DReader)
231    /**                          styledLayer = new StyledGridCoverageReader(
232     * Creates an JDOM {@link Element} for the given {@link AttributeMetaData}                                          (AbstractGridCoverage2DReader) object, id, title, style);
233     * object.                  else if (object instanceof FeatureCollection)
234     * @param amd meta data for one attribute                          styledLayer = new StyledFeatureCollection(
235     */                                          (FeatureCollection) object, id, title, style);
236    public static Element createAttributeMetaDataElement(final AttributeMetaData amd) {  
237      final Element element = new Element( ELEM_NAME_ATTRIBUTE , AMLURI);                  if (styledLayer == null)
238      element.setAttribute("col", String.valueOf( amd.getColIdx() ) );                          throw new UnsupportedOperationException(
239      element.setAttribute("visible", String.valueOf( amd.isVisible() ) );                                          "Can not create StyledLayerInterface object from "
240      element.setAttribute("unit", amd.getUnit() );                                                          + (object == null ? "null" : object.getClass()));
241      // Creating a aml:name tag...  
242      element.addContent( createTranslationElement("name", amd.getTitle()) );                  return styledLayer;
243      // Creating a aml:desc tag...          }
244      element.addContent( createTranslationElement("desc", amd.getDesc()) );  
245      return element;          /**
246    }           * Return only the visible or invisible entries of an AttributeMetaData-Map.
247             *
248    /**           * @param amdMap
249     * Creates an JDOM {@link Element} for the given {@link AttributeMetaData}           *            AttributeMetaData-Map
250     * map.           * @param visible
251     * @param amdMap map of attribute meta data           *            indicated whether the visible or invisible entries are
252     */           *            returned
253    public static Element createAttributeMetaDataMapElement(final Map<Integer,AttributeMetaData> amdMap) {           *
254      final Element element = new Element( ELEM_NAME_AMD , AMLURI);           *            TODO replace with
255      for (AttributeMetaData amd : amdMap.values())           *            {@link AttributeMetadataMap#sortedValuesVisibleOnly()}
256        element.addContent( createAttributeMetaDataElement( amd ) );           */
257      return element;          public static AttributeMetadataMap<? extends AttributeMetadataInterface > getVisibleAttributeMetaData(
258    }                          final AttributeMetadataMap<? extends AttributeMetadataInterface> amdMap,
259                            final boolean visible) {
260    /**  
261     * Saves a {@link AttributeMetaData AttributeMetaData-Map} to an URL.                  final AttributeMetadataMap<AttributeMetadataInterface> filteredMap = (AttributeMetadataMap<AttributeMetadataInterface>) amdMap.clone();
262     * @param amdMap map of {@link AttributeMetaData}                  if (filteredMap.size() > 0 ) {
263     * @param documentUrl {@link URL} to store the XML                          filteredMap.clear(); // Just in case the close copies the contents
264     */                  }
265    public static void saveAttributeMetaDataMap(final Map<Integer,AttributeMetaData> amdMap, final URL documentUrl) throws Exception {                  
266      // Create XML-Document                  for (final AttributeMetadataInterface amd : amdMap.values())
267      final FileWriter out = new FileWriter( new File(documentUrl.toURI()) );                          if (amd.isVisible() == visible)
268      XML_OUTPUTTER.output(                                  filteredMap.put(amd.getName(), amd);
269        createAttributeMetaDataMapElement(amdMap),  
270        out                  return filteredMap;
271      );          }
272      out.flush();  
273      out.close();          /**
274    }           * Parses a {@link AttributeMetadataImpl} object from an JDOM-
275             * {@link Element}. This method works like {@link
276             * AMLImport#parseDataAttribute(org.w3c.dom.Node}, but for JDOM.
277             *
278    /**           * TODO 20.11.2009, SK: There are some new attribute weight, functiona,
279     * Parses a {@link RasterLegendData} object from an JDOM-{@link Element}.           * functionX and nodata in AttributeMetaData that should be parsed/exported
280     * This method works like {@link AMLImport#parseRasterLegendData(org.w3c.dom.Node},           * too. but this method is only used by ISDSS, which is not supporting that
281     * but for JDOM.           * stuff anyways.
282     * @param element {@link Element} to parse           *
283     */           * @param element
284    public static RasterLegendData parseRasterLegendData(Element element) {           *            {@link Element} to parse
285             */
286      final boolean paintGaps = Boolean.valueOf( element.getAttributeValue("paintGaps") );          public static AttributeMetadataImpl parseAttributeMetaData(
287                            final Element element) {
288      RasterLegendData rld = new RasterLegendData(paintGaps);                  final String namespace = String.valueOf(element
289                                    .getAttributeValue("namespace"));
290      for ( Element childElement : (List<Element>)element.getChildren() ) {                  final String localname = String.valueOf(element
291        final String name = childElement.getName();                                  .getAttributeValue("localname"));
292        // Cancel if it's an attribute                  final NameImpl aName = new NameImpl(namespace, localname);
293        if ( childElement.getChildren().size() == 0 )                  final Boolean visible = Boolean.valueOf(element
294          continue;                                  .getAttributeValue("visible"));
295                    final String unit = element.getAttributeValue("unit");
296        if (name.equals( ELEM_NAME_RASTERLEGEND )) {  
297          final String valueAttr = childElement.getAttributeValue("value");                  Translation name = new Translation();
298          if ( valueAttr == null )                  Translation desc = new Translation();
299            throw new UnsupportedOperationException("Attribute 'value' missing for definition of <"+ELEM_NAME_RASTERLEGEND+">");                  for (final Element childElement : (List<Element>) element.getChildren()) {
300          final double value = Double.valueOf(valueAttr);                          if (childElement.getName() == null)
301                                    continue;
302          // first and only item should be the label  
303          final Element labelElement = childElement.getChild("label");                          if (childElement.getName().equals("name"))
304          // id label element is missing, the translation is searched directly                                  name = parseTranslation(childElement);
305          // as childs of the rasterLegendItem element                          else if (childElement.getName().equals("desc"))
306          Translation label = parseTranslation( labelElement != null ? labelElement : childElement );                                  desc = parseTranslation(childElement);
307          rld.put(value, label);                  }
308        }                  return new AttributeMetadataImpl(aName, visible, name, desc, unit);
309      }          }
310    
311      return rld;          /**
312    }           * Parses a {@link AttributeMetadataImpl} map from an JDOM-{@link Element}
313             * with {@code <attribute>}-childs.
314    /**           *
315     * Loads a {@link RasterLegendData} object from an URL.           * @param element
316     * @param documentUrl {@link URL} to parse           *            {@link Element} to parse
317     * @see #parseAttributeMetaData(Element)           *
318     */           *            TODO Since GP 1.3 the {@link AttributeMetadataImpl} class has
319    public static RasterLegendData loadRasterLegendData(final URL documentUrl) throws Exception {           *            more attributes which are not used by Xulu/ISDSS. GP
320      Document document = SAX_BUILDER.build(documentUrl);           *            exports/imports the AMD via AMLExporter and AMLImporter
321      return parseRasterLegendData( document.getRootElement() );           *            classes. (SK, 3.2.2010) *
322    }           */
323            public static AttributeMetadataMap parseAttributeMetaDataMap(
324   /**                          final Element element) {
325     * Creates an JDOM {@link Element} for the given {@link RasterLegendData}                  final AttributeMetadataMap metaData = new AttributeMetadataImplMap();
326     * map.                  final List<Element> attributesElements = element
327     * @param rld raster legend data                                  .getChildren(ELEM_NAME_ATTRIBUTE);
328     */                  for (final Element attibuteElement : attributesElements) {
329    public static Element createRasterLegendDataElement(final RasterLegendData rld) {                          final AttributeMetadataImpl attrMetaData = parseAttributeMetaData(attibuteElement);
330      final Element element = new Element( ELEM_NAME_RLD , AMLURI);                          metaData.put(attrMetaData.getName(), attrMetaData);
331      element.setAttribute("paintGaps", rld.isPaintGaps().toString());                  }
332      for (Double key : rld.getSortedKeys()) {                  return metaData;
333        Element item = new Element( ELEM_NAME_RASTERLEGEND, AMLURI);          }
334        item.setAttribute("value", key.toString());  
335        item.addContent( createTranslationElement("label", rld.get(key)) );          /**
336        element.addContent(item);           * Loads a {@link AttributeMetadataImpl} object from an URL.
337      }           *
338      return element;           * @param documentUrl
339    }           *            {@link URL} to parse
340             * @see #parseAttributeMetaData(Element)
341    /**           */
342     * Creates {@link RasterLegendData} from a {@link ColorMap}.          public static AttributeMetadataMap loadAttributeMetaDataMap(
343     * @param colorMap  a color map                          final URL documentUrl) throws Exception {
344     * @param paintGaps indicated whether gaps are painted between the legend items                  final Document document = SAX_BUILDER.build(documentUrl);
345     * @param digits    number of digits the grid value classes (and legend) are                  return parseAttributeMetaDataMap(document.getRootElement());
346     *                  rounded to (null means no round; >= 0 means digits after comma;          }
347     *                  < 0 means digits before comma)    */  
348    public static RasterLegendData generateRasterLegendData(ColorMap colorMap, boolean paintGaps, Integer digits) {          /**
349      DecimalFormat    decFormat = digits != null ? new DecimalFormat( SwingUtil.getNumberFormatPattern(digits) ) : null;           * Creates an JDOM {@link Element} for the given
350      RasterLegendData rld       = new RasterLegendData(paintGaps);           * {@link AttributeMetadataImpl} object.
351      for (ColorMapEntry cme : colorMap.getColorMapEntries())           *
352      {           * @param amd
353        double value = StylingUtil.getQuantityFromColorMapEntry(cme);           *            meta data for one attribute
354        String label = cme.getLabel();           *
355        // if no label is set (e.g. quantitative style),           *            TODO Since GP 1.3 the {@link AttributeMetadataImpl} class has
356        // use the value as label           *            more attributes which are not used by Xulu/ISDSS. GP
357        if ( label == null || label.equals("") )           *            exports/imports the AMD via AMLExporter and AMLImporter
358          if ( digits == null )           *            classes. (SK, 3.2.2010)
359            label = String.valueOf(value);           */
360          else          public static Element createAttributeMetaDataElement(
361            label = decFormat.format( LangUtil.round(value, digits) );                          final AttributeMetadataInterface amd) {
362        rld.put( value, new Translation("   "+label) );                  final Element element = new Element(ELEM_NAME_ATTRIBUTE, AMLURI);
363      }                  element.setAttribute("namespace", String.valueOf(amd.getName()
364      return rld;                                  .getNamespaceURI()));
365    }                  element.setAttribute("localname", String.valueOf(amd.getLocalName()));
366                    element.setAttribute("visible", String.valueOf(amd.isVisible()));
367    /**                  element.setAttribute("unit", amd.getUnit());
368     * Creates {@link RasterLegendData} from the {@link ColorMap} of a style.                  // Creating a aml:name tag...
369     * @param style     a raster style (must contain a  {@link RasterSymbolizer})                  element.addContent(createTranslationElement("name", amd.getTitle()));
370     * @param paintGaps indicated whether gaps are painted between the legend items                  // Creating a aml:desc tag...
371     * @param digits    number of digits the grid value classes (and legend) are                  element.addContent(createTranslationElement("desc", amd.getDesc()));
372     *                  rounded to (null means no round; >= 0 means digits after comma;                  return element;
373     *                  < 0 means digits before comma)    */          }
374    public static RasterLegendData generateRasterLegendData(Style style, boolean paintGaps, Integer digits) {  
375      ColorMap colorMap = StylingUtil.getColorMapFromStyle(style);          /**
376      if ( colorMap == null)           * Creates an JDOM {@link Element} for the given
377        throw new IllegalArgumentException("Color map can not be determined from style!");           * {@link AttributeMetadataImpl} map.
378      return generateRasterLegendData(colorMap, paintGaps, digits);           *
379    }           * @param amdMap
380             *            map of attribute meta data
381    /**           */
382     * Saves a {@link RasterLegendData} to an URL.          public static Element createAttributeMetaDataMapElement(
383     * @param rld raster legend data                          final AttributeMetadataMap<? extends AttributeMetadataInterface> amdMap) {
384     * @param documentUrl {@link URL} to store the XML                  final Element element = new Element(ELEM_NAME_AMD, AMLURI);
385     */                  for (final AttributeMetadataInterface amd : amdMap.values())
386    public static void saveRasterLegendData(final RasterLegendData rld, final URL documentUrl) throws Exception {                          element.addContent(createAttributeMetaDataElement(amd));
387      // Create XML-Document                  return element;
388      final FileWriter out = new FileWriter( new File(documentUrl.toURI()) );          }
389      XML_OUTPUTTER.output(  
390        createRasterLegendDataElement(rld),          /**
391        out           * Saves a {@link AttributeMetadataImpl AttributeMetaData-Map} to an URL.
392      );           *
393      out.flush();           * @param amdMap
394      out.close();           *            map of {@link AttributeMetadataImpl}
395    }           * @param documentUrl
396             *            {@link URL} to store the XML
397    /**           */
398     * Parses a {@link Translation} object from an JDOM-{@link Element}.          public static void saveAttributeMetaDataMap(
399     * This method works like {@link AMLImport#parseTranslation(org.w3c.dom.Node},                          final AttributeMetadataMap amdMap, final URL documentUrl)
400     * but for JDOM.                          throws Exception {
401     * @param element {@link Element} to parse                  // Create XML-Document
402     */                  final FileWriter out = new FileWriter(new File(documentUrl.toURI()));
403    public final static Translation parseTranslation(final Element element) {                  XML_OUTPUTTER.output(createAttributeMetaDataMapElement(amdMap), out);
404      Translation trans = new Translation();                  out.flush();
405                    out.close();
406      if (element == null)          }
407       return trans;  
408            /**
409      for (final Element translationElement : (List<Element>)element.getChildren()) {           * Parses a {@link RasterLegendData} object from an JDOM-{@link Element}.
410        final String name = translationElement.getName();           * This method works like {@link
411        if (name == null)           * AMLImport#parseRasterLegendData(org.w3c.dom.Node}, but for JDOM.
412          continue;           *
413             * @param element
414        // lang attribute           *            {@link Element} to parse
415        String lang = translationElement.getAttributeValue("lang");           */
416        // set the default, if no language code is set          public static RasterLegendData parseRasterLegendData(final Element element) {
417        if ( lang == null )  
418          lang = Translation.DEFAULT_KEY;                  final boolean paintGaps = Boolean.valueOf(element
419                                    .getAttributeValue("paintGaps"));
420        final String translationText = translationElement.getValue();  
421        if (translationText == null)                  final RasterLegendData rld = new RasterLegendData(paintGaps);
422          trans.put(lang, "");  
423        else                  for (final Element childElement : (List<Element>) element.getChildren()) {
424          trans.put(lang, translationText);                          final String name = childElement.getName();
425      }                          // Cancel if it's an attribute
426                            if (childElement.getChildren().size() == 0)
427      // if no <translation> is given, the value of the node should                                  continue;
428      // be used as a default translation  
429      if (trans.size() == 0)                          if (name.equals(ELEM_NAME_RASTERLEGEND)) {
430        trans.put( Translation.DEFAULT_KEY, element.getValue() );                                  final String valueAttr = childElement
431      //     trans = new Translation( ((List<Element>)element.getChildren()).get(0).getValue() );                                                  .getAttributeValue("value");
432                                    if (valueAttr == null)
433      return trans;                                          throw new UnsupportedOperationException(
434    }                                                          "Attribute 'value' missing for definition of <"
435                                                                            + ELEM_NAME_RASTERLEGEND + ">");
436    /**                                  final double value = Double.valueOf(valueAttr);
437     * Creates an JDOM {@link Element} for the given {@link Translation}.  
438     * @param tagname Name of the Element                                  // first and only item should be the label
439     * @param translation Translation to store in the Element                                  final Element labelElement = childElement.getChild("label");
440     */                                  // id label element is missing, the translation is searched
441    public final static Element createTranslationElement(String tagname, Translation translation) {                                  // directly
442      Element element = new Element(tagname, AMLURI);                                  // as childs of the rasterLegendItem element
443      if ( translation == null )                                  final Translation label = parseTranslation(labelElement != null ? labelElement
444        throw new UnsupportedOperationException("Translation element can not be created from null!");                                                  : childElement);
445                                    rld.put(value, label);
446      // If only a default translation is set, the <translation lang="..">..</tranlation>                          }
447      // part is not used                  }
448      if (translation.keySet().size() == 1 && translation.get(Translation.DEFAULT_KEY) != null) {  
449        element.addContent( translation.get(Translation.DEFAULT_KEY) );                  return rld;
450        return element;          }
451      }  
452            /**
453      // add a <translation lang="..">..</tranlation> part to the element for           * Loads a {@link RasterLegendData} object from an URL.
454      // all languages           *
455      for (String lang : translation.keySet()) {           * @param documentUrl
456        Element translationElement = new Element( ELEM_NAME_TRANSLATION , AMLURI);           *            {@link URL} to parse
457        translationElement.setAttribute("lang", lang);           * @see #parseAttributeMetaData(Element)
458        String translationString = translation.get(lang);           */
459        if (translationString == null)          public static RasterLegendData loadRasterLegendData(final URL documentUrl)
460         translationString = "";                          throws Exception {
461        translationElement.addContent( translationString );                  final Document document = SAX_BUILDER.build(documentUrl);
462        element.addContent(translationElement);                  return parseRasterLegendData(document.getRootElement());
463      }          }
464    
465      return element;          /**
466    }           * Creates an JDOM {@link Element} for the given {@link RasterLegendData}
467             * map.
468             *
469    /**           * @param rld
470     * Sets a style to {@link StyledMapInterface}.           *            raster legend data
471     * @param styledObject a styled object           */
472     * @param style a Style          public static Element createRasterLegendDataElement(
473     */                          final RasterLegendData rld) {
474    public static void setStyledMapStyle(StyledMapInterface styledObject, StyledMapStyle<?> style) {                  final Element element = new Element(ELEM_NAME_RLD, AMLURI);
475      // set SLD style                  element.setAttribute("paintGaps", rld.isPaintGaps().toString());
476      styledObject.setStyle( style.getGeoObjectStyle() );                  for (final Double key : rld.getSortedKeys()) {
477      // set meta data                          final Element item = new Element(ELEM_NAME_RASTERLEGEND, AMLURI);
478      if ( styledObject        instanceof StyledGridCoverageInterface &&                          item.setAttribute("value", key.toString());
479           (style.getMetaData() instanceof RasterLegendData || style.getMetaData() == null) ) {                          item.addContent(createTranslationElement("label", rld.get(key)));
480        RasterLegendData sourceRld = (RasterLegendData)style.getMetaData();                          element.addContent(item);
481        RasterLegendData destRld = ((StyledGridCoverageInterface)styledObject).getLegendMetaData();                  }
482        if ( destRld != null && sourceRld != null ) {                  return element;
483          destRld.setPaintGaps(sourceRld.isPaintGaps());          }
484          destRld.clear();  
485          destRld.putAll( sourceRld );          /**
486        }           * Creates {@link RasterLegendData} from a {@link ColorMap}.
487        return;           *
488      }           * @param colorMap
489      if ( styledObject        instanceof StyledFeatureCollectionInterface &&           *            a color map
490           (style.getMetaData() instanceof Map || style.getMetaData() == null) ) {           * @param paintGaps
491        Map<Integer, AttributeMetaData> sourceAmd = (Map<Integer, AttributeMetaData>)style.getMetaData();           *            indicated whether gaps are painted between the legend items
492        Map<Integer, AttributeMetaData> destAmd   = ((StyledFeatureCollectionInterface)styledObject).getAttributeMetaDataMap();           * @param digits
493        if ( destAmd != null && sourceAmd != null ) {           *            number of digits the grid value classes (and legend) are
494          destAmd.clear();           *            rounded to (null means no round; >= 0 means digits after
495          destAmd.putAll( sourceAmd );           *            comma; < 0 means digits before comma)
496        }           */
497        return;          public static RasterLegendData generateRasterLegendData(
498      }                          final ColorMap colorMap, final boolean paintGaps,
499                            final Integer digits) {
500      throw new UnsupportedOperationException("Style is not compatible to object: " +                  final DecimalFormat decFormat = digits != null ? new DecimalFormat(
501                                              (style.getMetaData() == null ? null : style.getMetaData().getClass().getSimpleName()) +                                  SwingUtil.getNumberFormatPattern(digits)) : null;
502                                              " <-> " +                  final RasterLegendData rld = new RasterLegendData(paintGaps);
503                                              (styledObject == null ? null : styledObject.getClass().getSimpleName()));                  for (final ColorMapEntry cme : colorMap.getColorMapEntries()) {
504    }                          final double value = StylingUtil.getQuantityFromColorMapEntry(cme);
505                            String label = cme.getLabel();
506    /**                          // if no label is set (e.g. quantitative style),
507     * Returns the style a {@link StyledMapInterface} as a {@link StyledMapStyle}.                          // use the value as label
508     * @param styledObject a styled object                          if (label == null || label.equals(""))
509     * @return {@code StyledMapStyle<RasterLegendData>} for {@link StyledGridCoverageInterface}                                  if (digits == null)
510     *         or {@code StyledMapStyle<Map<Integer,AttributeMetaData>>} for                                          label = String.valueOf(value);
511     *         {@link StyledFeatureCollectionInterface}                                  else
512     */                                          label = decFormat.format(LangUtil.round(value, digits));
513    public static StyledMapStyle<?> getStyledMapStyle(StyledMapInterface styledObject) {                          rld.put(value, new Translation("   " + label));
514      if ( styledObject instanceof StyledGridCoverageInterface )                  }
515        return getStyledMapStyle( (StyledGridCoverageInterface)styledObject );                  return rld;
516      if ( styledObject instanceof StyledFeatureCollectionInterface )          }
517        return getStyledMapStyle( (StyledFeatureCollectionInterface)styledObject );  
518      throw new UnsupportedOperationException("Unknown type of StyledMapInterface: "+(styledObject == null ? null : styledObject.getClass().getSimpleName()));          /**
519    }           * Creates {@link RasterLegendData} from the {@link ColorMap} of a style.
520             *
521    /**           * @param style
522     * Returns the style and raster meta data of a {@link StyledGridCoverageInterface}           *            a raster style (must contain a {@link RasterSymbolizer})
523     * as a {@link StyledMapStyle}.           * @param paintGaps
524     * @param styledGC a styled grid coverage           *            indicated whether gaps are painted between the legend items
525     */           * @param digits
526    public static StyledMapStyle<RasterLegendData> getStyledMapStyle(StyledGridCoverageInterface styledGC) {           *            number of digits the grid value classes (and legend) are
527      return new StyledMapStyle<RasterLegendData>(           *            rounded to (null means no round; >= 0 means digits after
528        styledGC.getStyle(),           *            comma; < 0 means digits before comma)
529        styledGC.getLegendMetaData()           */
530      );          public static RasterLegendData generateRasterLegendData(final Style style,
531    }                          final boolean paintGaps, final Integer digits) {
532                    final ColorMap colorMap = StylingUtil.getColorMapFromStyle(style);
533    /**                  if (colorMap == null)
534     * Returns the style and attribute meta data of a {@link StyledFeatureCollectionInterface}                          throw new IllegalArgumentException(
535     * as a {@link StyledMapStyle}.                                          "Color map can not be determined from style!");
536     * @param styledFC a styled feature collection                  return generateRasterLegendData(colorMap, paintGaps, digits);
537     */          }
538    public static StyledMapStyle<Map<Integer,AttributeMetaData>> getStyledMapStyle(StyledFeatureCollectionInterface styledFC) {  
539      return new StyledMapStyle<Map<Integer,AttributeMetaData>>(          /**
540        styledFC.getStyle(),           * Saves a {@link RasterLegendData} to an URL.
541        styledFC.getAttributeMetaDataMap()           *
542      );           * @param rld
543    }           *            raster legend data
544             * @param documentUrl
545    /**           *            {@link URL} to store the XML
546     * Loads a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData Raster-LegendData}           */
547     * for a given geo-object (raster) source. The SLD file must be present. A missing          public static void saveRasterLegendData(final RasterLegendData rld,
548     * raster legend-data file is tolerated.                          final URL documentUrl) throws Exception {
549     * @param geoObjectURL URL of the (already read) raster object                  // Create XML-Document
550     * @param sldExt file extention for the SLD file                  final FileWriter out = new FileWriter(new File(documentUrl.toURI()));
551     * @param rldExt file extention for the raster legend-data file                  XML_OUTPUTTER.output(createRasterLegendDataElement(rld), out);
552     * @return {@code null} in case of any error                  out.flush();
553     */                  out.close();
554    public static StyledMapStyle<RasterLegendData> loadStyledRasterStyle(URL geoObjectURL, String sldExt, String rldExt) {          }
555      RasterLegendData metaData = null;  
556      Style sldStyle = null;          /**
557      try {           * Parses a {@link Translation} object from an JDOM-{@link Element}. This
558        Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(geoObjectURL, sldExt));           * method works like {@link AMLImport#parseTranslation(org.w3c.dom.Node},
559        // SLD must be present           * but for JDOM.
560        if ( styles == null || styles.length == 0 )           *
561          return null;           * @param element
562        sldStyle = styles[0];           *            {@link Element} to parse
563      }           */
564      catch (Exception err) {          public final static Translation parseTranslation(final Element element) {
565        // SLD must be present                  final Translation trans = new Translation();
566        LangUtil.logDebugError(LOGGER,err);  
567        return null;                  if (element == null)
568      }                          return trans;
569    
570      try {                  for (final Element translationElement : (List<Element>) element
571        metaData = StyledMapUtil.loadRasterLegendData( IOUtil.changeUrlExt(geoObjectURL,rldExt) );                                  .getChildren()) {
572      } catch (FileNotFoundException err) {                          final String name = translationElement.getName();
573        // ignore missing raster legend data                          if (name == null)
574      } catch (Exception err) {                                  continue;
575        // any other error during legend data creation leads to error  
576        LangUtil.logDebugError(LOGGER,err);                          // lang attribute
577        return null;                          String lang = translationElement.getAttributeValue("lang");
578      }                          // set the default, if no language code is set
579      return new StyledMapStyle<RasterLegendData>(sldStyle, metaData);                          if (lang == null)
580    }                                  lang = Translation.DEFAULT_KEY;
581    
582    /**                          final String translationText = translationElement.getValue();
583     * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and                          if (translationText == null)
584     * {@linkplain RasterLegendData Raster-LegendData} from a {@code .rld} file                                  trans.put(lang, "");
585     * for a given geo-object (raster) source. The SLD file must be present. A missing                          else
586     * raster legend-data file is tolerated.                                  trans.put(lang, translationText);
587     * @param geoObjectURL URL of the (already read) raster object                  }
588     * @param sldExt file extention for the SLD file  
589     * @param rldExt file extention for the raster legend-data file                  // if no <translation> is given, the value of the node should
590     * @return {@code null} in case of any error                  // be used as a default translation
591     */                  if (trans.size() == 0)
592    public static StyledMapStyle<RasterLegendData> loadStyledRasterStyle(URL geoObjectURL) {                          trans.put(Translation.DEFAULT_KEY, element.getValue());
593      return loadStyledRasterStyle(geoObjectURL, "sld", "rld");                  // trans = new Translation(
594    }                  // ((List<Element>)element.getChildren()).get(0).getValue() );
595    
596    /**                  return trans;
597     * Loads a {@linkplain Style SLD-Style} and a {@linkplain AttributeMetaData AttributeMetaData-Map}          }
598     * for a given geo-object (feature) source. The SLD file must be present. A missing  
599     * attribute meta-data file is tolerated.          /**
600     * @param geoObjectURL URL of the (already read) feature object           * Creates an JDOM {@link Element} for the given {@link Translation}.
601     * @param sldExt file extention for the SLD file           *
602     * @param rldExt file extention for the raster legend-data file           * @param tagname
603     * @return {@code null} in case of any error           *            Name of the Element
604     */           * @param translation
605    public static StyledMapStyle<Map<Integer,AttributeMetaData>> loadStyledFeatureStyle(URL geoObjectURL, String sldExt, String rldExt) {           *            Translation to store in the Element
606      Map<Integer,AttributeMetaData> metaData = null;           */
607      Style                          sldStyle = null;          public final static Element createTranslationElement(final String tagname,
608      try {                          final Translation translation) {
609        Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(geoObjectURL, sldExt));                  final Element element = new Element(tagname, AMLURI);
610        // SLD must be present                  if (translation == null)
611        if ( styles == null || styles.length == 0 )                          throw new UnsupportedOperationException(
612          return null;                                          "Translation element can not be created from null!");
613        sldStyle = styles[0];  
614      } catch (Exception err) {                  // If only a default translation is set, the <translation
615        // SLD must be present                  // lang="..">..</tranlation>
616        LangUtil.logDebugError(LOGGER,err);                  // part is not used
617        return null;                  if (translation.keySet().size() == 1
618      }                                  && translation.get(Translation.DEFAULT_KEY) != null) {
619                            element.addContent(translation.get(Translation.DEFAULT_KEY));
620      try {                          return element;
621        metaData = StyledMapUtil.loadAttributeMetaDataMap( IOUtil.changeUrlExt(geoObjectURL,rldExt) );                  }
622      } catch (FileNotFoundException err) {  
623        // ignore missing attribute meta data                  // add a <translation lang="..">..</tranlation> part to the element for
624      } catch (Exception err) {                  // all languages
625        // any other error during meta data creation leads to error                  for (final String lang : translation.keySet()) {
626        LangUtil.logDebugError(LOGGER,err);                          final Element translationElement = new Element(
627        return null;                                          ELEM_NAME_TRANSLATION, AMLURI);
628      }                          translationElement.setAttribute("lang", lang);
629                            String translationString = translation.get(lang);
630      return new StyledMapStyle<Map<Integer,AttributeMetaData>>(sldStyle, metaData);                          if (translationString == null)
631    }                                  translationString = "";
632                            translationElement.addContent(translationString);
633    /**                          element.addContent(translationElement);
634     * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and                  }
635     * {@linkplain AttributeMetaData AttributeMetaData-Map} from a {@code .amd} file  
636     * for a given geo-object (feature) source. The SLD file must be present. A missing                  return element;
637     * attribute meta-data file is tolerated.          }
638     * @param geoObjectURL URL of the (already read) feature object  
639     * @param sldExt file extention for the SLD file          /**
640     * @param rldExt file extention for the raster legend-data file           * Sets a style to {@link StyledLayerInterface}.
641     * @return {@code null} in case of any error           *
642     */           * @param styledObject
643    public static StyledMapStyle<Map<Integer,AttributeMetaData>> loadStyledFeatureStyle(URL geoObjectURL) {           *            a styled object
644      return loadStyledFeatureStyle(geoObjectURL, "sld", "amd");           * @param style
645    }           *            a Style
646             */
647    /**          public static void setStyledLayerStyle(
648     * Stores a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData Raster-LegendData}                          final StyledLayerInterface styledObject,
649     * for a given geo-object (raster) source.                          final StyledLayerStyle<?> style) {
650     * @param style  style to save                  // set SLD style
651     * @param geoObjectURL URL of the raster object                  styledObject.setStyle(style.getGeoObjectStyle());
652     * @param sldExt file extention for the SLD file                  // set meta data
653     * @param mdExt file extention for the meta-data file                  if (styledObject instanceof StyledGridCoverageInterface
654     */                                  && (style.getMetaData() instanceof RasterLegendData || style
655    public static <T> void saveStyledMapStyle(StyledMapStyle<T> style, URL geoObjectURL, String sldExt, String mdExt) throws Exception {                                                  .getMetaData() == null)) {
656      // Store the SLD                          final RasterLegendData sourceRld = (RasterLegendData) style
657      Style sldStyle = style.getGeoObjectStyle();                                          .getMetaData();
658      if ( sldStyle != null ) {                          final RasterLegendData destRld = ((StyledGridCoverageInterface) styledObject)
659        StylingUtil.saveStyleToSLD(                                          .getLegendMetaData();
660           sldStyle,                          if (destRld != null && sourceRld != null) {
661           IOUtil.changeFileExt(                                  destRld.setPaintGaps(sourceRld.isPaintGaps());
662                new File(geoObjectURL.toURI()),                                  destRld.clear();
663                sldExt                                  destRld.putAll(sourceRld);
664           )                          }
665        );                          return;
666      }                  }
667                    if (styledObject instanceof StyledFeatureCollectionInterface
668      // Store the meta data                                  && (style.getMetaData() instanceof Map || style.getMetaData() == null)) {
669      T metaData = style.getMetaData();                          final AttributeMetadataMap sourceAmd = (AttributeMetadataMap) style
670      if ( metaData != null ) {                                          .getMetaData();
671        if ( metaData instanceof RasterLegendData ) {                          final AttributeMetadataMap destAmd = ((StyledFeatureCollectionInterface) styledObject)
672          saveRasterLegendData(                                          .getAttributeMetaDataMap();
673              (RasterLegendData)metaData,                          if (destAmd != null && sourceAmd != null) {
674              IOUtil.changeUrlExt(geoObjectURL,mdExt)                                  destAmd.clear();
675          );                                  destAmd.putAll(sourceAmd);
676  //      } else if ( metaData instanceof Map<Integer,AttributeMetaData> ) { // LEIDER NICHT KOMPILIERBAR!!                          }
677        } else if ( metaData instanceof Map ) {                          return;
678          saveAttributeMetaDataMap(                  }
679              (Map<Integer,AttributeMetaData>)metaData,  
680              IOUtil.changeUrlExt(geoObjectURL,mdExt)                  throw new UnsupportedOperationException(
681          );                                  "Style is not compatible to object: "
682        } else                                                  + (style.getMetaData() == null ? null : style
683          throw new UnsupportedOperationException("Export for meta data not yet supported: "+metaData.getClass().getSimpleName());                                                                  .getMetaData().getClass().getSimpleName())
684      }                                                  + " <-> "
685    }                                                  + (styledObject == null ? null : styledObject
686                                                                    .getClass().getSimpleName()));
687    /**          }
688     * Stores the {@linkplain Style SLD-Style} to a {@code .sld} file and  
689     * the meta data ({@link RasterLegendData} or {@link AttributeMetaData})          /**
690     * to a {@code .rld} or {@code .amd} file.           * Returns the style a {@link StyledLayerInterface} as a
691     * for a given geo-object source.           * {@link StyledLayerStyle}.
692     * @param style  style to save           *
693     * @param geoObjectURL URL of the (already read) raster object           * @param styledObject
694     */           *            a styled object
695    public static void saveStyledMapStyle(StyledMapStyle<?> style, URL geoObjectURL) throws Exception {           * @return {@code StyledLayerStyle<RasterLegendData>} for
696      if ( style.getMetaData() instanceof RasterLegendData )           *         {@link StyledGridCoverageInterface} or {@code
697        saveStyledMapStyle(style,geoObjectURL, "sld", "rld");           *         StyledLayerStyle<Map<Integer,AttributeMetaData>>} for
698      else           *         {@link StyledFeatureCollectionInterface}
699        saveStyledMapStyle(style,geoObjectURL, "sld", "amd");           */
700    }          public static StyledLayerStyle<?> getStyledLayerStyle(
701                            final StyledLayerInterface styledObject) {
702  }                  if (styledObject instanceof StyledGridCoverageInterface)
703                            return getStyledLayerStyle((StyledGridCoverageInterface) styledObject);
704                    if (styledObject instanceof StyledFeatureCollectionInterface)
705                            return getStyledLayerStyle((StyledFeatureCollectionInterface) styledObject);
706                    throw new UnsupportedOperationException(
707                                    "Unknown type of StyledLayerInterface: "
708                                                    + (styledObject == null ? null : styledObject
709                                                                    .getClass().getSimpleName()));
710            }
711    
712            /**
713             * Returns the style and raster meta data of a
714             * {@link StyledGridCoverageInterface} as a {@link StyledLayerStyle}.
715             *
716             * @param styledGC
717             *            a styled grid coverage
718             */
719            public static StyledLayerStyle<RasterLegendData> getStyledLayerStyle(
720                            final StyledGridCoverageInterface styledGC) {
721                    return new StyledLayerStyle<RasterLegendData>(styledGC.getStyle(),
722                                    styledGC.getLegendMetaData());
723            }
724    
725            /**
726             * Returns the style and attribute meta data of a
727             * {@link StyledFeatureCollectionInterface} as a {@link StyledLayerStyle}.
728             *
729             * @param styledFC
730             *            a styled feature collection
731             */
732            public static StyledLayerStyle<AttributeMetadataMap> getStyledLayerStyle(
733                            final StyledFeatureCollectionInterface styledFC) {
734                    return new StyledLayerStyle<AttributeMetadataMap>(styledFC.getStyle(),
735                                    styledFC.getAttributeMetaDataMap());
736            }
737    
738            /**
739             * Loads a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData
740             * Raster-LegendData} for a given geo-object (raster) source. The SLD file
741             * must be present. A missing raster legend-data file is tolerated.
742             *
743             * @param geoObjectURL
744             *            URL of the (already read) raster object
745             * @param sldExt
746             *            file extention for the SLD file
747             * @param rldExt
748             *            file extention for the raster legend-data file
749             * @return {@code null} in case of any error
750             */
751            public static StyledLayerStyle<RasterLegendData> loadStyledRasterStyle(
752                            final URL geoObjectURL, final String sldExt, final String rldExt) {
753                    RasterLegendData metaData = null;
754                    Style sldStyle = null;
755                    try {
756                            final Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(
757                                            geoObjectURL, sldExt));
758                            // SLD must be present
759                            if (styles == null || styles.length == 0)
760                                    return null;
761                            sldStyle = styles[0];
762                    } catch (final Exception err) {
763                            // SLD must be present
764                            LangUtil.logDebugError(LOGGER, err);
765                            return null;
766                    }
767    
768                    try {
769                            metaData = StyledLayerUtil.loadRasterLegendData(IOUtil
770                                            .changeUrlExt(geoObjectURL, rldExt));
771                    } catch (final FileNotFoundException err) {
772                            // ignore missing raster legend data
773                    } catch (final Exception err) {
774                            // any other error during legend data creation leads to error
775                            LangUtil.logDebugError(LOGGER, err);
776                            return null;
777                    }
778                    return new StyledLayerStyle<RasterLegendData>(sldStyle, metaData);
779            }
780    
781            /**
782             * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and
783             * {@linkplain RasterLegendData Raster-LegendData} from a {@code .rld} file
784             * for a given geo-object (raster) source. The SLD file must be present. A
785             * missing raster legend-data file is tolerated.
786             *
787             * @param geoObjectURL
788             *            URL of the (already read) raster object
789             * @param sldExt
790             *            file extention for the SLD file
791             * @param rldExt
792             *            file extention for the raster legend-data file
793             * @return {@code null} in case of any error
794             */
795            public static StyledLayerStyle<RasterLegendData> loadStyledRasterStyle(
796                            final URL geoObjectURL) {
797                    return loadStyledRasterStyle(geoObjectURL, "sld", "rld");
798            }
799    
800            /**
801             * Loads a {@linkplain Style SLD-Style} and a
802             * {@linkplain AttributeMetadataImpl AttributeMetaData-Map} for a given
803             * geo-object (feature) source. The SLD file must be present. A missing
804             * attribute meta-data file is tolerated.
805             *
806             * @param geoObjectURL
807             *            URL of the (already read) feature object
808             * @param sldExt
809             *            file extention for the SLD file
810             * @param rldExt
811             *            file extention for the raster legend-data file
812             * @return {@code null} in case of any error
813             */
814            public static StyledLayerStyle<AttributeMetadataMap> loadStyledFeatureStyle(
815                            final URL geoObjectURL, final String sldExt, final String rldExt) {
816                    AttributeMetadataMap metaData = null;
817                    Style sldStyle = null;
818                    try {
819                            final Style[] styles = StylingUtil.loadSLD(IOUtil.changeUrlExt(
820                                            geoObjectURL, sldExt));
821                            // SLD must be present
822                            if (styles == null || styles.length == 0)
823                                    return null;
824                            sldStyle = styles[0];
825                    } catch (final Exception err) {
826                            // SLD must be present
827                            LangUtil.logDebugError(LOGGER, err);
828                            return null;
829                    }
830    
831                    try {
832                            metaData = StyledLayerUtil.loadAttributeMetaDataMap(IOUtil
833                                            .changeUrlExt(geoObjectURL, rldExt));
834                    } catch (final FileNotFoundException err) {
835                            // ignore missing attribute meta data
836                    } catch (final Exception err) {
837                            // any other error during meta data creation leads to error
838                            LangUtil.logDebugError(LOGGER, err);
839                            return null;
840                    }
841    
842                    return new StyledLayerStyle<AttributeMetadataMap>(sldStyle, metaData);
843            }
844    
845            /**
846             * Loads a {@linkplain Style SLD-Style} from a {@code .sld} file and
847             * {@linkplain AttributeMetadataImpl AttributeMetaData-Map} from a {@code
848             * .amd} file for a given geo-object (feature) source. The SLD file must be
849             * present. A missing attribute meta-data file is tolerated.
850             *
851             * @param geoObjectURL
852             *            URL of the (already read) feature object
853             * @param sldExt
854             *            file extention for the SLD file
855             * @param rldExt
856             *            file extention for the raster legend-data file
857             * @return {@code null} in case of any error
858             */
859            public static StyledLayerStyle<AttributeMetadataMap> loadStyledFeatureStyle(
860                            final URL geoObjectURL) {
861                    return loadStyledFeatureStyle(geoObjectURL, "sld", "amd");
862            }
863    
864            /**
865             * Stores a {@linkplain Style SLD-Style} and {@linkplain RasterLegendData
866             * Raster-LegendData} for a given geo-object (raster) source.
867             *
868             * @param style
869             *            style to save
870             * @param geoObjectURL
871             *            URL of the raster object
872             * @param sldExt
873             *            file extention for the SLD file
874             * @param mdExt
875             *            file extention for the meta-data file
876             */
877            public static <T> void saveStyledLayerStyle(
878                            final StyledLayerStyle<T> style, final URL geoObjectURL,
879                            final String sldExt, final String mdExt) throws Exception {
880                    // Store the SLD
881                    final Style sldStyle = style.getGeoObjectStyle();
882                    if (sldStyle != null) {
883                            StylingUtil.saveStyleToSLD(sldStyle, IOUtil.changeFileExt(new File(
884                                            geoObjectURL.toURI()), sldExt));
885                    }
886    
887                    // Store the meta data
888                    final T metaData = style.getMetaData();
889                    if (metaData != null) {
890                            if (metaData instanceof RasterLegendData) {
891                                    saveRasterLegendData((RasterLegendData) metaData, IOUtil
892                                                    .changeUrlExt(geoObjectURL, mdExt));
893                                    // } else if ( metaData instanceof
894                                    // Map<Integer,AttributeMetaData> ) { // LEIDER NICHT
895                                    // KOMPILIERBAR!!
896                            } else if (metaData instanceof Map) {
897                                    saveAttributeMetaDataMap((AttributeMetadataMap) metaData,
898                                                    IOUtil.changeUrlExt(geoObjectURL, mdExt));
899                            } else
900                                    throw new UnsupportedOperationException(
901                                                    "Export for meta data not yet supported: "
902                                                                    + metaData.getClass().getSimpleName());
903                    }
904            }
905    
906            /**
907             * Stores the {@linkplain Style SLD-Style} to a {@code .sld} file and the
908             * meta data ({@link RasterLegendData} or {@link AttributeMetadataImpl}) to
909             * a {@code .rld} or {@code .amd} file. for a given geo-object source.
910             *
911             * @param style
912             *            style to save
913             * @param geoObjectURL
914             *            URL of the (already read) raster object
915             */
916            public static void saveStyledLayerStyle(final StyledLayerStyle<?> style,
917                            final URL geoObjectURL) throws Exception {
918                    if (style.getMetaData() instanceof RasterLegendData)
919                            saveStyledLayerStyle(style, geoObjectURL, "sld", "rld");
920                    else
921                            saveStyledLayerStyle(style, geoObjectURL, "sld", "amd");
922            }
923    
924            /**
925             * *If appended to the name of a rule, this rule shall not be shown in the
926             * legend
927             */
928            public final static String HIDE_IN_LAYER_LEGEND_HINT = "HIDE_IN_LEGEND";
929    
930            /**
931             * Creates a {@link JPanel} that shows a legend for a list of
932             * {@link FeatureTypeStyle}s and a targeted featureType
933             *
934             * @param featureType
935             *            If this a legend for Point, Polygon or Line?
936             * @param list
937             *            The Styles to presented in this legend
938             *
939             * @author <a href="mailto:[email protected]">Stefan Alfons
940             *         Kr&uuml;ger</a>
941             */
942            public static JPanel createLegendPanel(Style style,
943                            final SimpleFeatureType featureType, final int iconWidth,
944                            final int iconHeight) {
945    
946                    final List<FeatureTypeStyle> list = style.featureTypeStyles();
947    
948                    final JPanel panel = new JPanel(new MigLayout("wrap 2", "[]:3:[]"));
949    
950                    if (style == null) {
951                            // No Style => no legend
952                            return panel;
953                    }
954    
955                    for (final FeatureTypeStyle ftStyle : list) {
956    
957                            // One child-node for every rule
958                            final List<Rule> rules = ftStyle.rules();
959                            for (final Rule rule : rules) {
960    
961                                    // Check if this RULE shall actually appear in the legend
962                                    if (rule.getName() != null
963                                                    && rule.getName().endsWith(HIDE_IN_LAYER_LEGEND_HINT))
964                                            continue;
965    
966                                    /**
967                                     * Let's not create a hbox for Rules that only contain
968                                     * TextSymbolizers
969                                     */
970                                    if (StylingUtil.getTextSymbolizers(rule.getSymbolizers())
971                                                    .size() == rule.getSymbolizers().length)
972                                            continue;
973    
974                                    final BufferedImage imageForRule = LegendIconFeatureRenderer
975                                                    .getInstance().createImageForRule(rule, featureType,
976                                                                    new Dimension(iconWidth, iconHeight));
977    
978                                    final ImageIcon legendIcon = new ImageIcon(imageForRule);
979    
980                                    final JLabel iconLabel = new JLabel(legendIcon);
981                                    panel.add(iconLabel, "sgx1");
982                                    // hbox.setAlignmentX(0f);
983                                    // hbox.add(iconLabel);
984                                    // hbox.add(Box.createHorizontalStrut(3));
985    
986                                    final Translation labelT = new Translation();
987                                    labelT.fromOneLine(rule.getDescription().getTitle());
988                                    final JLabel classTitleLabel = new JLabel(labelT.toString());
989    
990                                    panel.add(classTitleLabel, "sgx2");
991                                    classTitleLabel.setLabelFor(iconLabel);
992                            }
993                    }
994    
995                    return panel;
996            }
997    
998            /**
999             * Creates a {@link JComponent} that contains a legend for a given
1000             * rasterLayer and a given {@link Style}.
1001             *
1002             * @param style
1003             *            if <code>null</code>, the default {@link Style} is extracetd
1004             *            from the {@link StyledRasterInterface}
1005             */
1006            public static JPanel createLegendPanel(
1007                            final StyledRasterInterface<?> styledRaster, Style style,
1008                            final int iconWidth, final int iconHeight) {
1009    
1010                    // If no style is given, we use the default style for this layer
1011                    if (style == null)
1012                            style = styledRaster.getStyle();
1013    
1014                    /**
1015                     * Determine whether a Style is responsible for the coloring
1016                     */
1017                    ColorModel colorModel = null;
1018                    if (!isStyleable(styledRaster)
1019                                    || (isStyleable(styledRaster) && style == null)) {
1020                            colorModel = getColorModel(styledRaster);
1021                    }
1022    
1023                    final RasterLegendData rasterLegendData = styledRaster
1024                                    .getLegendMetaData();
1025                    final List<Double> legendRasterValues = rasterLegendData
1026                                    .getSortedKeys();
1027                    final Map<Double, GridCoverage2D> sampleRasters = rasterLegendData
1028                                    .createSampleRasters();
1029    
1030                    final JPanel panel = new JPanel(new MigLayout("wrap 2, gapy 0"));
1031    
1032                    for (final Double rValue : legendRasterValues) {
1033    
1034                            // final Dimension ICON_SIZE = new Dimension(iconWidth,
1035                            // new JLabel().getFontMetrics(new JLabel().getFont())
1036                            // .getHeight() > 5 ? new JLabel().getFontMetrics(
1037                            // new JLabel().getFont()).getHeight() : iconHeight);
1038    
1039                            // ****************************************************************************
1040                            // Create the actual icon
1041                            // ****************************************************************************
1042                            final BufferedImage buffImage = new BufferedImage(iconWidth,
1043                                            iconHeight, BufferedImage.TYPE_INT_ARGB);
1044    
1045                            final Graphics2D graphics = buffImage.createGraphics();
1046    
1047                            if (colorModel != null) {
1048                                    // The colors come from the ColorModel!
1049    
1050                                    try {
1051                                            Object inData = null;
1052                                            switch (colorModel.getTransferType()) {
1053                                            case DataBuffer.TYPE_BYTE:
1054                                                    inData = new byte[] { rValue.byteValue() };
1055                                                    break;
1056                                            case DataBuffer.TYPE_USHORT:
1057                                                    inData = new short[] { rValue.shortValue() };
1058                                                    break;
1059                                            case DataBuffer.TYPE_INT:
1060                                                    inData = new int[] { rValue.intValue() };
1061                                                    break;
1062                                            case DataBuffer.TYPE_SHORT:
1063                                                    inData = new short[] { rValue.shortValue() };
1064                                                    break;
1065                                            case DataBuffer.TYPE_FLOAT:
1066                                                    inData = new float[] { rValue.floatValue() };
1067                                                    break;
1068                                            case DataBuffer.TYPE_DOUBLE:
1069                                                    inData = new double[] { rValue.doubleValue() };
1070                                                    break;
1071                                            default:
1072                                                    inData = rValue.intValue();
1073                                            }
1074                                            final Color color = new Color(colorModel.getRGB(inData));
1075                                            graphics.setBackground(color);
1076                                            graphics.setColor(color);
1077                                            graphics.fillRect(0, 0, iconWidth, iconHeight);
1078                                    } catch (final Exception e) {
1079                                            LOGGER.info(
1080                                                            "Dann nehmen wir halt den GridCoverageRenderer", e);
1081                                            colorModel = null;
1082                                    }
1083                            } else {
1084                                    // The colors come from the Style
1085    
1086                                    /**
1087                                     * The coverage contains only one value of value rValue
1088                                     */
1089                                    final GridCoverage2D sampleCov = sampleRasters.get(rValue);
1090                                    GridCoverageRenderer renderer;
1091                                    try {
1092                                            renderer = new GridCoverageRenderer(sampleCov
1093                                                            .getCoordinateReferenceSystem(), JTSUtil
1094                                                            .createEnvelope(sampleCov.getEnvelope()),
1095                                                            new Rectangle(iconWidth, iconHeight),
1096                                                            (AffineTransform) null);
1097                                    } catch (final Exception e1) {
1098                                            throw new RuntimeException(
1099                                                            "Creating a GridCoverageRenderer failed:", e1);
1100                                    }
1101    
1102                                    /**
1103                                     * Iterate over all FeatureTypeStyles.
1104                                     */
1105                                    final List<RasterSymbolizer> rSymbols = StylingUtil
1106                                                    .getRasterSymbolizers(style);
1107    
1108                                    for (final RasterSymbolizer symbolizer : rSymbols) {
1109                                            try {
1110                                                    renderer.paint(graphics, sampleCov, symbolizer);
1111                                            } catch (final Exception ee) {
1112                                                    LOGGER.error("Unable to paint " + symbolizer
1113                                                                    + " into the legend image", ee);
1114                                            }
1115                                    }
1116                            }
1117    
1118                            final JLabel iconLabel = new JLabel(new ImageIcon(buffImage));
1119                            panel.add(iconLabel, "sgx1");
1120    
1121                            final Translation labelT = rasterLegendData.get(rValue);
1122                            final JLabel classTitleLabel = new JLabel(labelT.toString());
1123                            panel.add(classTitleLabel, "sgx2"
1124                                            + (rasterLegendData.isPaintGaps() ? ", gapy 0:0:0 5:5:5"
1125                                                            : ""));
1126                            classTitleLabel.setLabelFor(iconLabel);
1127    
1128                            if (rasterLegendData.isPaintGaps()) {
1129                                    iconLabel
1130                                                    .setBorder(BorderFactory.createLineBorder(Color.black));
1131                            }
1132    
1133                    }
1134    
1135                    return panel;
1136            }
1137    
1138            /**
1139             * Extracts the {@link ColorModel} of any {@link StyledRasterInterface}. May
1140             * return <code>null</code> if the geoobject can not be accessed.
1141             */
1142            @SuppressWarnings("unchecked")
1143            public static ColorModel getColorModel(
1144                            final StyledRasterInterface<?> styledGrid) {
1145                    ColorModel colorModel = null;
1146                    try {
1147                            final Object geoObject = styledGrid.getGeoObject();
1148                            if (geoObject instanceof GridCoverage2D) {
1149                                    final GridCoverage2D cov = (GridCoverage2D) geoObject;
1150                                    colorModel = cov.getRenderedImage().getColorModel();
1151                            } else if (styledGrid instanceof StyledRasterPyramidInterface) {
1152    
1153                                    final Parameter readGG = new Parameter(
1154                                                    AbstractGridFormat.READ_GRIDGEOMETRY2D);
1155    
1156                                    final ReferencedEnvelope mapExtend = new org.geotools.geometry.jts.ReferencedEnvelope(
1157                                                    styledGrid.getEnvelope(), styledGrid.getCrs());
1158    
1159                                    readGG.setValue(new GridGeometry2D(new GeneralGridEnvelope(
1160                                                    new Rectangle(0, 0, 1, 1)), mapExtend));
1161    
1162                                    final FeatureCollection<SimpleFeatureType, SimpleFeature> rFc = (FeatureCollection<SimpleFeatureType, SimpleFeature>) geoObject;
1163    
1164                                    final AbstractGridCoverage2DReader aReader = (AbstractGridCoverage2DReader) FeatureUtil
1165                                                    .getWrappedGeoObject(rFc);
1166                                    final GridCoverage2D cov = (GridCoverage2D) aReader
1167                                                    .read(new GeneralParameterValue[] { readGG });
1168                                    colorModel = cov.getRenderedImage().getColorModel();
1169                            }
1170                    } catch (final Exception e) {
1171                            LOGGER.error("Error reading the colormodel from " + styledGrid, e);
1172                            return null;
1173                    }
1174                    return colorModel;
1175            }
1176    
1177            /**
1178             * @return <code>true</code> if a {@link RasterSymbolizer} can be applied
1179             *         and will have an effect. Some rasters (e.g. GeoTIFF) can come
1180             *         with their own {@link ColorModel} and will ignore any
1181             *         {@link RasterSymbolizer} = SLD.
1182             */
1183            public static boolean isStyleable(
1184                            final StyledRasterInterface<?> styledRaster) {
1185                    final ColorModel colorModel = getColorModel(styledRaster);
1186    
1187                    // LOGGER.info("The colormodel of " + styledRaster.getTitle() + " is "
1188                    // + colorModel != null ? colorModel.getClass().getSimpleName() :
1189                    // "NULL");
1190    
1191                    if (colorModel == null)
1192                            return true;
1193                    if (colorModel instanceof ComponentColorModel)
1194                            return true;
1195                    return false;
1196            }
1197    
1198            /**
1199             * Set the given Style as the Style of the {@link MapLayer}, unless the
1200             * styles are the same (not comparing selection stuff). If the
1201             * {@link MapLayer}s {@link Style} is changed, the selection FTS is kept.<br/>
1202             * Remember {@link MapLayer#setStyle(Style)} triggers an event leading to a
1203             * repaint, so only use it when needed.
1204             *
1205             * @return <code>true</code> if the {@link MapLayer}'s {@link Style} has
1206             *         been changed.
1207             */
1208            public static boolean updateMapLayerStyleIfChangedAndKeepSelection(
1209                            MapLayer mapLayer, Style style2) {
1210    
1211                    Style mapLayerStyleCleaned = StylingUtil
1212                                    .removeSelectionFeatureTypeStyle(mapLayer.getStyle());
1213    
1214                    Style newStyleCleaned = StylingUtil
1215                                    .removeSelectionFeatureTypeStyle(style2);
1216    
1217                    if (StylingUtil.isStyleDifferent(mapLayerStyleCleaned, newStyleCleaned)) {
1218    
1219                            // They are different when compared without SELECTION FTS!
1220    
1221                            // Now let's copy any SELECTION FTS to the now style
1222                            FeatureTypeStyle selectionFeatureTypeStyle = StylingUtil
1223                                            .getSelectionFeatureTypeStyle(mapLayer.getStyle());
1224                            if (selectionFeatureTypeStyle != null) {
1225                                    newStyleCleaned.featureTypeStyles().add(
1226                                                    selectionFeatureTypeStyle);
1227                                    // newStyleCleaned is not so clean anymore... We just alled a
1228                                    // selcetion FTS
1229                            }
1230    
1231                            mapLayer.setStyle(newStyleCleaned);
1232    
1233                            return true;
1234    
1235                    } else {
1236                            return false;
1237                    }
1238            }
1239    
1240            /**
1241             * After loading an atlas, the AttribteMetaData contains whatever is written
1242             * in the XML. But the DBF may have changed! This method checks an
1243             * {@link AttributeMetadataMap} against a schema and also corrects
1244             * upperCase/lowerCase problems. It will also remove any geometry column
1245             * attribute metadata.
1246             */
1247            /**
1248             * After loading an atlas, the AttribteMetaData contains whatever is written
1249             * in the XML. But the DBF may have changed!
1250             */
1251            public static void checkAttribMetaData(
1252                            AttributeMetadataMap<AttributeMetadataImpl> attributeMetaDataMap,
1253                            SimpleFeatureType schema) {
1254    
1255                    if (schema == null)
1256                            throw new IllegalArgumentException("schmema may not be null!");
1257    
1258                    ArrayList<Name> willRemove = new ArrayList<Name>();
1259    
1260                    // 1. Check.. all attributes in the atm should be in the schema as well.
1261                    // maybe correct some upperCase/loweCase stuff
1262    
1263                    for (AttributeMetadataInterface atm : attributeMetaDataMap.values()) {
1264    
1265                            AttributeDescriptor foundDescr = schema
1266                                            .getDescriptor(atm.getName());
1267                            if (foundDescr == null) {
1268                                    NameImpl bestMatch = FeatureUtil.findBestMatchingAttribute(schema,
1269                                                    atm.getLocalName());
1270                                    if (bestMatch == null)
1271                                            willRemove.add(atm.getName());
1272                                    else
1273                                            atm.setName(bestMatch);
1274                            } else if (foundDescr instanceof GeometryDescriptor) {
1275                                    // We don't want GeometryColumns in here
1276                                    willRemove.add(atm.getName());
1277                            }
1278                    }
1279    
1280                    // Remove the ones that were not findable in the schema
1281                    for (Name removeName : willRemove) {
1282                            if (attributeMetaDataMap.remove(removeName) == null) {
1283                                    LOGGER.warn("removing the AMData didn't work");
1284                            }
1285                    }
1286    
1287                    // 2. check... all attributes from the schema must have an ATM
1288                    for (AttributeDescriptor ad : schema.getAttributeDescriptors()) {
1289                            if (ad instanceof GeometryDescriptor)
1290                                    continue;
1291                            if (!attributeMetaDataMap.containsKey(ad.getName())) {
1292                                    attributeMetaDataMap.put( new NameImpl(ad.getName().getNamespaceURI(), ad.getName().getLocalPart()),
1293                                                    new AttributeMetadataImpl(ad, schema
1294                                                                    .getAttributeDescriptors().indexOf(ad),
1295                                                                    attributeMetaDataMap.getLanguages()));
1296                            }
1297                    }
1298            }
1299    
1300            /**
1301             * Checks every attribute name in the {@link AttributeMetadataMap} for its
1302             * binding type. It the type is textual, add the mrpty string as a NODATA
1303             * value.
1304             *
1305             * @param attributeMetaDataMap
1306             * @param schema
1307             */
1308            public static void addEmptyStringToAllTextualAttributes(
1309                            AttributeMetadataMap<? extends AttributeMetadataInterface> attributeMetaDataMap,
1310                            SimpleFeatureType schema) {
1311    
1312                    for (Name name : attributeMetaDataMap.keySet()) {
1313                            if (String.class.isAssignableFrom(schema.getDescriptor(name)
1314                                            .getType().getBinding())) {
1315                                    attributeMetaDataMap.get(name).getNodataValues().add("");
1316                            }
1317                    }
1318            }
1319    
1320            /**
1321             * @return a nicely formatted String containing all NODATA values of any
1322             *         {@link AttributeMetadataInterface} object. Strings are quoted so that any
1323             *         empty {@link String} can be seen.
1324             */
1325            public static String formatNoDataValues(Set<Object> nodataValuesList) {
1326                    String nicelyFormatted = "";
1327                    if (nodataValuesList != null) {
1328                            if (nodataValuesList.size() == 0)
1329                                    nicelyFormatted = "";
1330                            else {
1331                                    for (Object ndo : nodataValuesList) {
1332                                            if (ndo instanceof String)
1333                                                    nicelyFormatted += "\"" + ndo + "\"";
1334                                            else
1335                                                    nicelyFormatted += ndo.toString();
1336    
1337                                            nicelyFormatted += ",";
1338                                    }
1339                                    // Remove the extra comma
1340                                    nicelyFormatted = nicelyFormatted.substring(0, nicelyFormatted
1341                                                    .length() - 1);
1342                            }
1343                    }
1344                    return nicelyFormatted;
1345            }
1346    }

Legend:
Removed from v.111  
changed lines
  Added in v.788

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26