You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by de...@apache.org on 2007/08/13 12:11:24 UTC
svn commit: r565292 - /webservices/axis2/site/maven-help.html
Author: deepal
Date: Mon Aug 13 03:11:22 2007
New Revision: 565292
URL: http://svn.apache.org/viewvc?view=rev&rev=565292
Log:
site updated for 1.3 release
Modified:
webservices/axis2/site/maven-help.html
Modified: webservices/axis2/site/maven-help.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/maven-help.html?view=diff&rev=565292&r1=565291&r2=565292
==============================================================================
--- webservices/axis2/site/maven-help.html (original)
+++ webservices/axis2/site/maven-help.html Mon Aug 13 03:11:22 2007
@@ -1,118 +1,478 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - Quick Guide to Maven for Axis 2.0</title><style type="text/css" media="all">
- @import url("./style/maven-base.css");
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+ <head>
+ <title>Apache Axis2 - </title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../" id="bannerLeft">
+
+ <img src="http://www.apache.org/images/asf_logo_wide.png" alt="" />
+
+ </a>
+ <span id="bannerRight">
+
+ <img src="http://ws.apache.org/axis2/images/axis.jpg" alt="" />
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
- @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 04 May 2007
- | Doc for 1.2</div><div class="xright">
-
- <a href="index.html">Axis2/Java</a>
-
-
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 08/13/2007
+ </div>
+ <div class="xright"> <a href="index.html">Axis2/Java</a>
+ |
+ <a href="http://ws.apache.org/axis2/c">Axis2/C</a>
+ |
+ <a href="../../">Apache WS</a>
+ |
+ <a href="http://www.apache.org">Apache</a>
- <span class="separator">|</span>
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+ <h5>Axis2/Java</h5>
+ <ul>
+
+ <li class="none">
+ <a href="index.html">Home</a>
+ </li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+
+ <li class="none">
+ <a href="download.cgi">Releases</a>
+ </li>
+
+ <li class="none">
+ <a href="modules/index.html">Modules</a>
+ </li>
+
+ <li class="none">
+ <a href="tools/index.html">Tools</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+
-
- <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
+
-
-
- <span class="separator">|</span>
-
-
- <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="1_3/contents.html">Version 1.3</a>
+ <ul>
+
+ <li class="none">
+ <a href="1_3/toc.html">Table of Contents</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/installationguide.html">Installation Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/quickstartguide.html">QuickStart Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/userguide.html">User Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/pojoguide.html">POJO Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/spring.html">Spring Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/webadminguide.html">Web Administrator's Guide</a>
+ </li>
+
+ <li class="none">
+ <a href="1_3/migration.html">Migration Guide (from Axis1)</a>
+ </li>
+ </ul>
+ </li>
+
+ <li class="none">
+ <a href="1_2/contents.html">Version 1.2</a>
+ </li>
+
+ <li class="none">
+ <a href="1_1_1/contents.html">Version 1.1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="1_1/contents.html">Version 1.1</a>
+ </li>
+
+ <li class="none">
+ <a href="1_0/index.html">Version 1.0</a>
+ </li>
+
+ <li class="none">
+ <a href="0_95/index.html">Version 0.95</a>
+ </li>
+
+ <li class="none">
+ <a href="0_94/index.html">Version 0.94</a>
+ </li>
+
+ <li class="none">
+ <a href="0_93/index.html">Version 0.93</a>
+ </li>
+ </ul>
+ <h5>Resources</h5>
+ <ul>
+
+ <li class="none">
+ <a href="faq.html">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="articles.html">Articles</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/ws/FrontPage/Axis2/">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="refLib.html">Reference Library</a>
+ </li>
+
+ <li class="none">
+ <a href="http://ws.apache.org/axis2/1_3/api/index.html">Online Java Docs</a>
+ </li>
+ </ul>
+ <h5>Get Involved</h5>
+ <ul>
+
+ <li class="none">
+ <a href="overview.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="svn.html">Checkout the Source</a>
+ </li>
+
+ <li class="none">
+ <a href="mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="release-process.html">Release Process</a>
+ </li>
+
+ <li class="none">
+ <a href="guidelines.html">Developer Guidelines</a>
+ </li>
+
+ <li class="none">
+ <a href="siteHowTo.html">Build the Site</a>
+ </li>
+ </ul>
+ <h5>Project Information</h5>
+ <ul>
+
+ <li class="none">
+ <a href="team-list.html">Project Team</a>
+ </li>
+
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+
+ <li class="none">
+ <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN">Source Code</a>
+ </li>
+
+ <li class="none">
+ <a href="thanks.html">Acknowledgements</a>
+ </li>
+
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta name="generator" content="HTML Tidy for Windows (vers 14 June 2007), see www.w3.org"></meta>
+ Quick Guide to Maven for Axis 2.0
+ <meta http-equiv="content-type" content="text/html; charset=us-ascii"></meta>
+ <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+ </head>
+
+ <h1 align="center">Quick Guide to Maven for Axis 2.0</h1>
+ <h2 align="left">Introduction</h2>
+ <p>
+ <a href="http://maven.apache.org">Maven 2</a>
+ is used
+ as the build environment for Axis2. This document will provide a quick
+ guide on how to use Maven with our project.
+ </p>
+ <h2 align="left">Commands</h2>
+ <table class="bodyTable">
+ <tbody>
+ <tr class="a">
+ <th>
+ <div align="left">Command</div>
+ </th>
+ <th>
+ <div align="left">Description</div>
+ </th>
+ </tr>
+ <tr class="b">
+ <td>mvn clean</td>
+ <td>Cleans all the content built so far in the target/ folder. This
+ will not delete jars from your local repository.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ <div align="left">mvn install</div>
+ </td>
+ <td>
+ <div align="left">Run a full build.</div>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>
+ <div align="left">mvn test</div>
+ </td>
+ <td>
+ <div align="left">Runs our basic test suite.</div>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ <div align="left">mvn clean test</div>
+ </td>
+ <td>
+ <div align="left">Cleans up, rebuilds everything from scratch, and then runs the basic test
+ suite.
+ </div>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>
+ <div align="left">mvn -Dtest=MyTest install</div>
+ </td>
+ <td>
+ <div align="left">run a single test (cd to the specific module say kernel before running this
+ and don't use the package name of the class, just the class name).
+ </div>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ <div align="left">mvn dependency:resolve</div>
+ </td>
+ <td>
+ <div align="left">print dependencies under any module</div>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>
+ <div align="left">mvn site</div>
+ </td>
+ <td>
+ <div align="left">Generates the website in target/site/</div>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ <div align="left">mvn idea:idea</div>
+ </td>
+ <td>
+ <div align="left">Generates IDEA .ipr, .iml and .iws project
+ files.
+ </div>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>
+ <div align="left">mvn -Dtest=false</div>
+ </td>
+ <td>
+ <div align="left"></div>
+ Builds Axis2 and skips all the tests.
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ <div align="left">mvn -U -Drelease clean install</div>
+ </td>
+ <td>
+ <div align="left"></div>
+ Generate release artifacts.
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ <h4>Notes:</h4>
+ <ul>
+ <li>The "-U" ensures that you fetch the latest snapshots</li>
+ <li>The "-Drelease" runs the pom.xml under modules/distribution. The zip's are created under
+ modules/distribution/target
+ </li>
+ <li>To skip tests use "-Dtest=false"</li>
+ <li>If you run into an exception, switch on printing of full exception using "-e"</li>
+ <li>If you want to see the versbose output, use "-X"</li>
+ </ul>
+ <h3>Ant helper for the m2 build</h3>
+ If you prefer to use Ant, we have a build.xml. Please note that there are 2 maven2 plugins that need to be
+ built first when you update version # for Axis2. the ant build.xml takes care of that automatically. It
+ builds
+ axis2-aar-maven-plugin and axis2-mar-maven-plugin before it runs the main build.
+ <table class="bodyTable">
+ <tbody>
+ <tr class="b">
+ <th>
+ <div align="left">Command</div>
+ </th>
+ <th>
+ <div align="left">Description</div>
+ </th>
+ </tr>
+ <tr class="a">
+ <td>ant clean"</td>
+ <td>cleans up</td>
+ </tr>
+ <tr class="b">
+ <td>ant install"</td>
+ <td>runs the build</td>
+ </tr>
+ <tr class="a">
+ <td>ant deploy"</td>
+ <td>deploys artifacts in apache m2 snapshots repo</td>
+ </tr>
+ <tr class="b">
+ <td>ant -Doffline=true clean"</td>
+ <td>offline clean up</td>
+ </tr>
+ <tr class="a">
+ <td>ant -Doffline=true install"</td>
+ <td>offline build</td>
+ </tr>
+ <tr class="b">
+ <td>ant -Dskip=true install"</td>
+ <td>run the build, but skip the tests</td>
+ </tr>
+ <tr class="a">
+ <td>ant -Dskip=true install"</td>
+ <td>run the build, but skip the tests</td>
+ </tr>
+ <tr class="b">
+ <td>ant -Dskip=true deploy"</td>
+ <td>deploys artifacts, but skip the tests</td>
+ </tr>
+ <tr class="a">
+ <td>ant -Doffline=true -Dskip=true install"</td>
+ <td>run the build in the offline and skips the tests</td>
+ </tr>
+ </tbody>
+ </table>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
- <span class="separator">|</span>
-
-
- <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
- </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="index.html">Home</a></li></ul></div><div id="menuDownloads"><h5>Downloads</h5><ul><li class="none"><a href="download.cgi">Releases</a></li><li class="none"><a href="modules/index.html">Modules</a></li><li class="none"><a href="tools/index.html">Tools</a></li></ul></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="1_2/contents.html">Version 1.2</a><ul><li class="none"><a href="1_2/toc.html">Table of Contents</a></li><li class="none"><a href="1_2/installationguide.html">Installation Guide</a></li><li class="none"><a href="1_2/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="1_2/userguide.html">User Guide</a></li><li class="none"><a href="1_2/pojoguide.html">POJO Guide</a></li><li class="none"><a href="1_2/spring.html">Spring Guide</a></li><li class="n
one"><a href="1_2/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="1_2/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="1_1_1/contents.html">Version 1.1.1</a></li><li class="none"><a href="1_1/contents.html">Version 1.1</a></li><li class="none"><a href="1_0/index.html">Version 1.0</a></li><li class="none"><a href="0_95/index.html">Version 0.95</a></li><li class="none"><a href="0_94/index.html">Version 0.94</a></li><li class="none"><a href="0_93/index.html">Version 0.93</a></li></ul></div><div id="menuResources"><h5>Resources</h5><ul><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="articles.html">Articles</a></li><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2/" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="refLib.html">Reference Library</a></li><li class="none"><a href="http://ws.apache.org/axis2/1_2/api/index.html" class="ex
ternalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><h5>Get Involved</h5><ul><li class="none"><a href="overview.html">Overview</a></li><li class="none"><a href="svn.html">Checkout the Source</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="guidelines.html">Developer Guidelines</a></li><li class="none"><a href="siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><h5>Project Information</h5><ul><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="thanks.html">Acknowledgements</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="E
xternal Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Quick_Guide_to_Maven_for_Axis_2_0"></a><h2>Quick Guide to Maven for Axis 2.0</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p align="left"><a href="http://maven.apache.org" class="externalLink" title="External Link">Maven</a> is used as the
-build tool of Axis 2.0. This document will provide a quick guide on how to
-use Maven with your developments.</p></div><div class="subsection"><a name="Commands"></a><h3>Commands</h3><table class="bodyTable"><tbody>
- <tr class="a"><th scope="col">
- <div align="left">
- Command</div>
- </th><th scope="col">
- <div align="left">
- Description</div>
- </th></tr>
- <tr class="b"><td>
- <div align="left">
- maven</div>
- </td><td>
- <div align="left">
- Downloads relevant jars if not available, and compiles and runs the
- tests in the system.</div>
- </td></tr>
- <tr class="a"><td>maven clean</td><td>Cleans all the content built so far in the target folder. This will
- not clean the jar repository.</td></tr>
- <tr class="b"><td>
- <div align="left">
- maven test</div>
- </td><td>
- <div align="left">
- Runs only the tests. Performs automatic compilation of the changed
- sources as well. This will not run SOAP interop tests</div>
- </td></tr>
- <tr class="a"><td>
- <div align="left">
- maven clean all-tests</div>
- </td><td>
- <div align="left">
- Cleans up and runs all offline and online tests</div>
- </td></tr>
- <tr class="b"><td>
- <div align="left">
- maven itest</div>
- </td><td>
- <div align="left">
- To run the online-mode tests for say the modules/integration, run
- "maven itest" from modules/integration</div>
- </td></tr>
- <tr class="a"><td>
- <div align="left">
- maven test itest</div>
- </td><td>
- <div align="left">
- To run all the tests for say the modules/integration, run "maven test
- itest" from modules/integration</div>
- </td></tr>
- <tr class="b"><td>
- <div align="left">
- maven -g</div>
- </td><td>
- <div align="left">
- Lists down all the commands available with Maven.</div>
- </td></tr>
- <tr class="a"><td>
- <div align="left">
- maven multiproject</div>
- </td><td>
- <div align="left">
- Generates the site.</div>
- </td></tr>
- <tr class="b"><td>
- <div align="left">
- maven idea:multiproject</div>
- </td><td>
- <div align="left">
- Generates IDEA .ipr, .iml and .iws project files.</div>
- </td></tr>
- <tr class="a"><td>
- <div align="left">
- maven -Dmaven.test.skip=true</div>
- </td><td>
- <div align="left">
- </div>
- Builds Axis2 and skips all the tests.</td></tr>
- </tbody></table><br></br></div><div class="subsection"><a name="Maven_FAQ"></a><h3>Maven FAQ</h3><p><i>1. I have problems with Maven 1.1</i></p><p style="text-indent: 10pt">It seems that Maven 1.1 doesn't come bundled
-with the required itest plug-in and artifact plug-in. Run the following to
-get it updated.<br></br>
-</p><ol>
- <li>maven plugin:download -DgroupId=maven-itest-plugin
- -DartifactId=maven-itest-plugin -Dversion=1.0
- -Dmaven.repo.remote=http://www.openejb.org/maven,http://www.ibiblio.org/maven</li>
- <li>maven plugin:Download -DgroupId=maven
- -DartifactId=maven-artifact-plugin -Dversion=1.6</li>
-</ol><p align="left"> </p><p align="left"> </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org