各位好，上次我們簡單的介紹了ant這個工具，這次我們利用
這個工具，設計了一個開發jboss上的程式的template，作為一個簡單
的例子。在這裡先說明一下template的路徑架構：
<template>
   |
   |---<build>--------------------------------------<server>
   |---<conf>                                            |---<client>
   |---<dist>----------------------------------------<server>
   |---<otherpackages>                            |---<client>
   |---<src>----------------------------------------<server> 
   |---ant.properties                                 |---<client>
   |---jndi.properties
   |---build.xml
   |---lcp.bat
   |---run-client.bat
其中，ant.properties,lcp.bat和run-client.bat是參考自jboss網站所附的
example，ant.properties是用來設定jboss.home這個環境參數，lcp.bat
是用來設定執行期的classpath，run-client.bat是用來執行client程式的。
在路徑架構裡面，<src>是放置原始碼的地方，<otherpackages>則是
用來放置程式編譯所需要的相關jar檔案或者是展開的package,<conf>
主要是用來放置ejb-jar.xml和jboss.xml
最後我們來看看build.xml
----------------------------------第一段------------------------------------------------
<project name="EJBtemplate" default="dist" basedir=".">
    <description>
        template build file
    </description>
  <!-- set global properties for this build -->
  <property file="ant.properties"/>
  <property name="src" location="src"/>
  <property name="build" location="build"/>
  <property name="dist"  location="dist"/>
  <property name="conf" location="conf"/>
  <property name="otherpackages"  location="otherpackages"/>
----------------------------------------------------------------------------------------
檔案很長，所以我們分成幾段來看，第一段主要是設定一些基本
的property，如上。
-----------------------------------第二段-----------------------------------------------
<target name="checkproperties" unless="jboss.home">
      <fail>
         Property "jboss.home" must be set in ant.properties
      </fail>
  </target>
  
  <target name="init" depends="checkproperties">
    <!-- Create the time stamp -->
    <tstamp/>
    <!-- Create the build directory structure used by compile -->
    <mkdir dir="${build}"/>
    <mkdir dir="${build}/server"/>
    <mkdir dir="${build}/client"/>
  </target>
------------------------------------------------------------------------------------------
第二段的兩個target，第一個是檢查jboss.home是否有被設定，第二個
則是產生<build>及其底下的路徑。
----------------------------------第三段----------------------------------------------
<target name="compile_server" depends="init"
        description="compile the source " >
    <!-- Compile the java code from ${src} into ${build} -->
    <javac srcdir="${src}/server" destdir="${build}/server">
    	<classpath>
    		<pathelement path="${classpath}"/>
    		<pathelement path="${otherpackages}"/>
    		<pathelement path="${build}/server"/>
    		<fileset dir="${jboss.home}/server/default/lib" includes="*.jar"/>
    		<fileset dir="${jboss.home}/lib" includes="*.jar"/>
    		<fileset dir="${otherpackages}" includes="*.jar"/>
    	</classpath>
    </javac>
  </target>
  
  <target name="compile_client" depends="init"
        description="compile the source " >
    <!-- Compile the java code from ${src} into ${build} -->
    <javac srcdir="${src}/client" destdir="${build}/client">
    	<classpath>
    		<pathelement path="${classpath}"/>
    		<pathelement path="${otherpackages}"/>
    		<pathelement path="${build}/server"/>
    		<fileset dir="${jboss.home}/server/default/lib" includes="*.jar"/>
    		<fileset dir="${jboss.home}/lib" includes="*.jar"/>
    		<fileset dir="${jboss.home}/client" includes="*.jar"/>
    		<fileset dir="${otherpackages}" includes="*.jar"/>
    	</classpath>
    </javac>
 </target>
---------------------------------------------------------------------------------------------------
第三段是用來進行compile的，特別注意<classpath>......</classpath>這組標籤，
用來指定編譯時期的classpath，其中使用<pathelement>可以用來表示路徑
型態的classpath設定，亦即包括系統的classpath環境變數與展開型態的package.
使用<fileset>可以表達更廣泛的意義，這裡只用來表示所有相關路徑的.jar檔案。
----------------------------------------第四段-----------------------------------------------------
  <target name="dist_server" depends="compile_server"
        description="generate the distribution" >
    <!-- Create the distribution directory -->
    <mkdir dir="${dist}/server"/>
    <mkdir dir="${build}/server/META-INF"/>
    <copy todir="${build}/server/META-INF">
    	<fileset dir="${conf}"/>
    </copy>

    <jar jarfile="${dist}/server/EJBtemplate_server.jar" basedir="${build}/server"/>
  </target>
  
  <target name="dist_client" depends="compile_client"
        description="generate the distribution" >
    <!-- Create the distribution directory -->
    <mkdir dir="${dist}/client"/>
    <jar jarfile="${dist}/client/EJBtemplate_client.jar" basedir="${build}/client">
    	<fileset dir="${build}/client"/>
    	<fileset dir="${build}/server"/>
    </jar>
    <copy todir="${dist}/client">
    	<fileset dir="." includes="*.bat"/>
    </copy>
    <copy todir="${dist}/client" file="jndi.properties"/>
  </target>
-----------------------------------------------------------------------------------------------------
第四段是用來發佈server端和client端的檔案，這邊可以特別注意<copy>和<jar>
的用法，透過這些設定，我把<conf>裡面的檔案copy到<build>\server資料夾裡面，
把執行client端用的批次執行檔和jndi.properties檔案copy到<build>\client資料夾裡面，
並且利用jar來封裝server端和client端的檔案。
----------------------------------------第五段---------------------------------------------------
<target name="dist" depends="dist_server,dist_client">
    <mkdir dir="${dist}/otherpackages"/>
    <copy todir="${dist}/otherpackages">
    	<fileset dir="otherpackages" includes="*.jar"/>
    </copy>
 </target>
----------------------------------------------------------------------------------------------------
第五段是用來把<otherpackages>裡面的.jar檔案copy到<dist>\otherpackages資料夾
裡面，這些檔案有可能必須發佈到server端或client端
----------------------------------------第六段---------------------------------------------------
  <target name="clean"
        description="clean up" >
    <!-- Delete the ${build} and ${dist} directory trees -->
    <delete dir="${build}"/>
    <delete dir="${dist}"/>
  </target>
</project>
------------------------------------------------------------------------------------------------------
第六段是用來清除編譯過的程式的，將資料夾還原到完全尚未編譯之前的狀態。