com.supermap.web.mapping
public class TiledDynamicRESTLayer
继承 TiledDynamicRESTLayer Inheritance TiledDynamicLayer Inheritance TiledLayer Inheritance ImageLayer Inheritance Layer Inheritance mx.core.UIComponent
子类 UTFGridLayer

SuperMap iServer Java 6R 分块动态 REST 图层.

该类继承 TiledDynamicLayer,支持 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 附近取值。如果发现图层叠加时有偏移,可通过该属性移动图层,使图层正确叠加。
TiledDynamicRESTLayer
  Inherited bounds : Rectangle2D
当前图层的地理范围,若当前图层为 Map 的第一个图层,且 Map 的 ViewBounds 为 null,则将当前图层的 bounds 作为 Map 的 ViewBounds。一般情况下该属性默认值为(0,0,0,0)。若当前图层为 WMTS 图层(TiledWMTSLayer),则 bounds 的默认值参考 WMTS 标准而定...
Layer
    clipRegion : GeoRegion
剪裁多边形。指定该属性后,当前图层仅显示该多边形内的地图。
TiledDynamicRESTLayer
  Inherited CRS : CoordinateReferenceSystem
获取或设置当前图层的坐标参考系( CoordinateReferenceSystem )。默认值为 null。设置 CoordinateReferenceSystem.wkid 属性后,图层将被动态投影至 wkid 所代表的投影坐标系下,若 wkid 小于等于 0 则不进行动态投影...
Layer
    customServiceParams : Object
获取或设置用户参数,如 DynamicRESTLayer.customServiceParams.angle = 90,用于设置当前图层的旋转角度.
TiledDynamicRESTLayer
    enableServerCaching : Boolean
获取或设置是否使用服务端的缓存,默认为 true,即使用服务端的缓存。在编辑功能时,需要将该属性设为 false,否则影响编辑后的显示效果。
TiledDynamicRESTLayer
  Inherited fadeInFrameCount : uint
获取或设置图层在缩放过程中渐显帧数,这样可使缩放过程更加平滑。默认值为4.
TiledLayer
  Inherited imageFormat : String
获取或设置载入 ImageLayer 的图片格式,默认为 png 格式。
ImageLayer
  Inherited 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。
TiledDynamicRESTLayer
    layersID : String
图层 ID ,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片...
TiledDynamicRESTLayer
  Inherited loaded : Boolean
[read-only] 若当前图层已加载完闭则返回 true,否则返回 false。
Layer
  Inherited localStorage : LocalStorage
LocalStorage 对象。该属性与 memoryStorageEnabled 属性为 true 时的功能类似,不同之处在于 memoryStorageEnabled 是将地图数据缓存至内存,且浏览器关闭后会被清除;而 localStorage 是将数据缓存至本地磁盘,由用户清除缓存数据...
TiledLayer
  Inherited maxVisibleResolution : Number
当前图层的最大显示分辨率。即当图层缩放至该分辨率时就不能再放大。
Layer
    maxVisibleVertex : int
获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数,则超过的那部分节点不显示。
TiledDynamicRESTLayer
  Inherited memoryStorageEnabled : Boolean
是否使用内存数据。当该属性为 true 时表示在浏览器中浏览地图时,系统内部会自动将地图数据缓存至本地内存中,并读取已有的地图缓存数据。在浏览器未关闭的情况下,内存中的缓存数据会一直存在,用户在浏览地图时一直访问的是本地已缓存的数据,对于重复浏览地图可大幅提升浏览速度;若浏览器关闭,缓存会自动清除。默认值为 false...
TiledLayer
  Inherited metadata : Object
获取或设置当前图层信息,包括图层标题、描述信息、图层所在地图控件名称。
Layer
  Inherited minVisibleResolution : Number
当前图层的最小显示分辨率。即当图层缩放至该分辨率时就不能再缩小。
Layer
  Inherited origin : Point2D
获取或设置分块图层的起点坐标(左上角点).
TiledLayer
    overlapDisplayed : Boolean
地图对象在同一范围内时,是否重叠显示,默认为false。
TiledDynamicRESTLayer
    overlapDisplayedOptions : OverlapDisplayedOptions
避免地图对象压盖显示的过滤选项,当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。
TiledDynamicRESTLayer
    redirect : Boolean
是否重定向,HTTP传输中的一个概念。如果为true,则将请求重定向到图片的真实地址;如果为false,则响应体中是图片的字节流。默认为false,不进行重定向。
TiledDynamicRESTLayer
  Inherited resolution : Number
