FlexViewer使用步骤.doc

学习FlexViewer，最重要的是掌握其框架结构，了解FlexViewer组织模式，包括VierContainer、MapManager、ConfigManager、WidgetManager的关联关系，以及事件。本篇将重点讲述FlexViewer的组织原理以及开发方法，先从事件入手，通过事件的分发与监听，将FlexViewer中的各个Manager关联起来，进而明确其组织架构。1、Flex Viewer事件整个FlexViewer，有两个关于事件的类EventBus和AppEvent。EventBus继承自EventDispatcher类，它是一个singleton类，并且所有AppEvent的分发都要EventBus。AppEvent事件的构造函数如下，参数包括了事件类型（type），对象类型（data）以及回调函数：public function AppEvent(type:String, data:Object = null, callback:Function = null) super(type); _data = data; _callback = callback; 事件类型：AppEvent的事件类型中涵盖了所有与FlexViewer相关的，其中比较重要的有： APP_ERROR：APP错误事件 CONFIG_LOADED：加载Config文件完成后调用事件MAP_LOADED：加载地图完成后调用SET_MAP_ACTION：与地图交互相关的事件，其data参数中包含有地图交互动作的token值，如Zoomin，Zoomout等； DATA_FETCH_ALL：获得所有数据时调用；DATA_FETCH：获得数据时调用DATA_CREATE_INFOWIDGET：创建Widget时调用 WIDGET_RUN：Widget运行时调用;WIDGET_CHANGE_STATE：Widget状态变化时调用，其data参数中包含了widgetID和State值 WIDGET_FOCUS：Widget得到焦点时调用 WIDGET_ADD：添加Widget时调用 WIDGET_ADDED：widget已添加后调用2、掌握FlexViewer的架构FlexViewer中，首先构造的UIComponet就是ViewContainer。ViewContainer中首先要通过httpservice加载config.xml文件，然后加载MapManger、ConfigManager、WidgetManager等对象；MapManager与MapMangerSkin共同表达了FlexViewer主视图，实例化了Map对象，然后通过ViewContainer.DispatchEvent方法分发AppEvent.MAP_LOADED事件，事件的参数包含了事件类型(Type)，还包含了对象类型(data参数)，这样就可以通过AppEvent事件的监听获得Map对象了。ConfigManger主要用于加载widget的xml文件，每一个widget实例化之前都要加载xml文件，在xml中可以定义一些全局的变量(如geometryservice等)，加载完毕之后同样通过viewContainer.DispatchEvent分发 CONFIG_LOADED事件，并添加相应的事件监听。WidgetManager主要用于加载Widget，任何widget制作之后都要在WidgetManager中才能使用，因此该类中主要是Widget相关的事件相应。FlexViewer在运行加载ViewerContainer之后，会首先通过HttpService加载config.xml文件，该文件通过ConfigManager获得ConfigXML，通过对ConfigXML的解析获得ConfigData。对config.xml文件的解析，获得包括全局概念的属性设置（括号内为config.xml中的节点），包括proxyUrl（httpproxy）、BingKey（key）、geometryService的url（geometryservice）、title标题（title）、subtitle（subtitle）、logo（logo）、widgetLayout（widgetlayout）、widgetContainer的Layout、Left、ringt、top和bottom（layout、left、right、top和bottom）等等map的属性包括：initial或full（initialextent/fullextent）、Left、ringt、top和bottom（left、right、top和bottom）、wkid（wkid）、wkt（wkt）、zoomslider是否可见（zoomslidervisible）、scalebar是否可见（scalebarvisible）、esrilogo是否可见（esrilogovisible）、lod的设置（父节点lods，子节点lod）、basemap用于显示的地图服务（父basemaps子Layer）、用于操作的地图服务（父operationallayers子layer）等等Layer的属性包括：显示标签（Label）地图类型（dynamic/tiled/bing/image/wms/arcims）地图服务的url（url）widget的属性包括：Label（label）、 Icon图标（icon） config文件（config）;widget所对应的url，swf文件（url）; preload是否展开（preload）; x（x），y（y）; Left、ringt、top和bottom（left、right、top和bottom）等开发者也可根据自定义，定制自己的标签。如果是全局的，需要在WidgetManager中解析，如果是和Map相关的，需要在MapManager中解析，如果和Widget相关，需要在WidgetManager中解析。FlexViewer开发，大多是继承自BaseWidget，进行Widget开发。整个FlexViewer的框架架构，可以看做是由容器（Container）、管理器（Manager）以及一个个Widget组成的，其中Widget即是FlexViewer中实现功能的微型组件，在一定程度上讲，Widget承载了我们的需求实现。在整个FlexViewer中，只有index.mxml是主应用程序，所有的widget都是Componet。所以，我们要创建自己的widget，第一步即是，创建一个mxml Component。第二步，继承自BaseWidget，创建自己的Widget。切记：一定要继承自BaseWidget，才能最终将自己的widget添加至WidgetManger中。第三步，既然是继承自BaseWidget，我们就要明确继承了那些成员。继承的成员包括：WidgetID：widget的唯一ID值WidgetTitle：titleWidgetIcon：图标Config：widget自己的config文件ConfigXML：config.xmlConfigData：ConfigData类型Map：全局的Map类型IsDragable：是否可拖拽IsResizeable：是否