Flex-Viewer编程的详细图解教程.doc

第 第 PAGE 3 页 开发指南 目 录 1 简介 4 1.1 准备知识 4 1.1.1 技能与软件需求 4 1.1.2 获取源代码与所需库 4 1.2 文件组织… 5 2 Sample Flex Viewe架构 5 2.1 架构介绍 5 2.2 Sample Flex Viewer实例的生命周期 6 2.3 Sample Flex Viewer容器 7 2.4 理解Widget编程模型 8 2.5 Widget命名习惯 9 3 为Widget开发建一个Flex Builder项目 9 3.1 用Sample Flex Viewer FlexBuilder项目开发一个微件 10 3.2 在Sample Flex Viewer的FB项目之外开发一个widget 12 3.3 为Flex Builder设置测试服务器 14 4 开发一个widget 15 4.1 使用WidgetTemplate模板 16 4.2 获取地图信息 17 4.3 在地图上显示widget数据 19 4.4 从地图接收数据(通过单击，画线等操作实现) 20 4.5 在widget中控制导航 21 4.6 不使用WidgetTemplate模板开发Widget 22 4.7 开发一个自己的Widget模板 23 4.8 修改或是创建一个主题 24 4.9 Widget的配置 25 5 了解Sample Flex Viewer核心代码 26 5.1 事件总线容器 26 5.2 依赖注入(DI，也叫控制反转) 29 5.3 国际化 30 5.3.1 使用Flex的国际化特性 30 5.3.2 本地化设置 32 5.4 日志和错误处理 33 6 Sample Flex Viewer框架和Widget部署 35 6.1 部署一个Sample Flex Viewer应用程序 35 6.2 部署一个widget到Sample Flex Viewer 35 6.3 安全性考虑 36 6.3.1 crossdomain.xml 36 6.3.2 网络资源代理 37 7 附录A: Configuration XML37 1 简 介 此文档可供使用Sample Flex Viewer框架来开发基于Flex的ArcGIS API应用程序的开发人员使用。 1.1 准备知识 1.1.1 技能和软件需求 Sample Flex Viewer框架通过已编译的发布包和源代码包两种形式提供给开发人员。已编译的开发包 “即开即用”，部署方面快捷；而源代码包是提供给GeoWeb应用程序的开发人员使用。利用Sample Flex Viewer框架开发应用程序应该充分熟悉Adobe Flex这套软件并且具备足够的开发基于Flash的RIA网页应用程序的经验。 Adobe Flex的编程语言是ActionScript，一种基于标准JAVA-SCRIPT的强类型的面向对象语言。对于有过Java，C# ，Javascript等面向对象语言编程经验的开发人员会发现ActionScript这门语言相对比较容易上手。 要能够开发与GIS相关的程序，首先要具备熟练运用Flex的ArcGIS应用程序接口的知识和经验。 所需软件： ? Adobe Flex 3 Builder 标准版 (如果需要用到先进的可视化交互数据, 性能配置文件, 或者需要用的第三方集成测试工具的话，推荐安装Adobe Flex 3 Builder企业版) ? Adobe的软件开发包 (如果无法获取Flex Builder的话) ? 针对Eclipse的Subversion插件 (仅适用于需要用到Svn代码版本控制软件的开发人员) ? Flex的ArcGIS 应用程序接口 (如果需要开发GIS应用程序的话) 1.1.2 获取源代码和所需库 源代码将会以zip压缩文件的格式包含在发布包中，文件名为flexviewer-src-1.0-.zip。发布包的压缩文件可以从ESRI公司的资源网站 HYPERLINK /arcgisserver/apis/flex/index.cfm?fa=codeGalleryDetailsscriptID=15905 ArcGIS API for Flex代码库下载，文件名为AS15905.zip（当上传更新的版本文件名上的数字会相应更新）。 压缩文件的根文件夹FlexViewer包所有的源文件，库文件，文档以及FB项目文件。库文件的子文件夹libs中包含Flex的ArcGIS应用程序接口组件集swc文件，它是用来创建这个发布包的。 Widget 编程模型库也包括在源代码的压缩文件中。用它开发微件不需要访问和编译整个Sample Flex Viewer架