[read-only] 获取当前图层的显示分辨率。
Layer
  Inherited tileBufferCount : int
TiledLayer
  Inherited tileSize : int
获取或者设置图层分块大小,单位为像素,默认值为 512.
TiledLayer
    tileversion : String
指定请求瓦片的版本号。
TiledDynamicRESTLayer
  Inherited transparent : Boolean
指定图片是否透明显示。
ImageLayer
    url : String
[Override] 图层所在的服务地址。
TiledDynamicRESTLayer
    urls : Array
TiledDynamicRESTLayer轮询出图服务地址
TiledDynamicRESTLayer
  Inherited viewRegion : GeoRegion
获取或设置分块图层的出图控制范围.
TiledLayer
  Inherited visible : Boolean
[Override] 获取或设置当前图层是否可见。
Layer
受保护的属性
  属性 定义方
  Inherited dpi : Number
获取当前图层的扫描精度,即单位面积内的像素的个数...
Layer
  Inherited _urls : Array
TiledLayer
公共方法
  方法 定义方
   
初始化 TiledDynamicRESTLayer 类的新实例。
TiledDynamicRESTLayer
   
refresh():void
[Override] 刷新图层,即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法),更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。
TiledDynamicRESTLayer
  Inherited
selectUrls(row:int, col:int):String
TiledLayer
受保护的方法
  方法 定义方
  Inherited
addedHandler(event:Event):void
处理 Event.ADDED 事件的侦听器函数。
Layer
  Inherited
[Override] 为当前图层添加事件侦听器,以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。
TiledLayer
  Inherited
draw():void
[Override] 渲染出图,注意:子类必须重写该方法来实现渲染出图。
TiledLayer
   
getTileURL(row:int, col:int, resolution:Number):URLRequest
[Override] 获取指定图片块在服务器端的存放地址。
TiledDynamicRESTLayer
  Inherited
hideHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.HIDE 事件的侦听器函数。
TiledLayer
  Inherited
通过子类调用以更新图层。
Layer
  Inherited
[Override] 删除 Layer 上的所有对象。
TiledLayer
  Inherited
removedHandler(event:Event):void
[Override] 处理 Event.REMOVED 事件的侦听器函数。
TiledLayer
  Inherited
[Override] 移除通过 addMapListeners 添加的事件侦听器。
TiledLayer
  Inherited
setLoaded(value:Boolean):void
设置图层是否加载完闭,会触发 LayerEvent.LOAD 事件。true 表示当前图层已加载完毕。注意:任何继承 Layer 的子类都必须在 Layer 初始化完成之后调用该接口设置对应的图层是否加载完毕。
Layer
  Inherited
showHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.SHOW 事件的侦听器函数。
TiledLayer
  Inherited
[Override] 处理 viewBoundsChanged 事件的侦听器函数。
TiledLayer
  Inherited
[Override] 处理 zoomEnd 事件的侦听器函数。
TiledLayer
  Inherited
[Override] 处理 zoomStart 事件的侦听器函数。
TiledLayer
  Inherited
[Override] 处理 zoomUpdate 事件的侦听器函数。
TiledLayer
事件
  事件 Summary 定义方
  Inherited TiledLayer
  Inherited 当 Layer 的 IsInResolutionRange 属性发生变化时触发该事件。 Layer
  Inherited 当图层初始化完成时触发该事件。 Layer
  Inherited 当载入图层出错时触发该事件。 Layer
  Inherited 当图层最大显示分辨率改变时触发该事件。 Layer
  Inherited 当图层最小显示分辨率改变时触发该事件。 Layer
  Inherited 当完成更新图层时触发该事件。 Layer
  Inherited 当更新图层开始时触发该事件。 Layer
  Inherited 当图层的 visible 属性发生改变时触发该事件。 Layer
属性详细信息
adjustFactor 属性
adjustFactor:Number

获取或设置地图坐标比例因子,取值范围大于0,建议在 1 附近取值。如果发现图层叠加时有偏移,可通过该属性移动图层,使图层正确叠加。


Implementation
    public function get adjustFactor():Number
    public function set adjustFactor(value:Number):void
clipRegion 属性  
clipRegion:GeoRegion

剪裁多边形。指定该属性后,当前图层仅显示该多边形内的地图。


Implementation
    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),系统内部会自动将参数传递到服务端,并获取服务端返回的地图显示结果信息,在客户端进行出图显示。


Implementation
    public function get customServiceParams():Object
    public function set customServiceParams(value:Object):void
