ArcGIS Server Java ADF 案例教程 23

三 Task的渲染

Task的功能类中还有一个属性，IDE默认生成的名字是taskInfo，它对应这个另外一个Java类（如上面QueryTaskTaskInfo类）的对象。这个类主要控制Task的渲染，我们可以回想一下，如果光在Task的功能类中定义了Command是一个void类型的query方法，Task面板怎么会生成一个标签为“查询”的按钮出来的呢？答案就在taskInfo中。

打开上面生成的“QueryTaskTaskInfo.java”文件，我们可以看到以下的内容：
public class QueryTaskTaskInfo extends SimpleTaskInfo
{
public TaskDescriptor getTaskDescriptor()
{
TaskDescriptor descriptor = new TaskDescriptor(QueryTask.class, "queryTask", "查询任务");
return descriptor;
}

public TaskParamDescriptorModel[] getParamDescriptors()
{
TaskParamDescriptor[] descriptors = new TaskParamDescriptor[1];
descriptors[0] = new TaskParamDescriptor(QueryTask.class, "keyWord", "关键词", "getKeyWord", "setKeyWord");
return descriptors;
}

public TaskActionDescriptorModel[] getActionDescriptors()
{
TaskActionDescriptor[] descriptors = new TaskActionDescriptor[1];
descriptors[0] = new TaskActionDescriptor(QueryTask.class, "query", "查询");
return descriptors;
}

public TaskToolDescriptorModel[] getToolDescriptors()
{
TaskToolDescriptor[] descriptors = new TaskToolDescriptor[1];
descriptors[0] = new TaskToolDescriptor(QueryTask.class, "select", "选择", "EsriMapPolygon");
return descriptors;
}
}

简单的说，TaskInfo类中包含4个主要的属性：TaskDescriptor对象、TaskParamDescriptor[]数组、TaskActionDescriptor[]数组、TaskToolDescriptor[]数组。很好理解，TaskDescriptor对应整个Task的外观，比如Task的标题等；TaskParamDescriptor[]描述所有Parameter的外观；TaskActionDescriptor[]描述所有Command的外观；TaskToolDescriptor[]描述所有Tool的外观。一个Task中肯定包含不定数目的Parameter、Command或Tool，因此他们的描述需要数组来存放。

让我们通过TaskToolDescriptor来更详细地看一下，上面的代码设置“select”这个TaskTool表现为一个“选择”按钮，并在点击时通知Map执行“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");

现在我还想调整一下这些按钮、文本框的布局，怎么办？TaskInfo还可以指定Task各个子元素的布局，让我们在刚刚的QueryTaskTaskInfo类中再添加以下的代码：
public TaskLayout[] getTaskLayout()
{
TabularLayout[] descriptors = new TabularLayout[1];
descriptors[0] = new TabularLayout();
descriptors[0].addComponent(getParamDescriptors()[0], new TabularPosition(0, 0, 0, 0));
descriptors[0].addComponent(getActionDescriptors()[0], new TabularPosition(1, 0, 0, 0));
descriptors[0].addComponent(getToolDescriptors()[0], new TabularPosition(2, 0, 0, 0));
return descriptors;
}

经过上面的两次修改，我们会发现Task面板的Tool变成了使用图片渲染，并且布局方式更加我们的定义进行了变化，效果如图 17所示。

图 17 更改Tool渲染方式和布局后的Task面板

顺便回头再看看页面中Task的定义，其中有taskInfo属性，它对应的就是这个Task的TaskInfo对象：
taskInfo="#{queryTask.taskInfo}"

最后稍微总结一下吧，Task的外观主要通过TaskInfo来定义，ADF会根据Task所对应的TaskInfo，通过XSL样式文件渲染成DHTML代码，并输出到浏览器。到现在为止，一个Task面板包含什么内容、对应后台什么对象、怎么控制它们的表现，你应该都清楚了吧？