skrueger/geotools/MapContextManagerInterface.java

/*******************************************************************************
 * Copyright (c) 2009 Martin O. J. Schmitz.
 * 
 * This file is part of the SCHMITZM library - a collection of utility 
 * classes based on Java 1.6, focusing (not only) on Java Swing 
 * and the Geotools library.
 * 
 * The SCHMITZM project is hosted at:
 * http://wald.intevation.org/projects/schmitzm/
 * 
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public License (license.txt)
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 * or try this link: http://www.gnu.org/licenses/lgpl.html
 * 
 * Contributors:
 *     Martin O. J. Schmitz - initial API and implementation
 *     Stefan A. Tzeggai - additional utility classes
 ******************************************************************************/
package skrueger.geotools;
import java.util.List;

import org.geotools.map.MapContext;
import org.geotools.map.MapLayer;
import org.geotools.map.event.MapLayerListListener;

import skrueger.AttributeMetadataImpl;
import skrueger.RasterLegendData;

/**
 * Implementations of this class can can be used to fill/insert/remove a mapContext
 * with {@link StyledLayerInterface} objects.
 *
 * @author <a href="mailto:[email protected]">Stefan Alfons Tzeggai</a>
 *
 */
public interface MapContextManagerInterface {

        /**
         * Add a {@link StyledLayerInterface} object into the underlying {@link MapContext}
         * as the topmost layer
         *
         * @param styledLayer Layer to add to the map
         */
        boolean addStyledLayer (StyledLayerInterface<?> styledLayer);

        /**
         * @param mapContextIdx Index in the {@link MapContext}, bottom first
         * @return successful?
         */
        boolean removeStyledLayer (int mapContextIdx);

        /**
         * Inserts a {@link StyledLayerInterface} object into the underlying {@link MapContext}
         * at the given position
         */
        boolean insertStyledLayer (StyledLayerInterface<?> styledLayer, int mapContextIdx);

        /** Add {@link MapLayerListListener} */
        void addMapLayerListListener( MapLayerListListener listener);

        /** Remove {@link MapLayerListListener} */
        void removeMapLayerListListener( MapLayerListListener listener);

        /**
         * Help the GC by disposing this Component
         */
        void dispose();

        /**
         * Returns a ordered list of the layers that are contained in the underlying {@link MapContext}
         */
        List<StyledLayerInterface<?>> getStyledObjects();

        /**
         * Returns a list of {@link AttributeMetadataImpl} that shall be shown (e.g. when the Mouse clicked into the map)
         * Returns an empty list if the layer doesn't exist or is not backed by a {@link StyledFeatureCollectionInterface}
         */
        List<AttributeMetadataImpl> getVisibleAttribsFor(MapLayer mapLayer);

        /**
         * Returns the title of the layer
         * @param mapLayer {@link MapLayer}
         * @return <code>null</code>, if the layer is unknown
         */
        String getTitleFor(MapLayer mapLayer);

        /**
         * Returns the description of the layer
         * @param mapLayer {@link MapLayer}
         * @return <code>null</code>, if the layer is unknown. Empty String if the description is empty
         */
        String getDescFor(MapLayer mapLayer);

        /**
         * Returns the {@link RasterLegendData} object for the layer.
         * @return null, if the layer is not found or of type raster
         */
        RasterLegendData getLegendMetaData(MapLayer mapLayer);

        /**
         * Returns the {@link StyledLayerInterface} object that is associated with the layer or NULL if the layer can't be found.
         */
        StyledLayerInterface<?> getStyledObjectFor(MapLayer layer);
        
