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

Legend:
Removed from v.43  
changed lines
  Added in v.604

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26