build.xml.txt
上传用户:bj_pst
上传日期:2019-07-07
资源大小:7353k
文件大小:17k
源码类别:

Java编程

开发平台:

Java

  1. <!--
  2.   Licensed to the Apache Software Foundation (ASF) under one or more
  3.   contributor license agreements.  See the NOTICE file distributed with
  4.   this work for additional information regarding copyright ownership.
  5.   The ASF licenses this file to You under the Apache License, Version 2.0
  6.   (the "License"); you may not use this file except in compliance with
  7.   the License.  You may obtain a copy of the License at
  8.       http://www.apache.org/licenses/LICENSE-2.0
  9.   Unless required by applicable law or agreed to in writing, software
  10.   distributed under the License is distributed on an "AS IS" BASIS,
  11.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12.   See the License for the specific language governing permissions and
  13.   limitations under the License.
  14. -->
  15. <!--
  16.      General purpose build script for web applications and web services,
  17.      including enhanced support for deploying directly to a Tomcat 5
  18.      based server.
  19.      This build script assumes that the source code of your web application
  20.      is organized into the following subdirectories underneath the source
  21.      code directory from which you execute the build script:
  22.         docs                 Static documentation files to be copied to
  23.                              the "docs" subdirectory of your distribution.
  24.         src                  Java source code (and associated resource files)
  25.                              to be compiled to the "WEB-INF/classes"
  26.                              subdirectory of your web applicaiton.
  27.         web                  Static HTML, JSP, and other content (such as
  28.                              image files), including the WEB-INF subdirectory
  29.                              and its configuration file contents.
  30.      $Id: build.xml.txt 572161 2007-09-02 21:18:19Z markt $
  31. -->
  32. <!-- A "project" describes a set of targets that may be requested
  33.      when Ant is executed.  The "default" attribute defines the
  34.      target which is executed if no specific target is requested,
  35.      and the "basedir" attribute defines the current working directory
  36.      from which Ant executes the requested task.  This is normally
  37.      set to the current working directory.
  38. -->
  39. <project name="My Project" default="compile" basedir=".">
  40. <!-- ===================== Property Definitions =========================== -->
  41. <!--
  42.   Each of the following properties are used in the build script.
  43.   Values for these properties are set by the first place they are
  44.   defined, from the following list:
  45.   * Definitions on the "ant" command line (ant -Dfoo=bar compile).
  46.   * Definitions from a "build.properties" file in the top level
  47.     source directory of this application.
  48.   * Definitions from a "build.properties" file in the developer's
  49.     home directory.
  50.   * Default definitions in this build.xml file.
  51.   You will note below that property values can be composed based on the
  52.   contents of previously defined properties.  This is a powerful technique
  53.   that helps you minimize the number of changes required when your development
  54.   environment is modified.  Note that property composition is allowed within
  55.   "build.properties" files as well as in the "build.xml" script.
  56. -->
  57.   <property file="build.properties"/>
  58.   <property file="${user.home}/build.properties"/>
  59. <!-- ==================== File and Directory Names ======================== -->
  60. <!--
  61.   These properties generally define file and directory names (or paths) that
  62.   affect where the build process stores its outputs.
  63.   app.name             Base name of this application, used to
  64.                        construct filenames and directories.
  65.                        Defaults to "myapp".
  66.   app.path             Context path to which this application should be
  67.                        deployed (defaults to "/" plus the value of the
  68.                        "app.name" property).
  69.   app.version          Version number of this iteration of the application.
  70.   build.home           The directory into which the "prepare" and
  71.                        "compile" targets will generate their output.
  72.                        Defaults to "build".
  73.   catalina.home        The directory in which you have installed
  74.                        a binary distribution of Tomcat 5.  This will
  75.                        be used by the "deploy" target.
  76.   dist.home            The name of the base directory in which
  77.                        distribution files are created.
  78.                        Defaults to "dist".
  79.   manager.password     The login password of a user that is assigned the
  80.                        "manager" role (so that he or she can execute
  81.                        commands via the "/manager" web application)
  82.   manager.url          The URL of the "/manager" web application on the
  83.                        Tomcat installation to which we will deploy web
  84.                        applications and web services.
  85.   manager.username     The login username of a user that is assigned the
  86.                        "manager" role (so that he or she can execute
  87.                        commands via the "/manager" web application)
  88. -->
  89.   <property name="app.name"      value="myapp"/>
  90.   <property name="app.path"      value="/${app.name}"/>
  91.   <property name="app.version"   value="0.1-dev"/>
  92.   <property name="build.home"    value="${basedir}/build"/>
  93.   <property name="catalina.home" value="../../../.."/> <!-- UPDATE THIS! -->
  94.   <property name="dist.home"     value="${basedir}/dist"/>
  95.   <property name="docs.home"     value="${basedir}/docs"/>
  96.   <property name="manager.url"   value="http://localhost:8080/manager"/>
  97.   <property name="src.home"      value="${basedir}/src"/>
  98.   <property name="web.home"      value="${basedir}/web"/>
  99. <!-- ================== Custom Ant Task Definitions ======================= -->
  100. <!--
  101.   These properties define custom tasks for the Ant build tool that interact
  102.   with the "/manager" web application installed with Tomcat 5.  Before they
  103.   can be successfully utilized, you must perform the following steps:
  104.   - Copy the file "server/lib/catalina-ant.jar" from your Tomcat 5
  105.     installation into the "lib" directory of your Ant installation.
  106.   - Create a "build.properties" file in your application's top-level
  107.     source directory (or your user login home directory) that defines
  108.     appropriate values for the "manager.password", "manager.url", and
  109.     "manager.username" properties described above.
  110.   For more information about the Manager web application, and the functionality
  111.   of these tasks, see <http://localhost:8080/tomcat-docs/manager-howto.html>.
  112. -->
  113.   <taskdef name="deploy"   classname="org.apache.catalina.ant.DeployTask"/>
  114.   <taskdef name="list"     classname="org.apache.catalina.ant.ListTask"/>
  115.   <taskdef name="reload"   classname="org.apache.catalina.ant.ReloadTask"/>
  116.   <taskdef name="undeploy" classname="org.apache.catalina.ant.UndeployTask"/>
  117. <!--  ==================== Compilation Control Options ==================== -->
  118. <!--
  119.   These properties control option settings on the Javac compiler when it
  120.   is invoked using the <javac> task.
  121.   compile.debug        Should compilation include the debug option?
  122.   compile.deprecation  Should compilation include the deprecation option?
  123.   compile.optimize     Should compilation include the optimize option?
  124. -->
  125.   <property name="compile.debug"       value="true"/>
  126.   <property name="compile.deprecation" value="false"/>
  127.   <property name="compile.optimize"    value="true"/>
  128. <!-- ==================== External Dependencies =========================== -->
  129. <!--
  130.   Use property values to define the locations of external JAR files on which
  131.   your application will depend.  In general, these values will be used for
  132.   two purposes:
  133.   * Inclusion on the classpath that is passed to the Javac compiler
  134.   * Being copied into the "/WEB-INF/lib" directory during execution
  135.     of the "deploy" target.
  136.   Because we will automatically include all of the Java classes that Tomcat 5
  137.   exposes to web applications, we will not need to explicitly list any of those
  138.   dependencies.  You only need to worry about external dependencies for JAR
  139.   files that you are going to include inside your "/WEB-INF/lib" directory.
  140. -->
  141. <!-- Dummy external dependency -->
  142. <!--
  143.   <property name="foo.jar"
  144.            value="/path/to/foo.jar"/>
  145. -->
  146. <!-- ==================== Compilation Classpath =========================== -->
  147. <!--
  148.   Rather than relying on the CLASSPATH environment variable, Ant includes
  149.   features that makes it easy to dynamically construct the classpath you
  150.   need for each compilation.  The example below constructs the compile
  151.   classpath to include the servlet.jar file, as well as the other components
  152.   that Tomcat makes available to web applications automatically, plus anything
  153.   that you explicitly added.
  154. -->
  155.   <path id="compile.classpath">
  156.     <!-- Include all JAR files that will be included in /WEB-INF/lib -->
  157.     <!-- *** CUSTOMIZE HERE AS REQUIRED BY YOUR APPLICATION *** -->
  158. <!--
  159.     <pathelement location="${foo.jar}"/>
  160. -->
  161.     <!-- Include all elements that Tomcat exposes to applications -->
  162.     <pathelement location="${catalina.home}/common/classes"/>
  163.     <fileset dir="${catalina.home}/common/endorsed">
  164.       <include name="*.jar"/>
  165.     </fileset>
  166.     <fileset dir="${catalina.home}/common/lib">
  167.       <include name="*.jar"/>
  168.     </fileset>
  169.     <pathelement location="${catalina.home}/shared/classes"/>
  170.     <fileset dir="${catalina.home}/shared/lib">
  171.       <include name="*.jar"/>
  172.     </fileset>
  173.   </path>
  174. <!-- ==================== All Target ====================================== -->
  175. <!--
  176.   The "all" target is a shortcut for running the "clean" target followed
  177.   by the "compile" target, to force a complete recompile.
  178. -->
  179.   <target name="all" depends="clean,compile"
  180.    description="Clean build and dist directories, then compile"/>
  181. <!-- ==================== Clean Target ==================================== -->
  182. <!--
  183.   The "clean" target deletes any previous "build" and "dist" directory,
  184.   so that you can be ensured the application can be built from scratch.
  185. -->
  186.   <target name="clean"
  187.    description="Delete old build and dist directories">
  188.     <delete dir="${build.home}"/>
  189.     <delete dir="${dist.home}"/>
  190.   </target>
  191. <!-- ==================== Compile Target ================================== -->
  192. <!--
  193.   The "compile" target transforms source files (from your "src" directory)
  194.   into object files in the appropriate location in the build directory.
  195.   This example assumes that you will be including your classes in an
  196.   unpacked directory hierarchy under "/WEB-INF/classes".
  197. -->
  198.   <target name="compile" depends="prepare"
  199.    description="Compile Java sources">
  200.     <!-- Compile Java classes as necessary -->
  201.     <mkdir    dir="${build.home}/WEB-INF/classes"/>
  202.     <javac srcdir="${src.home}"
  203.           destdir="${build.home}/WEB-INF/classes"
  204.             debug="${compile.debug}"
  205.       deprecation="${compile.deprecation}"
  206.          optimize="${compile.optimize}">
  207.         <classpath refid="compile.classpath"/>
  208.     </javac>
  209.     <!-- Copy application resources -->
  210.     <copy  todir="${build.home}/WEB-INF/classes">
  211.       <fileset dir="${src.home}" excludes="**/*.java"/>
  212.     </copy>
  213.   </target>
  214. <!-- ==================== Dist Target ===================================== -->
  215. <!--
  216.   The "dist" target creates a binary distribution of your application
  217.   in a directory structure ready to be archived in a tar.gz or zip file.
  218.   Note that this target depends on two others:
  219.   * "compile" so that the entire web application (including external
  220.     dependencies) will have been assembled
  221.   * "javadoc" so that the application Javadocs will have been created
  222. -->
  223.   <target name="dist" depends="compile,javadoc"
  224.    description="Create binary distribution">
  225.     <!-- Copy documentation subdirectories -->
  226.     <mkdir   dir="${dist.home}/docs"/>
  227.     <copy    todir="${dist.home}/docs">
  228.       <fileset dir="${docs.home}"/>
  229.     </copy>
  230.     <!-- Create application JAR file -->
  231.     <jar jarfile="${dist.home}/${app.name}-${app.version}.war"
  232.          basedir="${build.home}"/>
  233.     <!-- Copy additional files to ${dist.home} as necessary -->
  234.   </target>
  235. <!-- ==================== Install Target ================================== -->
  236. <!--
  237.   The "install" target tells the specified Tomcat 5 installation to dynamically
  238.   install this web application and make it available for execution.  It does
  239.   *not* cause the existence of this web application to be remembered across
  240.   Tomcat restarts; if you restart the server, you will need to re-install all
  241.   this web application.
  242.   If you have already installed this application, and simply want Tomcat to
  243.   recognize that you have updated Java classes (or the web.xml file), use the
  244.   "reload" target instead.
  245.   NOTE:  This target will only succeed if it is run from the same server that
  246.   Tomcat is running on.
  247.   NOTE:  This is the logical opposite of the "remove" target.
  248. -->
  249.   <target name="install" depends="compile"
  250.    description="Install application to servlet container">
  251.     <deploy url="${manager.url}"
  252.        username="${manager.username}"
  253.        password="${manager.password}"
  254.            path="${app.path}"
  255.        localWar="file://${build.home}"/>
  256.   </target>
  257. <!-- ==================== Javadoc Target ================================== -->
  258. <!--
  259.   The "javadoc" target creates Javadoc API documentation for the Java
  260.   classes included in your application.  Normally, this is only required
  261.   when preparing a distribution release, but is available as a separate
  262.   target in case the developer wants to create Javadocs independently.
  263. -->
  264.   <target name="javadoc" depends="compile"
  265.    description="Create Javadoc API documentation">
  266.     <mkdir          dir="${dist.home}/docs/api"/>
  267.     <javadoc sourcepath="${src.home}"
  268.                 destdir="${dist.home}/docs/api"
  269.            packagenames="*">
  270.       <classpath refid="compile.classpath"/>
  271.     </javadoc>
  272.   </target>
  273. <!-- ====================== List Target =================================== -->
  274. <!--
  275.   The "list" target asks the specified Tomcat 5 installation to list the
  276.   currently running web applications, either loaded at startup time or
  277.   installed dynamically.  It is useful to determine whether or not the
  278.   application you are currently developing has been installed.
  279. -->
  280.   <target name="list"
  281.    description="List installed applications on servlet container">
  282.     <list    url="${manager.url}"
  283.         username="${manager.username}"
  284.         password="${manager.password}"/>
  285.   </target>
  286. <!-- ==================== Prepare Target ================================== -->
  287. <!--
  288.   The "prepare" target is used to create the "build" destination directory,
  289.   and copy the static contents of your web application to it.  If you need
  290.   to copy static files from external dependencies, you can customize the
  291.   contents of this task.
  292.   Normally, this task is executed indirectly when needed.
  293. -->
  294.   <target name="prepare">
  295.     <!-- Create build directories as needed -->
  296.     <mkdir  dir="${build.home}"/>
  297.     <mkdir  dir="${build.home}/WEB-INF"/>
  298.     <mkdir  dir="${build.home}/WEB-INF/classes"/>
  299.     <!-- Copy static content of this web application -->
  300.     <copy todir="${build.home}">
  301.       <fileset dir="${web.home}"/>
  302.     </copy>
  303.     <!-- Copy external dependencies as required -->
  304.     <!-- *** CUSTOMIZE HERE AS REQUIRED BY YOUR APPLICATION *** -->
  305.     <mkdir  dir="${build.home}/WEB-INF/lib"/>
  306. <!--
  307.     <copy todir="${build.home}/WEB-INF/lib" file="${foo.jar}"/>
  308. -->
  309.     <!-- Copy static files from external dependencies as needed -->
  310.     <!-- *** CUSTOMIZE HERE AS REQUIRED BY YOUR APPLICATION *** -->
  311.   </target>
  312. <!-- ==================== Reload Target =================================== -->
  313. <!--
  314.   The "reload" signals the specified application Tomcat 5 to shut itself down
  315.   and reload. This can be useful when the web application context is not
  316.   reloadable and you have updated classes or property files in the
  317.   /WEB-INF/classes directory or when you have added or updated jar files in the
  318.   /WEB-INF/lib directory.
  319.   NOTE: The /WEB-INF/web.xml web application configuration file is not reread
  320.   on a reload. If you have made changes to your web.xml file you must stop
  321.   then start the web application. 
  322. -->
  323.   <target name="reload" depends="compile"
  324.    description="Reload application on servlet container">
  325.     <reload url="${manager.url}"
  326.        username="${manager.username}"
  327.        password="${manager.password}"
  328.            path="${app.path}"/>
  329.   </target>
  330. <!-- ==================== Remove Target =================================== -->
  331. <!--
  332.   The "remove" target tells the specified Tomcat 5 installation to dynamically
  333.   remove this web application from service.
  334.   NOTE:  This is the logical opposite of the "install" target.
  335. -->
  336.   <target name="remove"
  337.    description="Remove application on servlet container">
  338.     <undeploy url="${manager.url}"
  339.          username="${manager.username}"
  340.          password="${manager.password}"
  341.              path="${app.path}"/>
  342.   </target>
  343. </project>