ant的build.xml文件詳解

以build_for_ejb_templet.xml爲示例,講解Ant中常用的元素和任務。

約定: "…"表示這裏有很多代碼,未列出

build_for_ejb_templet.xml任務的分爲以下幾大部分
i. 開始
ii. 初始化
iii. 定義classpath
iv. 爲編譯作準備
v. 編譯EJB部分
vi. 編譯WEB部分
vii. 編譯J2EE Application
viii. 部署Application
ix. 創建組件的API
x. 確定build的目標

build_for_ejb_templet.xml的講解


開始
<?xml version="1.0" encoding="UTF-8"?>
講解:encoding="UTF-8"表示XML文件採用UTF-8編碼格式,如果要使用GBK編碼,需定義爲encodeing="GBK"。

<!--  
  Build file for 'componentName'  
  Creation 
  Updated 
  Author:  developerName
  Copyright 2002 CompanyName, Inc. All rights reserved.  
-->
  
講解:此部分爲文件內容的簡介,包括文件名稱、創建日期、最後修改日期、創建文件的作者、版權。
componentName 表示 文件名稱
yyyy-m-dd 表示 創建日期、最後修改日期的格式,如2002-5-1
developerName 表示 創建文件的作者
CompanyName 表示 公司名稱或URL

<project default="core" basedir=".">

</project>

講解:此部分定義了一個名稱爲componentName的項目元素,缺省的任務爲"core"任務,根目錄爲當前目錄。componentName表示組件的名稱,這裏指EJB的名稱。



初始化
<target >

</target>

講解:此部分用於初始化所有的變量

<property file="../../build.properties" />
講解:導入項目根目錄下build.properties中的全局變量,開發人員也可以在此文件中重新定義全局變量。

<property value="${jboss.home}/lib" />  
<property value="${jboss.home}/client" />  
<property value="${jboss.home}/server/${jboss.configuration}/deploy" />  

<property       value="${jboss.home}" />  

<property      value=""/>  
<property value=""/>  
<property value=""/>

講解:定義和Jboss Application Server有關的變量,包括lib目錄、client目錄、
deploy目錄和J2EE Application部署要用到的一些變量。

<property   value="componentName"/>  
講解:定義組件的名稱

<property value="${basedir}/src"/>  
講解:定義源代碼目錄路徑

<property value="${basedir}/etc"/>  
講解:定義資源目錄路徑

<property value="${basedir}/lib"/>  
講解:定義庫目錄路徑

<property value="${basedir}/build"/>  
講解:定義build目錄路徑

<property value="${src.dir}/main"/>
講解:定義源代碼的主目錄路徑

<property value="${src.main.dir}/ejb"/>  
講解:定義存放EJB的源代碼目錄路徑

<property value="${src.main.dir}/javabean"/>
講解:定義存放JavaBean的源代碼目錄路徑

<property value="${src.main.dir}/servlet"/>
講解:定義存放Servlet的源代碼目錄路徑

<property value="${src.main.dir}/web"/>  
講解:定義存放WEB部分文件(包括JSP程序、HTML文件、圖片、CSS文件、JS腳本等)的目錄路徑

<property value="${lib.dir}/docs/api"/>
講解:定義存放組件API的開發文件目錄路徑

<property value="${lib.dir}/ejb"/>  
講解:定義存放EJB的編譯代碼目錄路徑

<property value="${lib.dir}/javabean"/>  
講解:定義存放JavaBean的編譯代碼目錄路徑

<property value="${lib.dir}/web/WEB-INF/classes" />
講解:定義WEB目錄的類目錄路徑

<property value="${lib.dir}/web/WEB-INF/lib" />  
講解:定義WEB目錄的庫目錄名稱

<property value="${name}-pkg"/>  
講解:定義壓縮文檔的名稱

<property value="../../components" />  
講解:定義項目的組件目錄路徑

<!-- Define componentName Component -->
講解:這段爲註釋,說明以下是定義當前組件的變量

<property value="componentName"/>
講解:定義當前組件的名稱

<property value="${ProjectName.components.home}/componentName"/>
講解:定義當前組件的目錄路徑


<property value="${ProjectName.componentName.home}/lib/ejb"/>
講解:定義當前組件的EJB編譯目錄路徑

 


