axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From d...@apache.org
Subject svn commit: r652665 [35/45] - in /webservices/axis2/site: ./ 1_4/ 1_4/adb/ 1_4/adb/images/ 1_4/images/ 1_4/images/archi-guide/ 1_4/images/userguide/ 1_4/jibx/ 1_4/src/ css/ download/0_9/ download/0_91/ download/0_92/ download/0_93/ download/0_94/ downl...
Date Thu, 01 May 2008 21:20:38 GMT
Modified: webservices/axis2/site/tools/1_1/idea/Idea_plug-in_userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_1/idea/Idea_plug-in_userguide.html?rev=652665&r1=652664&r2=652665&view=diff
==============================================================================
--- webservices/axis2/site/tools/1_1/idea/Idea_plug-in_userguide.html (original)
+++ webservices/axis2/site/tools/1_1/idea/Idea_plug-in_userguide.html Thu May  1 14:20:27 2008
@@ -1,190 +1,190 @@
-<!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 - Axis2 Plug-in Guide for IntelliJ IDEA</title><style type="text/css" media="all">
-          @import url("../../../style/maven-base.css");
-          
-			    @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>
-      
-        
-          
-            <span class="separator">|</span>
-          
-        
-        <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>
-      
-        
-          
-            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Axis2_Plug-in_Guide_for_IntelliJ_IDEA"></a><h2>Axis2 Plug-in Guide for IntelliJ IDEA</h2><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" class="externalLink" title="External Link">[Download
-Plug-in]</a></p><div class="subsection"><a name="Content"></a><h3>Content</h3><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 &amp; Sub Wizard 2</a></li>
-      <li><a href="#sub3">Sub Wizard 3</a></li>
-    </ul>
-  </li>
-</ul><p><a name="intro"></a></p></div><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>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.</p><p><a name="installation"></a></p></div><div class="subsection"><a name="Installation"></a><h3>Installation</h3><p>First <a href="http://ws.apache.org/axis2/tools/index.html" class="externalLink" title="External Link">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.</p><p>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.</p><p><img alt="Figure 1" src="images/idea-icons.jpg"></img></p><p>Also if you right-click on the  IDEA editor you would see a link to the
-same plug-in.</p><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>
-  <li><a href="#Create_Service_Archive">Create a service archive</a></li>
-  <li><a href="#WSDL2Java_Code_Generation">WSDL2Java code generation</a></li>
-</ol><p><strong>Page 1:</strong></p><p><img alt="Figure3" src="images/fig1.jpg"></img></p><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></div><div class="subsection"><a name="WSDL2Java_Code_Generation"></a><h3>WSDL2Java Code Generation</h3><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>
-		<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 
-&lt;service name &gt;-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>
-</p><p><img alt="Figure5" src="images/fig19.jpg"></img></p><p><strong>WSDL2Java Page 4:</strong></p><p><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><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>
-
-  <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>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><p>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.</p><p><strong>WSDL2Java Page 5:</strong></p><p><img alt="Figure6" src="images/fig3.jpg"></img></p><p>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. </p><p>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.</p><p><img alt="Fig4" src="images/fig4.jpg"></img></p><p>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.</p><p><a name="Create_Service_Archive" id="Create_Service_Archive"></a></p></div><div class="subsection"><a name="Create_a_Service_Archive"></a><h3>Create a Service Archive</h3><p>Select the "Create a service archive" radio button on Page 1 of Axis2 IDEA
-plug-in wizard.</p><p><strong>Page 1:</strong></p><p><img alt="Fig5" src="images/fig1.jpg"></img></p><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>
-  <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><p>1 &amp; 2 follow the same set of steps except for some looping mechanism
-in the middle of the wizard.</p><p><a name="sub12"></a></p></div><div class="subsection"><a name="Sub_Wizard_1_and_Sub_Wizard_2"></a><h3>Sub Wizard 1 and Sub Wizard 2</h3><p><strong>Service Archive (sub wizards 1 &amp; 2) Page 3:</strong></p><p>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><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 &amp; 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 &amp; 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 &amp; 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 &amp; 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 &amp; 7 of sub wizards 1 &amp; 2 are common to sub
-wizard 3 from its page 3 onwards.</em></strong><em></em></p><p><a name="sub3"></a></p></div><div class="subsection"><a name="Sub_Wizard_3"></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 &amp; 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
+<!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 - Axis2 Plug-in Guide for IntelliJ IDEA</title><style type="text/css" media="all">
+          @import url("../../../style/maven-base.css");
+          
+			    @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>
+      
+        
+          
+            <span class="separator">|</span>
+          
+        
+        <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>
+      
+        
+          
+            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Axis2_Plug-in_Guide_for_IntelliJ_IDEA"></a><h2>Axis2 Plug-in Guide for IntelliJ IDEA</h2><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" class="externalLink" title="External Link">[Download
+Plug-in]</a></p><div class="subsection"><a name="Content"></a><h3>Content</h3><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 &amp; Sub Wizard 2</a></li>
+      <li><a href="#sub3">Sub Wizard 3</a></li>
+    </ul>
+  </li>
+</ul><p><a name="intro"></a></p></div><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>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.</p><p><a name="installation"></a></p></div><div class="subsection"><a name="Installation"></a><h3>Installation</h3><p>First <a href="http://ws.apache.org/axis2/tools/index.html" class="externalLink" title="External Link">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.</p><p>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.</p><p><img alt="Figure 1" src="images/idea-icons.jpg"></img></p><p>Also if you right-click on the  IDEA editor you would see a link to the
+same plug-in.</p><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>
+  <li><a href="#Create_Service_Archive">Create a service archive</a></li>
+  <li><a href="#WSDL2Java_Code_Generation">WSDL2Java code generation</a></li>
+</ol><p><strong>Page 1:</strong></p><p><img alt="Figure3" src="images/fig1.jpg"></img></p><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></div><div class="subsection"><a name="WSDL2Java_Code_Generation"></a><h3>WSDL2Java Code Generation</h3><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>
+		<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 
+&lt;service name &gt;-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>
+</p><p><img alt="Figure5" src="images/fig19.jpg"></img></p><p><strong>WSDL2Java Page 4:</strong></p><p><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><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>
+
+  <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>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><p>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.</p><p><strong>WSDL2Java Page 5:</strong></p><p><img alt="Figure6" src="images/fig3.jpg"></img></p><p>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. </p><p>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.</p><p><img alt="Fig4" src="images/fig4.jpg"></img></p><p>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.</p><p><a name="Create_Service_Archive" id="Create_Service_Archive"></a></p></div><div class="subsection"><a name="Create_a_Service_Archive"></a><h3>Create a Service Archive</h3><p>Select the "Create a service archive" radio button on Page 1 of Axis2 IDEA
+plug-in wizard.</p><p><strong>Page 1:</strong></p><p><img alt="Fig5" src="images/fig1.jpg"></img></p><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>
+  <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><p>1 &amp; 2 follow the same set of steps except for some looping mechanism
+in the middle of the wizard.</p><p><a name="sub12"></a></p></div><div class="subsection"><a name="Sub_Wizard_1_and_Sub_Wizard_2"></a><h3>Sub Wizard 1 and Sub Wizard 2</h3><p><strong>Service Archive (sub wizards 1 &amp; 2) Page 3:</strong></p><p>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><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 &amp; 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 &amp; 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 &amp; 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 &amp; 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 &amp; 7 of sub wizards 1 &amp; 2 are common to sub
+wizard 3 from its page 3 onwards.</em></strong><em></em></p><p><a name="sub3"></a></p></div><div class="subsection"><a name="Sub_Wizard_3"></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 &amp; 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
 &amp; 2.</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

