Java ADF 运行原理剖析（2）

     Task是实现业务逻辑的重要部分。Task可以让用户输入参数，通过Command和Tools的组合，完成任务，返回结果。Task过Command+Tools简单相加之处在于Task提供了一个多样化组合的面板。

      A．Parameter   String       keyword

      B．Command   void方法    query（TaskEvent event）

      C．Tool           void方法    select（MapEvent event）

      A 定义了传递的参数 B.Command命令，通过TaskEvent获取消息，C.Tool工具，通过MapEvent捕获消息。下面以CustomTask和CustomTaskInfo为例，分析Task整个实现过程。

      CustomTask.Java关键代码：

public class CustomTask {

   

     private String layoutType;

     private Map<String,String> layoutOptions;

     private CustomTaskInfo taskInfo = new CustomTaskInfo();

     private String keyWord;

   

    public void query(TaskEvent event) {

       WebContext webContext = event.getWebContext();

       WebQuery webQuery = (WebQuery) webContext.getAttribute("query");

       TextCriteria textCriteria = new TextCriteria();

       textCriteria.setMaxRecordCount(100);

       textCriteria.setSearchText(this.keyWord);

    List<QueryResult> listQueryResult = webQuery.query(textCriteria,

              webQuery.getQueryLayers());

       webContext.getWebGraphics().clearGraphics();

       for (int i = 0; i < listQueryResult.size(); i++) {

           QueryResult queryResult = listQueryResult.get(i);

           queryResult.highlight();

       }

       webContext.refresh();

    }

  public void select (MapEvent event){

       WebContext webContext = event.getWebContext();

       WebGeometry webGeometry = (WebPolygon) event.getWebGeometry().toMapGeometry(webContext.getWebMap());

       WebQuery webQuery = (WebQuery) webContext.getAttribute("query");

       List<WebLayerInfo> layers = webQuery.getQueryLayers();

       List<WebLayerInfo> queryLayers = new ArrayList<WebLayerInfo>();

       for (WebLayerInfo layer : layers){

           if (layer.getName().equals("QXZF")){

              queryLayers.add(layer); break;

              }

           }

       IdentifyCriteria identifyCriteria = new IdentifyCriteria();

       identifyCriteria.setWebGeometry(webGeometry);

       List<QueryResult> listQueryResult = webQuery.query(identifyCriteria, queryLayers);

      

       //---------------------------高亮显示-------------------------

    /*  webContext.getWebGraphics().clearGraphics();

       for (int i = 0; i < listQueryResult.size(); i++) {

           QueryResult queryResult = listQueryResult.get(i);

           queryResult.highlight();

       }

       webContext.refresh();

       */

       //---------------------WebSimpleMarkerSymbol---------------------

       /*WebSimpleMarkerSymbol symbol = new WebSimpleMarkerSymbol();

       symbol.setMarkerType(WebSimpleMarkerSymbol.CIRCLE);

       symbol.setAntialiasing(true);

       symbol.setTransparency(0.7);

       symbol.setColor("255,255,0");

       symbol.setOutlineColor("255,0,0");*/

       //---------------------WebPictureMarkerSymbol--------------------

       /*WebPictureMarkerSymbol symbol = new WebPictureMarkerSymbol();

       symbol.setFileName("images/esri-logo.gif");*/

       //---------------------WebTrueTypeMarkerSymbol-------------------

       WebTrueTypeMarkerSymbol symbol=new WebTrueTypeMarkerSymbol();

        symbol.setFontName("ESRI Business");

symbol.setCharacterIndex(0);

       symbol.setFontColor("0,255,0");

symbol.setFontSize(50);

       symbol.setFontStyle(WebTrueTypeMarkerSymbol.UNDERLINE);

       webContext.getWebGraphics().clearGraphics();

       for (int i = 0; i < listQueryResult.size(); i++){

           QueryResult queryResult = listQueryResult.get(i);

          

           GraphicElement element = new GraphicElement();

           element.setGeometry(queryResult.getHighlightGeometry());

           element.setSymbol(symbol);

           webContext.getWebGraphics().addGraphics(element);

           }

      

    }

}

      以上是一段以两种不同方式查询显示的代码，public void query(TaskEvent event) 通过输入参数，对选择的数据集高亮显示。public void select (MapEvent event)相对复杂一些，根据选定图层，定义了以多边形框选取的方式，得到数据集，除了进行简单的高亮显示之外，还采取的其他的符号化方式，标注部分为不同符号化代码。

 

     CustomTaskInfo.Java代码片段：

public class CustomTaskInfo extends SimpleTaskInfo{

