root/trunk/build/buildTools/buildjar.xml

<!-- This file builds a single jar file. It just sets defaults for the java
     compiler then invokes it.

     This is the only place we compile files.

     On entry we require:
       build.jar.file        Fully specified name of destination jar file.
       base.java.sources     Defines the java source files
       base.class.patternset Defines the java class files
       base.resource.files   Defines extra resources to go in the jar

     We will copy all files defined by base.java.patternset to a temporary
     location and compile out of that into a temporary classes location.

     We do that to avoid a problematic feature of the java compilers, the
     tendency to recompile any referenced sources found on the source path.

     So, if we have all our sources under the directory "src" and compile a
     single package in that tree, all referenced classes will be compiled,
     even if they exist in a jar file on the class path.

     The other side-effect is that we might compile and include classes we
     didn't realise we were compiling.

     The downside is that we need to be very specific about the classes we
     compile for a package and we might need to put classes in
     base.java.sources which we don't want in the final jar file.

     On exit we will have created classes in the directory
        ${jar.temp.classes}
     and a jar file
        ${build.jar.file}

     Authors: Mike Douglass   douglm rpi.edu
-->

<project name="buildjar" default="build" >
  <taskdef resource="net/sf/antcontrib/antcontrib.properties" />

  <target name="init">
    <!--  =================== Compilation Control Options ===============
      These properties control option settings on the Javac compiler when it
      is invoked using the <javac> task.

      compile.debug        Should compilation include the debug option?
      compile.deprecation  Should compilation include the deprecation option?
      compile.optimize     Should compilation include the optimize option?

      Below are the defaults. They may already be set in the build properties.
    -->

    <property name="compile.debug" value="true"/>
    <property name="compile.deprecation" value="false"/>
    <property name="compile.optimize" value="true"/>
    <property name="compile.verbose" value="false"/>
    <property name="compile.listfiles" value="false"/>

    <property name="jar.temp.sources"
             location="${dist.home}/source" />
    <property name="jar.temp.classes"
             location="${dist.home}/classes" />
  </target>

  <target name="build" depends="init"
          description="Compile Java sources">
    <!-- ==============================================================
          See if the jar is up to date. We recompile if any of the
          source files or metainf files are newer. We also recompile if
          any jars on the package classpath are newer.
         ============================================================== -->

    <noisyMsg message="build.jar.file=${build.jar.file}" />

    <uptodate property="build.jar.uptodate"
              targetfile="${build.jar.file}" >
      <srcfiles refid="buildjar.java.sources" />
      <srcfiles refid="buildjar.generated.java.sources" />
      <srcfiles refid="buildjar.resource.files"/>
    </uptodate>

    <if>
      <isset property="build.jar.uptodate"/>
      <then>
        <noisyMsg message="**** ${build.jar.file} is up to date" />
      </then>
      <else>
        <noisyMsg message="**** ${build.jar.file} needs rebuilding" />

        <!-- Delete jar file -->
        <delete file="${build.jar.file}"/>

        <dirname property="build.jar.dir" file="${build.jar.file}"/>

        <mkdir dir="${build.jar.dir}" />

        <!-- ==========================================================
                          Build the classes
             ========================================================== -->

        <!-- First copy the sources we are going to compile into a temp
             directory. -->
        <delete dir="${jar.temp.sources}" />
        <mkdir dir="${jar.temp.sources}" />
        
        <copy toDir="${jar.temp.sources}">
          <fileset refid="buildjar.java.sources" />
          <fileset refid="buildjar.generated.java.sources" />
          <fileset refid="buildjar.resource.files"/>
        </copy>

        <mkdir dir="${jar.temp.classes}"/>
        
        <debugMsg message="About to build jar ${build.jar.file}"/>
        <debugCpid idpar="compile.classpath" />

        <javac srcdir="${jar.temp.sources}"
               destdir="${jar.temp.classes}"
               debug="${compile.debug}"
               verbose="${compile.verbose}"
               listfiles="${compile.listfiles}"
               deprecation="${compile.deprecation}"
               optimize="${compile.optimize}">
          <classpath refid="compile.classpath"/>
          <include name="**/*.java"/>
          <compilerarg value="-nowarn" compiler="jikes" />
        </javac>

        <!-- ==========================================================
                          Build jar file
             ========================================================== -->

        <jar jarfile="${build.jar.file}">
          <fileset dir="${jar.temp.classes}">
            <patternset refid="base.class.patternset"/>
          </fileset>
          <fileset refid="buildjar.resource.files"/>
        </jar>

        <!-- ==========================================================
                          Clean up
             ========================================================== -->

        <delete dir="${jar.temp.sources}" />
        <delete dir="${jar.temp.classes}"/>
      </else>
    </if>
  </target>
</project>