<property value="${ProjectName.componentName.home}/build/componentName-ejb.jar"/>
講解:定義當前組件內的EJB包的路徑

 


<property value="${ProjectName.componentName.home}/build/componentName-ejb-client.jar"/>
講解:定義當前組件內的EJB客戶端包的路徑

 


<!-- Define referencesComponentName Component -->
講解:這段爲註釋,說明以下是定義引入其它組件的變量


<property value="referencesComponentName"/>
講解:定義指定組件的名稱


<property value="${ProjectName.components.home}/referencesComponentName"/>
講解:定義指定組件的目錄路徑

<property value="${ProjectName.referencesComponentName.home}/lib/ejb"/>
講解:定義指定組件的EJB編譯目錄路徑

<property value="${ProjectName.referencesComponentName.home}/build/referencesComponentName-ejb.jar"/>
講解:定義指定組件內的EJB包的路徑

<property value="${ProjectName.referencesComponentName.home}/build/referencesComponentName-ejb-client.jar"/>
講解:定義指定組件內的EJB客戶端包的路徑

<property
value="${jboss.client}/jboss-j2ee.jar:

${jboss.client}/jnp-client.jar:

${jboss.client}/jnp-client.jar:

${jboss.client}/jbossmq-client.jar:

${jboss.client}/jbosssx-client.jar:

${jboss.client}/concurrent.jar:

${jboss.client}/jaas.jar:

${jboss.lib}/jboss-jmx.jar:

${jboss.home}/server/${jboss.configuration}/lib/jbosssx.jar:

${jboss.home}/server/${jboss.configuration}/lib/mail.jar:

${servlet-lib.path}:

${ejb-classes.dest}:
${web-classes.dest}:

${ProjectName.componentName.classbindir}:
${ProjectName.componentName.ejbjar.client}:
${ProjectName.referencesComponentName.classbindir}:
${ProjectName.referencesComponentName.ejbjar.client}" />

講解:定義classpath,編譯bean時要用到。這是定義classpath的一種方法,下面還有另一種方法。

定義classpath
<!-- ================================================================== -->  
  <!-- Define the classpath for compile the component                     -->
  <!-- ================================================================== -->  
  <path >  
      <pathelement location="${jboss.client}/jboss-j2ee.jar" />  
      <pathelement location="${jboss.client}/jnp-client.jar" />  
      <pathelement location="${jboss.client}/jbossmq-client.jar" />  
      <pathelement location="${jboss.client}/jbosssx-client.jar" />  
      <pathelement location="${jboss.client}/concurrent.jar" />
      <pathelement location="${jboss.client}/jaas.jar" />  
      <pathelement location="${jboss.lib}/jboss-jmx.jar" />  
      <pathelement location="${jboss.home}/server/${jboss.configuration}/lib/jbosssx.jar" />  
      <pathelement location="${jboss.home}/server/${jboss.configuration}/lib/mail.jar" />  
</path>  
講解:此段定義應用服務器中包文件,如支持ejb的jboss-j2ee.jar、支持客戶端程序的jnp-client.jar、jbossmq-client.jar、jbosssx-client.jar、支持JavaMail的mail.jar等。


   <path >  
      <path refid="base.path"/>
      <pathelement location="${ProjectName.componentName.classbindir}"/>
      <pathelement location="${ProjectName.componentName.ejbjar.client}"/>
      <pathelement location="${ProjectName.referencesComponentName.classbindir}"/>
      <pathelement location="${ProjectName.referencesComponentName.ejbjar.client}"/>
   </path>  
講解:此段定義項目中要用到的包文件。


   <path >
         <path refid="project.path"/>
         <pathelement location="${servlet-lib.path}"/>
         <pathelement location="${ejb-classes.dest}"/>
   </path>
講解:此段定義在編譯servlet時的classpath,${ servlet-lib.path }是系統指定的Servlet引擎包。


爲編譯作準備工作

<!--=============================================================== -->  
   <!-- Removes all created files and directories                      -->  
   <!-- ============================================================== -->  
   <target depends="init">  
      <delete dir="${lib.dir}" />  
      <delete dir="${build.dir}" />  
   </target>