Modified: webservices/axis2/site/tools/1_1/maven-plugins/maven-aar-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_1/maven-plugins/maven-aar-plugin.html?rev=652665&r1=652664&r2=652665&view=diff
==============================================================================
--- webservices/axis2/site/tools/1_1/maven-plugins/maven-aar-plugin.html (original)
+++ webservices/axis2/site/tools/1_1/maven-plugins/maven-aar-plugin.html Thu May  1 14:20:27 2008
@@ -1,105 +1,105 @@
-<!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 - Maven2 AAR Plug-in Guide</title><style type="text/css" media="all">
-          @import url("../../../style/maven-base.css");
-          
-			    @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>
-      
-        
-          
-            <span class="separator">|</span>
-          
-        
-        <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>
-      
-        
-          
-            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Maven2_AAR_Plug-in_Guide"></a><h2>Maven2 AAR Plug-in Guide</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>This plugin generates an Axis 2 service file (AAR file).</p><p><a href="http://ws.apache.org/axis2/tools/index.html" class="newWindow" title="New Window" target="_blank">[Download Plugin Tool]</a></p></div><div class="subsection"><a name="Goals"></a><h3>Goals</h3><p>The AAR plugin allows the pack
 aging of an Axis 2 service aar in 3
-different modes:</p><ol>
-  <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><p>Each mode is materialized by a goal. For instance, to generate an exploded
-aar from the current project, one would type</p>
-    <div class="source"><pre>mvn aar:exploded
-
-</pre></div>
-  </div><div class="subsection"><a name="Configuration"></a><h3>Configuration</h3><p>All AAR plugin goals takes the following configuration parameters as
-input:</p><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>aarDirectory</td><td>${project.build.directory}/aar</td><td>Directory where the aar file is built</td></tr>
-    <tr class="b"><td>classesDirectory</td><td>${project.build.outputDirectory}</td><td>Directory with compiled classes and resources</td></tr>
-    <tr class="a"><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="b"><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="a"><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="b"><td>wsdlFileName</td><td>service.wsdl</td><td>Name, to which the WSDL file should be mapped</td></tr>
-  </tbody></table></div><div class="subsection"><a name="The_aar_Goal"></a><h3>The aar Goal</h3><p>The aar goal allows the following additional parameters:</p><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>outputDirectory</td><td>${project.build.directory}</td><td>Directory where to generate the AAR file</td></tr>
-    <tr class="a"><td>aarName</td><td>${project.build.finalName}</td><td>The generated AAR files name</td></tr>
-    <tr class="b"><td>archive</td><td></td><td>A Maven archive configuration. This allows, for example, to
-        configure the MANIFEST.MF file</td></tr>
-    <tr class="a"><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="b"><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><p><a name="file_sets"></a></p></div><div class="subsection"><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>
-    <div class="source"><pre>  
-  &lt;fileSets&gt;
-    &lt;fileSet&gt;
-      &lt;directory&gt;src/aar/files&lt;/directory&gt;
-      &lt;outputDirectory&gt;META-INF/docs&lt;/outputDirectory&gt;
-      &lt;includes&gt;
-        &lt;include&gt;**/*.html&lt;/include&gt;
-
-      &lt;/includes&gt;
-    &lt;/fileSet&gt;
-    &lt;fileSet&gt;
-      &lt;directory&gt;src/aar/files&lt;/directory&gt;
-      &lt;outputDirectory&gt;META-INF/etc&lt;/outputDirectory&gt;
-
-      &lt;excludes&gt;
-        &lt;exclude&gt;**/*.html&lt;/exclude&gt;
-      &lt;/excludes&gt;
-    &lt;/fileSet&gt;
-  &lt;/fileSets&gt;
-  
-
-</pre></div>
-  <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="a"><td><strong>Parameter Name</strong></td><td><strong>Description</strong></td></tr>
-    <tr class="b"><td>directory</td><td>The directory, from which to read the file set. This parameter is
-        required</td></tr>
-    <tr class="a"><td>outputDirectory</td><td>The target directory within the AAR file. Defaults to the AAR files
-        root directory</td></tr>
-    <tr class="b"><td>includes</td><td>Configures the set of files, which shall be included into the AAR
-        file. Defaults to **/*</td></tr>
-    <tr class="a"><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="b"><td>skipDefaultExcludes</td><td>If this parameter is set to true, then no default excludes are
-        being used</td></tr>
+<!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 - Maven2 AAR Plug-in Guide</title><style type="text/css" media="all">
+          @import url("../../../style/maven-base.css");
+          
+			    @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>
+      
+        
+          
+            <span class="separator">|</span>
+          
+        
+        <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>
+      
+        
+          
+            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Maven2_AAR_Plug-in_Guide"></a><h2>Maven2 AAR Plug-in Guide</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><p>This plugin generates an Axis 2 service file (AAR file).</p><p><a href="http://ws.apache.org/axis2/tools/index.html" class="newWindow" title="New Window" target="_blank">[Download Plugin Tool]</a></p></div><div class="subsection"><a name="Goals"></a><h3>Goals</h3><p>The AAR plugin allows the pack
 aging of an Axis 2 service aar in 3
+different modes:</p><ol>
+  <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><p>Each mode is materialized by a goal. For instance, to generate an exploded
+aar from the current project, one would type</p>
+    <div class="source"><pre>mvn aar:exploded
+
+</pre></div>
+  </div><div class="subsection"><a name="Configuration"></a><h3>Configuration</h3><p>All AAR plugin goals takes the following configuration parameters as
+input:</p><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>aarDirectory</td><td>${project.build.directory}/aar</td><td>Directory where the aar file is built</td></tr>
+    <tr class="b"><td>classesDirectory</td><td>${project.build.outputDirectory}</td><td>Directory with compiled classes and resources</td></tr>
+    <tr class="a"><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="b"><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="a"><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="b"><td>wsdlFileName</td><td>service.wsdl</td><td>Name, to which the WSDL file should be mapped</td></tr>
+  </tbody></table></div><div class="subsection"><a name="The_aar_Goal"></a><h3>The aar Goal</h3><p>The aar goal allows the following additional parameters:</p><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>outputDirectory</td><td>${project.build.directory}</td><td>Directory where to generate the AAR file</td></tr>
+    <tr class="a"><td>aarName</td><td>${project.build.finalName}</td><td>The generated AAR files name</td></tr>
+    <tr class="b"><td>archive</td><td></td><td>A Maven archive configuration. This allows, for example, to
+        configure the MANIFEST.MF file</td></tr>
+    <tr class="a"><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="b"><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><p><a name="file_sets"></a></p></div><div class="subsection"><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>
+    <div class="source"><pre>  
+  &lt;fileSets&gt;
+    &lt;fileSet&gt;
+      &lt;directory&gt;src/aar/files&lt;/directory&gt;
+      &lt;outputDirectory&gt;META-INF/docs&lt;/outputDirectory&gt;
+      &lt;includes&gt;
+        &lt;include&gt;**/*.html&lt;/include&gt;
+
+      &lt;/includes&gt;
+    &lt;/fileSet&gt;
+    &lt;fileSet&gt;
+      &lt;directory&gt;src/aar/files&lt;/directory&gt;
+      &lt;outputDirectory&gt;META-INF/etc&lt;/outputDirectory&gt;
+
+      &lt;excludes&gt;
+        &lt;exclude&gt;**/*.html&lt;/exclude&gt;
+      &lt;/excludes&gt;
+    &lt;/fileSet&gt;
+  &lt;/fileSets&gt;
+  
+
+</pre></div>
+  <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="a"><td><strong>Parameter Name</strong></td><td><strong>Description</strong></td></tr>
+    <tr class="b"><td>directory</td><td>The directory, from which to read the file set. This parameter is
+        required</td></tr>
+    <tr class="a"><td>outputDirectory</td><td>The target directory within the AAR file. Defaults to the AAR files
+        root directory</td></tr>
+    <tr class="b"><td>includes</td><td>Configures the set of files, which shall be included into the AAR
+        file. Defaults to **/*</td></tr>
+    <tr class="a"><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="b"><td>skipDefaultExcludes</td><td>If this parameter is set to true, then no default excludes are
+        being used</td></tr>
   </tbody></table></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