enableServerCaching 属性  
enableServerCaching:Boolean

获取或设置是否使用服务端的缓存,默认为 true,即使用服务端的缓存。在编辑功能时,需要将该属性设为 false,否则影响编辑后的显示效果。


Implementation
    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。


Implementation
    public function get isScaleCentric():Boolean
layersID 属性  
layersID:String

图层 ID ,可以是临时图层集,也可以是当前地图中图层的组合。如果此参数缺省则对全部图层进行切片...

layersID 作为临时图层集 ID 使用:例如服务端生成的专题图以资源的形式存储,每个资源都会有一个 ID 号,将资源的 ID 号赋值于该属性是在客户端显示专题图的关键步骤,如 layersID=382139acf0。
layersID 作为当前图层中的某些子图层的 ID 编号使用时,可控制子图层的可见性,此时 layersID 的定义规则如下:
1. 各级图层按照图层顺序自上而下从0开始编号;
2. 冒号(:)前为顶级图层;
3. 英文句号(.)表示其他各级图层间的从属关系;
4. 英文逗号(,)表示图层间的分隔。
例如:
1. [0:0,1,2.0]表示顶级图层0下面的子图层:0、1及其下属所有子图层,和2下的子图层0;
2. [1:1.2,2]表示顶级级图层1下面的子图层:1下的子图层2,和图层2及其下属所有子图层;
3. 两个示例合并在一起则是:[0:0,1,2.0,1:1.2,2]
此外,[0,1,2,3]表示顶级图层0下面的图层0、1、2、3及所有子图层,[0:,1:,2:]表示顶级图层0、1、2及其所有子图层。
例如,进入http://local:8090/iserver/services/maps/rest/maps/World/layers资源,显示出顶级图层 World(如下图),点击进入World资源下,可见顶级图层下包含多个子图层:

如果只显示 World 图层下的 OceanLabel_C@World@@World 子图层,则 layersID = [0:0]。


Implementation
    public function get layersID():String
    public function set layersID(value:String):void
maxVisibleVertex 属性  
maxVisibleVertex:int

获取或设置最大几何对象可见节点数。如果图层中的某个几何对象的节点数超过指定的个数,则超过的那部分节点不显示。


Implementation
    public function get maxVisibleVertex():int
    public function set maxVisibleVertex(value:int):void
overlapDisplayed 属性  
overlapDisplayed:Boolean

地图对象在同一范围内时,是否重叠显示,默认为false。


Implementation
    public function get overlapDisplayed():Boolean
    public function set overlapDisplayed(value:Boolean):void
overlapDisplayedOptions 属性  
overlapDisplayedOptions:OverlapDisplayedOptions

避免地图对象压盖显示的过滤选项,当 overlapDisplayed为 false 时有效,用来增强对地图对象压盖时的处理。


Implementation
    public function get overlapDisplayedOptions():OverlapDisplayedOptions
    public function set overlapDisplayedOptions(value:OverlapDisplayedOptions):void
redirect 属性  
redirect:Boolean

是否重定向,HTTP传输中的一个概念。如果为true,则将请求重定向到图片的真实地址;如果为false,则响应体中是图片的字节流。默认为false,不进行重定向。


Implementation
    public function get redirect():Boolean
    public function set redirect(value:Boolean):void
tileversion 属性  
tileversion:String

指定请求瓦片的版本号。


Implementation
    public function get tileversion():String
    public function set tileversion(value:String):void
url 属性  
url:String[Override]

图层所在的服务地址。


Implementation
    public function get url():String
    public function set url(value:String):void
urls 属性  
urls:Array

TiledDynamicRESTLayer轮询出图服务地址

此属性可用作数据绑定的源。修改此属性后,将调度 Bindable 事件。


Implementation
    public function get urls():Array
    public function set urls(value:Array):void
构造函数详细信息
TiledDynamicRESTLayer () 构造函数
public function TiledDynamicRESTLayer()

初始化 TiledDynamicRESTLayer 类的新实例。

方法详细描述
getTileURL () 方法
override protected function getTileURL(row:int, col:int, resolution:Number):URLRequest

获取指定图片块在服务器端的存放地址。

参数

row:int — 指定图片块在整幅图层中的行号。
 
col:int — 指定图片块在整幅图层中的列号。
 
resolution:Number — 指定图片块的显示分辨率。

返回
URLRequest — 返回指定图片块在服务器端的存放地址。
refresh () 方法  
override public function refresh():void

刷新图层,即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法),更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。