| 包 | com.supermap.web.mapping |
| 类 | public class DynamicRESTLayer |
| 继承 | DynamicRESTLayer  DynamicLayer ImageLayer Layer mx.core.UIComponent |
该类继承 DynamicLayer，支持 SuperMap iServer Java 6R 的 REST 地图服务的动态栅格图层。必设属性为 Url。
REST （REpresentational State Transfer，表述性状态转移）是一种面向资源的架构（Resource-Oriented Architecture，ROA）风格。资源可以是具体的数据，也可以是能够实现某些功能的服务，资源通常由 URI（Uniform Resource Identifier，统一资源标识符）唯一标识，客户端的应用通过 URI 来获取资源的表述，客户端获得这些表述致使应用程序状态发生改变，即，表述性的状态转变。有关 REST 服务请参见 “SuperMap iServer Java 6R 帮助文档”。
| 属性 | 定义方 | ||
|---|---|---|---|
| adjustFactor : Number
获取或设置地图坐标比例因子，取值范围大于0，建议在 1 附近取值。如果发现图层叠加时有偏移，可通过该属性移动图层，使图层正确叠加。
|
DynamicRESTLayer | ||
 |
bounds : Rectangle2D
当前图层的地理范围，若当前图层为 Map 的第一个图层，且 Map 的 ViewBounds 为 null，则将当前图层的 bounds 作为 Map 的 ViewBounds。一般情况下该属性默认值为（0,0,0,0）。若当前图层为 WMTS 图层（TiledWMTSLayer），则 bounds 的默认值参考 WMTS 标准而定...
|
Layer | |
| clipRegion : GeoRegion
剪裁多边形。指定该属性后，当前图层仅显示该多边形内的地图。
|
DynamicRESTLayer | ||
|
CRS : CoordinateReferenceSystem
获取或设置当前图层的坐标参考系（ CoordinateReferenceSystem ）。默认值为 null。设置 CoordinateReferenceSystem.wkid 属性后，图层将被动态投影至 wkid 所代表的投影坐标系下，若 wkid 小于等于 0 则不进行动态投影...
|
Layer | |
| customServiceParams : Object
获取或设置用户参数，如 DynamicRESTLayer.customServiceParams.angle = 90，用于设置当前图层的旋转角度.
|
DynamicRESTLayer | ||
| enableServerCaching : Boolean
获取或设置是否使用服务端的缓存，默认为 true，即使用服务端的缓存。在编辑功能时，需要将该属性设为 false，否则影响编辑后的显示效果。
|
DynamicRESTLayer | ||
|
imageFormat : String
获取或设置载入 ImageLayer 的图片格式，默认为 png 格式。
|
ImageLayer | |
|
isInResolutionRange : Boolean
[read-only] 判断与当前图层关联的 Map 的分辨率是否在当前图层的最大、最小分辨率范围内。true 表示在最大、最小范围内。
|
Layer | |
| isScaleCentric : Boolean
[Override] [read-only] 指示该图层是否有 DPI 值，ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI；false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。
|
DynamicRESTLayer | ||
| layersID : String
获取或设置专题图资源 ID.
|
DynamicRESTLayer | ||
|
loaded : Boolean
[read-only] 若当前图层已加载完闭则返回 true，否则返回 false。
|
Layer | |
|
maxVisibleResolution : Number
当前图层的最大显示分辨率。即当图层缩放至该分辨率时就不能再放大。
|
Layer | |
| maxVisibleVertex : int
获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数，则超过的那部分节点不显示。
|
DynamicRESTLayer | ||
|
metadata : Object
获取或设置当前图层信息，包括图层标题、描述信息、图层所在地图控件名称。
|
Layer | |
|
minVisibleResolution : Number
当前图层的最小显示分辨率。即当图层缩放至该分辨率时就不能再缩小。
|
Layer | |
|
resolution : Number
[read-only] 获取当前图层的显示分辨率。
|
Layer | |
|
transparent : Boolean
指定图片是否透明显示。
|
ImageLayer | |
| url : String
[Override] 图层所在的服务地址。
|
DynamicRESTLayer | ||
|
visible : Boolean
[Override] 获取或设置当前图层是否可见。
|
Layer | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
初始化 DynamicRESTLayer 类的新实例。
|
DynamicRESTLayer | ||
|
refresh():void
[Override] 刷新图层，即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法)，更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。
|
DynamicRESTLayer | ||
| 方法 | 定义方 | ||
|---|---|---|---|
|
addedHandler(event:Event):void
处理 Event.ADDED 事件的侦听器函数。
|
Layer | |
|
addMapListeners():void
为当前图层添加事件侦听器，以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。
|
Layer | |
|
计算图片的地理范围。
|
DynamicLayer | |
|
draw():void
[Override] 渲染出图，注意：子类必须重写该方法来实现渲染出图。
|
DynamicLayer | |
|
hideHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.HIDE 事件的侦听器函数。
|
DynamicLayer | |
|
invalidateLayer():void
通过子类调用以更新图层。
|
Layer | |
|
loadMapImage(loader:Loader):void
[Override] 载入图片（ PNG、JPEG ）。
|
DynamicRESTLayer | ||
|
removeAllChildren():void
删除 Layer 上的所有对象。
|
Layer | |
|
removedHandler(event:Event):void
[Override] 处理 Event.REMOVED 事件的侦听器函数。
|
DynamicLayer | |
|
removeMapListeners():void
移除通过 addMapListeners 添加的事件侦听器。
|
Layer | |
|
setLoaded(value:Boolean):void
设置图层是否加载完闭，会触发 LayerEvent.LOAD 事件。true 表示当前图层已加载完毕。注意：任何继承 Layer 的子类都必须在 Layer 初始化完成之后调用该接口设置对应的图层是否加载完毕。
|
Layer | |
|
showHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.SHOW 事件的侦听器函数。
|
DynamicLayer | |
|
viewBoundsChangedHandler(event:ViewBoundsEvent):void
处理 viewBoundsChanged 事件的侦听器函数。
|
Layer | |
|
zoomEndHandler(event:ZoomEvent):void
[Override] 处理 zoomEnd 事件的侦听器函数。
|
DynamicLayer | |
|
zoomStartHandler(event:ZoomEvent):void
[Override] 处理 zoomStart 事件的侦听器函数。
|
DynamicLayer | |
|
zoomUpdateHandler(event:ZoomEvent):void
[Override] 处理 zoomUpdate 事件的侦听器函数。
|
DynamicLayer | |
| adjustFactor | 属性 |
隐藏继承的公共属性
显示继承的公共属性adjustFactor:Number
获取或设置地图坐标比例因子，取值范围大于0，建议在 1 附近取值。如果发现图层叠加时有偏移，可通过该属性移动图层，使图层正确叠加。
默认值为： 1.0.
public function get adjustFactor():Number public function set adjustFactor(value:Number):void| clipRegion | 属性 |
clipRegion:GeoRegion
剪裁多边形。指定该属性后，当前图层仅显示该多边形内的地图。
public function get clipRegion():GeoRegion public function set clipRegion(value:GeoRegion):void| customServiceParams | 属性 |
customServiceParams:Object
获取或设置用户参数，如 DynamicRESTLayer.customServiceParams.angle = 90，用于设置当前图层的旋转角度.
本客户端产品中所指的图层等同于服务器产品的地图 Map，SuperMap iServer Java 6R 服务器产品在 Map 中提供了多种有关地图的属性，若本客户端产品中的图层未提供某些属性，用户即可用 customServiceParams 进行设置（如：DynamicRESTLayer.customServiceParams.angle = 90），系统内部会自动将参数传递到服务端，并获取服务端返回的地图显示结果信息，在客户端进行出图显示。
public function get customServiceParams():Object public function set customServiceParams(value:Object):void| enableServerCaching | 属性 |
enableServerCaching:Boolean
获取或设置是否使用服务端的缓存，默认为 true，即使用服务端的缓存。在编辑功能时，需要将该属性设为 false，否则影响编辑后的显示效果。
public function get enableServerCaching():Boolean public function set enableServerCaching(value:Boolean):void| isScaleCentric | 属性 |
isScaleCentric:Boolean [read-only] [Override]
指示该图层是否有 DPI 值，ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI；false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。
public function get isScaleCentric():Boolean| layersID | 属性 |
layersID:String
获取或设置专题图资源 ID.
服务端生成的专题图以资源的形式存储在服务端，每个资源都会有一个 ID 号和一个获取资源的地址 url（不同于地图 url）。将资源的 ID 号赋值于该属性是在客户端显示专题图的关键步骤。
public function get layersID():String public function set layersID(value:String):void| maxVisibleVertex | 属性 |
maxVisibleVertex:int
获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数，则超过的那部分节点不显示。
public function get maxVisibleVertex():int public function set maxVisibleVertex(value:int):void| url | 属性 |
url:String[Override]
图层所在的服务地址。
public function get url():String public function set url(value:String):void| DynamicRESTLayer | () | 构造函数 |
public function DynamicRESTLayer()
初始化 DynamicRESTLayer 类的新实例。
| loadMapImage | () | 方法 |
override protected function loadMapImage(loader:Loader):void
载入图片（ PNG、JPEG ）。
参数
loader:Loader — 需要载入的图片。 |
| refresh | () | 方法 |
override public function refresh():void
刷新图层，即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法)，更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。