包 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 进行重绘。