axis/java/ant/ant.html - axis-site - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <link rel="stylesheet" href="../../skin/tigris.css" type="text/css">
 <link rel="stylesheet" href="../../skin/mysite.css" type="text/css">
 <link rel="stylesheet" href="../../skin/site.css" type="text/css">
 <link media="print" rel="stylesheet" href="../../skin/print.css" type="text/css">
 <title>WebServices - Axis</title>
 </head>
 <body bgcolor="white" class="composite">
 <div id="banner">
 <table width="100%" cellpadding="0" cellspacing="0" summary="banner" border="0">
 <tbody>
 <tr>
 <td align="left">
 <div class="groupLogo">
 <a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../../images/project-logo.png"></a>
 </div>
 </td><td nowrap="1" width="100%" align="left">
 <div class="projectTitleImg">
 <br>
 <a href=""><img border="0" class="logoImage" alt="Web Services - Axis" src="../../images/wsaxis.png"></a>
 </div>
 </td><td align="right">
 <div class="projectLogo">
 <a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../../images/axis3.jpg"></a>
 </div>
 </td>
 </tr>
 </tbody>
 </table>
 </div>
 <table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
 <tbody>
 <tr class="status">
 <td width="100%">&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">Web Services</a> | <a href="http://ws.apache.org/axis/">Axis</a></td><td nowrap="1" align="right">
 <form method="get" action="http://www.google.com/search" target="_blank">Search <input type="hidden" name="sitesearch" value="ws.apache.org"><input type="text" id="query" name="q" size="10"><img class="spacer" src="skin/images/spacer.gif" alt="" width="5" height="1"><input type="submit" value="Go" name="Search">
 </form>
 </td>
 </tr>
 </tbody>
 </table>
 <table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
 <tbody>
 <tr valign="top">
 <td id="leftcol">
 <div id="navcolumn">
 <div class="menuBar">
 <div class="menu">
 <span class="menuLabel">Axis</span>

 <div class="menuItem">
 <a href="../../index.html">Introduction</a>
 </div>

 <div class="menuItem">
 <a href="../../news.html">News</a>
 </div>


 <div class="menuItem">
 <a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
 </div>

 <div class="menu">
 <span class="menuLabel">Get Involved</span>

 <div class="menuItem">
 <a href="../../overview.html">Overview</a>
 </div>

 <div class="menuItem">
 <a href="../../cvs.html">SVN Repository</a>
 </div>

 <div class="menuItem">
 <a href="../../mail.html">Mailing Lists</a>
 </div>

 <div class="menuItem">
 <a href="../../ref.html">Reference Library</a>
 </div>

 <div class="menuItem">
 <a href="../../bugs.html">Bugs</a>
 </div>

 <div class="menuItem">
 <a href="../../howtobuild.html">HowToBuildSite</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Axis (Java)</span>

 <div class="menuItem">
 <a href="../../java/index.html">Documentation</a>
 </div>


 <div class="menuItem">
 <a href="../../java/releases.html">Releases</a>
 </div>

 <div class="menuItem">
 <a href="../../java/install.html">Installation</a>
 </div>

 <div class="menuItem">
 <a href="../../java/user-guide.html">User's Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/developers-guide.html">Developer's Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/integration-guide.html">Integration Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/architecture-guide.html">Architecture Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/reference.html">Reference Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/reading.html">Reading Guide</a>
 </div>

 <div class="menuItem">
 <a href="../../java/requirements.html">Requirements</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Axis C++</span>

 <div class="menuItem">
 <a href="http://ws.apache.org/axis/cpp/index.html">Home</a>
 </div>

 <div class="menuItem">
 <a href="http://ws.apache.org/axis/cpp/documentation.html">Documentation</a>
 </div>

 <div class="menuItem">
 <a href="http://ws.apache.org/axis/cpp/download.html">Download</a>
 </div>

 <div class="menuItem">
 <a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>
 </div>

 <div class="menuItem">
 <a href="http://ws.apache.org/axis/cpp/who.html">Who we are</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Downloads</span>

 <div class="menuItem">
 <a href="../../interim.html">Interim Drops</a>
 </div>

 <div class="menuItem">
 <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/">Source Code</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Translation</span>

 <div class="menuItem">
 <a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Related Projects</span>

 <div class="menuItem">
 <a href="http://ws.apache.org/wsif/">WSIF</a>
 </div>

 <div class="menuItem">
 <a href="http://ws.apache.org/juddi/">jUDDI</a>
 </div>

 <div class="menuItem">
 <a href="http://wsdl4j.sourceforge.net">WSDL4J</a>
 </div>

 <div class="menuItem">
 <a href="http://www.uddi4j.org/">UDDI4J</a>
 </div>

 </div>

 <div class="menu">
 <span class="menuLabel">Misc</span>

 <div class="menuItem">
 <a href="../../who.html">Who we are</a>
 </div>

 <div class="menuItem">
 <a href="../../contact.html">Contact</a>
 </div>

 <div class="menuItem">
 <a href="../../legal.html">Legal</a>
 </div>

 <div class="menuItem">
 <a href="../../docs.html">Notes/Docs</a>
 </div>

 </div>


 </div>
 </div>
 </div>
 </td><td>
 <div id="bodycol">
 <div class="app">
 <div class="h3">


 <a name="AxisAntTasks"></a>

 <div class="h3">
 <h3>Axis Ant Tasks</h3>
 </div>


 <p>Axis comes with Ant tasks to automate aspects of the build process inside ant. To use these tasks, you need</p>


 <ol>

 <li>
 <a href="http://jakarta.apache.org/ant">Apache Ant 1.5.1 or later</a>
 </li>

 <li>The library <span class="codefrag">axis-ant.jar</span> which contains the tasks</li>

 <li>All the main Axis libraries</li>

 </ol>


 <div class="h4">
 <h4>Declaring the Tasks</h4>
 </div>


 <p>To declare the tasks, set up a classpath to include the axis task JAR and all the dependent libraries. Including everything in the axis lib directory should suffice</p>


 <pre class="code">&lt;path id="axis.classpath"&gt;
   &lt;fileset dir="${axis.home}/build/lib"&gt;
     &lt;include name="**/*.jar" /&gt;
   &lt;/fileset&gt;
 &lt;/path&gt;</pre>


 <p>Then use the <span class="codefrag">&lt;taskdef&gt;</span> declaration to declare all the tasks listed in a properties file inside the <span class="codefrag">axis-ant.jar</span> file:</p>

 <pre class="code">&lt;taskdef resource="axis-tasks.properties"
   classpathref="axis.classpath" /&gt;</pre>


 <div class="h4">
 <h4>Creating Java files from WSDL</h4>
 </div>


 <p>This uses the <a href="axis-wsdl2java.html">&lt;axis-wsdl2java&gt;</a> task.</p>

 <pre class="code">&lt;axis-wsdl2java
   output="${generated.dir}"
   testcase="true"
   verbose="true"
   url="${local.wsdl}" &gt;
     &lt;mapping
       namespace="http://axis.apache.org/ns/interop"
       package="interop" /&gt;
   &lt;/axis-wsdl2java&gt;</pre>


 <p>The mapping elements are used to list the mappings from XML namespaces to Java packages; you can include as many as you need.</p>


 <div class="h4">
 <h4>Creating WSDL files from Java</h4>
 </div>


 <p>This uses the <a href="axis-java2wsdl.html">&lt;axis-java2wsdl&gt;</a> task.</p>


 <div class="h4">
 <h4>Talking to the admin service</h4>
 </div>


 <p>This can be done with the <a href="axis-admin.html">&lt;axis-admin&gt;</a> task.</p>

 <pre class="code">&lt;axis-admin
     port="${target.port}"
     hostname="${target.server}"
     failonerror="true"
     servletpath="${target.appname}/services/AdminService"
     debug="true"
     xmlfile="${endpoint-stub.wsdd}"
     /&gt;</pre>


 <p>Here the target.* properties are pulled from a properties file for the system being deployed to, so a single build file can deploy to different systems with ease.</p>


 <div class="h4">
 <h4>Foreach Task</h4>
 </div>


 <p>
 <a href="foreach.html">&lt;axis-admin&gt;</a>
 </p>


 <div class="h4">
 <h4>Runaxisfunctionaltests Task</h4>
 </div>


 <p>
 <a href="runaxisfunctionaltests.html">&lt;axis-admin&gt;</a>
 </p>


 <div id="pdf" align="right">
 <a href="ant.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
           PDF</a>
 </div>
 </div>
 </div>
 </div>
 </td>
 </tr>
 </tbody>
 </table>
 <div id="footer">
 <table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
 <tbody>
 <tr>
 <td colspan="2">
 <div align="center">
 <div class="copyright">
               Copyright &copy; 2000-2005&nbsp;The Apache Software Foundation. All rights reserved.
             </div>
 </div>
 </td>
 </tr>
 <tr>
 <td align="left"></td><td align="right">
 <div align="right">
 <div class="credit"></div>
 </div>
 </td>
 </tr>
 </tbody>
 </table>
 </div>
 </body>
 </html>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<head>
	<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<link rel="stylesheet" href="../../skin/tigris.css" type="text/css">
	<link rel="stylesheet" href="../../skin/mysite.css" type="text/css">
	<link rel="stylesheet" href="../../skin/site.css" type="text/css">
	<link media="print" rel="stylesheet" href="../../skin/print.css" type="text/css">
	<title>WebServices - Axis</title>
	</head>
	<body bgcolor="white" class="composite">
	<div id="banner">
	<table width="100%" cellpadding="0" cellspacing="0" summary="banner" border="0">
	<tbody>
	<tr>
	<td align="left">
	<div class="groupLogo">
	<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../../images/project-logo.png"></a>
	</div>
	</td><td nowrap="1" width="100%" align="left">
	<div class="projectTitleImg">
	<br>
	<a href=""><img border="0" class="logoImage" alt="Web Services - Axis" src="../../images/wsaxis.png"></a>
	</div>
	</td><td align="right">
	<div class="projectLogo">
	<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../../images/axis3.jpg"></a>
	</div>
	</td>
	</tr>
	</tbody>
	</table>
	</div>
	<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
	<tbody>
	<tr class="status">
	<td width="100%">    <a href="http://www.apache.org/">Apache</a> \| <a href="http://ws.apache.org/">Web Services</a> \| <a href="http://ws.apache.org/axis/">Axis</a></td><td nowrap="1" align="right">
	<form method="get" action="http://www.google.com/search" target="_blank">Search <input type="hidden" name="sitesearch" value="ws.apache.org"><input type="text" id="query" name="q" size="10"><img class="spacer" src="skin/images/spacer.gif" alt="" width="5" height="1"><input type="submit" value="Go" name="Search">
	</form>
	</td>
	</tr>
	</tbody>
	</table>
	<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
	<tbody>
	<tr valign="top">
	<td id="leftcol">
	<div id="navcolumn">
	<div class="menuBar">
	<div class="menu">
	<span class="menuLabel">Axis</span>

	<div class="menuItem">
	<a href="../../index.html">Introduction</a>
	</div>

	<div class="menuItem">
	<a href="../../news.html">News</a>
	</div>


	<div class="menuItem">
	<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
	</div>

	<div class="menu">
	<span class="menuLabel">Get Involved</span>

	<div class="menuItem">
	<a href="../../overview.html">Overview</a>
	</div>

	<div class="menuItem">
	<a href="../../cvs.html">SVN Repository</a>
	</div>

	<div class="menuItem">
	<a href="../../mail.html">Mailing Lists</a>
	</div>

	<div class="menuItem">
	<a href="../../ref.html">Reference Library</a>
	</div>

	<div class="menuItem">
	<a href="../../bugs.html">Bugs</a>
	</div>

	<div class="menuItem">
	<a href="../../howtobuild.html">HowToBuildSite</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Axis (Java)</span>

	<div class="menuItem">
	<a href="../../java/index.html">Documentation</a>
	</div>


	<div class="menuItem">
	<a href="../../java/releases.html">Releases</a>
	</div>

	<div class="menuItem">
	<a href="../../java/install.html">Installation</a>
	</div>

	<div class="menuItem">
	<a href="../../java/user-guide.html">User's Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/developers-guide.html">Developer's Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/integration-guide.html">Integration Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/architecture-guide.html">Architecture Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/reference.html">Reference Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/reading.html">Reading Guide</a>
	</div>

	<div class="menuItem">
	<a href="../../java/requirements.html">Requirements</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Axis C++</span>

	<div class="menuItem">
	<a href="http://ws.apache.org/axis/cpp/index.html">Home</a>
	</div>

	<div class="menuItem">
	<a href="http://ws.apache.org/axis/cpp/documentation.html">Documentation</a>
	</div>

	<div class="menuItem">
	<a href="http://ws.apache.org/axis/cpp/download.html">Download</a>
	</div>

	<div class="menuItem">
	<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>
	</div>

	<div class="menuItem">
	<a href="http://ws.apache.org/axis/cpp/who.html">Who we are</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Downloads</span>

	<div class="menuItem">
	<a href="../../interim.html">Interim Drops</a>
	</div>

	<div class="menuItem">
	<a href="http://svn.apache.org/viewcvs.cgi/webservices/axis/trunk/">Source Code</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Translation</span>

	<div class="menuItem">
	<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Related Projects</span>

	<div class="menuItem">
	<a href="http://ws.apache.org/wsif/">WSIF</a>
	</div>

	<div class="menuItem">
	<a href="http://ws.apache.org/juddi/">jUDDI</a>
	</div>

	<div class="menuItem">
	<a href="http://wsdl4j.sourceforge.net">WSDL4J</a>
	</div>

	<div class="menuItem">
	<a href="http://www.uddi4j.org/">UDDI4J</a>
	</div>

	</div>

	<div class="menu">
	<span class="menuLabel">Misc</span>

	<div class="menuItem">
	<a href="../../who.html">Who we are</a>
	</div>

	<div class="menuItem">
	<a href="../../contact.html">Contact</a>
	</div>

	<div class="menuItem">
	<a href="../../legal.html">Legal</a>
	</div>

	<div class="menuItem">
	<a href="../../docs.html">Notes/Docs</a>
	</div>

	</div>


	</div>
	</div>
	</div>
	</td><td>
	<div id="bodycol">
	<div class="app">
	<div class="h3">




	<a name="AxisAntTasks"></a>

	<div class="h3">
	<h3>Axis Ant Tasks</h3>
	</div>



	<p>Axis comes with Ant tasks to automate aspects of the build process inside ant. To use these tasks, you need</p>


	<ol>

	<li>
	<a href="http://jakarta.apache.org/ant">Apache Ant 1.5.1 or later</a>
	</li>

	<li>The library <span class="codefrag">axis-ant.jar</span> which contains the tasks</li>

	<li>All the main Axis libraries</li>

	</ol>


	<div class="h4">
	<h4>Declaring the Tasks</h4>
	</div>



	<p>To declare the tasks, set up a classpath to include the axis task JAR and all the dependent libraries. Including everything in the axis lib directory should suffice</p>


	<pre class="code"><path id="axis.classpath">
	<fileset dir="${axis.home}/build/lib">
	<include name="*/.jar" />
	</fileset>
	</path></pre>


	<p>Then use the <span class="codefrag"><taskdef></span> declaration to declare all the tasks listed in a properties file inside the <span class="codefrag">axis-ant.jar</span> file:</p>

	<pre class="code"><taskdef resource="axis-tasks.properties"
	classpathref="axis.classpath" /></pre>




	<div class="h4">
	<h4>Creating Java files from WSDL</h4>
	</div>



	<p>This uses the <a href="axis-wsdl2java.html"><axis-wsdl2java></a> task.</p>

	<pre class="code"><axis-wsdl2java
	output="${generated.dir}"
	testcase="true"
	verbose="true"
	url="${local.wsdl}" >
	<mapping
	namespace="http://axis.apache.org/ns/interop"
	package="interop" />
	</axis-wsdl2java></pre>


	<p>The mapping elements are used to list the mappings from XML namespaces to Java packages; you can include as many as you need.</p>




	<div class="h4">
	<h4>Creating WSDL files from Java</h4>
	</div>



	<p>This uses the <a href="axis-java2wsdl.html"><axis-java2wsdl></a> task.</p>




	<div class="h4">
	<h4>Talking to the admin service</h4>
	</div>



	<p>This can be done with the <a href="axis-admin.html"><axis-admin></a> task.</p>

	<pre class="code"><axis-admin
	port="${target.port}"
	hostname="${target.server}"
	failonerror="true"
	servletpath="${target.appname}/services/AdminService"
	debug="true"
	xmlfile="${endpoint-stub.wsdd}"
	/></pre>


	<p>Here the target.* properties are pulled from a properties file for the system being deployed to, so a single build file can deploy to different systems with ease.</p>




	<div class="h4">
	<h4>Foreach Task</h4>
	</div>



	<p>
	<a href="foreach.html"><axis-admin></a>
	</p>




	<div class="h4">
	<h4>Runaxisfunctionaltests Task</h4>
	</div>



	<p>
	<a href="runaxisfunctionaltests.html"><axis-admin></a>
	</p>







	<div id="pdf" align="right">
	<a href="ant.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
	PDF</a>
	</div>
	</div>
	</div>
	</div>
	</td>
	</tr>
	</tbody>
	</table>
	<div id="footer">
	<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
	<tbody>
	<tr>
	<td colspan="2">
	<div align="center">
	<div class="copyright">
	Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
	</div>
	</div>
	</td>
	</tr>
	<tr>
	<td align="left"></td><td align="right">
	<div align="right">
	<div class="credit"></div>
	</div>
	</td>
	</tr>
	</tbody>
	</table>
	</div>
	</body>
	</html>