講解:清除build、lib目錄下的所有文件和目錄。

   <!-- ================================================================ -->  
   <!-- Makes sure the needed directory structure is in place              -->  
   <!-- ================================================================ -->  
   <target depends="init,clean">  
      <mkdir dir="${lib.dir}" />  
      <mkdir dir="${lib.dir}/ejb" />  
      <mkdir dir="${lib.dir}/ejb/META-INF" />  
      <mkdir dir="${lib.dir}/web" />  
      <mkdir dir="${lib.dir}/web/WEB-INF" />  
      <mkdir dir="${lib.dir}/web/WEB-INF/classes" />  
      <mkdir dir="${lib.dir}/web/WEB-INF/lib" />  
      <mkdir dir="${lib.dir}/j2ee" />  
      <mkdir dir="${lib.dir}/META-INF" />  
      <mkdir dir="${lib.dir}/docs/api" />
      <mkdir dir="${build.dir}" />  
   </target>  
講解:創建build中要用到的所有目錄,根據需要可以加入自定義的目錄如:
      <mkdir dir="${lib.dir}/javabean/ " />

編譯EJB部分
<!-- ================================================================ -->  
   <!-- Compilation of the EJB part of the application                     -->  
   <!-- ================================================================ -->  
   <target depends="prepare">  
      <javac srcdir="${src.ejb.dir}"  
             destdir="${ejb-classes.dest}"  
             includes="com/**"  
             classpathref="base.path" />
   </target>  
講解:此小段用來完成編譯ejb和其它help classes。根據需要可以加入一個非常有用的元素:
             encoding="${javac.encoding}"

   <target depends="prepare">  
      <copy file="${etc.dir}/ejb-jar.xml"  tofile="${lib.dir}/ejb/META-INF/ejb-jar.xml" />  
      <copy file="${etc.dir}/jaws.xml"  tofile="${lib.dir}/ejb/META-INF/jaws.xml" />  
      <copy file="${etc.dir}/jboss.xml"  tofile="${lib.dir}/ejb/META-INF/jboss.xml" />  
      <copy file="${etc.dir}/jbosscmp-jdbc.xml"  tofile="${lib.dir}/ejb/META-INF/jbosscmp-jdbc.xml" />  
   </target>
講解:此小段用來拷貝EJB部署文件,在JAS中EJB部署文件有jaws.xml、jboss.xml、jbosscmp-jdbc.xml。

   <target depends="ejb-classes,ejb-meta-inf">  
      <jar jarfile="${build.dir}/${name}-ejb.jar"  basedir="${lib.dir}/ejb" />  
   </target>  
講解:此小段用來把class和部署文件壓縮成包文件,這個包文件就是一個EJB組件。

   <target depends="ejb-jar,web-classes">
      <copy
         file="${ProjectName.referencesComponentName.home}/build/${ProjectName.referencesComponentName.name}-ejb-client.jar"  
          tofile="${build.dir}/${ProjectName.referencesComponentName.name}-ejb-client.jar" />  
      <jar jarfile="${build.dir}/${name}-ejb-client.jar"  
           basedir="${lib.dir}/ejb"
           excludes="com/ProjectName/componentName/ejb/ComponentNameEJB.class" />  
   </target>

講解:此小段用來把class和部署文件壓縮成包文件,以支持客戶端運行。

編譯WEB部分
<!-- ================================================================== -->  
   <!-- Compilation of the web part of the application                     -->  
   <!-- ================================================================== -->  
   <target depends="prepare,ejb-jar">  
      <javac srcdir="${src.servlet.dir}"  
             destdir="${lib.dir}/web/WEB-INF/classes"  
             includes="com/**"  
             classpath="${build.classpath}" />  
   </target>  
講解:此小段用來完成編譯servlet。

   <target depends="prepare">
      <copy file="${etc.dir}/jboss-web.xml"  tofile="${lib.dir}/web/WEB-INF/jboss-web.xml" />  
      <copy file="${etc.dir}/web.xml"  tofile="${lib.dir}/web/WEB-INF/web.xml" />  
   </target>

