arcgis for flex api version3.7 教程：3.如何使用QueryTask查询地图服务

这篇介绍如何通过query task来从ArcGIS service中查询数据，分下面四步：
1  设置Map和GraphicsLayer.
2  使用query filter来设置QueryTask
3  输入查询参数执行QueryTask
4  显示查询结果


下面的例子是通过query task来根据输入的美国城市名来查询出所有相关的城市在地图上显示。
首先是设置地图和图层，地图和图层为查询结果展示提供了显示环境。GraphicsLayer用来展示查询


结果的几何图形并将其符号化。下面的代码示例就是使用了ArcGIS Server的瓦片服务和一个


graphics layer来实现的。
（1）在Flash builder中，新建工程，加入api库，引用esri的命名空间
（2）下面代码是引用命名空间的MXML标记语言代码，及布局基本属性的设置

<?xml version="1.0" encoding="utf-8"?><s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"    xmlns:s="library://ns.adobe.com/flex/spark"   xmlns:mx="library://ns.adobe.com/flex/mx"   xmlns:esri="http://www.esri.com/2008/ags"><s:layout>   <s:VerticalLayout gap="10"   horizontalAlign="center"   paddingBottom="20"   paddingLeft="25"   paddingRight="25"   paddingTop="20"/></s:layout></s:Application>

（3）接下来，添加地图，瓦片服务、添加一个Graphicslayer来显示查询结果。

...paddingTop="20"/></s:layout><esri:Map id="myMap">   <esri:extent>      <esri:Extent xmin="-14298000" ymin="2748000" xmax="-6815000" ymax="7117000">         <esri:SpatialReference wkid="102100"/>      </esri:Extent>   </esri:extent>      <esri:ArcGISTiledMapServiceLayer       url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer"/>   <esri:GraphicsLayer id="myGraphicsLayer"       graphicProvider="{queryTask.executeLastResult.features}"/></esri:Map></s:Application>

提示：并不是所有的查询结果都是在地图上显示，有的查询结果可以是表单数据。


设置QueryTask，QueryTask只是ArcGIS API for Flex中一些查询工具对象中的一种。每一种查询工


具都会有特定类型的参数需要定义。例如，QueryTask是通过设置Query object作为参数。
在使用QueryTask之前，你需要先对其设置需要进行查询操作的数据源（地图服务）的URL地址，URL


地址中具体到图层ID，在下面的代码示例中，图层ID为0。
提示：像QueryTask这种不可视的对象，在使用MXML标签时，需要写在<fx:Declarations>标签中。

<fx:Declarations><!-- Layer with US States --><esri:QueryTask id="queryTask"   showBusyCursor="true"   url="http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer/5"   useAMF="false"/>   <esri:Query id="query"      outSpatialReference="{myMap.spatialReference}"      returnGeometry="true"      text="{qText.text}">            <esri:outFields>         <fx:String>MED_AGE</fx:String>         <fx:String>POP2007</fx:String>      </esri:outFields>   </esri:Query></fx:Declarations><esri:Map id="myMap">   <esri:extent>...

在上面的代码中，设置returnGeometry="true",是表示将查询到的Geometry也作为结果数据返回。代码中还设置了两个输出字段（outFields），这两个字段将会输出到查询结果 中。
提示：输出字段越少，查询效率越高。并且使用实际字段名比使用别名效率更高。


执行查询过程，QueryTask、Query parameter(查询参数对象)和作为结果数据的FeatureSet对象，共同完成对一个地图图层 的查询及结果 显示。FeatureSet同时包含features和attribute信息。
添加以下代码：

...   </esri:Query></fx:Declarations><s:Panel height="60"    backgroundColor="0xB2BFC6"   title="Query a layer (search for a state)">   <s:layout>      <s:HorizontalLayout/>   </s:layout>      <s:TextInput id="qText"      width="100%"      enter="doQuery()"      text="California"/>   <s:Button click="doQuery()" label="Do Query"/></s:Panel><esri:Map id="myMap">   <esri:extent>   ...

代码中的输入框（TextInput）允许你输入一个城市名。输入完按回车键，响应doQuery（）函数。进而执行回调函数onResult()，该函数中的第一个参数就是返回的查询结果FeatureSet。FeatureSet可以直接作为Graphicslayer的数据提供GraphicProvider对象的参数。如果查询没有顺利完成，将会回调onFault()函数，显示错误信息。
提示：上述代码中，已经将查询结果数据作为数据源绑定到要显示的GraphicLayer上面了，既：graphicProvider="{queryTask.executeLastResult.features}",一旦有结果返回就会直接显示到地图上，无需在通过as代码在onResult()函数中设置。
as代码要添加在fx:script标签中，代码如下

paddingTop="20"/></s:layout><fx:Script>   <![CDATA[      import com.esri.ags.FeatureSet;      import mx.controls.Alert;      import mx.rpc.AsyncResponder;   private function doQuery():void   {    queryTask.execute(query, new AsyncResponder(onResult, onFault));       function onResult(featureSet:FeatureSet, token:Object = null):void    {      // No code needed in this simple sample, since the      // graphics layer is bound to the query result using      // graphicProvider="{queryTask.executeLastResult.features}"    }    function onFault(info:Object, token:Object = null):void    {     Alert.show(info.toString(), "Query Problem");    }   }   ]]></fx:Script><fx:Declarations>   <!-- Layer with US States -->

运行程序查看结果 

例如输入一个城市名称：California.