SuperMap iClient 6R(2012) for Flex
产品自述
北京超图软件股份有限公司
2012年3月北京
法律声明
本文档的版权为北京超图软件股份有限公司所有，受中国著作权法和著作权国际公约的保护。未经本公司书面许可，不得以任何方式或理由对该文档的任何部分进行使用、复制、修改、抄录、传播或与其它产品捆绑使用、销售，侵权必究。
“超图”“SuperMap”以及为北京超图软件股份有限公司的注册商标，受法律保护。未经本公司书面许可，不得以任何方式或理由对该商标的任何部分进行使用、复制、修改、传播或与其它产品捆绑使用、销售，侵权必究。
本文档并不代表供应商及其代理的承诺，北京超图软件股份有限公司可在不作任何声明的情况下对本文档进行修改。
本文档中提到其他公司及其产品的商标所有权为该公司所有。未经该权利人的书面同意，不得以任何方式或理由进行使用、复制、修改、抄录、传播。
本手册中所涉及的软件产品及其后续升级产品均由北京超图软件股份有限公司研发、销售。
特此声明。
北京超图软件股份有限公司
地址：北京市朝阳区酒仙桥北路甲10号院201号楼E门3层
邮编：100015
电话：+86-10-59896655
传真：+86-10-59896666
技术支持与客户监督热线：400-8900-866
技术支持电子邮箱：support@https://www.doczj.com/doc/585747963.html,
客户监督电子邮箱：cs@https://www.doczj.com/doc/585747963.html,
网址：https://www.doczj.com/doc/585747963.html,
SuperMap 欢迎您的任何建议和意见。
前言
欢迎使用SuperMap?iClient 6R(2012) for Flex。本文档包含：
SuperMap?iClient 6R(2012) for Flex 简介
系统配置要求
产品安装与目录说明
新增功能
本文档主要介绍产品使用前的准备工作。在使用产品前，用户应查看系统配置要求，了解产品的运行环境；熟悉产品安装与目录说明，了解产品的目录结构及使用，撑握特殊情况如何处理；学习产品新增功能，了解为您带来的新体验。
I
目录
1SuperMap iClient 6R(2012) for Flex 简介 (1)
2系统配置要求 (7)
3产品安装与目录说明 (9)
3.1产品获取与安装 (9)
3.1.1获取产品包 (9)
3.1.2安装产品 (9)
3.2产品本地目录说明 (9)
3.2.1help (9)
3.2.2libs (10)
3.2.3samples (11)
3.2.4crossdomain.xml (12)
3.2.5自述文件 (12)
3.2.6注意事项 (13)
4新增功能及接口变更 (15)
4.1组件 (15)
4.2地图显示 (15)
4.3辅助类 (16)
4.4新增gears 工具包 (17)
4.5iServer6R (17)
I
1
SuperMap iClient 6R(2012) for
Flex 简介
SuperMap iClient 6R(2012) for Flex 是一套基于Adobe Flex 技术和Adobe Flash Builder4 开发平台的Web 地理信息系统开发包。SuperMap iClient 6R(2012) for Flex 作为一个跨浏览器、跨平台的客户端开发平台产品，不仅可以在客户端快速的显示地图，还可以便捷地访问SuperMap GIS 服务器或第三方服务器提供的地图与服务，从而构建表现丰富、交互深入、体验卓越的地图应用。
图1 SuperMap iClient 6R(2012) for Flex 与其他产品架构关系
SuperMap iClient 6R(2012) for Flex产品不仅提供了基本的GIS 功能，而且提供了更强大的功能，以下列出了SuperMap iClient 6R(2012) for Flex正式版所提供的主要功能：
产品自述
北京超图软件股份有限公司
产品自述
1SuperMap iClient 6R(2012) for Flex 简介 北京超图软件股份有限公司
5
2
系统配置要求
在使用SuperMap iClient 6R(2012) for Flex产品之前，请确保计算机满足最低配置需求。具体参考下面的硬件和软件要求。
2.1硬件要求
2.1.1最低硬件配置要求：
●主频要求：1 GHz CPU
●内存要求：512 MB
●硬盘容量：10 GB
●显卡：128 MB 显存
2.1.2推荐硬件配置要求：
●主频要求：2 GHz CPU
●内存要求：2 GB
●硬盘容量：80 GB
●显卡：256 MB显存
2.2软件要求
操作系统要求：
●详情请参见Adobe Flash Player 官方网站
服务器产品需求：
●SuperMap iServer Java 6R(2012)
●SuperMap iServer Java 2008
2系统配置要求
产品自述
8
开发平台：
● 推荐Adobe Flash Builder 4
Flex 开发工具包：
● Adobe Flex 4 SDK
运行平台：
● Adobe Flash Player 10 或以上版本
3
产品安装与目录说明
3.1产品获取与安装
3.1.1获取产品包
●购买SuperMap iServer Java 6R(2012)产品。安装成功后，在[SuperMap iServer Java 6R(2012) 产品包] \iClient下获取。
●进入北京超图软件股份有限公司官网下载专区（https://www.doczj.com/doc/585747963.html,/html/download.html）进行下载，具体路径为官网首页>支持与培训>下载专区>平台软件，即可找到SuperMap iClient 6R(2012) for Flex的产品包。
3.1.2安装产品
●SuperMap iClient 6R(2012) for Flex产品以zip格式的压缩包提供，获取产品包后仅需解压即可使用。
3.2产品本地目录说明
SuperMap iClient 6R(2012) for Flex产品包解压后包含以下文件：
图2 SuperMap iClient 6R(2012) for Flex产品包目录
3.2.1help
●help为帮助文档文件夹，在帮助文档中为您提供了有关接口注释、产品概述、系统配置、产品入门、专题技术等内容。
3.2.2libs
libs为SuperMap iClient 6R(2012) for Flex库文件：
产品自述
3.2.3samples
1)samplecode_iServerJava2
samplecode_iServerJava2为SuperMap iClient 6R(2012) for Flex 产品支持SuperMap iServer Java 2008服务器产品的示范代码。其中samplecode文件夹中存放功能运行文件，主页面为samplecode\samplecode.html，可全面浏览示范代码提供的所有功能；也可单独运行某一功能页面，如“要素标绘”功能，仅需直接打开samplecode\AddFeature.html即可；assets中存放示范代码所使用到的图片；src为示范代码的源码；readme.txt 介绍如何将示例代码导入本地工程。
●在本地直接访问示范代码：
?访问本机发布的服务：请确保本机上已安装对应的SuperMap iServer Java 2008服务器产
品；在启动服务之后，直接双击samplecode\samplecode.html即可。
?访问非本机发布的服务：示范代码中默认的服务访问地址均为：localhost，用户若需访问其
它非本机发布的服务，仅需修改samplecode文件夹下的服务地址配置文件——
mapUrlConfig.xml 中的服务地址，然后直接双击samplecode\samplecode.html即可访
问非本机发布的服务。使用此方法时请确保已在服务的根目录下（[SuperMap iServer Java
2008 产品包]\thirdparty\tomcat\webapps\ROOT）放置跨域文件crossdomain.xml。
●使用tomcat发布服务的方式访问示范代码
请确保发布服务的电脑已安装对应的SuperMap iServer Java 2008服务器产品；并在服务的根目录下（[SuperMap iServer Java 2008 安装包]\thirdparty\tomcat\webapps\ROOT）放置跨域文件crossdomain.xml。
访问方法：将示范代码整个文件夹samplecode_iServerJava2拷贝至[SuperMap iServer Java 2008 安装目录]/thirdparty/tomcat/webapps 文件夹中；然后启动SuperMap iServer Java 2008 服务。这样将示范代码以服务的形式发布出来，您现在就可以通过浏览器成功访问示范代码的页面了，地址为：http://发布服务的IP : 端口号/samplecode_iServerJava2/samplecode/samplecode.html。
通过此方式访问示范代码无需修改服务地址，示范代码内部会自动获取发布服务的地址。
2)samplecode_iServerJava6R
samplecode_iServerJava6R为SuperMap iClient 6R(2012) for Flex 产品支持SuperMap iServer Java 6R(2012) 服务器产品的示范代码。其中samplecode文件夹中存放功能运行文件，主页面为
北京超图软件股份有限公司
samplecode\samplecode.html，可全面浏览示范代码提供的所有功能；也可单独运行某一功能页面，如“要素标绘”功能，仅需直接打开samplecode\AddFeature.html即可；assets中存放示范代码所使用到的图片；src为示范代码的源码；readme.txt 介绍如何将示例代码导入本地工程。
●在本地直接访问示范代码：
?访问本机发布的服务：请确保本机上已安装对应的SuperMap iServer Java 6R(2012)服务
器产品；在启动服务之后，直接双击samplecode\samplecode.html即可。
?访问非本机发布的服务：示范代码中默认的服务访问地址均为：localhost，用户若需访问其
它非本机发布的服务，仅需修改samplecode文件夹下的服务地址配置文件——
mapUrlConfig.xml 中的服务地址，然后直接双击samplecode\samplecode.html即可访
问非本机发布的服务。使用此方法时请确保已在服务的根目录下（[SuperMap iServer Java
6R(2012) 产品包]\webapps\ROOT）放置跨域文件crossdomain.xml。
●使用tomcat发布服务的方式访问示范代码
请确保发布服务的电脑已安装对应的SuperMap iServer Java 6R(2012)服务器产品；并在服务的根目录下（[SuperMap iServer Java 6R(2012) 产品包]\webapps\ROOT）放置跨域文件crossdomain.xml。
访问方法：将示范代码整个文件夹（samplecode_iServerJava6R）拷贝至[SuperMap iServer Java
6R(2012) 产品包]/webapps 文件夹中，并启动SuperMap iServer Java 6R(2012) 服务。这样将示范代码以服务的形式发布出来，您现在就可以通过浏览器成功访问示范代码的页面了，地址为：http://服务发布IP 地址：端口号/samplecode_iServerJava6R/samplecode/samplecode.html。
通过此方式访问示范代码无需修改服务地址，示范代码内部会自动获取发布服务的地址。
3.2.4crossdomain.xml
crossdomain.xml为跨域文件：使用SuperMap服务器产品的用户，需要在Web服务器的Root目录下添加一个跨域策略文件crossdomain.xml，关于跨域文件的使用请参见
samplecode_iServerJava2/samplecode_iServerJava6R的介绍。
3.2.5自述文件
SuperMap_iClient_6R_2012_for_Flex_Readme_CHS.pdf为产品自述文件，主要介绍产品包中各个文件的功能。建议在使用产品之前的详细阅读此文档，以便您更加灵活的使用SuperMap iClient 6R for Flex 产品。
产品自述
3.2.6注意事项
注意当您在本地直接访问示范代码时，如果出现“无法访问本地资源”类似的错误对话框时，或显示空白页面，您需要按照以下步骤解决此问题：
1.在您的系统安装盘（如：C盘）中找到C:\Users\[计算机
名]\AppData\Roaming\Macromedia\Flash Player\#Security文件夹（该目录仅做
参考，若系统盘中不存在该路径，您可在搜索栏中直接搜索“#Security”文件夹），
进入..\ #Security\FlashPlayerTrust目录下，新建一个 .cfg 文件（文件名称可任意
定义），其中写入以下内容（如果您本机还有更多系统盘，按以下方式一一写入）：
2.进入C:\Windows\System32\Macromed\Flash路径下，查找是否存在
FlashPlayerTrust文件夹。如果不存在，将上一步中的FlashPlayerTrust文件夹拷贝
到此文件夹下；如果存在，则只需将上一步新建的 .cfg 文件拷贝到此文件夹下即可。
3.重新运行samplecode.html。
如果您的系统中不存在1）中所述的文件夹#Security，执行2）、3）步即可。在第2）步中您
需新建FlashPlayerTrust文件夹，并按照第1）步新建 .cfg文件。
北京超图软件股份有限公司
4
新增功能及接口变更
当前版本：6.1 SP1（6.1.1.8722）
上次版本：6.1正式版（6.1.0.8227）
SuperMap iClient 6R(2012) for Flex 6.1 SP1提供功能更加丰富、性能更加优越、扩展性更强的Web地理信息系统开发包。针对开发包中的各个功能，提供了更加简单、易用，内容更加丰富的范例程序及帮助文档，供学习使用。
4.1组件
●OverviewMap类，废弃接口：indexBoxBorderColor，indexBoxSizeFactor，
isDisableOverviewMapZoom，isOverviewVisiable，isViewEntirePan；新增接口：overviewZoomFactor，indexBoxColor，indexBoxBorderAlpha，indexBoxBorderWeight，iconPosition；变更接口：layer 修改为layers。
●ScaleBar类，新增属性lengthNMile和textNMile，用于海图。lengthNMile，获取当前以海里为
单位的比例尺长度，单位：像素；textNMile，获取lengthNMile属性值所代表的实际距离，单位：像素。
4.2地图显示
●Map类
新增属性multiTouchEnabled，该接口用于实现在触摸屏中通过触屏操作对地图进行缩放，默认值为true。
新增restrictedBounds属性，用于控制地图的浏览范围。
新增marginFactor属性，与restrictedBounds 结合使用，表示浏览范围外的缓冲距离因子。
详情请参见API文档。
●TiledLayer类
新增属性localStorage，对TiledLayer瓦片进行本地化存储管理；新增属性
memoryStorageEnabled，是否将瓦片保持到内存。当同时设置本地存储和保持到内存时，以
本地存储为准，此时memoryStorageEnabled属性处于失效状态，因localStorage本身就是
先将瓦片保存到内存，当viewBounds改变时再将瓦片数据从内存保存到本地。
新增viewRegion属性，该属性用于控制分块图层的出图范围。
●新增类LocalStorage，对本地存储的图层瓦片对象进行读取、删除等规范化管理。属性
sharedObjectName，获取或设置共享对象名称，默认值为“tileStorage”。LocalStorage()，初始化LocalStorage类的新实例。
●TiledWMTSLayer类
废弃tileMatrixNameHeader 属性
更改tileMatrixSetLevels 属性名为tileMatrixIdentifiers，用于指定TiledWMTSLayer 的显示级别。
新增wellKownScaleSet 属性，指定标准比例尺集名称。
在原有接口及变更接口的基础上，新增支持自定义WMTS服务的功能。
●TiledDynamicRESTLayer类：新增clipRegion属性，用于设置剪裁多边形，当前图层仅显示该多边
形内的地图。
●DynamicRESTLayer类：新增clipRegion属性，用于设置剪裁多边形，当前图层仅显示该多边形内
的地图。
●支持动态投影：通过设置Layer.CRS属性的wkid值，可将Layer转换至目标投影下显示，但并不改
变数据本身的投影信息。
●CoordinateReferenceSystem 类：新增datumAxis属性，设置坐标系所采用的椭球体长轴半径。
默认为WGS_84椭球体长轴半径：6378137，该属性主要用于通过ScaleUtil类进行比例尺与分辨率之间的相互转换。
4.3辅助类
●GeoUtil类，新增方法contains()，判断点是否在多边形内，该多边形由一组点集合组成；新增方法
filterPointsByRegion()，获取与多边形相交的点对象集合，包括与多边形边界相交的点。
●开放类JsonUtil，JSON对象辅助类，该类用于实现客户端对象与JSON对象之间的相互转换。JSON
对象用于实现客户端与服务端之间的参数传递。
产品自述
●开放类ScaleUtil，用于实现地图分辨率与比例尺之间的相互转换。
4.4新增gears 工具包
●新增类MapPrintContainer，打印容器，该类继承于Group 组件，用于提供打印的基础对象，即将
需要打印的地图Map 转换成可用于打印的可视对象。
●新增类ImageLoadIOEvent，地图打印图片加载错误事件类。属性mess，显示错误信息；方法
ImageLoadIOEvent()，初始化ImageLoadIOEvent类的新实例；常量IMAGELOAD_IOERROR，表示图片加载错误。
4.5iServer6R
●ThemeUnique类，新增属性colorGradientType，颜色渐变字段，参见枚举类ColorGradientType。
●DataReturnOption类，新增属性dataReturnMode，数据返回模式枚举类；新增属性dataset，设
置结果数据集标识；新增属性deleteExistResultDataset，如果用户命名的结果数据集名称与已有的数据集重名，是否删除已有的数据集。变更接口：属性maxRec ordCount改为expectCount。
●DatasetBufferAnalystParameters类，新增属性resultSetting，结果返回字段设置，
DataReturnOption类型；删除原有属性maxReturnRecordCount 。
●DatasetOverlayAnalystParameters类，新增属性resultSetting，DataReturnOption类型；删除
原有属性maxReturnRecordCount，resultDatasetName，deleteExistResultDataset，dataReturnMode。
北京超图软件股份有限公司