和xdoclet 说 Hello

偶尔也在这里发表一篇日志.关于xdoclet。

由于工作也很忙，所以可能写得比较匆忙，望观者见谅。

废话不多说直接开始。

1。运行环境：

eclipse ganymede版

Version: 3.4.0
Build id: I20080617-2000

 

java6.0

 

ant 1.6.5

http://archive.apache.org/dist/ant/binaries/apache-ant-1.6.5-bin.zip

xdoclet1.2.3

http://mirror.optus.net/sourceforge/

去这个镜像里找吧

 

介绍到这里接着说配置

 

2。工具的配置

ant的配置到处都是不说了。

接下去要装的插件是doclipse版本是0.7.0

去这里找

http://beust.com/doclipse/

 

得到的包名叫com.beust.doclipse.zip

直接解要到eclipse下的plugins里然后启动eclipse

 

通过菜单window->preferences中可以找到Doclipse已经安装好啦，如下图：

 

 

 

接下去点Doclipse下的External files发现个有Directory让你选。

这里就要说到doclipse的功能了。它就是让标签能通过快捷方式显示出来，通常是alt+"/"

而这里的directory是指模板的路径。可能说的不够准确。但的确是通过它再起作用的。。。哎~又废话了。。

 

这个模板是从http://mirror.optus.net/sourceforge/ 里找的。应该在xdoclet下。文件名为xdoclet-doclipse-1.2.3.zip。

 

然后解压出来后的这个目录就是前面所说到的directory了，browse以后选那个文件夹就可以了。结果如下图：

 

选中所有的xml然后apply最后ok

 

初步的设置就完成了。

 

3。开始写build.xml和其他的一些代码

 

下面是我练习的build.xml代码

Xml代码

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <!-- set properties -->
    <property name="src.dir" value="src"></property>
    <property name="lib.dir" value="lib"></property>
    <property name="build.dir" value="build"></property>
    <property name="dist.dir" value="dist"></property>
    <property name="project_name" value="xdoclet"></property>
    <property file="hibernate.properties"></property>

    <path id="lib.classpath">
        <fileset dir="${lib.dir}">
            <include name="**/*.jar"/>
        </fileset>
    </path>

    <path id="src.classpath">
        <pathelement location="${src.dir}"/>
    </path>

    <path id="runtime.classpath">
        <path refid="lib.classpath"></path>
        <path refid="src.classpath"></path>
    </path>

    <!-- =================================
          target: make base diectories, such as lib ,build , dist..
         ================================= -->
    <target name="mk_base_dir">
        <mkdir dir="${build.dir}"/>
        <mkdir dir="${dist.dir}"/>
    </target>

    <!-- =================================
          target: compile java to classes, classes directory is build/classes
         ================================= -->

    <target name="compile" depends="mk_base_dir">
        <mkdir dir="${build.dir}/classes"/>
        <javac srcdir="${src.dir}" destdir="${build.dir}/classes">
            <classpath refid="runtime.classpath"></classpath>
        </javac>
    </target>

    <!-- =================================
          target: export jar into build directory and jar is named according to the project
         ================================= -->
    <target name="export_jar" depends="mk_base_dir" description="exportClassesIntoJar">
        <jar destfile="${build.dir}/${project_name}.jar"></jar>
    </target>

    <!-- =================================
          target: clean Xmls under src directory
         ================================= -->
    <target name="cleanXml">
        <delete>
            <fileset dir="${src.dir}" includes="**/*.xml" />
        </delete>
    </target>

    <!-- =================================
          target: genate-hiberate3.x
         ================================= -->
    <target name="gen-hib">
        <taskdef
            name="hibernatedoclet"
            classname="xdoclet.modules.hibernate.HibernateDocletTask"
            classpathref="runtime.classpath"
            >
        </taskdef>
        <hibernatedoclet
            destdir="${src.dir}"
            verbose="true"
            >
            <fileset dir="${src.dir}">
                <include name="**/*.java"/>
            </fileset>
            <hibernate version="3.0"/>
            <hibernatecfg
                dialect="${hibernate.dialect}"
                jdbcUrl="${hibernate.connection.url}"
                driver="${hibernate.connection.driver_class}"
                username="${hibernate.connection.username}"
                password="${hibernate.connection.password}"
                showSql="false"
                version="3.0"
            />
        </hibernatedoclet>
    </target>

    <!-- =================================
          target: generate-struts1.2
         ================================= -->
    <target name="web xdoclet">
        <taskdef
            name="webdoclet"
            classname="xdoclet.modules.web.WebDocletTask"
            classpathref="runtime.classpath"
            />
        <webdoclet
            mergedir="${build.dir}/merge"
            destdir="${build.dir}/classes"
            verbose="false"
            >
                <fileset dir="${src.dir}">
                    <include name="**/*.java"/>
                </fileset>
                <strutsconfigxml version="1.2" />
        </webdoclet>
    </target>

</project>

 

 

 

还有个hibernate.properties的文件不得不提

Java代码

hibernate.dialect=org.hibernate.dialect.MySQLDialect
hibernate.connection.url=jdbc:mysql://localhost:3306/test
hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.username=root
hibernate.connection.password=root

 

 

3个基础文件

Car.java用来生成hibernate.cfg.xml和Car.hbm.xml

LoginAction.java和LoginForm.java用来生成struts-config.xml

当然这3个文件还会产生classes文件

 

Car.java

Java代码

import java.io.Serializable;

/**
 * @hibernate.class table="car"
 * @author Charles King
 *
 */
public class Car implements Serializable{

    private Integer carId;

    private String carName;

    /**
     * @hibernate.id generator-class = "native" column="carid"
     * @return
     */
    public Integer getCarId() {
        return carId;
    }

    public void setCarId(Integer carId) {
        this.carId = carId;
    }

    /**
     * @hibernate.property column="carname"
     * @return
     */
    public String getCarName() {
        return carName;
    }

    public void setCarName(String carName) {
        this.carName = carName;
    }



}

 

 

LoginForm.java

Java代码

import org.apache.struts.action.ActionForm;

/**
 * @struts.form
 *   name = "loginForm"
 * @author Charles King
 *
 */
public class LoginForm extends ActionForm {

}

 

 

LoginAction.java

Java代码

import org.apache.struts.action.Action;

/**
 * @struts.action
 *   input = "/login.jsp"
 *   scope = "request"
 *   name = "loginForm"
 *   validate = "false"
 *   path = "/login.do"
 * @author Charles King
 *
 */
public class LoginAction extends Action {

}

 

 

 

4。运行

 

在运行gen-hib和web xdoclet前先在lib下加入这些包，如图：

 

struts.jar是1.2.9版本里的那个。servlet-api都知道是哪个的。其他几个都在xdoclet里找。不过我很奇怪没有xdoclet-ejb-module-1.2.3.jar，web xdoclet运行时就会有问题。

 

5。文件目录

在不运行cleanXml情况下的目录结构。

在eclipse环境下：

 

 

以上就是最简单的xdoclet应用了。