【Flex Viewer】 开发教程（1）Flex Viewer配置文件

Flex Viewer的设计原则是SIMPLICITY（简单）。因为简单原则，Flex Viewer易于部署、配置和扩展。为了达到“简单”这个目的，Flex Viewer在设计和实现上未引入第三方框架。但是从其框架结构上，我们能捕捉到一些Flex框架中最佳实践的影子，比如事件机制就与PureMVC中的Notification机制类似。

其实，Flex Viewer本身就可以被认为是一个框架。在这个框架基础上，可以通过扩展快速实现业务系统原型。本文档将详细介绍如何在“简单”原则下实现自定义Widget，以及Widget如何与其它模块交互。

说明

本文档使用的代码位于widgets.FlexViewerInAction目录下。

 

Flex Viewer通过配置文件配置系统数据和功能，配置文件内容如下：

<?xml version="1.0" ?>

<configuration>

<title>ArcGIS Viewer for Flex</title>①

<subtitle>a configurable web mapping application</subtitle>②

<logo>assets/images/logo.png</logo>③

<style>④

  <colors>0xFFFFFF,0x333333,0x101010,0x000000,0xFFD700</colors>

  <alpha>0.8</alpha>

</style>

  <bing key="Al0VE_jsmagxk4LFghXGlK5JSHfC0tk-eHRubZv_eMYm6wzgQaStYks8g-wWcgk3"/>

  <!-- UI elements -->

  <widget left="10" top="50" config="widgets/Navigation/NavigationWidget.xml"

    url="widgets/Navigation/NavigationWidget.swf"/>⑤

  <widget right="-2" bottom="-2" config="widgets/OverviewMap/OverviewMapWidget.xml"

  url="widgets/OverviewMap/OverviewMapWidget.swf"/>⑥

  <widget right="20" top="55" config="widgets/MapSwitcher/MapSwitcherWidget.xml"

  url="widgets/MapSwitcher/MapSwitcherWidget.swf"/>⑦

  <widget left="0" top="0" config="widgets/HeaderController/HeaderControllerWidget.xml"

  url="widgets/HeaderController/HeaderControllerWidget.swf"/>⑧

 

  <map initialextent="-14083000 3139000 -10879000 5458000" top="40" wraparound180="true">⑨

  <basemaps>

      <layer label="Streets" type="tiled" visible="true" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer"/>

      <layer label="Aerial" type="tiled" visible="false" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer"/>

      <layer label="Topo" type="tiled" visible="false" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer"/>

    </basemaps>

  <operationallayers>

      <layer label="Boundaries and Places" type="tiled" visible="false" url="http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places_Alternate/MapServer"/>

      <layer label="Fires" type="feature" visible="false" alpha="1" info="widgets/InfoTemplates/SimpleInfoWinWidget.swf"

      infoconfig="widgets/InfoTemplates/IWT_Fires.xml"   url="http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Fire/Sheep/FeatureServer/0"/>

  </operationallayers>

</map>

  <!-- widgets organized into widget containers that manage close/open etc -->

  <!-- supported layout property options: horizontal(default)|float|vertical|fix-->

<widgetcontainer layout="horizontal">⑩

    <widget label="Bookmarks" left="430" top="90" icon="assets/images/i_bookmark.png"

    config="widgets/Bookmark/BookmarkWidget.xml"

    url="widgets/Bookmark/BookmarkWidget.swf"/>

    <widget label="Find an address" left="100" top="90" preload="open" icon="assets/images/i_target.png"

    config="widgets/Locate/LocateWidget_Bing.xml"

    url="widgets/Locate/LocateWidget.swf"/>

    <widget label="Louisville Police" left="590" top="280" icon="assets/images/i_police.png"      config="widgets/Query/QueryWidget_Louisville_PoliceStations.xml"

    url="widgets/Query/QueryWidget.swf"/>

    <widget label="Search" left="80" top="280" icon="assets/images/i_search.png"

    config="widgets/Search/SearchWidget_Louisville.xml"

    url="widgets/Search/SearchWidget.swf"/>

    <widget label="Earthquakes (GeoRSS)" left="410" top="280" icon="assets/images/i_rss.png"

    config="widgets/GeoRSS/GeoRSSWidget.xml"

    url="widgets/GeoRSS/GeoRSSWidget.swf"/>

    <widget label="Draw and Measure" left="60" top="400" icon="assets/images/i_draw2.png"

    config="widgets/Draw/DrawWidget.xml"

    url="widgets/Draw/DrawWidget.swf"/>

    <widget label="Print" left="390" top="400" icon="assets/images/i_print.png"

    config="widgets/Print/PrintWidget.xml"

    url="widgets/Print/PrintWidget.swf"/>

</widgetcontainer>

</configuration>

①   title：Flex Viewer自带Banner实现的标题；

②   subtitle：Flex Viewer自带Banner实现的副标题；

③   logo：Flex Viewer自带Banner实现的Logo图标；

④   style：用来设置全局的组件样式，具体详见UIManager代码；

⑤⑥⑦⑧ UI Elements：指Control Widget，比如HeaderControllerWidget、NavigationWidget等这些提供系统级别功能的Widget；

⑨ map：Flex Viewer用来设置地图属性，包括底图、业务图层；

⑩ widgetcontainer：Business Widget的容器，用来管理Business Widget。Business Widget指提供业务功能的Widget。

上述配置文件并未使用到所有可用的属性，比如在style中设置font属性，map中设置fullextent等，此处不一一列举，详见ConfigManager代码。

 

需要说明的是，基于Flex Viewer开发业务系统，一般通过实现自定义的Business Widget来实现具体的业务功能，通过修改或者自定义Control Widget实现符合需求的系统级别功能组件。所以，配置文件中的前三项并不是必须的，通常我们的业务系统需要更具特色的Banner实现。Flex Viewer各部分与配置文件的对应关系见下图：