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:16:21 UTC
svn commit: r565299 [2/3] - in /webservices/axis2/site/tools: ./ 1_3/
1_3/eclipse/ 1_3/idea/ 1_3/maven-plugins/
Added: webservices/axis2/site/tools/1_3/idea/Idea_plug-in_userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_3/idea/Idea_plug-in_userguide.html?view=auto&rev=565299
==============================================================================
--- webservices/axis2/site/tools/1_3/idea/Idea_plug-in_userguide.html (added)
+++ webservices/axis2/site/tools/1_3/idea/Idea_plug-in_userguide.html Mon Aug 13 03:16:20 2007
@@ -0,0 +1,620 @@
+<!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">
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+ </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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+<meta http-equiv="content-type" content="text/html; charset=us-ascii"></meta>
+<meta content="text/html; charset=iso-8859-1"></meta>
+Axis2 Plug-in Guide for IntelliJ IDEA
+<meta name="generator" content="Bluefish 1.0.6"></meta>
+<link href="../../../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1>Axis2 Plug-in Guide for IntelliJ IDEA</h1>
+<p>This document explains the installation and usage of Axis2
+plug-in for IntelliJ IDEA.</p>
+<p><a href="http://ws.apache.org/axis2/tools/index.html">[Download
+Plug-in]</a></p>
+<h2>Content</h2>
+<ul>
+<li><a href="#intro">Introduction</a></li>
+<li><a href="#installation">Installation</a></li>
+<li><a href="#WSDL2Java_Code_Generation">WSDL2Java Code
+Generation</a></li>
+<li><a href="#Create_Service_Archive">Create a Service Archive</a>
+<ul>
+<li><a href="#sub12">Sub Wizard 1 & Sub Wizard 2</a></li>
+<li><a href="#sub3">Sub Wizard 3</a></li>
+</ul>
+</li>
+</ul>
+<a name="intro"></a>
+<h2>Introduction</h2>
+The Axis2 plug-in for IntelliJ IDEA helps users to create
+service archives which can be deployed in Axis2, and generate java
+classes files from WSDL files. The following section describes the
+installation procedure followed by the usage of the plug-in.
+<b>Note:</b> This plug-in is made up with <a href="http://apidoc.org/docset/16">IDEA Open API</a> which will be
+compatible with idea version since build 4121. The plugin also be
+compatible with all the builds after build number 4121 and also the
+java version should be 1.4 or higher. The provided screen shots may
+slightly differ with what the user would actually see but the
+functionality has not been changed.
+<a name="installation"></a>
+<h2>Installation</h2>
+First <a href="http://ws.apache.org/axis2/tools/index.html">download</a> the
+plug-in which is a zipped file, and extract it into plugins
+directory which is located in the directory where IDEA is
+installed. If a previous version of the plug-in resides in this
+directory you will have to delete it prior to extracting the new
+zip file. If you have extracted the file correctly you would see a
+directory called axis2-idea-plugin.
+Next step is to restart IDEA so that the changes can take place.
+If the plug-in has been installed correctly, you will see following
+icons in IDEA when it is restarted.
+<img alt="Figure 1" src="images/idea-icons.jpg"></img>
+Also if you right-click on the IDEA editor you would see a link
+to the same plug-in.
+<p><img alt="Figure2" src="images/idea-popup.jpg"></img></p>
+<p>When you click on either one of them, a window (Page 1) will
+appear asking you to select one of the following two options.</p>
+<ol type="1">
+<li><a href="#Create_Service_Archive">Create a service
+archive</a></li>
+<li><a href="#WSDL2Java_Code_Generation">WSDL2Java code
+generation</a></li>
+</ol>
+<strong>Page 1:</strong>
+<img alt="Figure3" src="images/fig1.jpg"></img>
+<p>If you want to create a service archive obviously you must
+select "Create a service archive" option. Like wise, if u want to
+generate java class file from a WSDL file you must select the radio
+button option "WSDL2Java code generation".</p>
+<h2><a name="WSDL2Java_Code_Generation">WSDL2Java Code Generation</a></h2>
+<p>Select "WSDL2Java code generation" and click on the button "OK"
+to generate code from a WSDL file. Then the following window will
+appear.</p>
+<p><strong>WSDL2Java Page 2:</strong></p>
+<p><img alt="Figure4" src="images/fig2.jpg"></img></p>
+<p>Once the WSDL file is selected you will be able to move onto the
+next page. The "Browse" button can be used to easily browse for a
+file rather than having to type the whole path.</p>
+<p>Once the WSDL file is selected, click on the "Next" button which
+will take you to the page below.</p>
+<p><strong>WSDL2Java Page 3:</strong></p>
+<p>This page gives the user the option of selecting default or
+custom code generation options. There are three default code
+generation options in all. The first enables the user to generate
+both client and server code under default configurations while the
+second generates just the client side under default configurations.
+The third option generates server side code under default
+configurations.</p>
+<p><strong>Note:</strong></p>
+<ul>
+<li>When client side code is generated under default configurations
+it generates the stub, compiles it, packages it as a jar (the name
+of the jar will be <service name >-jar) places it in a lib
+folder (If there is no lib folder, it is created) under the IDEA
+project that is opened. This jar that's generated will also be
+added as a project library to the current active IDEA project.</li>
+<li>When server code is generated under default configurations it
+generates the server side code and also generates a default
+service.xml. The user will then be taken to page 5.</li>
+<li>When both server and client side is generated under default
+configurations the client stub is added are a jar to the current
+IDEA project and the user is taken to page 5.</li>
+</ul>
+<img alt="Figure5" src="images/fig19.jpg"></img>
+<strong>WSDL2Java Page 4:</strong>
+<strong>Codegen options</strong> are to be selected here. By far
+this is the most important page in this wizard, which determines
+the characteristics of the code being generated.
+<p><img alt="Figure5" src="images/fig18.jpg"></img></p>
+<p><strong>Here's some information on the options for
+selection:</strong></p>
+<ul>
+<li>Output language can be Java, C#. But we have not fully tested
+C# codegeneration, therefore, it is better to select Java as output
+language.</li>
+<li>If the WSDL comprises of several services, the user can select
+the service for which the code should be generated for.</li>
+<li>If the WSDL comprises of several ports for a particullar
+service, the user can select the port which the code should be
+generated for.</li>
+<li>The default data binding type is adb (Axis2 Data Binding).
+Although the tool is capable of providing XML beans, due to class
+loading issues in XML beans, current implementation only generate
+code with OM and ADB.</li>
+<li>As for the package name of the generated code, you can set the
+name as you wish.</li>
+<li>Users can select the one out of the three options- "Generate
+Client Side", "Generate Server Side" and "Generate All". The user
+will be able to select further options based on his options
+selected here. These sub options are explained below.</li>
+<li>
+<ul>
+<li>If user selects "Generate Client Side", he can further select
+the service invocation style. Since Axis2 supports both synchronous
+and asynchronous client programming model, the tool has provided a
+way to selecting the invocation style.</li>
+<li>If user selects "Generate Server Side", he can also generate a
+default service XML file. If the user selects "Generate an
+interface for skeleton" option then it only generates an interface
+for the server side. If so the user has to implement this
+interface. If this option is not selected, the skeleton class is
+generated, which the user can fill in later on.</li>
+<li>If user selects "Generate All" option, then all the classes
+will be generated in the referenced schemas by the WSDL
+irrespective of elements referred by the WSDL, along with the
+client side code.</li>
+</ul>
+</li>
+<li>The dafault behaviour of the code generator is to map
+namespaces to package names logically, but if the user wishes to
+change the package names of the generated classes, he can do so by
+changing the values in the Namespace to Packagename mapping
+table.</li>
+</ul>
+With these enhanced options novices need not worry about the
+options that can be set as the default options cover the most
+common cases. Advanced users will find it very easy to turn the
+knobs using the custom generation option.
+<strong>WSDL2Java Page 5:</strong>
+<img alt="Figure6" src="images/fig3.jpg"></img>
+Here uses have the option of adding the generated code directly
+to their working IDEA project or choose a custom location. If the
+user decides to add it to the current IDEA project he/she will have
+to choose the module and the source directory that the code should
+be generated to.
+Alternatively the user can browse and select the output
+location/path (the location at which the code is to be generated)
+using the "Browse" button. Because of the "Browse" button you do
+not need to type in the output file path.
+<img alt="Fig4" src="images/fig4.jpg"></img>
+Once an output location is selected you can click on "Finish"
+button which will generate the java class file. If code generation
+is successful then a message box will appear acknowledging this
+fact a shown above.
+<a name="Create_Service_Archive"></a>
+<h2>Create a Service Archive</h2>
+Select the "Create a service archive" radio button on Page 1 of
+Axis2 IDEA plug-in wizard.
+<strong>Page 1:</strong>
+<img alt="Fig5" src="images/fig1.jpg"></img>
+<p><strong>Service Archive Page 2:</strong></p>
+<p>The page below will appear asking the user to select the archive
+type</p>
+<p><img alt="fig6" src="images/fig6.jpg"></img></p>
+<p>In Axis2, the user can deploy a single service or a service
+group. Therefore, you can select either "Single service archive" or
+"Service group archive" for the archive type you want to
+create.</p>
+<p>If you already have a services.xml you can skip some of the
+steps in the wizard by selecting the radio button option "I already
+have services.xml" and clicking on "Next" button. If you do not
+have the services.xml, select the radio button option "Generate
+services.xml" and click on the "Next" button, in which case the
+tool will create the services.xml for you.</p>
+<p>Depending on the options you selected on this page there can be
+three sub wizards:</p>
+<ol type="1">
+<li><a href="#sub12">Sub wizard 1</a> (Generate single service and
+its services.xml)</li>
+<li><a href="#sub12">Sub wizard 2</a> (Generate service group and
+its services.xml)</li>
+<li><a href="#sub3">Sub wizard 3</a> (Generate service/service
+group using already existing services.xml)</li>
+</ol>
+1 & 2 follow the same set of steps except for some looping
+mechanism in the middle of the wizard.
+<a name="sub12"></a>
+<h3>Sub Wizard 1 and Sub Wizard 2</h3>
+<strong>Service Archive (sub wizards 1 & 2) Page
+3:</strong>
+From this page you have to select the location of the service
+classes directory (the location of the compiled classes). You do
+not need to type path, simply browse and select.
+<p><img alt="fig7" src="images/fig7.jpg"></img></p>
+<p>When you click on "Next" button, wizard will move to the page
+below</p>
+<p><strong>Service Archive (sub wizards 1 & 2) Page
+4:</strong></p>
+<p>Here you select service specific external libraries (third party
+libraries) and service WSDL files. If you want to add multiple WSDL
+files to a single service type you can do that as well.</p>
+<p><img alt="fig8" src="images/fig8.jpg"></img></p>
+<p>To add libraries first click on the browse button to browse for
+library files and then click on the "Add" button. Once added the
+selected file will appear in the list box.</p>
+<p>To add WSDLs, first click on the browse button to browse for
+WSDL file and then click the "Add" button to add the file to the
+list.</p>
+<p>After adding external libraries and service WSDL files click on
+the "Next" button to move to next page.</p>
+<p><strong>Service Archive (sub wizards 1 & 2) Page
+5:</strong></p>
+<p>This page allows you to select service implementation class. In
+the case of service group, same page will be looped to select
+multiple service implementation classes. This process is explained
+in detail below.</p>
+<p>Select a service implementation class by browsing and clicking
+on the "Load" button to load all the public methods in that class,
+after which you can select the methods that you want to publish
+using the check boxes.</p>
+<p><strong>Note :</strong> If you do not select the correct class
+path from the "Class location selection" window, the public methods
+which are available in the selected class file will not be
+loaded.</p>
+<p><img alt="fig10" src="images/fig10.jpg"></img></p>
+<p>In "Service Name" text box you can type the name of the service
+you want, but remember that the service name should be unique
+throughout the system.</p>
+<p>When you have completed this particular service click on the
+button "Next". In the case of a service group when you click on the
+"Next" button for that particular service the following dialog box
+will appear with option to add more service(s) to a service
+group.</p>
+<p><img alt="fig11" src="images/fig11.jpg"></img></p>
+<p>If you click on "Yes", you have to follow the same procedure to
+add some other service(s) to service group.</p>
+<p>If you click on "No", the button "Next" will be enabled and you
+can go to next page.</p>
+<p><a name="Note"><strong><em>Note: From this point
+onwards the steps are similar to all the sub
+wizards.</em></strong></a></p>
+<p><strong>Service Archive (sub wizards 1 & 2) Page
+6:</strong></p>
+<p>This page displays the services.xml file, either the one given
+by you (in the case of I already have services.xml)
+or the one generated by the system (in the case of "generate
+services.xml")</p>
+<p><img alt="fig12" src="images/fig12.jpg"></img></p>
+<p>This page is editable and provide a way to add parameters and
+module references to any level.</p>
+<p><strong>Note :</strong> When you click on either the
+"+Parameter" or the "+ModuleRef" buttons remember that
+corresponding text will be added to the current mouse position.
+Therefore, click on the location you want to add the parameter or
+module references and then click relevant button (+Parameter or
++ModuleRef).</p>
+<p><strong>+Parameter button:</strong></p>
+<p>If you click on the "+Parameter" button a window will appear
+asking to give parameter name and parameter value.</p>
+<p><img alt="fig13" src="images/fig13.jpg"></img></p>
+<p>Note that you can also manually add parameters (without clicking
+on the "+Parameter" button ) to any where in the document as you
+wish.</p>
+<p><strong>+ModuleRef button:</strong></p>
+<p>Likewise, adding module references can be done by clicking on
+the "+ModuleRef" button in the page. You have to type the name of
+the module to be engaged as shown in the following figure.</p>
+<p><img alt="fig14" src="images/fig14.jpg"></img></p>
+<p>When you complete this page press the "Next" button to go to
+final page.</p>
+<p><strong>Service Archive (sub wizards 1 & 2) Page
+7:</strong></p>
+<p><img alt="fig15" src="images/fig15.jpg"></img></p>
+<p>Next step is to select output file location, the location in
+which archive file should be created.</p>
+<p>In the "Archive Name" text box, type the name of the archive
+file you want to place. This name will finally become the service
+group name.</p>
+<p><strong>Note :</strong> Do not include file extension when you
+type archive name. System will generate that for you.</p>
+<p>When you are done, click the "Finish" button. If everything has
+been done successfully you will see following message.</p>
+<p><img alt="fig16" src="images/fig16.jpg"></img></p>
+<p><strong><em>Note: Pages 6 & 7 of sub wizards 1 & 2 are
+common to sub wizard 3 from its page 3 onwards.</em></strong></p>
+<a name="sub3"></a>
+<h3>Sub Wizard 3</h3>
+<p>In the case where services.xml is already available, the steps
+are as follows:</p>
+<p><strong>Service Archive (sub wizard 3) Page 3:</strong></p>
+<p><img alt="fig17" src="images/fig17.jpg"></img></p>
+<p>This page allows you to select both location of services.xml and
+the location of service classes directory. Click on the "Select"
+buttons and browse the file system to find required document and
+location.</p>
+<p>Click on the "Next" button which will take you to a page which
+allows you to add third party libraries and WSDL's in the same
+manner as "Sub Wizard 1 & Sub Wizard 2" section's <a href="#Note">Page 6 - Edit service descriptors</a>. Note that Sub Wizard
+3 from this point takes the same pages as 6 to 7 of Sub Wizards 1
+& 2.</p>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/tools/1_3/maven-plugins/maven-aar-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_3/maven-plugins/maven-aar-plugin.html?view=auto&rev=565299
==============================================================================
--- webservices/axis2/site/tools/1_3/maven-plugins/maven-aar-plugin.html (added)
+++ webservices/axis2/site/tools/1_3/maven-plugins/maven-aar-plugin.html Mon Aug 13 03:16:20 2007
@@ -0,0 +1,477 @@
+<!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">
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+ </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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+<meta http-equiv="content-type" content=""></meta>
+Maven2 AAR Plug-in Guide
+<link href="../../../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1>Maven2 AAR Plug-in Guide</h1>
+<h2>Introduction</h2>
+<p>This plugin generates an Axis 2 service file (AAR file).</p>
+<p><a href="http://ws.apache.org/axis2/tools/index.html">[Download Plugin Tool]</a></p>
+<h2>Goals</h2>
+<p>The AAR plugin allows the packaging of an Axis 2 service aar in
+3 different modes:</p>
+<ol type="1">
+<li><b>aar (default)</b>: generates the aar artifact</li>
+<li><b>inplace</b> : package the aar in the source tree</li>
+<li><b>exploded</b> : package an exploded aar application</li>
+</ol>
+Each mode is materialized by a goal. For instance, to generate
+an exploded aar from the current project, one would type
+<pre>
+mvn aar:exploded
+</pre>
+<h2>Configuration</h2>
+All AAR plugin goals takes the following configuration
+parameters as input:
+<table class="bodyTable">
+<tbody>
+<tr class="a">
+<td><strong>Parameter Name</strong></td>
+<td><strong>Default Value</strong></td>
+<td><strong>Description</strong></td>
+</tr>
+<tr class="b">
+<td>aarDirectory</td>
+<td>${project.build.directory}/aar</td>
+<td>Directory where the aar file is built</td>
+</tr>
+<tr class="a">
+<td>classesDirectory</td>
+<td>${project.build.outputDirectory}</td>
+<td>Directory with compiled classes and resources</td>
+</tr>
+<tr class="b">
+<td>fileSets</td>
+<td></td>
+<td>Additional file sets, which are being added to the archive. See
+"<a href="#file_sets">File Sets</a>" below for an example</td>
+</tr>
+<tr class="a">
+<td>servicesXmlFile</td>
+<td></td>
+<td>Location of the services.xml file. By default, it is assumed
+that the file is already present in classesDirectory/META-INF and
+no special processing is required</td>
+</tr>
+<tr class="b">
+<td>wsdlFile</td>
+<td></td>
+<td>Location of the WSDL file. By default, it is assumed that the
+file is already present in classesDirectory/META-INF and no special
+processing is required</td>
+</tr>
+<tr class="a">
+<td>wsdlFileName</td>
+<td>service.wsdl</td>
+<td>Name, to which the WSDL file should be mapped</td>
+</tr>
+</tbody>
+</table>
+<h3>The aar Goal</h3>
+The aar goal allows the following additional parameters:
+<table class="bodyTable">
+<tbody>
+<tr class="b">
+<td><strong>Parameter Name</strong></td>
+<td><strong>Default Value</strong></td>
+<td><strong>Description</strong></td>
+</tr>
+<tr class="a">
+<td>outputDirectory</td>
+<td>${project.build.directory}</td>
+<td>Directory where to generate the AAR file</td>
+</tr>
+<tr class="b">
+<td>aarName</td>
+<td>${project.build.finalName}</td>
+<td>The generated AAR files name</td>
+</tr>
+<tr class="a">
+<td>archive</td>
+<td></td>
+<td>A Maven archive configuration. This allows, for example, to
+configure the MANIFEST.MF file</td>
+</tr>
+<tr class="b">
+<td>classifier</td>
+<td></td>
+<td>A classifier, which should be added to the generated AAR files
+name. Setting this parameter has the side effect, that the artifact
+is treated as an attachment and not as the projects primary
+artifact</td>
+</tr>
+<tr class="a">
+<td>primaryArtifact</td>
+<td>true</td>
+<td>Setting this property to false disables installation or
+deployment of the artifact as the projects primary artifact</td>
+</tr>
+</tbody>
+</table>
+<a name="file_sets"></a>
+<h3>File Sets</h3>
+<p>Additional file sets may be configured for inclusion into the
+AAR file. A file set looks as follows:</p>
+<pre>
+
+ <fileSets>
+ <fileSet>
+ <directory>src/aar/files</directory>
+ <outputDirectory>META-INF/docs</outputDirectory>
+ <includes>
+ <include>**/*.html</include>
+
+ </includes>
+ </fileSet>
+ <fileSet>
+ <directory>src/aar/files</directory>
+ <outputDirectory>META-INF/etc</outputDirectory>
+
+ <excludes>
+ <exclude>**/*.html</exclude>
+ </excludes>
+ </fileSet>
+ </fileSets>
+
+</pre>
+<p>The example specifies, that the contents of the directory
+src/aar/files shall be added to the AAR file. HTML files will go
+into META-INF/docs, all other files to META-INF/etc.</p>
+<p>A file set is configured through the following configuration
+parameters:</p>
+<table class="bodyTable">
+<tbody>
+<tr class="b">
+<td><strong>Parameter Name</strong></td>
+<td><strong>Description</strong></td>
+</tr>
+<tr class="a">
+<td>directory</td>
+<td>The directory, from which to read the file set. This parameter
+is required</td>
+</tr>
+<tr class="b">
+<td>outputDirectory</td>
+<td>The target directory within the AAR file. Defaults to the AAR
+files root directory</td>
+</tr>
+<tr class="a">
+<td>includes</td>
+<td>Configures the set of files, which shall be included into the
+AAR file. Defaults to **/*</td>
+</tr>
+<tr class="b">
+<td>excludes</td>
+<td>Configures a set of files, which shall be excluded from the
+file set. Defaults to the Maven default excludes (**/*~,
+**/cvs/**/*, **/.svn/**/*, etc.)</td>
+</tr>
+<tr class="a">
+<td>skipDefaultExcludes</td>
+<td>If this parameter is set to true, then no default excludes are
+being used</td>
+</tr>
+</tbody>
+</table>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/tools/1_3/maven-plugins/maven-java2wsdl-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_3/maven-plugins/maven-java2wsdl-plugin.html?view=auto&rev=565299
==============================================================================
--- webservices/axis2/site/tools/1_3/maven-plugins/maven-java2wsdl-plugin.html (added)
+++ webservices/axis2/site/tools/1_3/maven-plugins/maven-java2wsdl-plugin.html Mon Aug 13 03:16:20 2007
@@ -0,0 +1,414 @@
+<!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">
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+ </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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+<meta http-equiv="content-type" content=""></meta>
+Maven2 Java2WSDL Plug-in Guide
+<link href="../../../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1>Maven2 Java2WSDL Plug-in Guide</h1>
+<h2>Introduction</h2>
+<p>This plugin takes as input a Java class and generates a WSDL,
+which describes a Web service for invoking the classes methods.</p>
+<p><a href="http://ws.apache.org/axis2/tools/index.html">[Download Plugin Tool]</a></p>
+<h2>Goals</h2>
+<p>The Java2WSDL plugin offers a single goal:</p>
+<ul>
+<li>java2wsdl (default): Reads a java class and generates a WSDL
+for invoking the classes methods as a Web service.</li>
+</ul>
+To run the plugin, add the following section to your <a href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">
+POM</a> (Project Object Model):
+<pre>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.axis2.maven2</groupId>
+ <artifactId>axis2-java2wsdl-maven-plugin</artifactId>
+ <configuration>
+ <className>com.foo.myservice.MyHandler</className>
+ </configuration>
+ <executions>
+ <execution>
+ <goals>
+ <goal>java2wsdl</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+
+</pre>
+<p>The plugin will be invoked automatically in the
+generate-resources phase. You can also invoke it directly from the
+command line by running the command:</p>
+<pre>
+mvn java2wsdl:java2wsdl
+</pre>
+<h3>The Java2WSDL Goal</h3>
+<p>By default, the plugin reads the given Java class and creates a
+file
+<strong>target/generated-resources/java2wsdl/service.xml</strong>.
+The Java class is given by the configuration element
+<strong>className</strong> above.</p>
+<h2>Configuration</h2>
+<p>The Java2WSDL goal takes the following parameters as input. All
+parameters can be set from the command line by using properties.
+For example, the parameter "className" may be set using the
+property "axis2.java2wsdl.className". If the parameter isn't set
+via property or in the POM, then a default value applies.</p>
+<table class="bodyTable">
+<tbody>
+<tr class="a">
+<td><strong>Parameter name</strong></td>
+<td><strong>Command line property</strong></td>
+<td><strong>Description</strong></td>
+<td><strong>Default value</strong></td>
+</tr>
+<tr class="b">
+<td>className</td>
+<td>${axis2.java2wsdl.className}</td>
+<td>Fully qualified name of the class, which is being read and
+transformed into a WSDL</td>
+<td></td>
+</tr>
+<tr class="a">
+<td>outputFileName</td>
+<td>${axis2.java2wsdl.outputFileName}</td>
+<td>Path of the generated service file.</td>
+<td></td>
+</tr>
+<tr class="b">
+<td>schemaTargetNamespace</td>
+<td>${axis2.java2wsdl.schemaTargetNamespace}</td>
+<td>Target namespace of the generated schema.</td>
+<td></td>
+</tr>
+<tr class="a">
+<td>schemaTargetNamespacePrefix</td>
+<td>${axis2.java2wsdl.schemaTargetNamespacePrefix}</td>
+<td>Prefix, which is being associated with the schemas target
+namespace.</td>
+<td></td>
+</tr>
+<tr class="b">
+<td>serviceName</td>
+<td>${axis2.java2wsdl.serviceName}</td>
+<td>Name of the generated Web service.</td>
+<td>Unqualified name of the input class.</td>
+</tr>
+<tr class="a">
+<td>targetNamespace</td>
+<td>${axis2.java2wsdl.targetNamespace}</td>
+<td>Target namespace of the generated WSDL</td>
+<td>Default namespace</td>
+</tr>
+<tr class="b">
+<td>targetNamespacePrefix</td>
+<td>${axis2.java2wsdl.targetNamespacePrefix}</td>
+<td>Prefix, which is being associated with the target
+namespace</td>
+<td></td>
+</tr>
+</tbody>
+</table>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: webservices/axis2/site/tools/1_3/maven-plugins/maven-wsdl2code-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_3/maven-plugins/maven-wsdl2code-plugin.html?view=auto&rev=565299
==============================================================================
--- webservices/axis2/site/tools/1_3/maven-plugins/maven-wsdl2code-plugin.html (added)
+++ webservices/axis2/site/tools/1_3/maven-plugins/maven-wsdl2code-plugin.html Mon Aug 13 03:16:20 2007
@@ -0,0 +1,479 @@
+<!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">
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+ </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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+<meta http-equiv="content-type" content=""></meta>
+Maven2 WSDL2Code Plug-in Guide
+<link href="../../../css/axis-docs.css" rel="stylesheet" type="text/css" media="all"></link>
+</head>
+
+<h1>Maven2 WSDL2Code Plug-in Guide</h1>
+<h2>Introduction</h2>
+<p>This plugin takes as input a WSDL and generates client and
+server stubs for calling or implementing a Web service matching the
+WSDL.</p>
+<p><a href="http://ws.apache.org/axis2/tools/index.html">[Download Plugin Tool]</a></p>
+<h2>Goals</h2>
+<p>The WSDl2Code offers a single goal:</p>
+<ul>
+<li>wsdl2code (default): Reads the WSDL and generates code.</li>
+</ul>
+To run the plugin, add the following section to your <a href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">
+POM</a> (Project Object Model):
+<pre>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.axis2.maven2</groupId>
+ <artifactId>axis2-wsdl2code-maven-plugin</artifactId>
+ <executions>
+ <execution>
+ <goals>
+ <goal>wsdl2code</goal>
+ </goals>
+ </execution>
+ </executions>
+ <configuration>
+ <packageName>com.foo.myservice</packageName>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+</pre>
+<p>The plugin will be invoked automatically in the generate-sources
+phase. You can also invoke it directly from the command line by
+running the command</p>
+<pre>
+mvn wsdl2code:wsdl2code
+</pre>
+<h3>The WSDL2Code Goal</h3>
+<p>By default, the plugin reads the file
+<strong>src/main/axis2/service.wsdl</strong>. Sources for the Java
+programming language and the ADB data binding are generated into
+<strong>target/generated-sources/axis2/wsdl2code</strong>. Note the
+configuration element <strong>packageName</strong> above, which
+sets the package name, thus a subdirectory.</p>
+<h2>Configuration</h2>
+<p>The WSDL2Code goal takes the following parameters as input. All
+parameters can be set from the command line by using properties.
+For example, the parameter "generateServerSide" may be set using
+the property "axis2.wsdl2code.generateServerSide". If the parameter
+isn't set via property or in the POM, then a default value
+applies.</p>
+<table class="bodyTable">
+<tbody>
+<tr class="a">
+<td><strong>Parameter Name</strong></td>
+<td><strong>Command Line Property</strong></td>
+<td><strong>Description</strong></td>
+<td><strong>Default Value</strong></td>
+</tr>
+<tr class="b">
+<td>databindingName</td>
+<td>${axis2.wsdl2code.databindingName}</td>
+<td>Data binding framework, which is being used by the generated
+sources.</td>
+<td>adb</td>
+</tr>
+<tr class="a">
+<td>generateAllClasses</td>
+<td>${axis2.wsdl2code.generateAllClasses}</td>
+<td>Whether to generate simply all classes. This is only valid in
+conjunction with "generateServerSide".</td>
+<td>false</td>
+</tr>
+<tr class="b">
+<td>generateServerSide</td>
+<td>${axis2.wsdl2code.generateServerSide}</td>
+<td>Whether server side sources are being generated.</td>
+<td>false</td>
+</tr>
+<tr class="a">
+<td>generateServerSideInterface</td>
+<td>${axis2.wsdl2code.generateServerSideInterface}</td>
+<td>Whether to generate the server side interface.</td>
+<td>false</td>
+</tr>
+<tr class="b">
+<td>generateServicesXml</td>
+<td>${axis2.wsdl2code.generateServicesXml}</td>
+<td>Whether a "services.xml" file is being generated.</td>
+<td>false</td>
+</tr>
+<tr class="a">
+<td>generateTestcase</td>
+<td>${axis2.wsdl2code.generateTestCase}</td>
+<td>Whether a test case is being generated.</td>
+<td>false</td>
+</tr>
+<tr class="b">
+<td>language</td>
+<td>${axis2.wsdl2code.language}</td>
+<td>Programming language of the generated sources.</td>
+<td>java</td>
+</tr>
+<tr class="a">
+<td>namespaceToPackages</td>
+<td>${axis2.wsdl2code.namespaceToPackages}</td>
+<td>Map of namespace URI to packages in the format
+uri1=package1,uri2=package2,... Using this parameter is
+discouraged. In general, you should use the namespaceUris
+parameter. However, the latter cannot be set on the command
+line.</td>
+<td></td>
+</tr>
+<tr class="b">
+<td>namespaceURIs</td>
+<td></td>
+<td>Map of namespace URI to packages. Example:
+<namespaceURIs> <namespaceURI>
+<uri>uri1</uri> <package>package1</package>
+</namespaceURI> ........ </namespaceURI></td>
+<td></td>
+</tr>
+<tr class="a">
+<td>outputDirectory</td>
+<td>${axis2.wsdl2code.target}</td>
+<td>Target directory, where sources are being
+target/generated-sources/axis2/wsdl2code generated.</td>
+<td></td>
+</tr>
+<tr class="b">
+<td>packageName</td>
+<td>${axis2.wsdl2code.package}</td>
+<td>Package name of the generated sources.</td>
+<td></td>
+</tr>
+<tr class="a">
+<td>portName</td>
+<td>${axis2.wsdl2code.portName}</td>
+<td>Port name, for which sources are being generated. By default,
+sources are generated for all ports.</td>
+<td></td>
+</tr>
+<tr class="b">
+<td>serviceName</td>
+<td>${axis2.wsdl2code.serviceName}</td>
+<td>Service name, for which sources are being generated. By
+default, sources are generated for all services.</td>
+<td></td>
+</tr>
+<tr class="a">
+<td>syncMode</td>
+<td>${axis2.wsdl2code.syncMode}</td>
+<td>Sync mode, for which sources are being generated; either of
+"sync", "async", or "both" (default).</td>
+<td>both</td>
+</tr>
+<tr class="b">
+<td>unpackClasses</td>
+<td>${axis2.wsdl2code.unpackClasses}</td>
+<td>Whether to unpack classes.</td>
+<td></td>
+</tr>
+<tr class="a">
+<td>wsdlFile</td>
+<td>${axis2.wsdl2code.wsdl}</td>
+<td>Location of the WSDL file, which is read as input</td>
+<td>src/main/axis2/service.wsdl</td>
+</tr>
+</tbody>
+</table>
+
+</html>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2004-2007
+
+ Apache Software Foundation
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org