Query Data with the ArcGIS Server API for Flex

Here we provide a demonstration of using the query object in the ArcGIS Server API for Flex as well as the code that was used in the demonstration.  The code for this demonstration is provided by the ESRI Samples site.

Attribute queries can be specified using one of two properties on the Query class.  The ‘text’ property searches the display field of your layer in a literal fashion.  It functions as a ‘like’ operator.  The ‘where’ property is used to define a traditional where clause for your query.

Spatial queries use the geometry property to apply a spatial filter to the query.  The geometry used as input will need to have been determined before the query is executed.  In addition, a spatialRelationship property is also used to apply a spatial relationship to the input geometry with SPATIAL_REL_INTERSECTS being the default if not specified.  As you can see from the figure below there are many spatialRelationship tests that you can apply to filter your data based on a spatial relationship.

You can restrict the data returned by a query in a number of ways.  The fields, spatial reference, and geometry can all be restricted.  For performance reasons you should try to limit the fields returned by the query through the use of the outFields property.  This is simply a set of field names provided within an array.  To return all fields you can use an asterisk as a wildcard.  As I mentioned, you should attempt to limit the fields returned to only those that you will use as it will increase the performance of your application.  Depending upon your application you may or may not want to return the geometry of each feature that matched the query.  Using the returnGeometry property you can specify a true or false value to indicate whether or not you wish to return the geometry for each feature.  If you don’t need to plot the geometry on your application by all means do not return the geometry as it will increase the performance of your application.  You can also specify the spatial reference for any returned geometry through the outSpatialReference property.

Since queries return data sets you will often use the results of the queries in data binding.  For example, you may want to populate the contents of a grid with the information returned from a query.  Flex data binding provides an easy way of doing this without a lot of coding.  Data binding is a Flex feature, not an ArcGIS Server API for Flex feature, but you can easily put it to use in your applications.  Essentially, data binding is a way of passing information around in your application in a sort of publish-subscribe pattern.  Data is published in one way or another such as the result of a QueryTask, and then one or more components in your application can monitor for this data and consume it when it becomes available.

In the figure below you’ll see a depiction of how data binding can be used with queries in Flex.  Here, the FeatureSet returned by our QueryTask is bound to a Flex grid component.  The contents of the grid will automatically be populated with the contents of the FeatureSet without the need for a lot of coding.  As you can see from the code snippet, data binding is accomplished through the use of curly braces that surround the data to be bound to the component.  Data binding in Flex is specified with these curly braces.

As I mentioned, curly braces are used to define the binding between a data source and the component that it will be bound to.  In the example code below we are binding the results of a QueryTask to a Flex DataGrid.