講解:此小段用來拷貝WEB部署文件,在JAS中WEB部署文件有jboss-web.xml。

   <target depends="web-classes,web-web-inf">  
      <copy todir="${lib.dir}/web" >
       <fileset dir="${src.web.dir}"/>
      </copy>
      <copy

         file="${build.dir}/${ProjectName.referencesComponentName.name}-ejb-client.jar"  
         tofile="${lib.dir}/web/WEB-INF/lib/${ProjectName.referencesComponentName.name}-ejb-lient.jar" />    
     <jar jarfile="${build.dir}/${name}-web.war"  basedir="${lib.dir}/web" />  
   </target>

講解:此小段用來把所有的JSP程序、Html、Css、圖片和部署文件等壓縮成WAR文件。

編譯J2EE Application
<!-- ================================================================== -->  
   <!-- Compilation of the complete J2EE application (both web and EJB)    -->  
   <!-- ================================================================== -->  
   <target depends="prepare">  
      <copy file="${etc.dir}/application.xml"  tofile="${lib.dir}/j2ee/META-INF/application.xml" />  
   </target>  
講解:此小段用來拷貝Application的部署文件。

   <target depends="ejb-jar,war,j2ee-meta-inf">  
      <copy file="${build.dir}/${name}-ejb.jar"  tofile="${lib.dir}/j2ee/${name}-ejb.jar" />  
      <copy file="${build.dir}/${name}-web.war"  tofile="${lib.dir}/j2ee/${name}-web.war" />  
      <jar jarfile="${build.dir}/${name}.ear"  basedir="${lib.dir}/j2ee" />  
   </target>
  
講解:此小段用來把EJB組件、支持客戶端運行的包和部署文件壓縮成EAR文件,它就是一個J2EE Application。這裏要說明,在進行build時,根據需要可以不生成EAR文件。

部署Application
<!-- ================================================================ -->
   <!-- Deploy EAR file                                                   -->
   <!-- ================================================================ -->
   <target depends="ear,war">  
      <copy todir="${jboss.deploy}">  
         <fileset dir="${build.dir}" includes="*.ear">  
         </fileset>  
      </copy>  
   </target>
  
講解:此小段用來部署Application,在JAS3.0中${jboss.deploy}是JAS的熱部署目錄。

創建組件的API
<!-- =================================================================== -->
   <!-- Create class and package usage pages                                -->
   <!-- =================================================================== -->
   <target depends="init">
    <javadoc locale="${javadoc.locale}" packagenames="${package.names}.${name}.*"  
             destdir="${javadoc.dir}"  
             classpath="${build.classpath}"
             encoding="${javadoc.encoding}"
             author="${javadoc.author}"
             version="${javadoc.version}" 
             use="${javadoc.usage}"  
             windowtitle="${project.name} ${name} Component API"
             doctitle="${project.name} ${name} Component"  
             bottom="Copyright ${sign.copyright} ${project.date} ${company.signature}. All Rights Reserved.">  
<classpath >
        <pathelement path="${lib.dir}/ejb"/>  
      </classpath>
      <sourcepath>
        <pathelement path="${src.main.dir}/ejb"/>
      </sourcepath>
    </javadoc>
   </target>
講解:此小段用來創建組件的API。這裏強烈要求類設計人員和編碼人員按照Javadoc定義的標籤對源代碼進行註釋。



確定build的目標
<target >
      <echo>+---------------------------------------+</echo>
      <echo>+    Building ${name} Component         +</echo>
      <echo>+---------------------------------------+</echo>
   </target>
   <target depends="main" >
      <echo>+---------------------------------------+</echo>
      <echo>+    Finished ${name} Component         +</echo>
      <echo>+---------------------------------------+</echo>
   </target>
   <target depends="startbanner, ejb-jar, ejbclientjar" />
   <target depends="startbanner, ejb-jar,ejbclientjar,war" />
   <target depends="startbanner, ejb-jar, ejbclientjar,war,ear,deploy-server" />
   <target depends="ejb-war" />
   <target depends="main2,endbanner" />
   <target depends="main3,endbanner" />
   <target depends="core, docs" />
講解:此小段用來確定build的目標。缺省目錄爲core,所以在build不加參數時,系統將只生成jar文件和war文件。如果 build時加上參數,系統將根據需要來生成文件,例如:在命令行輸入ant deploy,系統將生成jar文件、war文件、ear文件,同時將ear文件進行部署。

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章