GeoTools学习笔记--MapContext
转载自：http://blog.csdn.net/hengcai001/article/details/4403264
MapContext:
代码段：
/*
* GeoTools - The Open Source Java GIS Toolkit
* http://geotools.org
*
* (C) 2003-2008, Open Source Geospatial Foundation (OSGeo)
*
* This library 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;
* version 2.1 of the License.
*
* This library 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
* Lesser General Public License for more details.
*/
package org.geotools.map;
import java.awt.geom.AffineTransform;
import java.io.IOException;
import java.util.Collection;
import java.util.Iterator;
import org.geotools.coverage.grid.io.AbstractGridCoverage2DReader;
import org.geotools.data.FeatureSource;
import org.geotools.feature.FeatureCollection;
import org.geotools.geometry.jts.ReferencedEnvelope;
import org.geotools.map.event.MapBoundsEvent;
import org.geotools.map.event.MapBoundsListener;
import org.geotools.map.event.MapLayerListListener;
import org.geotools.styling.Style;
import org.opengis.coverage.grid.GridCoverage;
import org.opengis.feature.simple.SimpleFeature;
import org.opengis.feature.simple.SimpleFeatureType;
import org.opengis.referencing.FactoryException;
import org.opengis.referencing.crs.CoordinateReferenceSystem;
import org.opengis.referencing.operation.TransformException;
import com.vividsolutions.jts.geom.Envelope;
/**
* Store context information about a map display. This object is based on the
* OGC Web Map Context Specification.
*
* @author Cameron Shorter
* @source $URL: http://svn.geotools.org/trunk/modules/library/render/src/main/java/org/geotools/map/MapContext.java $
* @version $Id: MapContext.java 30649 2008-06-12 19:44:08Z acuster $
*/
/**
*存储需要显示的图形信息
*该接口的定义根据OGC 的描述
*/
public interface MapContext {
/**
* Add a new layer if not already present and trigger a
* {@link LayerListEvent}.
*
* @param layer
* the layer to be inserted
*
* @return true if the layer has been added, false otherwise
*
*增加一个图层 MapLayer
*如果插入成功返回True 否则返回False
*
*/
boolean addLayer(MapLayer layer);
/**
* Add a new layer in the specified position and trigger a
* {@link LayerListEvent}. Layer won't be added if it's already in the
* list.
*
* @param index
* index at which the layer will be inserted
* @param layer
* the layer to be inserted
*
* @return true if the layer has been added, false otherwise
*
*在特定的Idex增加一个图层MapLayer
*如果插入成功返回True
*否则返回False
*/
boolean addLayer(int index, MapLayer layer);
/**
* Add a new layer and trigger a {@link LayerListEvent}.
*
* @param featureSource
* a FeatureSource<SimpleFeatureType, SimpleFeature> with the new layer that will be added.
*
*根据FeatureSource和Style增加一个图层
*/
void addLayer(FeatureSource<SimpleFeatureType, SimpleFeature> featureSource, Style style);
/**
* Add a new layer and trigger a {@link LayerListEvent}.
*
* @param collection
* a FeatureCollection<SimpleFeatureType, SimpleFeature> with the new layer that will be added.
*根据FeatureCollection增加一个图层
*/
void addLayer(FeatureCollection<SimpleFeatureType, SimpleFeature> collection, Style style);
/**
* Add a new layer and trigger a {@link LayerListEvent}.
*
* @param collection Collection with the new layer that will be added.
*、根据Collection增加图层
*/
void addLayer(Collection collection, Style style);
/**
* Add a new layer and trigger a {@link LayerListEvent}
*
* @param gridCoverage
* a GridCoverage with the new layer that will be added.
*
*增加GridCoverage型的图层
*/
void addLayer(GridCoverage gridCoverage, Style style);
/**
* Add a new layer and trigger a {@link LayerListEvent}
*
* @param gridCoverage
* an AbstractGridCoverage2DReader with the new layer that will be added.
*
*/
void addLayer(AbstractGridCoverage2DReader gridCoverage, Style style);
/**
* Remove a layer, if present, and trigger a {@link LayerListEvent}.
*
* @param layer
* a MapLayer that will be added.
*
* @return true if the layer has been removed
*
*移除一个图层
*/
boolean removeLayer(MapLayer layer);
/**
* Remove a layer and trigger a {@link LayerListEvent}.
*
* @param index
* The index of the layer that it's going to be removed
*
* @return the layer removed, if any
*
*根据索引来删除一个图层
*/
MapLayer removeLayer(int index);
/**
* Add an array of new layers and trigger a {@link LayerListEvent}.
*
* @param layers
* The new layers that are to be added.
*
* @return the number of layers actually added to the MapContext
*
*增加Layers数组
*/
int addLayers(MapLayer[] layers);
/**
* Remove an array of layers and trigger a {@link LayerListEvent}.
*
* @param layers
* The layers that are to be removed.
*/
void removeLayers(MapLayer[] layers);
/**
* Clears the whole layer list. Will fire a LayerListChangedEvent
*清空列表
*/
void clearLayerList();
/**
* Return this model's list of layers. If no layers are present, then an
* empty array is returned.
*
* @return This model's list of layers.
*
*得到图层列表
*/
MapLayer[] getLayers();
/**
* Return the requested layer.
*
* @param index
* index of layer to return.
*
* @return the layer at the specified position
*
* @throws IndexOutOfBoundsException
* if the index is out of range
*根据索引返回图层
*/
MapLayer getLayer(int index) throws IndexOutOfBoundsException;
/**
* Moves a layer from a position to another. Will fire a MapLayerListEvent
*
* @param sourcePosition
* the layer current position
* @param destPosition
* the layer new position
*移动图层
*/
void moveLayer(int sourcePosition, int destPosition);
/**
* Returns an iterator over the layers in this context in proper sequence.
*
* @return an iterator over the layers in this context in proper sequence.
*返回一个迭代器
*/
Iterator iterator();
/**
* Returns the index of the first occurrence of the specified layer, or -1
* if this list does not contain this element.
*
* @param layer
* the MapLayer to search for
*
* @return DOCUMENT ME!
*返回一个layer
*的索引
*/
int indexOf(MapLayer layer);
/**
* Returns the number of layers in this map context
*
* @return the number of layers in this map context
*返回图层个数
*/
int getLayerCount();
/**
* Get the bounding box of all the layers in this MapContext. If all the
* layers cannot determine the bounding box in the speed required for each
* layer, then null is returned. The bounds will be expressed in the
* MapContext coordinate system.
*
* @return The bounding box of the features or null if unknown and too
* expensive for the method to calculate.
*
* @throws IOException
* if an IOException occurs while accessing the FeatureSource
* bounds
* 返回Bounds的BOX
*/
ReferencedEnvelope getLayerBounds() throws IOException;
/**
* Register interest in receiving a {@link LayerListEvent}. A
* <code>LayerListEvent</code> is sent if a layer is added or removed, but
* not if the data within a layer changes.
*
* @param listener
* The object to notify when Layers have changed.
*增加一图层事件监听器
*如果图层增加或者删除该事件被激发
*/
void addMapLayerListListener(MapLayerListListener listener);
/**
* Remove interest in receiving {@link LayerListEvent}.
*
* @param listener
* The object to stop sending <code>LayerListEvent</code>s.
*移除事件监听器
*/
void removeMapLayerListListener(MapLayerListListener listener);
/**
* Set a new area of interest and trigger a {@link BoundingBoxEvent}.
*
* @param areaOfInterest
* The new areaOfInterest.
* @param coordinateReferenceSystem
* The coordinate system being using by this model.
*
* @throws IllegalArgumentException
* if an argument is <code>null</code>.
*
*
*设置感兴趣的区域Envelope
*激发BoundBox事件
*/
void setAreaOfInterest(Envelope areaOfInterest,
CoordinateReferenceSystem coordinateReferenceSystem)
throws IllegalArgumentException;
/**
* Set a new area of interest and trigger an {@link BoundingBoxEvent}.
*
* @param areaOfInterest
* The new area of interest.
*
* @throws IllegalArgumentException
* if an argument is <code>null</code>.
* @deprecated Please use {@link #setAreaOfInterest(ReferencedEnvelope)}
* or {@link #setAreaOfInterest(Envelope, CoordinateReferenceSystem)}
*/
void setAreaOfInterest(Envelope areaOfInterest)
throws IllegalArgumentException;
/**
* Set a new area of interest and trigger an {@link BoundingBoxEvent}.
*
* @param areaOfInterest
* The new area of interest.
*
* @throws IllegalArgumentException
* if an argument is <code>null</code>.
*
*/
void setAreaOfInterest(ReferencedEnvelope areaOfInterest);
/**
* Gets the current area of interest.
*
* @return Current area of interest
*
*/
ReferencedEnvelope getAreaOfInterest();
/**
* Get the current coordinate system.
*
* @return the coordinate system of this box.
*返回现有图层的坐标参考系统
*/
CoordinateReferenceSystem getCoordinateReferenceSystem();
/**
* Transform the coordinates according to the provided transform. Useful for
* zooming and panning processes.
*
* @param transform
* The transform to change area of interest.
*转化坐标系统
*/
void transform(AffineTransform transform);
/**
* Register interest in receiving {@link MapBoundsEvent}s.
*
* @param listener
* The object to notify when the area of interest has changed.
*增加时间监听器
*/
void addMapBoundsListener(MapBoundsListener listener);
/**
* Remove interest in receiving a {@link BoundingBoxEvent}s.
*
* @param listener
* The object to stop sending change events.
*/
void removeMapBoundsListener(MapBoundsListener listener);
/**
* Get the abstract which describes this interface, returns an empty string
* if this has not been set yet.
*
* @return The Abstract.
*返回该接口的描述信息
*/
String getAbstract();
/**
* Set an abstract which describes this context.
*
* @param conAbstract
* the Abstract.
*设置该接口的描述信息
*/
void setAbstract(final String conAbstract);
/**
* Get the contact information associated with this context, returns an
* empty string if contactInformation has not been set.
*
* @return the ContactInformation.
*返回相关信息的描述
*/
String getContactInformation();
/**
* Set contact inforation associated with this class.
*
* @param contactInformation
* the ContactInformation.
*/
void setContactInformation(final String contactInformation);
/**
* Set the <code>CoordinateReferenceSystem</code> for this map context.
*
* @param crs
* @throws FactoryException
* @throws TransformException
*设置坐标参考信息
*/
void setCoordinateReferenceSystem(final CoordinateReferenceSystem crs)
throws TransformException, FactoryException;
/**
* Get an array of keywords associated with this context, returns an empty
* array if no keywords have been set. The array returned is a copy, changes
* to the returned array won't influence the MapContextState
*
* @return array of keywords
*/
String[] getKeywords();
/**
* Set an array of keywords to associate with this context.
*
* @param keywords
* the Keywords.
*/
void setKeywords(final String[] keywords);
/**
* Get the title, returns an empty string if it has not been set yet.
*
* @return the title, or an empty string if it has not been set.
*/
String getTitle();
/**
* Set the title of this context.
*
* @param title
* the title.
*/
void setTitle(final String title);
/**
* Registers PropertyChangeListener to receive events.
*
* @param listener
* The listener to register.
增加实践监听器
*/
public void addPropertyChangeListener(
java.beans.PropertyChangeListener listener);
/**
* Removes PropertyChangeListener from the list of listeners.
*
* @param listener
* The listener to remove.
*/
public void removePropertyChangeListener(
java.beans.PropertyChangeListener listener);
}