read AppFuse 15-XDoclet学习

read-AppFuse-15-实践-建立Action续

 

 

 

 

●     使用XDoclet创建JSPs骨架

Ø 利用AppFuse中提供的AppGen工具，可以根据POJO和管理类这两个类，通过Xdoclet生成Strutsh和Spring需要的所有文件和配置信息，大大简化了开发流程，非常方便。

 

 

 

 

Ø AppGen生成文件列表

          1. 对应的DAO Test 类  

     2. 对应的DAO接口类  

     3. 对应的Hibernate DAO实现类              

4. 对应的Spring DAO Bean的配置信息  

     5. 对应的Manager Test类(使用jMock)  

     6. 对应的Manager 接口

     7. 对应的Manager 实现类  

     8. 对应的Spring Manager Bean的配置信息

     9. 对应的Action Test类

     10. 对应的Action类

     11. DBUnit工具使用的样例数据库记录   

     12. Canoo测试需要的配置文件  

     13. 符合i18n要求的属性文件

     14. 对应的Form的JSP文件

     15. 对应的List JSP文件

     16. 对应的Struts Menu配置信息

     17. 对应的Menu JSP文件

 

 

 

 

Ø AppGen工具使用：

ant -Dmodel.name=Person -Dmodel.name.lowercase=person

Ø 注意：以上ant命令生成引用所需的多个文件，执行完以后，还需要执行以下的ant

命令：

 

ant install-other -Dmodel.name=Person -Dmodel.name.lowercase=person

 

该命令合并Constants.java文件、sample-data.xml文件、web-tests.xml文件ApplicationResources_en.properties文件，合并struts menu文件，（关键）将AppGen生成的struts所需的Jsp文首字母改为小写字母。这是AppFuse帮助文件中没有提及的，如果不执行这样步骤，web容器测试时，struts Action会因为forward所指jsp文件首字母是大写的而无法执行。

Øextras/appgen目录中 build.xml文件中的主要部分

    <target name="gen" depends="compile">

        <taskdef name="xdoclet" classname="xdoclet.DocletTask">

            <classpath>

                <path refid="xdoclet.classpath"/>

                <pathelement location="${build.dir}"/>

            </classpath>

        </taskdef>

        <property name="template.dir" value="src"/>

        <xdoclet destdir="${build.dir}"

                 excludedtags="@version,@author"

                 force="${xdoclet.force}">

            <fileset dir="${model.src.dir}" includes="**/${model.name}.java"/>

            <!-- NOTE: You must have {0} in the destinationFile for the class

                       to be available to templates -->  

           <!—根据模板和输入参数生成DAO Test 类-->  

            <template templateFile="${template.dir}/detailed/DAOTest.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

         destinationFile="${gen.dir}/test/dao/${app.package}/dao/{0}DAOTest.java"/>

            <!-- 根据模板和输入参数生成 DAO接口类-->  

            <template templateFile="${template.dir}/detailed/DAO.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

              destinationFile="${gen.dir}/src/dao/${app.package}/dao/{0}DAO.java"/>

            <!-- 根据模板和输入参数生成Hibernate DAO实现类 -->  

            <template templateFile="${template.dir}/detailed/DAOHibernate.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/dao/${app.package}/dao/hibern

ate/{0}DAOHibernate.java"/>

            <!-- 根据模板和输入参数生成Spring DAO Bean的配置信息，存于文件 -->  

            <template templateFile="${template.dir}/detailed/context-hibernate.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/dao/${app.package}/dao/hiber

nate/context-hibernate-{0}.xml"/>

            <!-- 根据模板和输入参数生成Manager Test类(使用jMock) -->  

            <template templateFile="${template.dir}/detailed/ManagerTest.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/test/service/${app.package}/service/{0}ManagerTest.java"/>

            <!-- 根据模板和输入参数生成Manager 接口 -->

            <template templateFile="${template.dir}/detailed/Manager.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/service/${app.package}/service/{0}Manager.java"/>

            <!-- 根据模板和输入参数生成Manager 实现类 -->   

            <template templateFile="${template.dir}/detailed/ManagerImpl.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/service/${app.package}/service/impl/{0}ManagerImpl.java"/>

            <!-- 根据模板和输入参数生成Spring Manager Bean的配置信息 -->

            <template templateFile="${template.dir}/detailed/context-service.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/service/${app.package}/service/context-service-{0}.xml"/>

            <!-- Constant values -->  

            <template templateFile="${template.dir}/Constants.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/dao/${app.package}/Constants-{

0}.java"/>

            <!-- 根据模板和输入参数生成Action Test类 -->

            <template templateFile="${template.dir}/ActionTest.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/test/web/${app.package}/webapp/action/{0}ActionTest.java"/>

            <!-- 根据模板和输入参数生成Detailed Action -->

            <template templateFile="${template.dir}/detailed/Action.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/src/web/${app.package}/webapp/action/{0}Action.java"/>

            <!-- 根据模板和输入参数生成Action类 -->

            <template templateFile="${template.dir}/generic/Action.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/generic/src/web/${app.package}/webapp/action/{0}Action.java"/>

            <!-- 根据模板和输入参数生成为DBUnit工具使用的样例数据库记录 -->   

            <template templateFile="${template.dir}/sample-data.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/metadata/sql/sample-data-{0}.xml"/>

            <!-- 根据模板和输入参数生成Canoo测试需要的配置文件 -->   

            <template templateFile="${template.dir}/web-tests.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

                      destinationFile="${gen.dir}/test/web/web-tests-{0}.xml"/>   

            <!-- 根据模板和输入参数生成符合i18n要求的属性文件-->

            <template templateFile="${template.dir}/FormKeys.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/web/WEB-INF/classes/{0}.properties

"/>

            <!-- 根据模板和输入参数生成对应Form的JSP文件 -->

            <template templateFile="${template.dir}/Form_jsp.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

                      destinationFile="${gen.dir}/web/pages/{0}Form.jsp"/>

            <!-- 根据模板和输入参数生成对应List JSP文件 -->

            <template templateFile="${template.dir}/List_jsp.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

                      destinationFile="${gen.dir}/web/pages/{0}List.jsp"/>

            <!-- 根据模板和输入参数生成Struts Menu配置信息-->

            <template templateFile="${template.dir}/menu-config.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

destinationFile="${gen.dir}/web/WEB-INF/menu-config-{0}.xml"/>

            <!-- 根据模板和输入参数生成Menu JSP文件 -->

            <template templateFile="${template.dir}/menu_jsp.xdt"

                      acceptAbstractClasses="false"

                      prefixWithPackageStructure="false"

                      destinationFile="${gen.dir}/web/pages/menu-{0}.jsp"/>

        </xdoclet>

    </target>