    TabularLayout[] layouts = new TabularLayout[1];

    //任务面板外观描述

    public TaskDescriptor getTaskDescriptor() {

       TaskDescriptor descriptor = new TaskDescriptor(CustomTask.class,

              "queryTask", "Custom Task");

       return descriptor;

    }

 

    public TaskToolDescriptorModel[] getToolDescriptors() {

       TaskToolDescriptor[] descriptors = new TaskToolDescriptor[1];

       descriptors[0] = new TaskToolDescriptor(CustomTask.class, "select",

              "选择", "EsriMapPolygon");

       descriptors[0].setRendererType(TaskToolDescriptor.IMAGE_RENDERER_TYPE);

       descriptors[0].setDefaultImage("images/tasks/maptools/polygon.gif");

       descriptors[0].setHoverImage("images/tasks/maptools/polygonU.gif");

       descriptors[0].setSelectedImage("images/tasks/maptools/polygonD.gif");

       descriptors[0].setDisabledImage("images/tasks/maptools/polygonX.gif");

       return descriptors;

    }

 

    public TaskParamDescriptorModel[] getParamDescriptors() {

       TaskParamDescriptor[] descriptors = new TaskParamDescriptor[2];

       descriptors[0] = new TaskParamDescriptor(CustomTask.class, "keyWord",

              "关键词", "getKeyWord", "setKeyWord");

       descriptors[1] = new TaskParamDescriptor(CustomTask.class,"layoutType","布局","getLayoutOptions");

       descriptors[1].setRendererType(TaskParamDescriptor.SELECT_RENDERER_TYPE);

       return descriptors;

    }

 

    public TaskActionDescriptorModel[] getActionDescriptors() {

       TaskActionDescriptor[] descriptors = new TaskActionDescriptor[2];

       descriptors[0] = new TaskActionDescriptor(CustomTask.class, "query",

              "查询");

       descriptors[1] = new TaskActionDescriptor(CustomTask.class,"changeLayout","布局切换");

       return descriptors;

    }

    public TaskLayout[] getTaskLayout() {

       

       layouts[0] = new TabularLayout();

       layouts[0].addComponent(getParamDescriptors()[1], new TabularPosition(0,0,1,1));

       layouts[0].addComponent(getActionDescriptors()[1], new TabularPosition(0,1,1,1));

       layouts[0].addComponent(getParamDescriptors()[0], new TabularPosition(1,0,1,1));

       layouts[0].addComponent(getActionDescriptors()[0], new TabularPosition(1,1,1,1));

       layouts[0].addComponent(getToolDescriptors()[0], new TabularPosition(1,1,1,0));

       return layouts;

    }

  

      CustomTaskInfo.Java为我们定义了Task面板的样式，public TaskDescriptor getTaskDescriptor()定义了面板的整体外观，并且关联了处理该面板事物的CustomTask类。

      public TaskToolDescriptorModel[] getToolDescriptors()定义了工具样式，该函数返回值为数组类型，可以添加多个工具样式。

      public TaskParamDescriptorModel[] getParamDescriptors() 也是以返回数组的形式，它提供描述所有参数的样式，如以文本形式还是以列表选择的方式。

      public TaskActionDescriptorModel[] getActionDescriptors() 描述所有命令按钮的样式，设置按钮名称，添加回调函数。

      public TaskLayout[] getTaskLayout()

      最后在getTaskLayout中添加前面定义的面板元素，这样一个完整的Task就生成了。

      当然以上只是后台部分的内容，在faces-config配置文件中，可以看到一下配置信息：

     <map-entry>

          <key>queryTask</key>

          <value>#{queryTask}</value>

    </map-entry>

<managed-bean>

    <managed-bean-name>queryTask</managed-bean-name>

    <managed-bean-class>com.esri.adf.web.developer.CustomTask</managed-bean-class>

    <managed-bean-scope>none</managed-bean-scope>

</managed-bean>

      以上配置文件，注册了CustomTask 这bean，名称为queryTask，queryTask又被添加到MapContext属性的列表中。

      最后就剩下了前台部分，代码如下：

<a:task id="queryTask"

           taskInfo="#{queryTask.taskInfo}"

           mapId="map1" clientPostBack="true"

           windowingSupport="true"

           value="#{mapContext.attributes.queryTask}" />

     完成整个工作，部署工程，运行，下面为示例图（1）：

     输入南京，单击查询Command按钮，后台调用query函数，结果高亮显示。

 

    通过Tool，多边形选取，目标要素以符号化的形式显示。

  如下图（2）：

  以上就是一个Task基本功能的完成展示。