axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cha...@apache.org
Subject svn commit: r448963 - in /webservices/axis2/trunk/java/xdocs/tools/1_1: ./ eclipse/ eclipse/images/ idea/ idea/images/
Date Fri, 22 Sep 2006 15:23:25 GMT
Author: chatra
Date: Fri Sep 22 08:23:22 2006
New Revision: 448963

URL: http://svn.apache.org/viewvc?view=rev&rev=448963
Log:
committing 1.1 tools docs

Added:
    webservices/axis2/trunk/java/xdocs/tools/1_1/
    webservices/axis2/trunk/java/xdocs/tools/1_1/CodegenToolReference.html
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServicePage1.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServiceWizardSelection.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/Thumbs.db   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/help.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen0.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen1.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen2.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen3.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page2.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3_hl.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_load.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_plain.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_search_declared.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_table.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_added.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_browsed.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_hl.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_remove.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page6.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/success_msg.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen0.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen1.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen2.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen3.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen4.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/servicearchiver-plugin.html
    webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/wsdl2java-plugin.html
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/Idea_plug-in_userguide.html
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/Thumbs.db   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig1.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig10.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig11.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig12.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig13.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig14.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig15.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig16.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig17.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig18.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig2.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig3.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig4.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig5.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig6.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig7.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig8.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig9.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-icons.jpg   (with props)
    webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-popup.jpg   (with props)

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/CodegenToolReference.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/CodegenToolReference.html?view=auto&rev=448963
==============================================================================
--- webservices/axis2/trunk/java/xdocs/tools/1_1/CodegenToolReference.html (added)
+++ webservices/axis2/trunk/java/xdocs/tools/1_1/CodegenToolReference.html Fri Sep 22 08:23:22 2006
@@ -0,0 +1,791 @@
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Code Generator-Command Line Tool</title>
+</head>
+
+<body lang="en">
+<h1>Code Generator Tool- Command Line and Ant Task</h1>
+
+<p>The Code Generator tool consists of a command line version and an Ant
+Task. This document will list the command line references and Ant task
+references. Also in detail, this document shows how to build file using
+custom Ant task and invoking the Code Generator from Ant.</p>
+
+<p>This tool is bundled with the Axis2 base distribution found <a
+href="http://ws.apache.org/axis2/download.cgi">here</a>.</p>
+
+<h2>Content</h2>
+<ul>
+  <li><a href="#intro">Introduction</a></li>
+  <li><a href="#cmdline">Command Line Version</a>
+    <ul>
+      <li><a href="#cmdref">Option Reference</a></li>
+    </ul>
+  </li>
+  <li><a href="#ant">Ant Task</a>
+    <ul>
+      <li><a href="#antref">Ant Task Reference</a></li>
+      <li><a href="#example">Example Build File Using the Custom Ant
+      Task</a></li>
+      <li><a href="#invoking">Invoking the Code Generator From Ant</a></li>
+    </ul>
+  </li>
+  <li><a href="#appendix">Appendix</a></li>
+</ul>
+<a name="intro"></a>
+
+<h2>Introduction</h2>
+
+<p>This basic tool is implemented by the WSDL2Code class and just for the
+convenience in the case of java (which would be the majority) there is
+another WSDL2Java class. One can choose to run the main classes directly or
+use one of the scripts to run the WSDL2Code and WSDL2Java appropriately. (the
+scripts are found in the bin directory of the binary distribution)</p>
+<a name="cmdline"></a>
+
+<h2>Command Line Version</h2>
+
+<p>For those users who wish to use the command line version of the tool, this
+section will be of value.</p>
+<a name="cmdref"></a>
+
+<h3>Option Reference</h3>
+
+<table border="1" cellpadding="0" cellspacing="0"
+style="border-collapse: collapse" width="100%" id="AutoNumber1">
+  <tbody>
+    <tr>
+      <td width="20%"><strong>Short Option</strong></td>
+      <td width="20%"><strong>Long Option</strong></td>
+      <td width="60%"><strong>Description</strong></td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-uri &lt;Location of WSDL&gt;</td>
+      <td width="20%">None</td>
+      <td width="60%">WSDL file location. This should point to a WSDL file in
+        the local file system</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-o &lt;output Location&gt; :</td>
+      <td width="20%">--output</td>
+      <td width="60%">output file location. This is where the files would be
+        copied once the code generation is done. If this option is omitted
+        the generated files would be copied to the working directory.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-l &lt;language&gt;</td>
+      <td width="20%">--language</td>
+      <td width="60%">Output language. Currently the code generator can
+        generate code in Java but it has the ability to be extended to
+        support other languages</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-p &lt;package name&gt;</td>
+      <td width="20%">--package</td>
+      <td width="60%">The target package name. If omitted, a default package
+        (formed using the target namespace of the WSDL) will be used.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-a</td>
+      <td width="20%">--async</td>
+      <td width="60%">Generate code only for async style . when this option
+        is used the generated stubs will have only the asynchronous
+        invocation methods. Switched off by default.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-s</td>
+      <td width="20%">--sync</td>
+      <td width="60%">Generate code only for sync style . When this option is
+        used the generated stubs will have only the  synchronous invocation
+        methods. Switched off by default. When used with the -a option, this
+        takes precedence.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-t</td>
+      <td width="20%">--test-case</td>
+      <td width="60%">Generates a test case. In the case of Java it would be
+        a junit test case.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-ss</td>
+      <td width="20%">--server-side</td>
+      <td width="60%">Generates server side code (i.e. skeletons). Default is
+        off</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-sd</td>
+      <td width="20%">--service-description</td>
+      <td width="60%">Generates the service descriptor (i.e. server.xml).
+        Default is off. only valid with -ss, the server side code generation
+        option</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-d</td>
+      <td width="20%">--databinding-method</td>
+      <td width="60%">Specifies the Databinding framework. valid values are
+        xmlbeans, adb, jibx, and none. Default is adb.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-g</td>
+      <td width="20%">--generate-all</td>
+      <td width="60%">Generates all the classes. This option is valid only
+        with the -ss (server side code generation) option. When on, the
+        client code (stubs) will also be generated along with the
+      skeleton.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-u</td>
+      <td width="20%">--unpack-classes</td>
+      <td width="60%">Unpack classes. This option specifies whether to unpack
+        the classes and generate separate classes for the databinders.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-sn</td>
+      <td width="20%">--service-name</td>
+      <td width="60%">Specifies the service name to be code generated. If the
+        service name is is not specified, then the first service will be
+        picked</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-pn</td>
+      <td width="20%">--port-name</td>
+      <td width="60%">Specifies the port name to be code generated. If the
+        port name is is not specified, then the first port (of the selected
+        service) will be picked</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-ns2p</td>
+      <td width="20%">--namespace2package</td>
+      <td width="60%">Specifies a comma seperated list of namespaces and
+        packages where the given package will be used in the place of the
+        auto generated package for the relevant namespace. The list will be
+        the format of ns1=pkg1,ns2=pkg2.</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td width="20%">-ssi</td>
+      <td width="20%">--serverside-interface</td>
+      <td width="60%">Generate an interface for the service skeleton 
+</td>
+      <td></td>
+    </tr>
+  </tbody>
+</table>
+
+<p>Apart from these mentioned options one can pass extra option by prefixing
+them with -E (uppercase). These extra options will be processed by the
+extensions. The extra options that can be passed are documented separately
+with the extensions documentation (For example with ADB)</p>
+<a name="ant"></a>
+
+<h2>Ant Task</h2>
+
+<p>The code generator also comes bundled with an Ant task. The ant task is
+implemented by the org.apache.axis2.tool.ant.AntCodegenTask class. Following
+are the ant task attributes.</p>
+<a name="antref"></a>
+
+<h3>Ant Task Reference</h3>
+
+<table border="1" cellpadding="0" cellspacing="0"
+style="border-collapse: collapse" width="100%" id="AutoNumber2">
+  <tbody>
+    <tr>
+      <td>wsdlfilename</td>
+      <td>WSDL file location. Maps to the uri option of the command line
+      tool</td>
+    </tr>
+    <tr>
+      <td>output</td>
+      <td>output file location. This is where the files would be copied once
+        the code generation is done. If this option is omitted the generated
+        files would be copied to the working directory. . Maps to the -o
+        option of the command line tool</td>
+    </tr>
+    <tr>
+      <td>language</td>
+      <td>Output language. Currently the code generator can generate code in
+        Java. Maps to the -l option of the command line tool</td>
+    </tr>
+    <tr>
+      <td>packagename</td>
+      <td>The target package name. If omitted, a default package (formed
+        using the target namespace of the WSDL) will be used. Maps to the -p
+        option of the command line tool.</td>
+    </tr>
+    <tr>
+      <td>asynconly</td>
+      <td>Generate code only for async style . when this option is used the
+        generated stubs will have only the asynchronous invocation methods.
+        Defaults to false if omitted Only true and false are applicable as
+        values. Maps to the -a option of the command line tool.</td>
+    </tr>
+    <tr>
+      <td>testcase</td>
+      <td>Generates a test case</td>
+    </tr>
+    <tr>
+      <td>synconly</td>
+      <td>Generate code only for sync style . when this option is used the
+        generated stubs will have only the synchronous invocation methods.
+        Defaults to false if omitted. Only true and false are applicable as
+        values. Maps to the -s option of the command line tool.</td>
+    </tr>
+    <tr>
+      <td>serverside</td>
+      <td>Generates server side code (i.e. skeletons). Only true and false
+        are applicable as values. Default is false. Maps to the -ss option of
+        the command line tool</td>
+    </tr>
+    <tr>
+      <td>generateservicexml</td>
+      <td>Generates server side code (i.e. skeletons). Only true and false
+        are applicable as values. Default is false. Maps to the -sd option of
+        the command line tool.</td>
+    </tr>
+    <tr>
+      <td>unpackClasses</td>
+      <td>Unpacks the generated classes. This forces the databinding classes
+        to be generated separately, which otherwise would have been generated
+        as inner classes.</td>
+    </tr>
+    <tr>
+      <td>serviceName</td>
+      <td>The name of the service in the case of multiple services</td>
+    </tr>
+    <tr>
+      <td>portName</td>
+      <td>The name of the port in the presence of multiple ports</td>
+    </tr>
+    <tr>
+      <td>namespaceToPackages</td>
+      <td>A list of namespace to package mappings</td>
+    </tr>
+<tr>
+      <td>serverSideInterface</td>
+      <td>flag stating whether to generate an interface for the server side skeleton</td>
+    </tr>
+  </tbody>
+</table>
+<a name="example"></a>
+
+<h3>Example Build File Using the Custom Ant Task</h3>
+
+<p>Following is an example ant build file that uses the custom Ant task.</p>
+<pre>&lt;?xml version="1.0"?&gt;
+&lt;project name="CodegenExample" default="main" basedir="."&gt;
+&lt;target name="declare" &gt;
+&lt;taskdef name="codegen"
+ classname="org.apache.axis2.tool.ant.AntCodegenTask"
+ classpath="classes"/&gt;
+&lt;/target&gt;
+&lt;target name="main" depends="declare"&gt;
+&lt;codegen 
+ wsdlfilename="C:\test\wsdl\CombinedService.wsdl"
+ output="C:\"
+ serverside="true"
+ generateservicexml="true"/&gt;
+&lt;/target&gt;
+&lt;/project&gt;</pre>
+
+<p>Notice the main target that uses the "codegen" task which will use the
+org.apache.axis2.tool.ant.AntCodegenTask class and run the code generation
+tool internally while passing the relevant arguments and do the proper
+generation. If a user types</p>
+
+<p>&gt;ant or &gt;ant main</p>
+
+<p>it will generate the server side code and services.xml for the given WSDL
+file(C:\test\wsdl\CombinedService.wsdl) and the generated code will be
+written to C:\ directory.</p>
+
+<p>For this Ant task to work the following jars need to be in the class
+path.</p>
+<ul>
+  <li>axis-*.jar (from the Axis2 distribution)</li>
+  <li>axis-wsdl4j-1.2.jar or higher (The WSDL4J implementation jar. Bundled
+    with the Axis2 distribution)</li>
+  <li>stax-api-1.0.jar (The StAX API's that contain the
+    javax.xml.namespace.QName class. This jar may be replaced by any other
+    jar that contains the javax.xml.namespace.QName implementation. However
+    Axis2 uses this class from the stax-api-1.0.jar which comes bundled with
+    the Axis2 distribution)</li>
+</ul>
+<a name="invoking"></a>
+
+<h3>Invoking the Code Generator From Ant</h3>
+
+<p>Since the users may find altering their ant class path a bit daunting they
+can also follow an easier technique. The code generator main class can be
+invoked directly through the build file.</p>
+
+<p>Below is an example of a full build.xml needed to run WSDL2Java and
+generate the Java source files, compile the sources, and build an AAR file
+ready for deployment:</p>
+<pre class="code">&lt;!DOCTYPE project&gt;
+
+&lt;project name="wsdl2java-example" default="usage" basedir="."&gt;
+
+  &lt;property name="project-name" value="wsdl2java-example"/&gt;
+  &lt;property file="build.properties"/&gt;
+  
+  &lt;property name="build" value="build"/&gt;
+  &lt;property name="src" value="src"/&gt;
+  &lt;property name="build.classes"      value="build/classes" /&gt;
+
+  &lt;path id="axis.classpath"&gt;
+     &lt;pathelement location="build/classes" /&gt;
+     &lt;fileset dir="${axis.home}/lib"&gt;
+       &lt;include name="**/*.jar" /&gt;
+     &lt;/fileset&gt;
+     &lt;pathelement location="${build.classes}" /&gt;
+  &lt;/path&gt;
+
+  &lt;path id="axis_client.classpath"&gt;
+     &lt;pathelement location="build/classes" /&gt;
+     &lt;fileset dir="${axis.home}"&gt;
+       &lt;include name="**/*.jar" /&gt;
+     &lt;/fileset&gt;
+     &lt;fileset dir="lib"&gt;
+       &lt;include name="*.jar" /&gt;
+     &lt;/fileset&gt;
+     &lt;pathelement location="${build.classes}" /&gt;
+  &lt;/path&gt;
+
+  &lt;target name="usage" description="Build file usage info (default task)"&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message="${project-name} " /&gt;
+    &lt;echo message="-------------------------------------------------------" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message="Available Targets:" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" Compiling:" /&gt;
+    &lt;echo message="  compile           - Compiles the WSDL2Java source code" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" Compiling client:" /&gt;
+    &lt;echo message="  compile_client           - Compiles the client source code" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" Cleaning up:" /&gt;
+    &lt;echo message="  clean             - Delete class files" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" WSDL:" /&gt;
+    &lt;echo message="  wsdl2java               - Generate source from WSDL" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" AAR:" /&gt;
+    &lt;echo message="  aar               - Generate an .aar for deployment into WEB-INF/services" /&gt;
+    &lt;echo message=" " /&gt;
+    &lt;echo message=" Executing:" /&gt;
+    &lt;echo message="  runLogin               - Execute the runLogin client" /&gt;
+  &lt;/target&gt;
+
+  &lt;target name="prepare" &gt;
+    &lt;mkdir dir="${build.classes}" /&gt;
+  &lt;/target&gt;
+
+  &lt;target name="clean" &gt;
+     &lt;delete dir="${build}" /&gt;
+     &lt;delete dir="${dist}" /&gt;
+  &lt;/target&gt;
+
+  &lt;target name="compile"&gt;
+    &lt;echo message="Compiling wsdl2 files"/&gt;
+
+    &lt;javac
+     srcdir="output"
+     destdir="${build.classes}"
+     deprecation="true"
+     failonerror="true" debug="true"
+    &gt;
+
+     &lt;classpath refid="axis.classpath"/&gt; 
+    &lt;/javac&gt;
+
+  &lt;/target&gt;
+
+  &lt;target name="wsdl2java" depends="clean,prepare"&gt;
+      &lt;delete dir="output" /&gt;
+      &lt;java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true"&gt;
+          &lt;classpath refid="axis.classpath"/&gt; 
+          &lt;arg value="-d"/&gt;
+          &lt;arg value="xmlbeans"/&gt;
+          &lt;arg value="-uri"/&gt;
+          &lt;arg file="wsdl/LoginEndpoint.wsdl"/&gt;
+          &lt;arg value="-ss"/&gt;
+          &lt;arg value="-g"/&gt;
+          &lt;arg value="-sd"/&gt;
+          &lt;arg value="-o"/&gt;
+          &lt;arg file="output"/&gt;
+          &lt;arg value="-p"/&gt;
+          &lt;arg value="org.example.types"/&gt;
+      &lt;/java&gt;
+
+      &lt;!-- Move the schema folder to classpath--&gt;
+      &lt;move todir="${build.classes}"&gt;
+          &lt;fileset dir="output/resources"&gt;
+              &lt;include name="**/*schema*/**/*.class"/&gt;
+              &lt;include name="**/*schema*/**/*.xsb"/&gt;
+          &lt;/fileset&gt;
+      &lt;/move&gt;
+
+  &lt;/target&gt;
+
+  &lt;target name="jar_wsdl" depends="compile"&gt;
+          &lt;jar jarfile="lib/axis2_example_wsdl.jar" &gt;
+              &lt;fileset dir="${build.classes}" /&gt;
+          &lt;/jar&gt;
+  &lt;/target&gt;
+  
+  &lt;!-- build an .aar file for axis2 web services --&gt;
+  &lt;target name="aar" depends="compile"&gt;
+     &lt;delete dir="${build.classes}/META-INF" /&gt;
+     &lt;mkdir dir="${build.classes}/META-INF" /&gt;
+     &lt;copy todir="${build.classes}/META-INF" &gt;
+       &lt;fileset dir="output/resources" &gt;
+         &lt;!-- axis2 web services definitions file --&gt;
+         &lt;include name="services.xml"/&gt;
+       &lt;/fileset&gt;
+       &lt;fileset dir="wsdl" &gt;
+         &lt;include name="LoginEndpoint.wsdl"/&gt;
+       &lt;/fileset&gt;
+     &lt;/copy&gt;
+     &lt;jar jarfile="dist/LoginEndpoint.aar" &gt;
+       &lt;fileset dir="${build.classes}" /&gt;
+     &lt;/jar&gt;
+  &lt;/target&gt;
+
+  &lt;target name="compile_client"&gt;
+    &lt;echo message="Compiling client files"/&gt;
+
+    &lt;javac
+     srcdir="src"
+     destdir="${build.classes}"
+     deprecation="true"
+     failonerror="true" debug="true"
+    &gt;
+
+     &lt;classpath refid="axis.classpath"/&gt; 
+    &lt;/javac&gt;
+
+  &lt;/target&gt;
+
+  &lt;target name="runLogin" depends="prepare,compile_client" description="run simple Login client"&gt;
+     &lt;java classname="org.client.LoginClient" &gt;
+     &lt;classpath refid="axis_client.classpath"/&gt;
+    &lt;/java&gt;
+  &lt;/target&gt;
+
+&lt;/project&gt;</pre>
+
+<p>The above build.xml depends on a build.properties file which defines
+'axis.home', such as:</p>
+
+<p>axis.home=/home/username/axis2-1.0-bin/</p>
+
+<p>The above build.xml example also assumes three empty directories exist,
+'dist', 'lib', and 'src'.</p>
+
+<p>Below is a validated WSDL Document following the Document/Literal Style.
+The name of this file matches the name used in the WSDL2Java ant task above,
+LoginEndpoint.wsdl</p>
+<pre class="code">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+
+&lt;definitions name="LoginService" targetNamespace="http://login" xmlns:tns="http://login" 
+xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
+xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns2="http://login/types"&gt;
+
+  &lt;types&gt;
+    &lt;schema targetNamespace="http://login/types" xmlns:tns="http://login/types" 
+    xmlns:soap11-enc="http://schemas.xmlsoap.org/soap/encoding/" 
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
+    xmlns="http://www.w3.org/2001/XMLSchema"&gt;
+      &lt;import namespace="http://schemas.xmlsoap.org/soap/encoding/"/&gt;
+      &lt;element name="returnWebLoginElement"&gt;
+        &lt;complexType&gt;
+          &lt;sequence&gt;
+
+            &lt;element ref="tns:soap_session_idElement"/&gt;
+            &lt;element ref="tns:web_user_nameElement"/&gt;
+          &lt;/sequence&gt;
+        &lt;/complexType&gt;
+      &lt;/element&gt;
+      &lt;element name="webLoginElement"&gt;
+
+        &lt;complexType&gt;
+          &lt;sequence&gt;
+            &lt;element ref="tns:user_nameElement"/&gt;
+            &lt;element ref="tns:user_passwordElement"/&gt;
+          &lt;/sequence&gt;
+        &lt;/complexType&gt;
+
+      &lt;/element&gt;
+      &lt;element name="user_nameElement" type="xsd:string"/&gt;
+      &lt;element name="user_passwordElement" type="xsd:string"/&gt;
+      &lt;element name="soap_session_idElement" type="xsd:string"/&gt;
+      &lt;element name="web_user_nameElement" type="xsd:string"/&gt;
+&lt;/schema&gt;&lt;/types&gt;
+
+  &lt;message name="LoginEndpoint_webLogin"&gt;
+     &lt;part name="parameters" element="ns2:webLoginElement"/&gt;
+  &lt;/message&gt;
+  &lt;message name="LoginEndpoint_webLoginResponse"&gt;
+    &lt;part name="result" element="ns2:returnWebLoginElement"/&gt;
+  &lt;/message&gt;
+
+  &lt;portType name="LoginEndpoint"&gt;
+    &lt;operation name="webLogin"&gt;
+      &lt;input message="tns:LoginEndpoint_webLogin" name="LoginEndpoint_webLogin"/&gt;
+      &lt;output message="tns:LoginEndpoint_webLoginResponse" name="LoginEndpoint_webLoginResponse"/&gt;
+    &lt;/operation&gt;
+  &lt;/portType&gt;
+
+  &lt;binding name="LoginEndpointBinding" type="tns:LoginEndpoint"&gt;
+    &lt;soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/&gt;
+    &lt;operation name="webLogin"&gt;
+      &lt;soap:operation soapAction="webLogin"/&gt;
+      &lt;input name="LoginEndpoint_webLogin"&gt;
+        &lt;soap:body use="literal"/&gt;
+
+      &lt;/input&gt;
+      &lt;output name="LoginEndpoint_webLoginResponse"&gt; 
+        &lt;soap:body use="literal"/&gt;
+      &lt;/output&gt;
+    &lt;/operation&gt;
+  &lt;/binding&gt;
+
+  &lt;service name="LoginService"&gt;
+    &lt;port name="LoginEndpointPort" binding="tns:LoginEndpointBinding"&gt;
+      &lt;soap:address location="http://localhost:8080/axis2/services/LoginService"/&gt;&lt;/port&gt;
+      &lt;/service&gt;&lt;/definitions&gt;</pre>
+
+<p>Place the above file, named LoginEndpoint.wsdl, in the directory 'wsdl'
+below the build.xml file. Run the WSDL2Java command via the ant task defined
+above, and there will be a directory called 'output' created. This directory
+contains the WSDL2Java generated source. An important detail is that an
+XMLBean class file is also generated by WSDL2Java, TypeSystemHolder.class.
+That file is placed into build/classes by the above ant task and will be
+needed to compile the generated sources. A frequent problem is users get an
+error such as:</p>
+
+<p>ClassNotFoundException : Cannot load SchemaTypeSystem. Unable to load
+class with name
+schemaorg_apache_xmlbeans.system.s68C41DB812F52C975439BA10FE4FEE54.TypeSystemHolder.
+Make sure the generated binary files are on the classpath.</p>
+
+<p>The TypeSystemHolder.class generated by WSDL2Java must be placed in your
+classpath in order to avoid this error.</p>
+
+<p>The next step is to modify the generated Skeleton Java Source file - the
+Web service. This file as generated returns null and needs to be updated to
+contain the business logic.</p>
+
+<p>After the WSDL2Java command runs the file LoginEndpoint.wsdl, edit the
+following file:</p>
+
+<p>output/org/example/types/LoginServiceSkeleton.java. You should see the
+following code:</p>
+<pre class="code">/**
+     * LoginServiceSkeleton.java
+     *
+     * This file was auto-generated from WSDL
+     * by the Apache Axis2 version: 1.0-RC4 Apr 28, 2006 (05:23:23 IST)
+     */
+    package org.example.types;
+    /**
+     *  LoginServiceSkeleton java skeleton for the axisService
+     */
+    public class LoginServiceSkeleton {
+     
+                 
+        /**
+         * Auto generated method signature
+         
+          * @param param0
+         
+         */
+        public  login.types.ReturnWebLoginElementDocument webLogin
+                  (login.types.WebLoginElementDocument param0 )
+         
+           {
+                //Todo fill this with the necessary business logic
+                throw new  java.lang.UnsupportedOperationException();
+        }
+     
+    }</pre>
+
+<p>Replace the contents of this file with the following, which uses the
+complex types generated by WSDL2Java and the example wsdl file:</p>
+<pre class="code">/**
+ * LoginServiceSkeleton.java
+ *
+ * This file was auto-generated from WSDL
+ * by the Apache Axis2 version: 1.0-RC4 Apr 28, 2006 (05:23:23 IST)
+ */
+package org.example.types;
+import login.types.ReturnWebLoginElementDocument;
+import login.types.ReturnWebLoginElementDocument.*;
+import login.types.WebLoginElementDocument;
+import login.types.WebLoginElementDocument.*;
+
+/**
+ *  Auto generated java skeleton for the service by the Axis code generator
+ */
+public class LoginServiceSkeleton {
+ 
+    /**
+     * Auto generated method signature
+     
+      * @param webLoginElementDocument changed from param0
+     
+     */
+    public ReturnWebLoginElementDocument webLogin
+       (WebLoginElementDocument webLoginElementDocument ){
+
+            //Todo fill this with the necessary business logic
+            System.out.println("LoginServiceSkeleton.webLogin reached successfully!");
+
+            // Get parameters passed in 
+            WebLoginElement webLoginElement = webLoginElementDocument.getWebLoginElement();
+            String userName = webLoginElement.getUserNameElement();
+            String password = webLoginElement.getUserPasswordElement();
+            System.out.println("LoginServiceSkeleton.webLogin userName: " + userName);
+            System.out.println("LoginServiceSkeleton.webLogin password: " + password);
+     
+            // input paramaters would be used here 
+    
+            // prepare output
+            ReturnWebLoginElementDocument retDoc =
+                ReturnWebLoginElementDocument.Factory.newInstance();
+            
+            ReturnWebLoginElement retElement = ReturnWebLoginElement.Factory.newInstance();
+            
+            retElement.setWebUserNameElement("joe sixpack");
+            retElement.setSoapSessionIdElement("some_random_string");
+            System.out.println("validate retElement: " + retElement.validate());
+
+            retDoc.setReturnWebLoginElement(retElement);
+            System.out.println("validate retDoc: " + retDoc.validate());
+            
+            System.out.println("LoginServiceSkeleton.webLogin returning...");
+    
+            return retDoc; 
+
+    }
+}</pre>
+
+<p>The next steps assume the axis2.war has been deployed and has expanded in
+a servlet container.</p>
+
+<p>Run the 'jar_wsdl' ant task from the example build.xml, which generates a
+jar file lib/axis2_example_wsdl.jar in the 'lib' directory under the
+build.xml . This jar will be used to compile the client, and also will be
+placed in the servlet container. Next, run the 'aar' ant task from the
+example build.xml, which generates the deployable axis2 Web service. Place
+dist/LoginEndpoint.aar into axis2/WEB-INF/services . Place
+lib/axis2_example_wsdl.jar into axis2/WEB-INF/lib . Verify the happy axis
+page loaded the services correctly - there should be the service
+'LoginEndpoint' with the available operation 'webLogin' displayed.</p>
+
+<p>The last step is to create and run the client. In the src directory create
+the file org.client.LoginClient.java, with the contents below:</p>
+<pre class="code">package org.client;
+
+import org.apache.axis2.AxisFault;
+
+import login.types.ReturnWebLoginElementDocument;
+import login.types.ReturnWebLoginElementDocument.*;
+import login.types.WebLoginElementDocument;
+import login.types.WebLoginElementDocument.*;
+import org.example.types.LoginServiceStub;
+
+/**
+ * Login.
+ *
+ */
+public class LoginClient {
+
+    public static void main(String[] args) {
+        try {
+
+            System.out.println("webLogin, firing...");
+            LoginServiceStub stub = new LoginServiceStub();
+                    
+            WebLoginElementDocument webLoginElementDocument 
+                = WebLoginElementDocument.Factory.newInstance();
+            WebLoginElement webLoginElement = 
+                WebLoginElement.Factory.newInstance();
+            webLoginElement.setUserNameElement("joe");
+            webLoginElement.setUserPasswordElement("sixpack");
+            
+            webLoginElementDocument.setWebLoginElement(webLoginElement);
+            
+            System.out.println("validate: " +  webLoginElement.validate());
+             stub.webLogin(webLoginElementDocument);
+ 
+            ReturnWebLoginElementDocument returnWebLoginElementDocument = 
+                stub.webLogin(webLoginElementDocument);
+
+            System.out.println("Client returned");
+
+            ReturnWebLoginElementDocument.ReturnWebLoginElement
+                retElement = returnWebLoginElementDocument.getReturnWebLoginElement();
+
+            System.out.println("WebUserName: " + retElement.getWebUserNameElement());
+            System.out.println("SOAPSessionId: " + retElement.getSoapSessionIdElement());
+            System.out.println("webLogin, completed!!!");
+
+        } catch (AxisFault axisFault) {
+            axisFault.printStackTrace();
+        } catch (Exception ex) {
+            ex.printStackTrace();
+        }
+    }
+}</pre>
+
+<p>Now run the ant task 'ant runLogin' . The following output should
+appear:</p>
+<pre class="code">runLogin:
+     [echo] running the webLogin client
+     [java] webLogin, firing...
+     [java] validate: true
+     [java] Client returned
+     [java] WebUserName: joe sixpack
+     [java] SOAPSessionId: some_random_string
+     [java] webLogin, completed!!!</pre>
+<a name="appendix"></a>
+
+<h2>Appendix</h2>
+<ul>
+  <li>Eclipse reference - <a href="http://www.eclipse.org/">
+    http://www.eclipse.org/</a></li>
+  <li>Custom Ant Tasks - <a href="http://ant.apache.org/manual/develop.html">
+    http://ant.apache.org/manual/develop.html</a></li>
+</ul>
+
+<p></p>
+
+<p></p>
+
+<p></p>
+
+<p></p>
+
+<p></p>
+</body>
+</html>

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServicePage1.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServicePage1.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServicePage1.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServiceWizardSelection.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServiceWizardSelection.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/ServiceWizardSelection.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/Thumbs.db
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/Thumbs.db?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/Thumbs.db
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/help.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/help.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/help.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen0.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen0.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen0.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen1.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen1.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen1.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen2.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen2.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen2.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen3.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen3.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/java2wsdl-screen3.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page2.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page2.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page2.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3_hl.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3_hl.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page3_hl.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_load.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_load.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_load.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_plain.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_plain.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_plain.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_search_declared.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_search_declared.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_search_declared.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_table.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_table.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page4_table.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_added.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_added.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_added.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_browsed.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_browsed.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_browsed.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_hl.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_hl.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_hl.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_remove.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_remove.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page5_remove.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page6.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page6.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/service_page6.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/success_msg.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/success_msg.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/success_msg.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen0.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen0.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen0.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen1.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen1.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen1.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen2.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen2.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen2.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen3.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen3.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen3.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen4.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen4.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/images/wsdl2java-screen4.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/servicearchiver-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/servicearchiver-plugin.html?view=auto&rev=448963
==============================================================================
--- webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/servicearchiver-plugin.html (added)
+++ webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/servicearchiver-plugin.html Fri Sep 22 08:23:22 2006
@@ -0,0 +1,149 @@
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Service Archive Generator Wizard - Eclipse Plug-in</title>
+</head>
+
+<body lang="en">
+<h1>Service Archive Generator Wizard - Eclipse Plug-in</h1>
+
+<p>This document will guide you through the installation and usage of the
+archive generator Eclipse plug-in.</p>
+
+<p><a href="http://ws.apache.org/axis2/tools/index.html"
+target="_blank">[Download Plugin Tool]</a></p>
+
+<h2>Content</h2>
+<ul>
+  <li><a href="#intro">Introduction</a></li>
+  <li><a href="#installation">Installation</a></li>
+  <li><a href="#operation">Operation</a></li>
+</ul>
+<a name="intro"></a>
+
+<h2>Introduction</h2>
+
+<p>As part of the Axis2 tool set, the service archive generator is an
+important tool that allows the generation of service archives ("aar" file or
+a "jar" files) that can be deployed as a web services to the Axis2.</p>
+<a name="installation"></a>
+
+<h2>Installation</h2>
+
+<p>Download the binary version of the plug-in and extract the content of the
+zip file into the Eclipse installation folder. (The plug-in will actually go
+into the plugins directory in the Eclipse installation root). Restarting
+Eclipse will set the plug-in automatically.</p>
+<a name="operation"></a>
+
+<h2>Operation</h2>
+
+<p>If the plug-in is properly installed you should see a new wizard under the
+"New" section. (Use the File -&gt; New -&gt; Other or Ctrl + N )</p>
+
+<p align="center"><img border="0" src="images/ServiceWizardSelection.jpg"></p>
+
+<p>Selecting the wizard and pressing the "Next" button will start the service
+generator wizard. Following is the first page of the wizard.</p>
+
+<p><strong>Page 1:</strong></p>
+
+<p align="center"><img border="0" src="images/ServicePage1.jpg"></p>
+
+<p>Once the class file folderĀ (which should be a folder in the file system)
+is browsed and selected, the "Next" button will be enabled and you can move to
+the next page. Note that you have the option of either including all the
+files or the class files only of the folder on page 1.</p>
+
+<p><strong>Page 2:</strong></p>
+
+<p>Page 2 of the wizard as seen below requires you to locate/browse the wsdl
+file. Note that the WSDL file cannot be skipped in this version of the
+tool.</p>
+
+<p align="center"><img border="0" src="images/service_page2.jpg"></p>
+
+<p><strong>Page 3:</strong></p>
+
+<p>Select the service.xml file on this wizard page by browsing or select the
+option of generating service xml automatically, after which you can click
+"Next" button to go to the next page. Notice how the browsing option disables
+when the "Generate service xml automatically" check box is ticked.</p>
+
+<p align="center"><img border="0" src="images/service_page3.jpg"></p>
+<!--
+<p>Note that The service XML file can be generated if needed. To proceed
+to the service generation page, check the "generate automatically" checkbox. </p>
+<p align="center"><img border="0" src="service_page3_hl.jpg"></p>
+
+<p>If the automatic mode is not selected then the wizard
+will directly jump to the library selection page. However if the automatic mode is selected the wizard will show the
+following page</p>
+<p align="center"><img border="0" src="service_page4_plain.JPG" width="500" height="500"></p>
+<p>This is a somewhat complicated page. The service name textbox should include the name of the service that you
+wish to give this service. 
+For the implementation class type in the fully qualified class name and hit the load button to view the operations</p>
+<p align="center"><img border="0" src="service_page4_load.JPG" ></p>
+<p> The loaded operations should be displayed in a table. Once this is displayed you can filter the methods by selecting/deselecting the methods using the checkbox at each row.</p>
+<p align="center"><img border="0" src="service_page4_table.JPG" width="500" height="500"></p>
+<p>Further filtering can be achieved by using the "search declared methods" only checkbox</p>
+<p align="center"><img border="0" src="service_page4_search_declared.JPG" ></p>
+<p>Once the method selection is complete the wizard has enough information to generate a basic services.xml file. If further customization is required, there's no choice but to manually edit it!</p>
+
+-->
+
+<p><strong>Page 4:</strong></p>
+<!--START-->
+
+<p>The next step is to add the libraries. The library addition page looks
+like this</p>
+
+<p align="center"><img border="0" src="images/service_page5.jpg"></p>
+
+<p>The library name (with full path) can be either typed on the text box or
+browsed for using the "Browse" button.</p>
+
+<p align="center"><img border="0" src="images/service_page5_browsed.jpg"></p>
+
+<p>Once there is a library name with full path on the text box, hit the "Add"
+button to add the library to the list. Added libraries should be displayed in
+the "Added libraries" list box. This way you can add as many external
+libraries as you wish. See the screen shots below.</p>
+
+<p align="center"><img border="0" src="images/service_page5_hl.jpg"></p>
+
+<p align="center"><img border="0" src="images/service_page5_added.jpg"></p>
+
+<p>If any added library needs to be removed, highlight it or in other words,
+select it from the "Added libraries" list and hit on the "Remove" button as shown
+below. Click on the "Next" button to proceed to the last page of the wizard.</p>
+
+<p align="center"><img border="0" src="images/service_page5_remove.jpg"></p>
+
+<p><strong>Page 5:</strong></p>
+
+<p>The last page of the wizard asks for the output file location and the
+output archive file name.</p>
+
+<p></p>
+
+<p align="center"><img border="0" src="images/service_page6.jpg"></p>
+
+<p>Once all the parameters are filled, hit the "Finish" button to complete the
+wizard and generate the service archive.</p>
+
+<p align="center"><img border="0" src="images/success_msg.jpg"></p>
+
+<p>If you see the above message, then you've successfully generated the
+service archive! This service archive can be hot deployed (deployed at run
+time) to the axis2</p>
+
+<h1>Appendix</h1>
+<ul>
+  <li>Eclipse reference - <a href="http://www.eclipse.org/" target="_blank">
+    http://www.eclipse.org/</a></li>
+  <li>Custom Ant TasksĀ  - <a href="http://ant.apache.org/manual/develop.html"
+    target="_blank"> http://ant.apache.org/manual/develop.html</a></li>
+</ul>
+</body>
+</html>

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/wsdl2java-plugin.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/wsdl2java-plugin.html?view=auto&rev=448963
==============================================================================
--- webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/wsdl2java-plugin.html (added)
+++ webservices/axis2/trunk/java/xdocs/tools/1_1/eclipse/wsdl2java-plugin.html Fri Sep 22 08:23:22 2006
@@ -0,0 +1,169 @@
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Code Generator Wizard - Eclipse Plug-in</title>
+</head>
+
+<body lang="en">
+<h1>Code Generator Wizard - Eclipse Plug-in</h1>
+
+<p>This document explains the usage of this code generator plug-in for
+Eclipse. In other words, this document will guide you through the operations
+of generating a WSDL file from a java class and/or generating a java class
+file from a WSDL file.</p>
+
+<p><a href="http://ws.apache.org/axis2/tools/index.html"
+target="_blank">[Download Plugin Tool]</a></p>
+
+<h2>Content</h2>
+<ul>
+  <li><a href="#intro">Introduction</a></li>
+  <li><a href="#installation">Installation</a></li>
+  <li><a href="#operation1">Operation - WSDL2Java</a></li>
+  <li><a href="#operation2">Operation - Java2WSDL</a></li>
+</ul>
+<a name="intro"></a>
+
+<h2>Introduction</h2>
+
+<p>The Axis2 code generator comes built-in with an <a
+href="http://www.eclipse.org">Eclipse</a> plug-in. This plug-in can be used
+to generate a WSDL file from a java class (Java2WSDL) and/or a java class
+file from a WSDL (WSDL2Java). First you need to install the plug-in. The
+instructions for the installation process are given below.</p>
+<a name="installation"></a>
+
+<h2>Installation</h2>
+
+<p>The easiest way to obtain the plug-in would be the binary distribution.
+The packages plug-in would be available from the tools section of the
+downloads page.</p>
+
+<p>If one needs to build the plugin from source, it is not as trivial as
+running the Maven build. The reason is that the plug-in depends heavily on
+the Eclipse classes, which are only available in an Eclipse environment. The
+recommended procedure is to run the create-project.xml (in the "modules\tool"
+directory of the source distribution) build file which will create two
+folders (the other one for the Service Archiver tool) and copy the necessary
+files to relevant folders. Then Eclipse should be configured to open the
+contents in a PDE project. Please go through the Eclipse documentation to
+learn how to open projects in the PDE format.</p>
+
+<p>Once you've obtained the plug-in just unzip the content of the plug-in
+archive to the Eclipse plug-in directory (if it is the zipped-binary version)
+or copy the necessary folders to the Eclipse plug-in directory and restart
+Eclipse.</p>
+
+<p><strong>NOTE</strong> : This plug-in works on Eclipse version 3.1 and
+upwards. The provided screen shots may slightly differ with what the user
+would actually see but the functionality has not been changed.</p>
+<a name="operation1"></a>
+
+<h2>Operation - WSDL2Java</h2>
+
+<p>If the plug-in is properly installed you should see a new wizard under the
+"New" section.(use the File -&gt; New -&gt; Other or Ctrl + N )</p>
+
+<p><img border="0" src="images/wsdl2java-screen0.jpg"></p>
+
+<p>Selecting the wizard and pressing the "Next" button will start the code
+generator wizard. Following is the first wizard page.</p>
+
+<p><strong>Page 1:</strong></p>
+
+<p><img src="images/wsdl2java-screen1.jpg"></p>
+
+<p>Selecting the "Generate Java source code from WSDL file" option and
+clicking "Next" leads to the following page.</p>
+
+<p><strong>WSDL2Java Page 2 :</strong></p>
+
+<p><img border="0" src="images/wsdl2java-screen2.jpg"></p>
+
+<p>To move on to the next page the WSDL file location must be given. The
+"Browse" button can be used to easily browse for a file rather than typing the
+whole path.</p>
+
+<p><strong>WSDL2Java Page 3 :</strong></p>
+
+<p>Once the WSDL file is selected, the next page will take you to the page
+from where <strong>codegen options</strong> are to be selected. By far this
+is the most important page in this wizard. This page determines the
+characteristics of the code being generated.</p>
+
+<p>Novices need not worry about these options since the most common options
+are defaulted, but advanced users will find it very easy to "turn the knobs"
+using these options.</p>
+
+<p><img border="0" src="images/wsdl2java-screen3.jpg"></p>
+
+<p>Once the options are selected, only the final step of the code generation
+is left which is the selection of the output file location.</p>
+
+<p><strong>WSDL2Java Page 4 :</strong></p>
+
+<p>Here you can select the output file path by typing or browsing using the
+"Browse" button. You have the option of browsing only workspace projects by
+selecting the "Browse Workspace projects only" checkbox.</p>
+
+<p><img border="0" src="images/wsdl2java-screen4.jpg"></p>
+
+<p>When the output file location is selected, the "Finish" button will be
+enabled. Clicking the "Finish" button will generate the code and a message box
+will pop up acknowledging the success. Well Done! You've successfully
+completed Axis2 code generation.</p>
+<a name="operation2"></a>
+
+<h2>Operation - Java2WSDL</h2>
+
+<p><strong>Page 1:</strong></p>
+
+<p>For this operation you need to select the option which says "Generate a
+WSDL from a Java source file"</p>
+
+<p><img border="0" src="images/java2wsdl-screen0.jpg"></p>
+
+<p>Then click the "Next" button which will lead to the next page below.</p>
+
+<p><strong>Java2WSDL Page 2:</strong></p>
+
+<p><img border="0" src="images/java2wsdl-screen1.jpg"></p>
+
+<p>In this page one needs to select the class to be exposed and the relevant
+jar files /classes to be loaded as the classpath. After the libraries have
+been set, the "Test Class Loading" button must be clicked in order to test
+whether the class is loadable. Unless the class loading is successful
+proceeding to the "Next" button will not be enabled.</p>
+
+<p>Once the classloading is successful and "Next" button is clicked the page
+below will appear.</p>
+
+<p><strong>Java2WSDL Page 3:</strong></p>
+
+<p>This page allows the parameters to be modified by setting the options for
+the generator.</p>
+
+<p><img border="0" src="images/java2wsdl-screen2.jpg"></p>
+
+<p><strong>Java2WSDL Page 4:</strong></p>
+
+<p>Output file location can be browsed using the "Browse" button. Note that by
+selecting "Browse Workspace projects only" check box you can browse for
+workspace projects only. Once output file location and output WSDL file name
+is add you can click the "Finish" button to complete generation.</p>
+
+<p><img border="0" src="images/java2wsdl-screen3.jpg"></p>
+
+<p>If a message box pops up acknowledging the success, then you've
+successfully completed the Java2WSDL code generation. </p>
+
+<h1>Appendix</h1>
+<ul>
+  <li>Eclipse reference - <a href="http://www.eclipse.org/">
+    http://www.eclipse.org/</a></li>
+  <li>Custom Ant Tasks&#xa0; - <a
+    href="http://ant.apache.org/manual/develop.html">
+    http://ant.apache.org/manual/develop.html</a></li>
+</ul>
+</body>
+</html>

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/Idea_plug-in_userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/Idea_plug-in_userguide.html?view=auto&rev=448963
==============================================================================
--- webservices/axis2/trunk/java/xdocs/tools/1_1/idea/Idea_plug-in_userguide.html (added)
+++ webservices/axis2/trunk/java/xdocs/tools/1_1/idea/Idea_plug-in_userguide.html Fri Sep 22 08:23:22 2006
@@ -0,0 +1,329 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+      "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
+  <meta content="text/html; charset=iso-8859-1">
+  <title>How to use IDEA plug-in</title>
+  <meta name="generator" content="amaya 9.2.1, see http://www.w3.org/Amaya/">
+</head>
+
+<body lang="en">
+<h1>Code Generator Wizard- IntelliJ IDEA Plug-in</h1>
+
+<p>This document explains installation and usage of IDEA code generation
+plug-in to create service archives and generate java class files from WSDL
+files.</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 &amp; Sub Wizard 2</a></li>
+      <li><a href="#sub3">Sub Wizard 3</a></li>
+    </ul>
+  </li>
+</ul>
+<a name="intro"></a>
+
+<h2>Introduction</h2>
+
+<p>Using this IntelliJ IDEA plug-in you can either create a service archive
+that can be deployed as a Web service to the Axis2 or generate a java class
+file from a WSDL file. Installation process is described first here followed
+by the above mentioned operations.</p>
+<a name="installation"></a>
+
+<h2>Installation</h2>
+
+<p>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 in
+IDEA installation directory or plugins directory in user directory
+(user/idea/conf/plugins). If you have correctly extracted the file you would
+see a directory called Axis2 in which there should be only one directory
+called lib containing a few .jar files.</p>
+
+<p>Next step is to restart IDEA so that the changes can take place. If the
+plug-in has been installed correctly, when you restart IDEA you will see
+following icons in IDEA .</p>
+
+<p><img alt="Figure 1" src="images/idea-icons.jpg"></p>
+
+<p>Also if you right-click on editor page of IDEA you would see a link to the
+same plug-in.</p>
+
+<p><img alt="Figure2" src="images/idea-popup.jpg"></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"></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
+codegeneration".</p>
+
+<h2><a name="WSDL2Java_Code_Generation">WSDL2Java Code Generation</a></h2>
+
+<p>Select "WSDL2Java codegeneration" 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"></p>
+
+<p>To move on to the next page the WSDL file location must be given. 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><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>Novices need not worry about these options since the most common options
+are defaulted. Advanced users will find it very easy to "turn the knobs"
+using these options.</p>
+
+<p><img alt="Figure5" src="images/fig18.jpg"></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>Since Axis2 supports both synchronous and asynchronous client
+    programming model, the tool has provided a way to select one of the two
+    from this page.</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>
+</ul>
+
+<p><strong>WSDL2Java Page 4:</strong></p>
+
+<p><img alt="Figure6" src="images/fig3.jpg"></p>
+
+<p>You can simply 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"></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>
+
+<h2>Create a Service Archive</h2>
+
+<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/fig5.jpg"></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"></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>
+<a name="sub12"></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, from where you compile output location. You do not need to type
+path, simply browse and select.</p>
+
+<p><img alt="fig7" src="images/fig7.jpg"></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 and service WSDL
+files. In the case of a service group you can add any number of WSDL files
+depending on the services in the service group. 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"></p>
+
+<p>To add libraries first click on the small (...) 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 small (...) button to browse for WSDL file
+and then click the "Add" button to add the file to the list.</p>
+
+<p>See page below:</p>
+
+<p><img alt="fig9" src="images/fig9.jpg"></p>
+
+<p>After adding external libraries and service WSDL files click on the "Done"
+button and then 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<em></em> from the "Class location selection" window, the public methods
+which are available in the selected<em></em> class file will not be
+loaded.</p>
+
+<p><img alt="fig10" src="images/fig10.jpg"></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<em></em> the
+system.</p>
+
+<p>When you have completed this particular service click on the button
+"Done". In the case of a service group when you click on the "Done" button
+for that particular service the following dialog will appear with option to
+add more service(s) to a service group.</p>
+
+<p><img alt="fig11" src="images/fig11.jpg"></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 &#x201c;I already have services.xml&#x201d;) or the one generated
+by the system (in the case of "generate services.xml")</p>
+
+<p><img alt="fig12" src="images/fig12.jpg"></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<em> </em>or<em> </em>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"></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>Like wise, 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"></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"></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"></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.</strong></em></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"></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 edit the services.xml 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>
+</body>
+</html>

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/Thumbs.db
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/Thumbs.db?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/Thumbs.db
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig1.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig1.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig1.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig10.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig10.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig10.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig11.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig11.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig11.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig12.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig12.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig12.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig13.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig13.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig13.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig14.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig14.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig14.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig15.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig15.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig15.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig16.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig16.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig16.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig17.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig17.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig17.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig18.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig18.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig18.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig2.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig2.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig2.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig3.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig3.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig3.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig4.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig4.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig4.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig5.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig5.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig5.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig6.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig6.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig6.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig7.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig7.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig7.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig8.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig8.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig8.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig9.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig9.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/fig9.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-icons.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-icons.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-icons.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-popup.jpg
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-popup.jpg?view=auto&rev=448963
==============================================================================
Binary file - no diff available.

Propchange: webservices/axis2/trunk/java/xdocs/tools/1_1/idea/images/idea-popup.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream



---------------------------------------------------------------------
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