httpcomponents-client/build.xml

548 lines
20 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
$HeadURL$
$Revision$
$Date$
====================================================================
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
====================================================================
This software consists of voluntary contributions made by many
individuals on behalf of the Apache Software Foundation. For more
information on the Apache Software Foundation, please see
<http://www.apache.org/>.
-->
<project name="HttpClient" basedir="." default="package-src">
<description>
HttpClient: Jakarta HttpComponents Client
</description>
<!-- Definition of the local environment.
The default location of the build.properties assumes that you are
building from the full tree of all HTTP components, and have a
single build.properties file located in ${root}/project/. If this is
not the case, override property local.properties when calling Ant.
Use this file to specify the location of external dependencies,
and to override other properties defined below if you have to.
External dependencies for which there is a default location:
httpcore.jar - always
javadoc.j2sdk.link - for javadoc
dist.core.api - for javadoc
External dependencies for which there is no default location:
commons-logging.jar - (to be added to default dependencies)
junit.jar - for test and clover targets
clover.jar - for clover target
-->
<property name="local.properties" location="../project/build.properties" />
<property file="${local.properties}" />
<!-- component and version information -->
<property name="comp.client.name"
value="httpclient"/>
<property name="comp.client.title"
value="Jakarta HttpComponents Client"/>
<property name="comp.client.version"
value="SNAPSHOT"/>
<!-- external dependencies
These are prime candidates for overriding in local.properties.
The defaults assume again that you are building from the full tree
of HTTP components, and that other components use the default
build settings.
The '.jar properties must be set to either to a JAR file in which
the classes are packaged, or to a directory tree holding them.
-->
<property name="httpcore.home" location="../httpcore" />
<property name="httpcore.jar"
location="${httpcore.home}/module-main/target/classes" />
<property name="dist.core.api"
location="${httpcore.home}/dist/docs/api/" />
<path id="classpath.client.compile">
<pathelement location="${httpcore.jar}"/>
<pathelement location="${commons-logging.jar}"/>
</path>
<path id="classpath.client.javadoc">
<path refid="classpath.client.compile" />
<!-- add dependencies for contrib classes for which to JavaDoc -->
</path>
<!-- directory structure of the source tree -->
<property name="comp.client.home" value="${basedir}"/>
<property name="comp.client.src" value="${comp.client.home}/src/java"/>
<property name="comp.client.tests" value="${comp.client.home}/src/test"/>
<property name="comp.client.xmpls" value="${comp.client.home}/src/examples"/>
<property name="comp.client.contr" value="${comp.client.home}/src/contrib"/>
<!-- locations for intermediate and final build results
For consistency with other builds, the temporary files are
located by default below "target/", final results below "dist/".
-->
<property name="build.client.home" value="${comp.client.home}/target"/>
<property name="build.client.classes" value="${build.client.home}/classes"/>
<property name="build.client.tests" value="${build.client.home}/tests"/>
<property name="build.client.xmpls" value="${build.client.home}/examples"/>
<property name="build.client.contr" value="${build.client.home}/contrib"/>
<property name="build.client.clover" value="${build.client.home}/clover"/>
<property name="dist.client.home" value="${comp.client.home}/dist"/>
<property name="dist.client.docs" value="${dist.client.home}/docs"/>
<property name="dist.client.api" value="${dist.client.docs}/api"/>
<property name="jar.client.src.name"
value="jakarta-${comp.client.name}-${comp.client.version}.jar" />
<property name="jar.client.addon.name"
value="jakarta-${comp.client.name}-addon-${comp.client.version}.jar" />
<!-- compiler and javadoc setup -->
<property name="compile.debug" value="true"/>
<property name="compile.deprecation" value="true"/>
<property name="compile.optimize" value="true"/>
<property name="compile.source" value="1.4"/>
<property name="compile.target" value="1.4"/>
<property name="javadoc.access" value="protected"/>
<property name="javadoc.j2sdk.link"
value="http://java.sun.com/j2se/1.4.2/docs/api/" />
<!-- build targets ======================================================== -->
<target name="echo-properties"
description="echo properties to verify the build setup"
>
<echo>
General
component ${comp.client.name}
component title ${comp.client.title}
component version ${comp.client.version}
base directory ${basedir}
local properties ${local.properties}
Dependencies
HttpCore ${httpcore.jar}
Commons Logging ${commons-logging.jar}
JUnit ${junit.jar}
Clover ${clover.jar}
Source Tree
base ${comp.client.home}
main ${comp.client.src}
tests ${comp.client.tests}
examples ${comp.client.xmpls}
contrib ${comp.client.contr}
Output
temp ${build.client.home}
final ${dist.client.home}
javadoc ${dist.client.api}
</echo>
</target>
<!-- traditional targets ======================================================
These targets match the ones before the build restructuring, except:
- "javadoc" does not depend on "compile"
- "clover" will always recompile the source and tests
-->
<target name="compile" depends="compile-src" />
<target name="package" depends="package-src" />
<target name="javadoc" depends="javadoc-src" />
<target name="test" depends="compile-src,run-tests" />
<target name="clover" depends="run-clover" />
<target name="clean" depends="clean-build,clean-dist" />
<!-- combined compilation targets =============================================
For external invocation.
See also the packaging and test/verification targets below
-->
<target name="compile-all"
depends="compile-src,compile-tests,
compile-examples,compile-contrib"
description="compiles everything, not from scratch"
/>
<target name="clean-compile"
depends="clean-src,clean-tests,
clean-examples,clean-contrib"
description="cleans intermediate files from compilation"
/>
<target name="compile-all-fs"
depends="clean-compile,compile-all"
description="compiles everything from scratch"
/>
<!-- compile and clean targets ================================================
For compiling and recompiling specific parts of HttpClient code.
These targets do NOT define dependencies between eachother.
Direct invocation of these targets is for those who know what they do!
-->
<target name="compile-src" depends="build-init">
<mkdir dir="${build.client.classes}" />
<javac destdir ="${build.client.classes}"
debug ="${compile.debug}"
deprecation ="${compile.deprecation}"
optimize ="${compile.optimize}"
encoding ="UTF-8"
source ="${compile.source}"
target ="${compile.target}"
>
<src>
<pathelement location="${comp.client.src}"/>
</src>
<classpath>
<path refid="classpath.client.compile"/>
</classpath>
</javac>
</target>
<target name="clean-src">
<delete dir="${build.client.classes}" quiet="true" />
</target>
<target name="compile-tests" depends="build-init">
<mkdir dir="${build.client.tests}" />
<javac destdir ="${build.client.tests}"
debug ="${compile.debug}"
deprecation ="${compile.deprecation}"
optimize ="${compile.optimize}"
encoding ="UTF-8"
source ="${compile.source}"
target ="${compile.target}"
>
<src>
<pathelement path="${comp.client.tests}"/>
</src>
<classpath>
<path refid="classpath.client.compile"/>
<pathelement location="${build.client.classes}"/>
<pathelement location="${junit.jar}"/>
</classpath>
</javac>
</target>
<target name="clean-tests">
<delete dir="${build.client.tests}" quiet="true" />
</target>
<target name="compile-examples" depends="build-init">
<mkdir dir="${build.client.xmpls}" />
<javac destdir ="${build.client.xmpls}"
debug ="${compile.debug}"
deprecation ="${compile.deprecation}"
optimize ="${compile.optimize}"
encoding ="UTF-8"
source ="${compile.source}"
target ="${compile.target}"
>
<src>
<pathelement path="${comp.client.xmpls}"/>
</src>
<classpath>
<path refid="classpath.client.compile"/>
<pathelement location="${build.client.classes}"/>
</classpath>
</javac>
</target>
<target name="clean-examples">
<delete dir="${build.client.xmpls}" quiet="true" />
</target>
<target name="compile-contrib" depends="build-init">
<mkdir dir="${build.client.contr}" />
<javac destdir ="${build.client.contr}"
debug ="${compile.debug}"
deprecation ="${compile.deprecation}"
optimize ="${compile.optimize}"
encoding ="UTF-8"
source ="${compile.source}"
target ="${compile.target}"
>
<src>
<pathelement path="${comp.client.contr}"/>
</src>
<classpath>
<path refid="classpath.client.compile"/>
<pathelement location="${build.client.classes}"/>
</classpath>
</javac>
</target>
<target name="clean-contrib">
<delete dir="${build.client.contr}" quiet="true" />
</target>
<!-- packaging and verification targets =======================================
For building JARs and running tests.
Targets for building JARs define dependencies on compilation targets.
Unlike with Maven, running tests is not a dependency for packaging.
The plain test target defines dependencies on the test classes, but
not on the classes to be tested. It should be possible to run a test
target without affecting the subject of the test. The "from scratch"
test target defines transitive dependencies on the subject classes.
-->
<target name="package-src"
depends="dist-init,compile-src"
description="builds the JAR with HttpClient classes"
>
<jar destfile="${dist.client.home}/${jar.client.src.name}">
<!-- manifest? -->
<!-- timestamp in meta-inf? -->
<fileset dir="${build.client.classes}" includes="**" />
</jar>
</target>
<target name="package-src-fs"
depends="clean-src,package-src"
description="builds the JAR with HttpClient classes, compiling from scratch"
/>
<target name="package-addon"
depends="dist-init,compile-src,
compile-examples,compile-contrib"
description="builds the JAR with HttpClient examples and contributions"
>
<jar destfile="${dist.client.home}/${jar.client.addon.name}">
<!-- manifest? -->
<!-- timestamp in meta-inf? -->
<fileset dir="${build.client.xmpls}" includes="**" />
<fileset dir="${build.client.contr}" includes="**" />
</jar>
</target>
<target name="package-addon-fs"
depends="clean-examples,clean-contrib,package-addon"
description="builds the JAR with HttpClient examples and contributions, compiling them from scratch"
/>
<target name="run-tests"
depends="build-init,compile-tests"
description="runs unit tests on HttpClient classes"
>
<copy todir="${build.client.tests}" filtering="on">
<fileset dir="${comp.client.tests}" excludes="**/*.java" />
</copy>
<!-- don't use Ant optional JUnit tasks here -->
<java classname="junit.textui.TestRunner"
fork="yes" failonerror="yes"
>
<arg value="org.apache.http.client.TestAll"/>
<classpath>
<path refid="classpath.client.compile"/>
<pathelement location="${junit.jar}"/>
<pathelement location="${clover.jar}"/>
<pathelement location="${build.client.classes}"/>
<pathelement location="${build.client.tests}"/>
</classpath>
</java>
</target>
<target name="run-tests-fs"
depends="clean-build,compile-src,run-tests"
/>
<!-- Clover always needs a recompile to instrument the source code.
clean-build enforces the recompilation, clover-init prepares
the Ant environment for Clover instrumentation.
-->
<target name="run-clover"
depends="clean-build,clover-init,compile-src,run-tests"
description="runs Clover on HttpClient, recompiling everything from scratch"
>
<echoproperties prefix="clover"/>
<mkdir dir="${build.client.clover}"/>
<clover-report>
<current outfile="${build.client.clover}/coverage-report">
<format type="html"/>
</current>
</clover-report>
</target>
<target name="javadoc-src"
description="generates JavaDoc for the HttpClient classes"
>
<mkdir dir="${dist.client.api}" />
<javadoc destdir="${dist.client.api}"
encoding="UTF-8"
access="${javadoc.access}"
version="true"
author="true"
windowtitle="${comp.client.title} (Version ${comp.client.version})"
>
<packageset dir="${comp.client.src}">
<include name="org/apache/http/**" />
</packageset>
<group title="API">
<package name="org.apache.http.auth" />
<package name="org.apache.http.conn" />
<package name="org.apache.http.conn.params" />
<package name="org.apache.http.conn.ssl" />
<package name="org.apache.http.cookie" />
<package name="org.apache.http.cookie.params" />
<package name="org.apache.http.client" />
</group>
<group title="Implementation">
<package name="org.apache.http.auth.impl*" />
<package name="org.apache.http.conn.impl*" />
<package name="org.apache.http.cookie.impl*" />
<package name="org.apache.http.client.impl*" />
</group>
<classpath refid="classpath.client.javadoc"/>
<link href="${javadoc.j2sdk.link}"/>
<link href="${dist.core.api}"/>
<doctitle>${comp.client.title}</doctitle>
<bottom>Copyright (c) 2005-2007 - Apache Software Foundation</bottom>
</javadoc>
</target>
<target name="javadoc-addon"
description="generates JavaDoc including examples and contributions"
>
<mkdir dir="${dist.client.api}" />
<javadoc destdir="${dist.client.api}"
encoding="UTF-8"
access="${javadoc.access}"
version="true"
author="true"
windowtitle="${comp.client.title} (Version ${comp.client.version})"
>
<packageset dir="${comp.client.src}">
<include name="org/apache/http/**" />
</packageset>
<packageset dir="${comp.client.xmpls}">
<include name="org/apache/http/**" />
</packageset>
<packageset dir="${comp.client.contr}">
<include name="org/apache/http/**" />
</packageset>
<group title="API">
<package name="org.apache.http.auth" />
<package name="org.apache.http.conn" />
<package name="org.apache.http.conn.params" />
<package name="org.apache.http.conn.ssl" />
<package name="org.apache.http.cookie" />
<package name="org.apache.http.cookie.params" />
<package name="org.apache.http.client" />
</group>
<group title="Implementation">
<package name="org.apache.http.auth.impl*" />
<package name="org.apache.http.conn.impl*" />
<package name="org.apache.http.cookie.impl*" />
<package name="org.apache.http.client.impl*" />
</group>
<group title="Examples">
<package name="org.apache.http.examples*" />
<package name="org.apache.http.client.examples*" />
</group>
<group title="Contributions (unsupported)">
<package name="org.apache.http.contrib*" />
<package name="org.apache.http.client.contrib*" />
</group>
<classpath refid="classpath.client.javadoc"/>
<link href="${javadoc.j2sdk.link}"/>
<link href="${dist.core.api}"/>
<doctitle>${comp.client.title}</doctitle>
<bottom>Copyright (c) 2005-2007 - Apache Software Foundation</bottom>
</javadoc>
</target>
<!-- generic and helper targets =========================================== -->
<target name="build-init">
<mkdir dir="${build.client.home}" />
</target>
<target name="clean-build"
description="cleans all intermediate files, including test reports"
>
<delete dir="${build.client.home}" quiet="true" />
</target>
<target name="dist-init">
<mkdir dir="${dist.client.home}" />
<!-- timestamp? (in build directory!) -->
<!-- manifest? (in build directory!) -->
</target>
<target name="clean-dist"
description="cleans all final build results"
>
<!-- By default, dist.client.docs and dist.client.api are located
below dist.client.home and will be cleaned here. If their
location is redefined to be somewhere else, they will not
be cleaned here. Use the targets dist-docs-clean or
dist-api-clean to achieve that.
-->
<delete dir="${dist.client.home}" quiet="true" />
<!-- delete timestamps and manifests from build.client.home? -->
</target>
<target name="dist-docs-clean">
<delete dir="${dist.client.docs}" quiet="true" />
</target>
<target name="dist-api-clean">
<delete dir="${dist.client.api}" quiet="true" />
</target>
<target name="clover-init">
<taskdef resource="clovertasks" />
<property name="build.client.clover.db"
location="${build.client.clover}/database" />
<mkdir dir="${build.client.clover.db}"/>
<!-- This task prepares the Ant environment for Clover instrumentation.
Everything compiled afterwards will be instrumented if it matches
the fileset(s) defined here.
-->
<clover-setup initString="${build.client.clover.db}/coverage.db" >
<fileset dir="${comp.client.src}" includes="**" />
</clover-setup>
</target>
</project><!-- HttpClient -->