Tasks框架是一个很有意思的东西。如果你对Tasks框架还没有概念，你可以参考一下web map application那个Sample，左边浮动的放大工具，查询工具都是用Tasks框架构成。有人会问，既然已经有了command和tools，为什么还需要tasks呢？事实上tasks的目的是不同的；我们可以看一下web map application，可以看到，相同类型的button和toos组合在一起，组成一个逻辑单元，这就是tasks的选择条件。
我们来看看如何编写Tasks，编写Tasks是非常有意思的事情。Tasks跟tools一样，也是一个普通的Java类即可，这个Java类可以从Object直接继承。请看下面的Task的例子：
1
public class JSTasks 
{
2
public void doSomething(){
3
System.out.println("Task button clicked.");
4
5
}
6
}
这个tasks实在是简单吧，看看怎么部署上去，我们在xml文件中做如下定义：
1
<managed-bean>
2 <managed-bean-name>jsTask</managed-bean-name>
3 <managed-bean-class>com.cj.ucdemo.JSTasks</managed-bean-class>
4 <managed-bean-scope>session</managed-bean-scope>
5 </managed-bean>
这个配置文件也非常简单，那么看来所有的诀窍在与如何在JSP页面里面使用它。我们来看看：
1<a:task mapId="Map0" value="#{jsTask}" rendered="true" />
添加一个task标签，把这个标签的mapId值指向地图控件”Map0”，讲它的值指向我们刚才定义的Managed Bean。访问一下，大家看看下面的浮动窗口结果：
是不是很令人惊奇啊？事实上我们这个Bean中只有一个方法，但是Tasks框架聪明地把这个方法名给提取出来，作为button的名字。你点击一下这个按钮，在后台就可以看到执行了这个方法，打印出了一条信息。简单的说：方法就是按钮！！
有了上个Task的基础, 我们来看其它的Task就驾轻就熟了。事实上，整个Task就是一个类，Task的Caption就是这个类的类名。里面的每一个Public方法都是Task浮动条上的一个按钮。那么参数怎么办呢？我们来加一个参数，并且加上一个它的get方法和set方法：
1String parameter;
2public String getParameter() {
3return parameter;
4}
5public void setParameter(String parameter) {
6this.parameter = parameter;
7}
看看我们的task工具条发生了什么变化，Task工具条如下图所示：
可以看到，多了一个Parameter的输入框，前面还有一个Label，很有意思吧。那个DoAnything是我加的另外一个方法。Task框架的扩展已经很明显了吧：把相同的功能集合在一个类里面，这个类可以接受参数。例如我们可以利用这个task进行buffer操作，这个输入框就可以用来输入buffer的距离。
看到这里，大家肯定想到了另外的几个问题，比如：怎么把这些参数，按钮的名字修改成中文，上次给人培训，有人说：用中文的变量名？也是一个办法，但是考虑的JDK对中文变量的处理，似乎有问题。还有其它的问题包括怎么跟地图进行交互？怎么样设置客户端的动作（画多边形还是画Polyline）。我们当然有另外的方法。
使用Taksinfo建立对Task的描述，所有的Taskinfo都需要继承自SimpleTaskInfo类。大家可以打开doc看看SimpleTaskInfo的子类有那些。事实上，那些子类都是已经存在的task的taskinfo，如果你需要做汉化，继承这些类并且改写其中的几个方法即可。
我们来看看我们自己的类需要改写SimpleTaskInfo的哪几个方法：
TaskActionDescriptorModel[]getActionDescriptors();
此方法用来修改command按钮的描述；command的意思是不需要和地图进行交互而是直接在服务器端执行一个命令。
TaskParamDescriptorModel[]getParamDescriptors()
此方法修改参数的描述；
TaskToolDescriptorModel[]getToolDescriptors()；
此方法修改工具的描述，工具的意思是需要和地图进行交互；
那么我们来写一个类，直接说明如何使用这几个方法，修改task的表现:
public TaskDescriptor getTaskDescriptor() {
TaskDescriptor td=new TaskDescriptor(JSTasks.class);
td.setDisplayName("我的任务");
return td;
}
此方法修改了task的标题，将此类作为一个Managed-bean添加到faces-config.xml文件中，并且在.jsp页面中修改task的使用如下：
<a:task mapId="Map0" value="#{jsTask}" rendered="true" taskInfo="#{jsTaskInfo}"/>
修改后的Task如下所示：
可以看到task的标题已经改变。下面我们来看修改Action的标题，代码如下：
public TaskActionDescriptorModel[]
getActionDescriptors() {
TaskActionDescriptorModel[] td=new TaskActionDescriptorModel[1];
TaskActionDescriptorModel actionDesc=new TaskActionDescriptor(JSTasks.class,"doSomething","查询");
td[0]=actionDesc;
return td;
}
需要说明的是TaskActionDescriptor(JSTasks.class,"doSomething","查询")构造函数的三个参数，第一个是task类，第二个是方法名，第三个是修改后的方法名；构造后放到数组中返回即可，如果有多个方法，可以如法炮制，都放到数组中。修改后的task有如下表现：
你会发现另外一个action没有了，别着急，因为我们还没有把它放到数组中，而原来默认的显示方式已经被我们修改了。
我们来修改doAnything工具，doAnything工具需要和地图交互，注意它的参数是MapEvent而不是TaskEvent，它完整的代码如下所示：
如果跟地图交互，就要涉及到客户端执行的操作，我们这里没有任何地方指定客户端的操作，这是在taskinfo里面指定的，我们来看下面的代码：
public TaskToolDescriptorModel[]
getToolDescriptors() {
TaskToolDescriptor [] toolDesAry=new
TaskToolDescriptor[1];
TaskToolDescriptor toolDesc=new
TaskToolDescriptor(JSTasks.class, "doAnything", "交互放大",ClientActions.MAP_RECTANGLE);
toolDesAry[0]=toolDesc;
return toolDesAry;
}
注意TaskToolDescriptor构造函数的4个参数，第一个是task类，第二个是原方法名，第三个是替换后的方法名，第四个是客户端的动作。构造完成后放到数组中，如果有多个tools，如法炮制即可。修改后的task如下所示：
有了上面的解释，我们来看参数的taskinfo代码，就非常容易了：
public TaskParamDescriptorModel[] getParamDescriptors() {
// TODO Auto-generated method stub
TaskParamDescriptorModel[] td=new TaskParamDescriptorModel[1];
TaskParamDescriptorModel paraDesc=new TaskParamDescriptor(SearchTask.class,"searchText","查询文本");
td[0]=paraDesc;
return td;
}
修改后的task如下所示：
Task框架的基本构成就是这样了，祝大家使用愉快。下节将介绍TaskResult的使用。
posted on 2007-08-16 11:01
JavaPoint 阅读(1915)
评论(8) 编辑 收藏 所属分类:
ArcGis