XDoclet简化Struts开发
Struts是一个Web开发框架，是用Struts避免了简单的JSP + Servlet开发过程，维护过程中的一系列问题，但是struts配置文件的编辑始终是一个问题。下面我们使用Xdoclet来自动生成struts配置文件。Xdoclet是一个使用Java代码中的注释来生成接口文件，或者配置文件的开源工具。
<shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f"></shapetype><stroke joinstyle="miter"></stroke><formulas></formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f><lock v:ext="edit" aspectratio="t"></lock><shape id="_x0000_i1025" type="#_x0000_t75" o:borderrightcolor="this" o:borderbottomcolor="this" o:borderleftcolor="this" o:bordertopcolor="this"></shape><imagedata src="file:///C:/DOCUME~1/mazhao/LOCALS~1/Temp/msoclip1/01/clip_image001.jpg" o:title="struts-dispatch-dia"></imagedata><bordertop type="single" width="4"></bordertop><borderleft type="single" width="4"></borderleft><borderbottom type="single" width="4"></borderbottom><borderright type="single" width="4"></borderright>
所有得Struts的各组件关系如上所示，其中有两个主要类，DispatchAction和DispatchValueBean。DispatchAction从上个页面获得输入，根据输入定位到不同的页面（0定位到dispatch_0.jsp,1定位dispatch_1.jsp）。
可以看看下列代码（只涉及到Xdoclet相关的部分）：
//DispatchValueBean.java
/**
*
* @author mazhao
* @struts.form
* name="DispatchValueBean"
*/
public class DispatchValueBean extends org.apache.struts.action.ActionForm {
private String dispatchValue = "0";
public DispatchValueBean () {
}
public String getDispatchValue()
{
return dispatchValue;
}
public void setDispatchValue(String dispatchValue)
{
this.dispatchValue = dispatchValue;
}
}
上述的蓝色代码表示自己是一个FormBean，且FormBean的名字是DispatchValueBean。
//DispatchAction.java
/**
*
* @author mazhao
* @struts.action
* name="DispatchValueBean"
* path="/DispatchAction.do"
* input="/index.jsp"
*
* @struts.action-forward
* name="dispatch_0"
* path="/dispatch_0.jsp"
* redirect="false"
*
* @struts.action-forward
* name="dispatch_1"
* path="/dispatch_1.jsp"
* redirect="false"
*
*/
public class DispatchAction extends org.apache.struts.action.Action {
private String dispatchValue = "0";
public DispatchAction() {
}
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception {
DispatchValueBean dispatchBean = (DispatchValueBean)form;
String value = dispatchBean.getDispatchValue();
if("0".equals(value))
{
return mapping.findForward("dispatch_0");
}
else
{
return mapping.findForward("dispatch_1");
}
}
public String getDispatchValue()
{
return dispatchValue;
}
public void setDispatchValue(String dispatchValue)
{
this.dispatchValue = dispatchValue;
}
}
上述的蓝色代码说明该Action所使用的FormBean，输入页面，path和不同的ActionForward。
根据如上的代码可以使用如下的build文件来自动生成struts-config.xml:
<!—- 将xdoclet的jar文件包含到编译路径中 -->
<path id="compile.classpath">
<fileset dir="${xdoclet.dir}">
<include name="*.jar"/>
</fileset>
</path>
<!—-定义子定义的任务标签 -->
<taskdef
name="webdoclet"
classname="xdoclet.modules.web.WebDocletTask"
classpathref="compile.classpath"
/>
<!—使用自定义的任务标签生成struts-config.xml文件-->
<target
name="webdoclet"
depends="prepare"
description="Generate deployment descriptors (run actionform to generate forms first)"> <echo>+---------------------------------------------------+</echo>
<echo>| |</echo>
<echo>| R U N N I N G W E B D O C L E T |</echo>
<echo>| |</echo>
<echo>+---------------------------------------------------+</echo>
<webdoclet
destdir="ant"
mergedir="ant/merge"
verbose="false"
>
<fileset dir="JavaSource">
<include name="**/*Action.java"/>
<include name="**/*Bean.java"/>
</fileset>
<strutsconfigxml
destdir="ant"
/>
</webdoclet>
</target>
建议在详细设计阶段使用这种方式生成代码框架和struts-config.xml配置文件。