Modified: webservices/axis2/site/tools/1_1/maven-plugins/maven-java2wsdl-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/tools/1_1/maven-plugins/maven-java2wsdl-plugin.html?rev=652665&r1=652664&r2=652665&view=diff
==============================================================================
--- webservices/axis2/site/tools/1_1/maven-plugins/maven-java2wsdl-plugin.html (original)
+++ webservices/axis2/site/tools/1_1/maven-plugins/maven-java2wsdl-plugin.html Thu May  1 14:20:27 2008
@@ -1,81 +1,81 @@
-<!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 - Maven2 Java2WSDL Plug-in Guide</title><style type="text/css" media="all">
-          @import url("../../../style/maven-base.css");
-          
-			    @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>
-      
-        
-          
-            <span class="separator">|</span>
-          
-        
-        <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>
-      
-        
-          
-            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Maven2_Java2WSDL_Plug-in_Guide"></a><h2>Maven2 Java2WSDL Plug-in Guide</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><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" class="newWindow" title="New Window" target="_blank">[Download Plugin Tool]</a></p></div><div class="subsection"><a name="Goals"></a><h3>Goals</h3><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><p>To run the plugin, add the following section to your <a href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html" class="externalLink" title="External Link">POM</a>
-(Project Object Model):</p>
-    <div class="source"><pre>  &lt;build&gt;
-    &lt;plugins&gt;
-      &lt;plugin&gt;
-        &lt;groupId&gt;org.apache.axis2.maven2&lt;/groupId&gt;
-        &lt;artifactId&gt;axis2-java2wsdl-maven-plugin&lt;/artifactId&gt;
-        &lt;configuration&gt;
-          &lt;className&gt;com.foo.myservice.MyHandler&lt;/className&gt;
-        &lt;/configuration&gt;
-        &lt;executions&gt;
-          &lt;execution&gt;
-            &lt;goals&gt;
-              &lt;goal&gt;java2wsdl&lt;/goal&gt;
-            &lt;/goals&gt;
-          &lt;/execution&gt;
-         &lt;/executions&gt;
-      &lt;/plugin&gt;
-    &lt;/plugins&gt;
-  &lt;/build&gt;
-  
-
-</pre></div>
-  <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>
-    <div class="source"><pre>mvn java2wsdl:java2wsdl
-
-</pre></div>
-  </div><div class="subsection"><a name="The_Java2WSDL_Goal"></a><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></div><div class="subsection"><a name="Configuration"></a><h3>Configuration</h3><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>
+<!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 - Maven2 Java2WSDL Plug-in Guide</title><style type="text/css" media="all">
+          @import url("../../../style/maven-base.css");
+          
+			    @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>
+      
+        
+          
+            <span class="separator">|</span>
+          
+        
+        <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>
+      
+        
+          
+            <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="none"><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="externa
 lLink" 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="externalLink" 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="External 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="Maven2_Java2WSDL_Plug-in_Guide"></a><h2>Maven2 Java2WSDL Plug-in Guide</h2><div class="subsection"><a name="Introduction"></a><h3>Introduction</h3><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" class="newWindow" title="New Window" target="_blank">[Download Plugin Tool]</a></p></div><div class="subsection"><a name="Goals"></a><h3>Goals</h3><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><p>To run the plugin, add the following section to your <a href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html" class="externalLink" title="External Link">POM</a>
+(Project Object Model):</p>
+    <div class="source"><pre>  &lt;build&gt;
+    &lt;plugins&gt;
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.apache.axis2.maven2&lt;/groupId&gt;
+        &lt;artifactId&gt;axis2-java2wsdl-maven-plugin&lt;/artifactId&gt;
+        &lt;configuration&gt;
+          &lt;className&gt;com.foo.myservice.MyHandler&lt;/className&gt;
+        &lt;/configuration&gt;
+        &lt;executions&gt;
+          &lt;execution&gt;
+            &lt;goals&gt;
+              &lt;goal&gt;java2wsdl&lt;/goal&gt;
+            &lt;/goals&gt;
+          &lt;/execution&gt;
+         &lt;/executions&gt;
+      &lt;/plugin&gt;
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+  
+
+</pre></div>
+  <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>
+    <div class="source"><pre>mvn java2wsdl:java2wsdl
+
+</pre></div>
+  </div><div class="subsection"><a name="The_Java2WSDL_Goal"></a><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></div><div class="subsection"><a name="Configuration"></a><h3>Configuration</h3><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></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



---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org


Mime
View raw message