        /**
         * @return The {@link MapContext} managed by this {@link MapContextManagerInterface} 
         */
        MapContext getMapContext();

}
1	alfonx	244	/*******************************************************************************
2			* Copyright (c) 2009 Martin O. J. Schmitz.
3			*
4			* This file is part of the SCHMITZM library - a collection of utility
5	alfonx	256	* classes based on Java 1.6, focusing (not only) on Java Swing
6	alfonx	244	* and the Geotools library.
7			*
8			* The SCHMITZM project is hosted at:
9			* http://wald.intevation.org/projects/schmitzm/
10			*
11			* This program is free software; you can redistribute it and/or
12			* modify it under the terms of the GNU Lesser General Public License
13			* as published by the Free Software Foundation; either version 3
14			* of the License, or (at your option) any later version.
15			*
16			* This program is distributed in the hope that it will be useful,
17			* but WITHOUT ANY WARRANTY; without even the implied warranty of
18			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19			* GNU General Public License for more details.
20			*
21			* You should have received a copy of the GNU Lesser General Public License (license.txt)
22			* along with this program; if not, write to the Free Software
23			* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
24			* or try this link: http://www.gnu.org/licenses/lgpl.html
25			*
26			* Contributors:
27			* Martin O. J. Schmitz - initial API and implementation
28	alfonx	862	* Stefan A. Tzeggai - additional utility classes
29	alfonx	244	******************************************************************************/
30			package skrueger.geotools;
31			import java.util.List;
32
33			import org.geotools.map.MapContext;
34			import org.geotools.map.MapLayer;
35			import org.geotools.map.event.MapLayerListListener;
36
37	alfonx	769	import skrueger.AttributeMetadataImpl;
38	alfonx	244	import skrueger.RasterLegendData;
39
40			/**
41			* Implementations of this class can can be used to fill/insert/remove a mapContext
42			* with {@link StyledLayerInterface} objects.
43			*
44	alfonx	1273	* @author <a href="mailto:[email protected]">Stefan Alfons Tzeggai</a>
45	alfonx	244	*
46			*/
47			public interface MapContextManagerInterface {
48
49			/**
50			* Add a {@link StyledLayerInterface} object into the underlying {@link MapContext}
51			* as the topmost layer
52			*
53			* @param styledLayer Layer to add to the map
54			*/
55			boolean addStyledLayer (StyledLayerInterface<?> styledLayer);
56
57			/**
58			* @param mapContextIdx Index in the {@link MapContext}, bottom first
59			* @return successful?
60			*/
61			boolean removeStyledLayer (int mapContextIdx);
62
63			/**
64			* Inserts a {@link StyledLayerInterface} object into the underlying {@link MapContext}
65			* at the given position
66			*/
67			boolean insertStyledLayer (StyledLayerInterface<?> styledLayer, int mapContextIdx);
68
69	alfonx	507	/** Add {@link MapLayerListListener} */
70	alfonx	244	void addMapLayerListListener( MapLayerListListener listener);
71
72	alfonx	507	/** Remove {@link MapLayerListListener} */
73	alfonx	244	void removeMapLayerListListener( MapLayerListListener listener);
74
75			/**
76			* Help the GC by disposing this Component
77			*/
78			void dispose();
79
80			/**
81			* Returns a ordered list of the layers that are contained in the underlying {@link MapContext}
82			*/
83			List<StyledLayerInterface<?>> getStyledObjects();
84
85			/**
86	alfonx	769	* Returns a list of {@link AttributeMetadataImpl} that shall be shown (e.g. when the Mouse clicked into the map)
87	alfonx	244	* Returns an empty list if the layer doesn't exist or is not backed by a {@link StyledFeatureCollectionInterface}
88			*/
89	alfonx	769	List<AttributeMetadataImpl> getVisibleAttribsFor(MapLayer mapLayer);
90	alfonx	244
91			/**
92			* Returns the title of the layer
93			* @param mapLayer {@link MapLayer}
94			* @return <code>null</code>, if the layer is unknown
95			*/
96			String getTitleFor(MapLayer mapLayer);
97
98			/**
99			* Returns the description of the layer
100			* @param mapLayer {@link MapLayer}
101			* @return <code>null</code>, if the layer is unknown. Empty String if the description is empty
102			*/
103			String getDescFor(MapLayer mapLayer);
104
105			/**
106			* Returns the {@link RasterLegendData} object for the layer.
107			* @return null, if the layer is not found or of type raster
108			*/
109			RasterLegendData getLegendMetaData(MapLayer mapLayer);
110
111			/**
112			* Returns the {@link StyledLayerInterface} object that is associated with the layer or NULL if the layer can't be found.
113			*/
114			StyledLayerInterface<?> getStyledObjectFor(MapLayer layer);
115	alfonx	294
116			/**
117			* @return The {@link MapContext} managed by this {@link MapContextManagerInterface}
118			*/
119			MapContext getMapContext();
120
121	alfonx	244	}