● xdoclet學習續
　　Xdoclet是一個代碼自動生成的工具
　　XDoclet任務就是Ant的自定義任務，除此以外，沒有其他運行XDoclet任務的方法。
　　XDoclet它有兩個重要的組件：
　　進行特殊標記的 Java 源文件。
　　預先定義的模板。[引用]
　　
　　
　　Merge File用來處理無法在Source Code中加xdoclet tag的情況。
　　
　　? XDoclet中的核心任務：
　　<ejbdoclet>：面向EJB領域，生成EJB、工具類和布署描述符。
　　<webdoclet>：面向Web開發，生成serlvet、自定義標簽庫和web框架文件。
　　<hibernatedoclet>：Hibernate持續，配置文件、Mbeans
　　<jdodoclet>：JDO，元數據，vender configuration
　　<jmxdoclet>：JMX，MBean接口，mlets，配置文件。
　　<doclet>：使用用戶自定義模板來生成代碼。
　　<documentdoclet>：生成項目文件（例如todo列報表）
　　
　　? webdoclet sub task
　　XDoclet并沒有和Ant一起發布，所以如果你想要使用XDoclet的話，就需要單獨的下載和
　　安裝。在使用任何一個XDoclet的任務之前，你首先需要在使用Ant的<taskdef>任務來聲
　　明它。
　　<deploymentdescriptor>：產生標準的web引用配置文件web.xml，destdir屬性設定
　　web.xml文件的存放位置。
　　XDoclet通過合并點(merge points)支持定制,合并點是在模板文件定義里允許運行時插入定制代碼的地方,使用mergedir屬性設置。
　　 <target name="webdoclet" depends="compile-web"
　　 unless="webdoclet.unnecessary"
　　 description="Generate web and Struts descriptors">
　　 <taskdef name="webdoclet" classname="xdoclet.modules.web.WebDocletTask">
　　 <classpath>
　　 <path refid="xdoclet.classpath"/>
　　 <path refid="web.compile.classpath"/>
　　 </classpath>
　　 </taskdef>
　　 <!—mergedir完成模板文件合并的功能-->
　　 <webdoclet destdir="${webapp.target}/WEB-INF"
　　 force="${xdoclet.force}"
　　 mergedir="metadata/web"
　　 excludedtags="@version,@author"
　　 verbose="true">
　　 <!—找出目錄src/web 和${build.dir}/web/gen文件中的webdoclet注
　　 釋，生成web.xml,struts-config.xml等配置信息文件-->
　　 <fileset dir="src/web"/>
　　 <fileset dir="${build.dir}/web/gen"/>
　　 <!—生成的web.xml文件放在build/appName/WEB-INF/-->
　　 <deploymentdescriptor validateXML="true"
　　 servletspec="2.3" sessiontimeout="10"
　　 destdir="${webapp.target}/WEB-INF" distributable="false"
　　 displayname="${ant.project.name}">
　　 <configParam name="httpPort" value="${http.port}"/>
　　 <configParam name="httpsPort" value="${https.port}"/>
　　 <configParam name="daoType" value="${dao.type}"/>
　　 <configParam name="security" value="${security.mode}"/>
　　 </deploymentdescriptor>
　　 <jsptaglib validateXML="true"
　　 description="Custom tag library for this application"
　　 shortName="${webapp.name}" filename="${webapp.name}.tld"/>
　　 <strutsconfigxml validateXML="true" version="1.2"/>
　　 <strutsvalidationxml/>
　　 </webdoclet>
　　 </target>
　　
　　圖表 1引用一張網友發表的非常直觀的使用說明圖
　　? XDoclet 中的合并點
　　在 XDoclet 的文檔中，您會非常頻繁地看到術語 合并點（merge point）和 合并文件（merge file）。合并文件是文本文件，您可以把它合并到 XDoclet 生成代碼的指定位置——“合并點”上（由模板指定）。可以用合并文件來包含靜態文本（例如代碼片斷和 XML 片斷），這些文本可能很難或者不能用 XDoclet 的能力生成。例如，在示例代碼的 metadata/web 目錄下，您會找到這些文件。在代碼生成期間，可以用到這些文件合并配置文件的一部分[引用]。
　　
　　?XDoclet中的模板
　　XDoclet使用代碼模板來生成代碼。模板(template)是你想生成文件的原型。模板里使
　　用一些XML標簽來指導模板引擎如何根據輸入類以及它們的元數據來調整代碼的生成。
　　模板有點像JSP文件。它們都包含文件和XML標簽，生成輸出文件時XML標簽會被解析，
　　然后生成文本并顯示在XML標簽所處的位置上。除了以XDt為命名空間打頭的XML標簽
　　會被XDoclet引擎解析以外，其余的XML標簽XDoclet會忽略不管。
　　? AppFuse中生成Action類的XDoclet模板
　　public final class <XDtClass:className/>Action extends BaseAction {
　　public ActionForward cancel(ActionMapping mapping, ActionForm form,HttpServletRequest request,
　　 HttpServletResponse response)
　　 throws Exception {
　　 return search(mapping, form, request, response);
　　 }
　　 public ActionForward delete(ActionMapping mapping, ActionForm form,
　　 HttpServletRequest request,
　　 HttpServletResponse response)
　　 throws Exception {
　　 if (log.isDebugEnabled()) {
　　 log.debug("Entering 'delete' method");
　　 }
　　 ActionMessages messages = new ActionMessages();
　　 <XDtClass:className/>Form <XDtForm:classNameLower/>Form = (<XDtClass:className/>Form) form;
　　 // Exceptions are caught by ActionExceptionHandler
　　 Manager mgr = (Manager) getBean("manager");
　　 mgr.removeObject(<XDtClass:className/>.class, new Long(<XDtForm:classNameLower/>Form.getId()));
　　 messages.add(ActionMessages.GLOBAL_MESSAGE,
　　 new ActionMessage("<XDtForm:classNameLower/>.deleted"));
　　 // save messages in session, so they'll survive the redirect
　　 saveMessages(request.getSession(), messages);
　　 return search(mapping, form, request, response);
　　 }
　　… …
　　}
　　? AppFuse中自動生成的對應Action類
　　public final class PersonAction extends BaseAction {
　　 public ActionForward cancel(ActionMapping mapping, ActionForm form,
　　 HttpServletRequest request,
　　 HttpServletResponse response)
　　 throws Exception {
　　 return search(mapping, form, request, response);
　　 }
　　
　　 public ActionForward delete(ActionMapping mapping, ActionForm form,
　　 HttpServletRequest request,
　　 HttpServletResponse response)
　　 throws Exception {
　　 if (log.isDebugEnabled()) {
　　 log.debug("Entering 'delete' method");
　　 }
　　 ActionMessages messages = new ActionMessages();
　　 PersonForm personForm = (PersonForm) form;
　　 // Exceptions are caught by ActionExceptionHandler
　　 Manager mgr = (Manager) getBean("manager");
　　 mgr.removeObject(Person.class, new Long(personForm.getId()));
　　 messages.add(ActionMessages.GLOBAL_MESSAGE,
　　 new ActionMessage("person.deleted"));
　　 // save messages in session, so they'll survive the redirect
　　 saveMessages(request.getSession(), messages);
　　 return search(mapping, form, request, response);
　　 }
　　… …
　　}