You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by de...@apache.org on 2007/01/23 06:34:05 UTC

svn commit: r498925 [2/4] - in /webservices/axis2/trunk/java/xdocs: ./ 1_1/ 1_1/jibx/ download/1_1/ download/1_1_1/ modules/ modules/rampart/1_0/ modules/rampart/1_1/ modules/rampart/1_1/sec-conf/ modules/wss4j/0_94/0.94/ modules/wss4j/0_95/ modules/ws...

Modified: webservices/axis2/trunk/java/xdocs/1_1/pojoguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/pojoguide.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/pojoguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/pojoguide.html Mon Jan 22 21:34:03 2007
@@ -1,605 +1,605 @@
-<html lang="en">
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>POJO Web Services using Axis2</title>
-  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all" />
-</head>
-
-<body lang="en">
-<h1>POJO Web Services using Apache Axis2</h1>
-
-<p>Want a quick way to get a Web service up and running in no time? Well
-then, you should consider creating a Plain Old Java Object (POJO) to deploy
-using Apache Axis2 on Apache Tomcat. POJOs are fast to build and easy to
-maintain, meaning you'll save a lot of time building and debugging your code.
-This document shows you how to take a simple POJO, and deploy it on Apache
-Tomcat as a Web service in the exploded directory format. You'll also be
-shown how to take a POJO based on the Spring Framework, and deploy that as an
-AAR packaged Web service on Tomcat.</p>
-
-<h2>Content</h2>
-<ul>
-  <li><a href="#introduction">Introduction</a></li>
-  <li><a href="#pojo">The POJO</a></li>
-  <li><a href="#pojows">POJO Web service using Apache Axis2 and Tomcat</a>
-    <ul>
-      <li><a href="#definingservice">Defining the Service:
-      services.xml</a></li>
-    </ul>
-  </li>
-  <li><a href="#buildpojows">Building the POJO Web Service Using Ant</a></li>
-  <li><a href="#testingpojows">Testing the POJO Web Service Using
-    RPCServiceClient</a>
-    <ul>
-      <li><a href="#limitationspojo">Limitations and Strengths of
-      POJO</a></li>
-    </ul>
-  </li>
-  <li><a href="#springpojows">Spring-based POJO Web Service</a>
-    <ul>
-      <li><a href="#quickintro">Quick Introduction</a></li>
-      <li><a href="#servicedef">The Service Definition: services.xml</a></li>
-      <li><a href="#initializingspring">Initializing the Spring application
-        context: SpringInit</a></li>
-      <li><a href="#testingrpc">Testing Using an RPCServiceClient</a></li>
-    </ul>
-  </li>
-  <li><a href="#summary">Summary</a></li>
-  <li><a href="#furtherstudy">For Further Study</a></li>
-</ul>
-<a name="introduction"></a>
-
-<h2>Introduction</h2>
-
-<p>The task of building a Web service can sometimes be overwhelming, but not
-with POJOs! The old-school Plain Old Java Object is a simple and quick way to
-get most, if not all, of your currently existing Java classes up on the Web
-as readily accessible Web services. This document will show you how to build
-a POJO-style Web service with Apache Axis2 and Tomcat, organized as
-follows:</p>
-<ul>
-  <li>The POJO: This is the Java class that you'll use throughout this
-    document</li>
-  <li>POJO deployment</li>
-  <li>Test the POJO Web service using an RPC based client</li>
-  <li>Limitations of straight POJO</li>
-  <li>Spring-based POJO Web service and deployment</li>
-</ul>
-
-<p>The code for the document can be found at Axis2_HOME/samples/pojoguide
-&amp; Axis2_HOME/samples/pojoguidespring once you extract the <a
-href="../../download/1_1/download.html#std-bin">Axis2 Stadard
-Distribution</a>, and it might help to go grab it now to help you as you
-follow along. Let's get started.</p>
-<a name="pojo"></a>
-
-<h2>The POJO</h2>
-
-<p>The POJO you'll be using throughout this document is a Weather service
-POJO that consists of two classes: WeatherService and Weather. Weather
-contains the Weather data: Temperature, forecast, rain (will it rain?), and
-howMuchRain (See Code Listing 1).</p>
-
-<p><b>Code Listing 1: The Weather POJO</b></p>
-<pre>package sample.pojo.data;
-
-public class Weather{
-    float temperature;
-    String forecast;
-    boolean rain;
-    float howMuchRain;
-    
-    public void setTemperature(float temp){
-        temperature = temp;
-    }
-
-    public float getTemperature(){
-        return temperature;
-    }
-    
-    public void setForecast(String fore){
-        forecast = fore;
-    }
-
-    public String getForecast(){
-        return forecast;
-    }
-    
-    public void setRain(boolean r){
-        rain = r;
-    }
-
-    public boolean getRain(){
-        return rain;
-    }
-    
-    public void setHowMuchRain(float howMuch){
-        howMuchRain = howMuch;
-    }
-
-    public float getHowMuchRain(){
-        return howMuchRain;
-    }
-}</pre>
-
-<p>And here's the WeatherService class, shown in Code Listing 2.</p>
-
-<p><b>Code Listing 2: The WeatherService class</b></p>
-<pre>package sample.pojo.service;
-
-import sample.pojo.data.Weather;
-
-public class WeatherService{
-    Weather weather;
-    
-    public void setWeather(Weather weather){
-        this.weather = weather;
-    }
-
-    public Weather getWeather(){
-        return this.weather;
-    }
-}</pre>
-
-<p>Note that it's all just straight POJOs with field items and
-<code>getter</code> and <code>setter</code> methods for each field. Next,
-you'll take a look at what you need to do to make it ready for deployment on
-Apache Axis2 and Tomcat.</p>
-<a name="pojows"></a>
-
-<h2>POJO Web Service Using Apache Axis2 and Tomcat</h2>
-
-<p>Got the POJOs? Great. This section will show you how to package them in
-the exploded directory format for easy deployment. First you'll look at the
-services.xml file that defines the Web service, and then you'll build the
-files using <a href="http://ant.apache.org/">Apache Ant</a>, and deploy the
-Web service on Tomcat.</p>
-<a name="definingservice"></a>
-
-<h3>Defining the Service: services.xml</h3>
-
-<p>Before Axis2 can understand what is going on, you have to tell it to use
-the services.xml file. Let's get right into it (see Code Listing 3).</p>
-
-<p><b>Code Listing 3: The service definition file: services.xml</b></p>
-<pre>&lt;service name="WeatherService" scope="application"&gt;
-    &lt;description&gt;
-        Weather POJO Service
-    &lt;/description&gt;
-    &lt;messageReceivers&gt;
-        &lt;messageReceiver 
-            mep="http://www.w3.org/2004/08/wsdl/in-only"
-    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/&gt;
-        &lt;messageReceiver
-            mep="http://www.w3.org/2004/08/wsdl/in-out"
-    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/&gt;
-    &lt;/messageReceivers&gt;
-    &lt;parameter name="ServiceClass"&gt;
-        sample.pojo.service.WeatherService
-    &lt;/parameter&gt;
-&lt;/service&gt;</pre>
-
-<p>The name of the service is specified as WeatherService and the scope of
-the service is application. As you can see in the WeatherService POJO, there
-are two methods, an IN-ONLY method and a IN-OUT method, hence the ordering
-for the messageReceiver elements within the messageReceivers tag. Lastly, the
-ServiceClass parameter specifies the class of the Web service, which is
-sample.pojo.service.WeatherService. When operations of your Web service get
-called, the methods of the WeatherService class will be called. Next you'll
-take a look at an easy method of building your application using Ant.</p>
-<a name="buildpojows"></a>
-
-<h2>Building the POJO Web Service Using Apache Ant</h2>
-
-<p><a href="http://ant.apache.org/">Ant</a> is a slick build tool. It helps
-reduce time to build applications, and several of the Axis2 command-line
-tools create build.xml files for you, so that's why we'll use it here. We
-won't go into the build.xml file that you'll be using in too much detail, so
-here are the main Ant tasks you'll be using:</p>
-<ul>
-  <li>generate.service -- This Ant task builds all the service relevant
-    source and copies the files to build/WeatherService</li>
-  <li>rpc.client -- This task builds the client relevant files, builds a JAR
-    at <em>build/lib/rpc-client.jar</em>, and then runs the client</li>
-</ul>
-
-<p>Before you can build the source, however, you'll need to download the
-Axis2 1.1-bin and 1.1-war distributions <a
-href="../../download/1_1/download.html">here</a>. Then modify the following
-line inside the build.xml file (in the Axis2_HOME/samples/pojoguide directory
-in the extracted Axis2 1.1 Standard Binary (bin) Distribution) :</p>
-<pre>&lt;property name="axis2.home" value="c:\apps\axis2" /&gt;</pre>
-
-<p>This modification contains the path to the root of the unzipped Axis2
-1.1-bin <a href="../../download/1_1/download.html#std-bin">download</a>. With
-that explanation, you'll now build the source by typing the following: ant</p>
-
-<p>The following directory format should now exist at
-build/WeatherService:</p>
-<pre> - WeatherService
-   - META-INF
-     - services.xml
-   - sample
-     - pojo
-       - data
-         - Weather.class
-       - service
-         - WeatherService.class</pre>
-
-<p>Simple isn't it? An excellent way to dive into Web services
-development.</p>
-
-<p>Now get a <a href="http://tomcat.apache.org/">Tomcat</a> distribution (I
-used v5.5), and start it up by running <em>bin/startup.bat</em> or
-<em>bin/startup.sh</em>. Once it's running, deploy the Axis2 1.1-war by
-copying the axis2.war file to Tomcat's webapps directory. Tomcat will proceed
-by deploying axis2 and un-archive it into the webapps directory. Now copy the
-WeatherService directory created when building our project to:
-<em>&lt;tomcat-home&gt;/webapps/axis2/WEB-INF/services</em>.</p>
-
-<p>The service should quickly deploy, and you'll test the Web service using
-the RPCServiceClient in the next section.</p>
-<a name="testingpojows"></a>
-
-<h2>Testing the POJO Web Service Using RPCServiceClient</h2>
-
-<p>OK, so the Web service should be running on Tomcat. Now you'll build a
-simple RPCServiceClient and test the POJO Web service. You'll first start out
-with the class constructs, creating the RPCServiceClient and initializing the
-values of the Weather class within the Web service (See Code Listing 4).</p>
-
-<p><b>Code Listing 4: Setting the weather</b></p>
-<pre>package sample.pojo.rpcclient;
-
-import javax.xml.namespace.QName;
-
-import org.apache.axis2.AxisFault;
-import org.apache.axis2.addressing.EndpointReference;
-import org.apache.axis2.client.Options;
-import org.apache.axis2.rpc.client.RPCServiceClient;
-
-import sample.pojo.data.Weather;
-
-
-public class WeatherRPCClient {
-
-    public static void main(String[] args1) throws AxisFault {
-
-        RPCServiceClient serviceClient = new RPCServiceClient();
-
-        Options options = serviceClient.getOptions();
-
-        EndpointReference targetEPR = new EndpointReference(
-                <b>"http://localhost:8080/axis2/services/WeatherService");</b>
-        options.setTo(targetEPR);
-
-        // Setting the weather
-        QName opSetWeather =
-            new QName("http://service.pojo.sample/xsd", "<b>setWeather");
-
-        Weather w = new Weather();
-
-        w.setTemperature((float)39.3);
-        w.setForecast("Cloudy with showers");
-        w.setRain(true);
-        w.setHowMuchRain((float)4.5);
-
-        Object[] opSetWeatherArgs = new Object[] { w };
-
-        serviceClient.invokeRobust(opSetWeather, opSetWeatherArgs);</b>
-...</pre>
-
-<p>The most interesting code to note is in bold font. Notice the targetEPR
-variable you create, setting the endpoint reference to
-http://localhost:8080/axis2/services/WeatherService. This is where you
-deployed it on Axis2. You can also verify this by asking Axis2 to list its
-services by going to the following URL:
-http://localhost:8080/axis2/services/listServices.</p>
-
-<p>Next the opSetWeather variable gets setup, pointing to the setWeather
-operation. Then the Weather data gets created and initialized. Lastly, you
-invoke the Web service, which initializes the weather data (you'll verify
-this soon). Next you get back the weather data (see Code Listing 5).</p>
-
-<p><b>Code Listing 5: Getting the weather data</b></p>
-<pre>...
-        serviceClient.invokeRobust(opSetWeather, opSetWeatherArgs);
-
-        // Getting the weather
-        QName opGetWeather =
-            new QName("http://service.pojo.sample/xsd", "<b>getWeather");
-
-        Object[] opGetWeatherArgs = new Object[] { };
-        Class[] returnTypes = new Class[] { Weather.class };
-        
-        Object[] response = serviceClient.invokeBlocking(opGetWeather,
-                opGetWeatherArgs, returnTypes);
-        
-        Weather result = (Weather) response[0];
-        
-        if (result == null) {
-            System.out.println("Weather didn't initialize!");
-            return;
-        }</b>
-...</pre>
-
-<p>First you set the operation in opGetWeather to getWeather. Then you create
-an empty argument list. Note this time you expect something back from the Web
-service, and so you create a list of return types. Then you invoke the Web
-service using a blocking call and wait for the weather data to be returned to
-you, and you place it in the result variable. Lastly, you make sure it isn't
-null and that it was successfully initialized by the previous call to
-setWeather. Now display the data to verify that it is indeed what you set it
-to (see Code Listing 6).</p>
-
-<p><b>Code Listing 6: Displaying the data</b></p>
-<pre>...
-            return;
-        }
-
-        // Displaying the result
-        <b>System.out.println("Temperature               : " +
-                           result.getTemperature());
-        System.out.println("Forecast                  : " +
-                           result.getForecast());
-        System.out.println("Rain                      : " +
-                           result.getRain());
-        System.out.println("How much rain (in inches) : " +
-                           result.getHowMuchRain());
-        
-    }</b>
-}</pre>
-
-<p>You should receive the data shown in Code Listing 7.</p>
-
-<p><b>Code Listing 7: Output from running the client</b></p>
-<pre>rpc.client.run:
-     [java] Temperature               : 39.3
-     [java] Forecast                  : Cloudy with showers
-     [java] Rain                      : true
-     [java] How much rain (in inches) : 4.5</pre>
-
-<p>Excellent, you have a working POJO Web service! Next you'll quickly morph
-this one into a Spring based POJO.</p>
-<a name="limitationspojo"></a>
-
-<h3>Limitations and Strengths of POJO</h3>
-
-<p>We've covered the strengths of using POJO based Web services, but what
-about any limitations? One main limitation of POJO based Web services is the
-lack of initialization support (meaning that you have to go into your Web
-service and initialize the values before the Web service is completely
-useful), but you'll soon see how to overcome that limitation with a Spring
-based POJO, covered next.</p>
-<a name="springpojows"></a>
-
-<h2>Spring-based POJO Web Service</h2>
-
-<p>Spring is a hot framework for J2EE and makes bean usage a breeze. You'll
-use it in this section to create a Spring based POJO Web service. For this
-section you'll need the spring.jar from the latest 1.x Spring download.</p>
-
-<a name="quickintro"></a>
-
-<h3>Quick Introduction</h3>
-
-<p>If you take a look at the source code of this document in
-Axis2_HOME/samples/pojoguidespring (to see how the Spring based POJO Web
-service is coded), you can see that the Weather class didn't change at all
-and the WeatherService class only got its name changed to
-WeatherSpringService.</p>
-
-<p>You'll also notice an applicationContext.xml file, which we'll cover
-later: it's used to setup the beans used in our Web service.</p>
-
-<p>Now you might wonder what the SpringInit.java class is for: This service
-is necessary, however, to initialize the Spring Framework's application
-context.</p>
-
-<p>The client is pretty much the same, except you won't use it to initialize
-the Weather data in the Web service, since Spring does that for you using
-Inversion of Control (IoC), which is covered next.</p>
-<a name="servicedef"></a>
-
-<h3>The Service Definition: services.xml</h3>
-
-<p>Because the core POJOs didn't change, you'll move straight to the
-services.xml file. It's a bit longer this time because it instantiates two
-services in one file (see Code Listing 7).</p>
-
-<p><b>Code Listing 7: Defining the services: services.xml</b></p>
-<pre>&lt;serviceGroup&gt;
-  &lt;service <b>name="SpringInit" 
-class="sample.spring.service.SpringInit</b>"&gt;
-    &lt;description&gt;
-      This web service initializes Spring.
-    &lt;/description&gt;
-    <b>&lt;parameter name="ServiceClass"&gt;
-        sample.spring.service.SpringInit
-    &lt;/parameter&gt;
-    &lt;parameter name="ServiceTCCL"&gt;composite&lt;/parameter&gt;
-    &lt;parameter name="load-on-startup"&gt;true&lt;/parameter&gt;</b>
-    &lt;operation name="springInit"&gt;
-      &lt;messageReceiver 
-      class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/&gt;
-    &lt;/operation&gt;
-  &lt;/service&gt;
-  &lt;service <b>name="WeatherSpringService</b>"&gt;
-    &lt;description&gt;
-      Weather Spring POJO Axis2 AAR deployment
-    &lt;/description&gt;
-    <b>&lt;parameter name="ServiceClass"&gt;
-        sample.spring.service.WeatherSpringService
-    &lt;/parameter&gt;
-    &lt;parameter name="ServiceObjectSupplier"&gt;
-org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier
-    &lt;/parameter&gt;
-    &lt;parameter name="SpringBeanName"&gt;
-        weatherSpringService
-    &lt;/parameter&gt;</b>
-    &lt;messageReceivers&gt;
-      &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
-      class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/&gt;
-      &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
-      class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/&gt;
-    &lt;/messageReceivers&gt;
-  &lt;/service&gt;
-&lt;/serviceGroup&gt;</pre>
-
-<p>You'll see a few familiar items in the above listing, and several changes.
-Once again, the items in bold are most important. The ServiceTCCL property
-under the SpringInit service makes sure that the Spring class loader is used
-for the Web service, allowing it to properly instantiate the Spring
-application context. The load-on-startup variable is a must-have so that the
-service loads up immediately on startup, creating the Spring application
-context. The WeatherSpringService stays mostly the same to the WeatherService
-previously with a couple additions: The ServiceObjectSupplier provides the
-service with the Spring application context, making it "Spring Aware."</p>
-
-<p>Lastly, the SpringBeanName points to the name of the bean associated with
-this Web service, which is defined in the applicationContext.xml file
-(essentially the WeatherSpringService). We'll cover the
-applicationContext.xml file next. The application context:
-applicationContext.xml file tells the Spring Framework, what beans are
-defined. For this example, you'll define three of them (see Code Listing
-8).</p>
-
-<p><b>Code Listing 8: Defining the application context:
-applicationContext.xml</b></p>
-<pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" 
-"http://www.springframework.org/dtd/spring-beans.dtd"&gt;
-
-&lt;beans&gt;
-  &lt;bean id="<b>applicationContext</b>" class=
-"org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" /&gt;
-
-  <b>&lt;bean id="weatherSpringService" 
-        class="sample.spring.service.WeatherSpringService"&gt;
-    &lt;property name="weather" ref="weatherBean"/&gt;
-  &lt;/bean&gt;
-
-  &lt;bean id="weatherBean" class="sample.spring.bean.Weather"&gt;
-    &lt;property name="temperature" value="89.9"/&gt;
-    &lt;property name="forecast" value="Sunny"/&gt;
-    &lt;property name="rain" value="false"/&gt;
-    &lt;property name="howMuchRain" value="0.2"/&gt;
-  &lt;/bean&gt;</b>
-&lt;/beans&gt;</pre>
-
-<p>The first one is Axis2's hook into Spring's application context (needed
-since AAR deployment is quite different from regular WAR deployment). Next,
-you define the bean pointed to by the services.xml file, the
-weatherSpringService bean that points to the WeatherSpringService class. It
-has one field property that gets initialized by the Spring Framework,
-weather, which will be set to the weatherBean. The weatherBean is an
-instantiation of the Weather class that holds information on the weather.
-Spring will initialize it to the values shown above, and set the Weather
-object in the WeatherSpringService class to this weatherBean instantiation.
-Thus, when you deploy the Web service you won't have to instantiate the
-values because they'll already be set.</p>
-
-<p>Next up is the SpringInit class.</p>
-<a name="initializingspring"></a>
-
-<h3>Initializing the Spring application context: SpringInit</h3>
-
-<p>Without the Spring application context being initialized quickly, you'll
-run into problems. The SpringInit class initializes the Spring application
-context on startup because it is a ServiceLifeCycle class, whose startUp
-method gets called upon loading the class (and because its load-on-startup
-property is set in the serices.xml file). The only code worth mentioning in
-this class is shown in Code Listing 9.</p>
-
-<p><b>Code Listing 9: SpringInit's startUp method</b></p>
-<pre>    public void startUp(ConfigurationContext ignore,
-                        AxisService service) {
-        <b>ClassLoader classLoader = service.getClassLoader();
-        ClassPathXmlApplicationContext appCtx = new
-            ClassPathXmlApplicationContext</b>(new String[]
-                                           {"<b>applicationContext.xml</b>"}, 
-                                           false);
-        <b>appCtx.setClassLoader(classLoader);
-        appCtx.refresh();</b>
-        if (logger.isDebugEnabled()) {
-            logger.debug("\n\nstartUp() set spring classloader " +
-                         "via axisService.getClassLoader() ... ");
-        }
-    }</pre>
-
-<p>Note that this method retrieves the Spring class loader, creates an
-application context with applicationContext.xml as the parameters. This new
-application context then gets the Spring class loader as its class loader.
-The Spring Framework is now up and ready for our WeatherSpringService.</p>
-
-<h3>Build and Deploy Using Apache Axis2 and Tomcat</h3>
-
-<p>Great, your POJO is now ready for primetime within the Spring Framework.
-Before you build, you'll first need to make sure the axis2-spring-1.1.jar and
-spring.jar files are in the project's <em>Axis2_HOME/lib</em> directory.</p>
-
-<p><strong>Note:</strong> The service will not deploy if you add the above jars files to the service archive due to cloass loding issues.</p>
-<p>Now build the source and create an AAR file by typing:
-ant</p>
-
-<p>It'll be created at <em>target/WeatherSpringService.aar</em>. Copy it over
-to <em>&lt;tomcat-home&gt;/webapps/axis2/WEB-INF/services</em>, and Axis2
-should deploy it quickly.</p>
-
-<p>Next test the Web service to see if Spring really will initialize the
-weather data for you.</p>
-<a name="testingrpc"></a>
-
-<h3>Testing Using an RPCServiceClient</h3>
-
-<p>It's as simple as it was for the other Web service, except this time type:
-ant rpc.client</p>
-
-<p>Feel free to browse the code for this client in
-src/client/WeatherSpringRPCClient.java. Essentially, this client does the
-exact same thing as the client testing the WeatherService, except this one
-skips the "Setting the weather" task since the weather data should already
-have been set by the Spring framework at startup.</p>
-
-<p>Thus, you should get the following as output from the client:</p>
-<pre>run.client:
-    [javac] Compiling 1 source file to C:\axis2-1.1\samples\pojoguidespring\build\cl
-asses
-     <b>[java] Temperature               : 89.9
-     [java] Forecast                  : Sunny
-     [java] Rain                      : false
-     [java] How much rain (in inches) : 0.2</b></pre>
-
-<p>Which is exactly the values you set them to be in the
-applicationContext.xml file!</p>
-<a name="summary"></a>
-
-<h2>Summary</h2>
-
-<p>Apache Axis2 is an excellent way to expose your POJOs as Web services, and
-Spring adds greater flexibility to your POJOs by adding beans support and
-initialization abilities, along with all the other goodies provided by the
-Spring framework.</p>
-<a name="furtherstudy"></a>
-
-<h2>For Further Study</h2>
-
-<p>Apache Axis2-<a
-href="http://ws.apache.org/axis2/">http://ws.apache.org/axis2/</a></p>
-
-<p>Axis2 Architecture-<a
-href="http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html">http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html</a></p>
-
-<p>Introduction to Apache Axis2-<a
-href="http://www.redhat.com/magazine/021jul06/features/apache_axis2/">http://www.redhat.com/magazine/021jul06/features/apache_axis2/</a></p>
-
-<p>Working With Apache Axis2-<a
-href="http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2">http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2</a></p>
-
-<p>Apache Tomcat-<a
-href="http://tomcat.apache.org/">http://tomcat.apache.org</a></p>
-
-<p>Spring Framework-<a
-href="http://www.springframework.org/">http://www.springframework.org/</a></p>
-</body>
-</html>
+<html lang="en">
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>POJO Web Services using Axis2</title>
+  <link href="../css/axis-docs.css" rel="stylesheet" type="text/css" media="all" />
+</head>
+
+<body lang="en">
+<h1>POJO Web Services using Apache Axis2</h1>
+
+<p>Want a quick way to get a Web service up and running in no time? Well
+then, you should consider creating a Plain Old Java Object (POJO) to deploy
+using Apache Axis2 on Apache Tomcat. POJOs are fast to build and easy to
+maintain, meaning you'll save a lot of time building and debugging your code.
+This document shows you how to take a simple POJO, and deploy it on Apache
+Tomcat as a Web service in the exploded directory format. You'll also be
+shown how to take a POJO based on the Spring Framework, and deploy that as an
+AAR packaged Web service on Tomcat.</p>
+
+<h2>Content</h2>
+<ul>
+  <li><a href="#introduction">Introduction</a></li>
+  <li><a href="#pojo">The POJO</a></li>
+  <li><a href="#pojows">POJO Web service using Apache Axis2 and Tomcat</a>
+    <ul>
+      <li><a href="#definingservice">Defining the Service:
+      services.xml</a></li>
+    </ul>
+  </li>
+  <li><a href="#buildpojows">Building the POJO Web Service Using Ant</a></li>
+  <li><a href="#testingpojows">Testing the POJO Web Service Using
+    RPCServiceClient</a>
+    <ul>
+      <li><a href="#limitationspojo">Limitations and Strengths of
+      POJO</a></li>
+    </ul>
+  </li>
+  <li><a href="#springpojows">Spring-based POJO Web Service</a>
+    <ul>
+      <li><a href="#quickintro">Quick Introduction</a></li>
+      <li><a href="#servicedef">The Service Definition: services.xml</a></li>
+      <li><a href="#initializingspring">Initializing the Spring application
+        context: SpringInit</a></li>
+      <li><a href="#testingrpc">Testing Using an RPCServiceClient</a></li>
+    </ul>
+  </li>
+  <li><a href="#summary">Summary</a></li>
+  <li><a href="#furtherstudy">For Further Study</a></li>
+</ul>
+<a name="introduction"></a>
+
+<h2>Introduction</h2>
+
+<p>The task of building a Web service can sometimes be overwhelming, but not
+with POJOs! The old-school Plain Old Java Object is a simple and quick way to
+get most, if not all, of your currently existing Java classes up on the Web
+as readily accessible Web services. This document will show you how to build
+a POJO-style Web service with Apache Axis2 and Tomcat, organized as
+follows:</p>
+<ul>
+  <li>The POJO: This is the Java class that you'll use throughout this
+    document</li>
+  <li>POJO deployment</li>
+  <li>Test the POJO Web service using an RPC based client</li>
+  <li>Limitations of straight POJO</li>
+  <li>Spring-based POJO Web service and deployment</li>
+</ul>
+
+<p>The code for the document can be found at Axis2_HOME/samples/pojoguide
+&amp; Axis2_HOME/samples/pojoguidespring once you extract the <a
+href="../../download/1_1_1/download.html#std-bin">Axis2 Stadard
+Distribution</a>, and it might help to go grab it now to help you as you
+follow along. Let's get started.</p>
+<a name="pojo"></a>
+
+<h2>The POJO</h2>
+
+<p>The POJO you'll be using throughout this document is a Weather service
+POJO that consists of two classes: WeatherService and Weather. Weather
+contains the Weather data: Temperature, forecast, rain (will it rain?), and
+howMuchRain (See Code Listing 1).</p>
+
+<p><b>Code Listing 1: The Weather POJO</b></p>
+<pre>package sample.pojo.data;
+
+public class Weather{
+    float temperature;
+    String forecast;
+    boolean rain;
+    float howMuchRain;
+    
+    public void setTemperature(float temp){
+        temperature = temp;
+    }
+
+    public float getTemperature(){
+        return temperature;
+    }
+    
+    public void setForecast(String fore){
+        forecast = fore;
+    }
+
+    public String getForecast(){
+        return forecast;
+    }
+    
+    public void setRain(boolean r){
+        rain = r;
+    }
+
+    public boolean getRain(){
+        return rain;
+    }
+    
+    public void setHowMuchRain(float howMuch){
+        howMuchRain = howMuch;
+    }
+
+    public float getHowMuchRain(){
+        return howMuchRain;
+    }
+}</pre>
+
+<p>And here's the WeatherService class, shown in Code Listing 2.</p>
+
+<p><b>Code Listing 2: The WeatherService class</b></p>
+<pre>package sample.pojo.service;
+
+import sample.pojo.data.Weather;
+
+public class WeatherService{
+    Weather weather;
+    
+    public void setWeather(Weather weather){
+        this.weather = weather;
+    }
+
+    public Weather getWeather(){
+        return this.weather;
+    }
+}</pre>
+
+<p>Note that it's all just straight POJOs with field items and
+<code>getter</code> and <code>setter</code> methods for each field. Next,
+you'll take a look at what you need to do to make it ready for deployment on
+Apache Axis2 and Tomcat.</p>
+<a name="pojows"></a>
+
+<h2>POJO Web Service Using Apache Axis2 and Tomcat</h2>
+
+<p>Got the POJOs? Great. This section will show you how to package them in
+the exploded directory format for easy deployment. First you'll look at the
+services.xml file that defines the Web service, and then you'll build the
+files using <a href="http://ant.apache.org/">Apache Ant</a>, and deploy the
+Web service on Tomcat.</p>
+<a name="definingservice"></a>
+
+<h3>Defining the Service: services.xml</h3>
+
+<p>Before Axis2 can understand what is going on, you have to tell it to use
+the services.xml file. Let's get right into it (see Code Listing 3).</p>
+
+<p><b>Code Listing 3: The service definition file: services.xml</b></p>
+<pre>&lt;service name="WeatherService" scope="application"&gt;
+    &lt;description&gt;
+        Weather POJO Service
+    &lt;/description&gt;
+    &lt;messageReceivers&gt;
+        &lt;messageReceiver 
+            mep="http://www.w3.org/2004/08/wsdl/in-only"
+    class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/&gt;
+        &lt;messageReceiver
+            mep="http://www.w3.org/2004/08/wsdl/in-out"
+    class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/&gt;
+    &lt;/messageReceivers&gt;
+    &lt;parameter name="ServiceClass"&gt;
+        sample.pojo.service.WeatherService
+    &lt;/parameter&gt;
+&lt;/service&gt;</pre>
+
+<p>The name of the service is specified as WeatherService and the scope of
+the service is application. As you can see in the WeatherService POJO, there
+are two methods, an IN-ONLY method and a IN-OUT method, hence the ordering
+for the messageReceiver elements within the messageReceivers tag. Lastly, the
+ServiceClass parameter specifies the class of the Web service, which is
+sample.pojo.service.WeatherService. When operations of your Web service get
+called, the methods of the WeatherService class will be called. Next you'll
+take a look at an easy method of building your application using Ant.</p>
+<a name="buildpojows"></a>
+
+<h2>Building the POJO Web Service Using Apache Ant</h2>
+
+<p><a href="http://ant.apache.org/">Ant</a> is a slick build tool. It helps
+reduce time to build applications, and several of the Axis2 command-line
+tools create build.xml files for you, so that's why we'll use it here. We
+won't go into the build.xml file that you'll be using in too much detail, so
+here are the main Ant tasks you'll be using:</p>
+<ul>
+  <li>generate.service -- This Ant task builds all the service relevant
+    source and copies the files to build/WeatherService</li>
+  <li>rpc.client -- This task builds the client relevant files, builds a JAR
+    at <em>build/lib/rpc-client.jar</em>, and then runs the client</li>
+</ul>
+
+<p>Before you can build the source, however, you'll need to download the
+Axis2 1.1.1-bin and 1.1.1-war distributions <a
+href="../../download/1_1_1/download.html">here</a>. Then modify the following
+line inside the build.xml file (in the Axis2_HOME/samples/pojoguide directory
+in the extracted Axis2 1.1.1 Standard Binary (bin) Distribution) :</p>
+<pre>&lt;property name="axis2.home" value="c:\apps\axis2" /&gt;</pre>
+
+<p>This modification contains the path to the root of the unzipped Axis2
+1.1.1-bin <a href="../../download/1_1_1/download.html#std-bin">download</a>. With
+that explanation, you'll now build the source by typing the following: ant</p>
+
+<p>The following directory format should now exist at
+build/WeatherService:</p>
+<pre> - WeatherService
+   - META-INF
+     - services.xml
+   - sample
+     - pojo
+       - data
+         - Weather.class
+       - service
+         - WeatherService.class</pre>
+
+<p>Simple isn't it? An excellent way to dive into Web services
+development.</p>
+
+<p>Now get a <a href="http://tomcat.apache.org/">Tomcat</a> distribution (I
+used v5.5), and start it up by running <em>bin/startup.bat</em> or
+<em>bin/startup.sh</em>. Once it's running, deploy the Axis2 1.1.1-war by
+copying the axis2.war file to Tomcat's webapps directory. Tomcat will proceed
+by deploying axis2 and un-archive it into the webapps directory. Now copy the
+WeatherService directory created when building our project to:
+<em>&lt;tomcat-home&gt;/webapps/axis2/WEB-INF/services</em>.</p>
+
+<p>The service should quickly deploy, and you'll test the Web service using
+the RPCServiceClient in the next section.</p>
+<a name="testingpojows"></a>
+
+<h2>Testing the POJO Web Service Using RPCServiceClient</h2>
+
+<p>OK, so the Web service should be running on Tomcat. Now you'll build a
+simple RPCServiceClient and test the POJO Web service. You'll first start out
+with the class constructs, creating the RPCServiceClient and initializing the
+values of the Weather class within the Web service (See Code Listing 4).</p>
+
+<p><b>Code Listing 4: Setting the weather</b></p>
+<p><pre>package sample.pojo.rpcclient;
+
+import javax.xml.namespace.QName;
+
+import org.apache.axis2.AxisFault;
+import org.apache.axis2.addressing.EndpointReference;
+import org.apache.axis2.client.Options;
+import org.apache.axis2.rpc.client.RPCServiceClient;
+
+import sample.pojo.data.Weather;
+
+
+public class WeatherRPCClient {
+
+    public static void main(String[] args1) throws AxisFault {
+
+        RPCServiceClient serviceClient = new RPCServiceClient();
+
+        Options options = serviceClient.getOptions();
+
+        EndpointReference targetEPR = new EndpointReference(
+                <b>"http://localhost:8080/axis2/services/WeatherService");</b>
+        options.setTo(targetEPR);
+
+        // Setting the weather
+        QName opSetWeather =
+            new QName("http://service.pojo.sample/xsd", "<b>setWeather");
+
+        Weather w = new Weather();
+
+        w.setTemperature((float)39.3);
+        w.setForecast("Cloudy with showers");
+        w.setRain(true);
+        w.setHowMuchRain((float)4.5);
+
+        Object[] opSetWeatherArgs = new Object[] { w };
+
+        serviceClient.invokeRobust(opSetWeather, opSetWeatherArgs);</b>
+...</pre></p>
+
+<p>The most interesting code to note is in bold font. Notice the targetEPR
+variable you create, setting the endpoint reference to
+http://localhost:8080/axis2/services/WeatherService. This is where you
+deployed it on Axis2. You can also verify this by asking Axis2 to list its
+services by going to the following URL:
+http://localhost:8080/axis2/services/listServices.</p>
+
+<p>Next the opSetWeather variable gets setup, pointing to the setWeather
+operation. Then the Weather data gets created and initialized. Lastly, you
+invoke the Web service, which initializes the weather data (you'll verify
+this soon). Next you get back the weather data (see Code Listing 5).</p>
+
+<p><b>Code Listing 5: Getting the weather data</b></p>
+<p><pre>...
+        serviceClient.invokeRobust(opSetWeather, opSetWeatherArgs);
+
+        // Getting the weather
+        QName opGetWeather =
+            new QName("http://service.pojo.sample/xsd", "<b>getWeather");
+
+        Object[] opGetWeatherArgs = new Object[] { };
+        Class[] returnTypes = new Class[] { Weather.class };
+        
+        Object[] response = serviceClient.invokeBlocking(opGetWeather,
+                opGetWeatherArgs, returnTypes);
+        
+        Weather result = (Weather) response[0];
+        
+        if (result == null) {
+            System.out.println("Weather didn't initialize!");
+            return;
+        }</b>
+...</pre></p>
+
+<p>First you set the operation in opGetWeather to getWeather. Then you create
+an empty argument list. Note this time you expect something back from the Web
+service, and so you create a list of return types. Then you invoke the Web
+service using a blocking call and wait for the weather data to be returned to
+you, and you place it in the result variable. Lastly, you make sure it isn't
+null and that it was successfully initialized by the previous call to
+setWeather. Now display the data to verify that it is indeed what you set it
+to (see Code Listing 6).</p>
+
+<p><b>Code Listing 6: Displaying the data</b></p>
+<p><pre>...
+            return;
+        }
+
+        // Displaying the result
+        <b>System.out.println("Temperature               : " +
+                           result.getTemperature());
+        System.out.println("Forecast                  : " +
+                           result.getForecast());
+        System.out.println("Rain                      : " +
+                           result.getRain());
+        System.out.println("How much rain (in inches) : " +
+                           result.getHowMuchRain());
+        
+    }</b>
+}</pre></p>
+
+<p>You should receive the data shown in Code Listing 7.</p>
+
+<p><b>Code Listing 7: Output from running the client</b></p>
+<pre>rpc.client.run:
+     [java] Temperature               : 39.3
+     [java] Forecast                  : Cloudy with showers
+     [java] Rain                      : true
+     [java] How much rain (in inches) : 4.5</pre>
+
+<p>Excellent, you have a working POJO Web service! Next you'll quickly morph
+this one into a Spring based POJO.</p>
+<a name="limitationspojo"></a>
+
+<h3>Limitations and Strengths of POJO</h3>
+
+<p>We've covered the strengths of using POJO based Web services, but what
+about any limitations? One main limitation of POJO based Web services is the
+lack of initialization support (meaning that you have to go into your Web
+service and initialize the values before the Web service is completely
+useful), but you'll soon see how to overcome that limitation with a Spring
+based POJO, covered next.</p>
+<a name="springpojows"></a>
+
+<h2>Spring-based POJO Web Service</h2>
+
+<p>Spring is a hot framework for J2EE and makes bean usage a breeze. You'll
+use it in this section to create a Spring based POJO Web service. For this
+section you'll need the spring.jar from the latest 1.x Spring download.</p>
+
+<a name="quickintro"></a>
+
+<h3>Quick Introduction</h3>
+
+<p>If you take a look at the source code of this document in
+Axis2_HOME/samples/pojoguidespring (to see how the Spring based POJO Web
+service is coded), you can see that the Weather class didn't change at all
+and the WeatherService class only got its name changed to
+WeatherSpringService.</p>
+
+<p>You'll also notice an applicationContext.xml file, which we'll cover
+later: it's used to setup the beans used in our Web service.</p>
+
+<p>Now you might wonder what the SpringInit.java class is for: This service
+is necessary, however, to initialize the Spring Framework's application
+context.</p>
+
+<p>The client is pretty much the same, except you won't use it to initialize
+the Weather data in the Web service, since Spring does that for you using
+Inversion of Control (IoC), which is covered next.</p>
+<a name="servicedef"></a>
+
+<h3>The Service Definition: services.xml</h3>
+
+<p>Because the core POJOs didn't change, you'll move straight to the
+services.xml file. It's a bit longer this time because it instantiates two
+services in one file (see Code Listing 7).</p>
+
+<p><b>Code Listing 7: Defining the services: services.xml</b></p>
+<p><pre>&lt;serviceGroup&gt;
+  &lt;service <b>name="SpringInit" 
+class="sample.spring.service.SpringInit</b>"&gt;
+    &lt;description&gt;
+      This web service initializes Spring.
+    &lt;/description&gt;
+    <b>&lt;parameter name="ServiceClass"&gt;
+        sample.spring.service.SpringInit
+    &lt;/parameter&gt;
+    &lt;parameter name="ServiceTCCL"&gt;composite&lt;/parameter&gt;
+    &lt;parameter name="load-on-startup"&gt;true&lt;/parameter&gt;</b>
+    &lt;operation name="springInit"&gt;
+      &lt;messageReceiver 
+      class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/&gt;
+    &lt;/operation&gt;
+  &lt;/service&gt;
+  &lt;service <b>name="WeatherSpringService</b>"&gt;
+    &lt;description&gt;
+      Weather Spring POJO Axis2 AAR deployment
+    &lt;/description&gt;
+    <b>&lt;parameter name="ServiceClass"&gt;
+        sample.spring.service.WeatherSpringService
+    &lt;/parameter&gt;
+    &lt;parameter name="ServiceObjectSupplier"&gt;
+org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier
+    &lt;/parameter&gt;
+    &lt;parameter name="SpringBeanName"&gt;
+        weatherSpringService
+    &lt;/parameter&gt;</b>
+    &lt;messageReceivers&gt;
+      &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
+      class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/&gt;
+      &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
+      class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/&gt;
+    &lt;/messageReceivers&gt;
+  &lt;/service&gt;
+&lt;/serviceGroup&gt;</pre></p>
+
+<p>You'll see a few familiar items in the above listing, and several changes.
+Once again, the items in bold are most important. The ServiceTCCL property
+under the SpringInit service makes sure that the Spring class loader is used
+for the Web service, allowing it to properly instantiate the Spring
+application context. The load-on-startup variable is a must-have so that the
+service loads up immediately on startup, creating the Spring application
+context. The WeatherSpringService stays mostly the same to the WeatherService
+previously with a couple additions: The ServiceObjectSupplier provides the
+service with the Spring application context, making it "Spring Aware."</p>
+
+<p>Lastly, the SpringBeanName points to the name of the bean associated with
+this Web service, which is defined in the applicationContext.xml file
+(essentially the WeatherSpringService). We'll cover the
+applicationContext.xml file next. The application context:
+applicationContext.xml file tells the Spring Framework, what beans are
+defined. For this example, you'll define three of them (see Code Listing
+8).</p>
+
+<p><b>Code Listing 8: Defining the application context:
+applicationContext.xml</b></p>
+<p><pre>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
+&lt;!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" 
+"http://www.springframework.org/dtd/spring-beans.dtd"&gt;
+
+&lt;beans&gt;
+  &lt;bean id="<b>applicationContext</b>" class=
+"org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" /&gt;
+
+  <b>&lt;bean id="weatherSpringService" 
+        class="sample.spring.service.WeatherSpringService"&gt;
+    &lt;property name="weather" ref="weatherBean"/&gt;
+  &lt;/bean&gt;
+
+  &lt;bean id="weatherBean" class="sample.spring.bean.Weather"&gt;
+    &lt;property name="temperature" value="89.9"/&gt;
+    &lt;property name="forecast" value="Sunny"/&gt;
+    &lt;property name="rain" value="false"/&gt;
+    &lt;property name="howMuchRain" value="0.2"/&gt;
+  &lt;/bean&gt;</b>
+&lt;/beans&gt;</pre></p>
+
+<p>The first one is Axis2's hook into Spring's application context (needed
+since AAR deployment is quite different from regular WAR deployment). Next,
+you define the bean pointed to by the services.xml file, the
+weatherSpringService bean that points to the WeatherSpringService class. It
+has one field property that gets initialized by the Spring Framework,
+weather, which will be set to the weatherBean. The weatherBean is an
+instantiation of the Weather class that holds information on the weather.
+Spring will initialize it to the values shown above, and set the Weather
+object in the WeatherSpringService class to this weatherBean instantiation.
+Thus, when you deploy the Web service you won't have to instantiate the
+values because they'll already be set.</p>
+
+<p>Next up is the SpringInit class.</p>
+<a name="initializingspring"></a>
+
+<h3>Initializing the Spring application context: SpringInit</h3>
+
+<p>Without the Spring application context being initialized quickly, you'll
+run into problems. The SpringInit class initializes the Spring application
+context on startup because it is a ServiceLifeCycle class, whose startUp
+method gets called upon loading the class (and because its load-on-startup
+property is set in the serices.xml file). The only code worth mentioning in
+this class is shown in Code Listing 9.</p>
+
+<p><b>Code Listing 9: SpringInit's startUp method</b></p>
+<p><pre>    public void startUp(ConfigurationContext ignore,
+                        AxisService service) {
+        <b>ClassLoader classLoader = service.getClassLoader();
+        ClassPathXmlApplicationContext appCtx = new
+            ClassPathXmlApplicationContext</b>(new String[]
+                                           {"<b>applicationContext.xml</b>"}, 
+                                           false);
+        <b>appCtx.setClassLoader(classLoader);
+        appCtx.refresh();</b>
+        if (logger.isDebugEnabled()) {
+            logger.debug("\n\nstartUp() set spring classloader " +
+                         "via axisService.getClassLoader() ... ");
+        }
+    }</pre></p>
+
+<p>Note that this method retrieves the Spring class loader, creates an
+application context with applicationContext.xml as the parameters. This new
+application context then gets the Spring class loader as its class loader.
+The Spring Framework is now up and ready for our WeatherSpringService.</p>
+
+<h3>Build and Deploy Using Apache Axis2 and Tomcat</h3>
+
+<p>Great, your POJO is now ready for primetime within the Spring Framework.
+Before you build, you'll first need to make sure the axis2-spring-1.1.1.jar and
+spring.jar files are in the project's <em>Axis2_HOME/lib</em> directory.</p>
+
+<p><strong>Note:</strong> The service will not deploy if you add the above jars files to the service archive due to cloass loding issues.</p>
+<p>Now build the source and create an AAR file by typing:
+ant</p>
+
+<p>It'll be created at <em>target/WeatherSpringService.aar</em>. Copy it over
+to <em>&lt;tomcat-home&gt;/webapps/axis2/WEB-INF/services</em>, and Axis2
+should deploy it quickly.</p>
+
+<p>Next test the Web service to see if Spring really will initialize the
+weather data for you.</p>
+<a name="testingrpc"></a>
+
+<h3>Testing Using an RPCServiceClient</h3>
+
+<p>It's as simple as it was for the other Web service, except this time type:
+ant rpc.client</p>
+
+<p>Feel free to browse the code for this client in
+src/client/WeatherSpringRPCClient.java. Essentially, this client does the
+exact same thing as the client testing the WeatherService, except this one
+skips the "Setting the weather" task since the weather data should already
+have been set by the Spring framework at startup.</p>
+
+<p>Thus, you should get the following as output from the client:</p>
+<pre>run.client:
+    [javac] Compiling 1 source file to C:\axis2-1.1.1\samples\pojoguidespring\build\cl
+asses
+     <b>[java] Temperature               : 89.9
+     [java] Forecast                  : Sunny
+     [java] Rain                      : false
+     [java] How much rain (in inches) : 0.2</b></pre>
+
+<p>Which is exactly the values you set them to be in the
+applicationContext.xml file!</p>
+<a name="summary"></a>
+
+<h2>Summary</h2>
+
+<p>Apache Axis2 is an excellent way to expose your POJOs as Web services, and
+Spring adds greater flexibility to your POJOs by adding beans support and
+initialization abilities, along with all the other goodies provided by the
+Spring framework.</p>
+<a name="furtherstudy"></a>
+
+<h2>For Further Study</h2>
+
+<p>Apache Axis2-<a
+href="http://ws.apache.org/axis2/">http://ws.apache.org/axis2/</a></p>
+
+<p>Axis2 Architecture-<a
+href="http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html">http://ws.apache.org/axis2/1_0/Axis2ArchitectureGuide.html</a></p>
+
+<p>Introduction to Apache Axis2-<a
+href="http://www.redhat.com/magazine/021jul06/features/apache_axis2/">http://www.redhat.com/magazine/021jul06/features/apache_axis2/</a></p>
+
+<p>Working With Apache Axis2-<a
+href="http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2">http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2</a></p>
+
+<p>Apache Tomcat-<a
+href="http://tomcat.apache.org/">http://tomcat.apache.org</a></p>
+
+<p>Spring Framework-<a
+href="http://www.springframework.org/">http://www.springframework.org/</a></p>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/1_1/quickstartguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/quickstartguide.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/quickstartguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/quickstartguide.html Mon Jan 22 21:34:03 2007
@@ -568,6 +568,12 @@
 http://localhost:8080/axis2/services/StockQuoteService?xsd
 </pre>
 
+<p>For more information on using JiBX with Axis2, see the
+<a href="jibx/jibx-codegen-integration.html">JiBX code generation integration</a>
+details. You can also check the
+<a href="http://www.sosnoski.com/jibx-wiki/space/axis2-jibx">JiBX Axis2 Wiki
+page</a> for updated information about using JiBX with Axis2.</p>
+
 <a name="clients"></a><h2>Creating Clients</h2>
 
 <p>In this section, we'll look at four ways to create clients based on the StockQuoteService class:  Building an AXIOM based client, generating a client using Axis2 Databinding Framework (ADB), generating a client using XMLBeans, and generating a client using JiBX.</p>
@@ -911,6 +917,10 @@
 42
 done
 </pre>
+
+<p>For more information on using JiBX with Axis2, see the
+<a href="jibx/jibx-codegen-integration.html">JiBX code generation integration</a>
+details.</p>
 
 <a name="summary"></a><h2>Summary</h2>
 

Modified: webservices/axis2/trunk/java/xdocs/1_1/reference.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/reference.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/reference.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/reference.html Mon Jan 22 21:34:03 2007
@@ -13,11 +13,11 @@
 <a name="wsdl2code"></a>
 <h2> WSDL2Java Reference</h2>
 <pre>NAME
-       WSDL2Java.sh or WSDL2Java.bat - Generates java code according to a given WSDL file to handle Web service invocation.
+       wsdl2java.sh or wsdl2java.bat - Generates java code according to a given WSDL file to handle Web service invocation.
        These scripts can be found under the bin directory of the Axis2 distribution.
 
 SYNOPSIS
-       WSDL2Java.sh [OPTION]... -uri &lt;Location of WSDL&gt;
+       wsdl2java.sh [OPTION]... -uri &lt;Location of WSDL&gt;
 
 DESCRIPTION
        Given a WSDL file, this generates java code to handle Web service invocations.
@@ -46,9 +46,9 @@
 	-R &lt;folder name&gt; : Generated resources folder name. (Default: resources)
 	
 EXAMPLES
-       WSDL2Java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl
-       WSDL2Java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl -ss -sd 
-       WSDL2Java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl -ss -sd -d xmlbeans -o ../samples -p org.apache.axis2.userguide</pre>
+       wsdl2java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl
+       wsdl2java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl -ss -sd 
+       wsdl2java.sh -uri ../samples/wsdl/Axis2SampleDocLit.wsdl -ss -sd -d xmlbeans -o ../samples -p org.apache.axis2.userguide</pre>
 
 <a name="wsdl2java"></a>
 <h2> Java2WSDL Reference</h2>

Modified: webservices/axis2/trunk/java/xdocs/1_1/tcp-transport.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/1_1/tcp-transport.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_1/tcp-transport.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_1/tcp-transport.html Mon Jan 22 21:34:03 2007
@@ -39,7 +39,7 @@
 <ol>
   <li>Use the name space URI of the first child element of SOAPBody.
     (SOAPMessageBodyBasedDispatcher).</li>
-  <li>Enable WS-Addressing. In the case of version 1.1 release Addressing is
+  <li>Enable WS-Addressing. In the case of version 1.1 and 1.1.1 releases Addressing is
     default (SOAPActionBasedDispatcher).</li>
 </ol>
 
@@ -68,12 +68,10 @@
 ServiceClient serviceClient = new ServiceClient();
 Options options = new Options();
 options.setTo(targetEPR);
-<!--options.useSeperateListener(false);-->
-<!--commented off as their is an error--- "The method useSeperateListener(boolean)is undefined for the type Options">
+<!--options.useSeperateListener(false);--><!--commented off as their is an error: "The method useSeperateListener(boolean)is undefined for the type Options"-->
 serviceClient.setOptions(options);
 
-OMElement response =
-        serviceClient.sendReceive(payload);
+OMElement response = serviceClient.sendReceive(payload);
 </pre>
 </source>
 <p>The transport that should be invoked is inferred from the targetEPR
@@ -97,7 +95,7 @@
 
 <p>In order to run the TCPClient.java, addressing should be engaged both in the 
 client and server sides. In client side, you can engage addressing by copying 
-the addressing-1.1.mar (AXIS2_HOME/repository/module) to AXIS2_HOME/lib directory.</p>
+the addressing-1.1.1.mar (AXIS2_HOME/repository/module) to AXIS2_HOME/lib directory.</p>
 
 <a name="components"></a>
 <h2>Transport Components</h2>

Modified: webservices/axis2/trunk/java/xdocs/archived_news.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/archived_news.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/archived_news.html (original)
+++ webservices/axis2/trunk/java/xdocs/archived_news.html Mon Jan 22 21:34:03 2007
@@ -7,7 +7,8 @@
   <title>Apache Axis2 Archived News</title>
   <meta name="generator" content="amaya 9.2.1, see http://www.w3.org/Amaya/"
   />
-  <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all" />
+  <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all"
+  />
 </head>
 
 <body xml:lang="en">
@@ -20,6 +21,7 @@
 
 <h3>Apache Axis2 Releases:</h3>
 <ul>
+  <li><a href="#1_1">13th November 2006- Version 1.1</a></li>
   <li><a href="#1_0">04 May 2006- Version 1.0</a></li>
   <li><a href="#0_95">23 March 2006- Version 0.95</a></li>
   <li><a href="#0_94">11 January 2006- Version 0.94</a></li>
@@ -30,8 +32,114 @@
   <li><a href="#M2">07 June 2005 - Milestone 2</a></li>
   <li><a href="#M1">24 February 2005 - Milestone 1</a></li>
 </ul>
+<a></a>
+
+<h2>13th November 2006 - Apache Axis2/Java Version 1.1 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download/1_1/download.cgi">Download
+1.1</a>]</p>
+
+<p>Apache Axis2 Version 1.1 comes to you with better Axis2 Databinding
+Framework (ADB) support, <a
+href="http://www.w3.org/TR/SOAP-attachments">attachments API</a>, Spring and
+complete support for SOAP with Attachments (SwA). Check out the complete
+features list below.</p>
+
+<h3>Programming Model</h3>
+<ul>
+  <li>Improved, XML-centric client API including full WSDL and policy
+  support</li>
+  <li>Support for any message exchange pattern</li>
+  <li>Synchronous and asynchronous calls</li>
+  <li>Archived service deployment model</li>
+  <li>Archived module deployment model supporting controlled extensibility
+    with versioning support</li>
+  <li><a href="#Hot_Deployment">Hot deployment</a></li>
+  <li>WS-Policy driven code generation extensions</li>
+  <li>Flexible service life cycle model</li>
+  <li>Support for querying service's WSDL (using ?wsdl), schema (using ?xsd)
+    and policies (using ?policy)</li>
+</ul>
+
+<h3>Supported Specifications</h3>
+<ul>
+  <li>SOAP 1.1 and 1.2</li>
+  <li>Message Transmission Optimization Mechanism (MTOM), XML Optimized
+    Packaging (XOP) and SOAP with Attachments</li>
+  <li>WSDL 1.1, including both SOAP and HTTP bindings</li>
+  <li>WS-Addressing (submission and final)</li>
+  <li>WS-Policy</li>
+  <li>SAAJ 1.1</li>
+</ul>
+
+<h3>Transports</h3>
+<ul>
+  <li>HTTP</li>
+  <li>SMTP</li>
+  <li>JMS</li>
+  <li>TCP</li>
+</ul>
+
+<h3>Supported Data Bindings</h3>
+<ul>
+  <li>Axis Data Binding (ADB)</li>
+  <li>XMLBeans</li>
+  <li>JibX</li>
+  <li>JaxMe</li>
+</ul>
+<a></a>
+
+<h2>Tools Included In This Release</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/tools/index.html">Download Tool
+Plug-ins</a>]</p>
+<ol type="1">
+  <li>Axis2 Web Application (Web App)</li>
+  <li>WSDL2WS- <a href="tools/1_1/eclipse/wsdl2java-plugin.html">eclipse
+    plug-in</a><a>/</a> <a href="tools/1_1/CodegenToolReference.html">Command
+    line version</a><a>/</a><a
+    href="tools/1_1/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation">IntelliJ
+    IDEA plug-in</a><a>/</a><a
+    href="tools/1_1/maven-plugins/maven-wsdl2code-plugin.html">Maven2
+    WSDL2Code Plug-in</a></li>
+  <li>Service Archive Wizard- <a
+    href="tools/1_1/eclipse/servicearchiver-plugin.html">eclipse plug-in</a>/
+    <a
+    href="tools/1_1/idea/Idea_plug-in_userguide.html#Create_Service_Archive">IntelliJ
+    IDEA plug-in</a>/ <a
+    href="tools/1_1/maven-plugins/maven-aar-plugin.html">Maven2 AAR
+    Plug-in</a></li>
+  <li>Java2WSDL- <a
+    href="tools/1_1/maven-plugins/maven-java2wsdl-plugin.html">Maven2
+    Java2WSDL Plug-in</a></li>
+</ol>
+
+<h2>Extension Modules</h2>
+<ul>
+  <li>Apache Rampart: Supporting WS-Security (and soon WS-Policy)</li>
+  <li>Apache Sandesha2: Supporting WS-Reliable Messaging</li>
+</ul>
+(Apache Axis2 comes built in with a module that supports WS-Addressing.)
+
+<h2>Known Issues and Limitations</h2>
+<ul>
+  <li>JaxMe and JAXBRI data binding support is experimental</li>
+  <li>AXIS2-595: Hot re-deployment in Apache Tomcat has problems</li>
+  <li>Axis Data Binding (ADB) does not support the following construct(s):
+    <ol>
+      <li>AXIS2-983: Support for Simple Type Union and Simple Type List</li>
+      <li>AXIS2-1092: Support for xs:list inside an xs:simpleType</li>
+      <li>AXIS2-1093: Support for xs:union inside xs:simpleType</li>
+    </ol>
+  </li>
+  <li>No support yet for unwrapping of doc/lit WSDL files (in stub
+  generation)</li>
+  <li>No support yet for rpc/encoded style WSDL documents (in stub
+  generation)</li>
+  <li>Idea plugin shows random behavior when XMLBeans is used</li>
+</ul>
+<a></a>
 
-<a name="1_0"></a>
 <h2>04 May 2006 - Apache Axis2 Version 1.0 Released!</h2>
 
 <p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 1.0</a>]</p>
@@ -50,24 +158,23 @@
 and reliability. Modules currently available or under development include:</p>
 <ul>
   <li><a
-    href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrm"
-    target="_blank">WS-ReliableMessaging</a> - Supported by <a
-    href="http://ws.apache.org/sandesha/sandesha2/">Apache Sandesha2</a></li>
+    href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrm">WS-ReliableMessaging</a>
+    - Supported by <a href="http://ws.apache.org/sandesha/sandesha2/">Apache
+    Sandesha2</a></li>
   <li><a
-    href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#coor"
-    target="_blank">WS-Coordination</a>  and <a
-    href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#atom"
-    target="_blank">WS-AtomicTransaction</a> - Supported by <a
-    href="http://ws.apache.org/kandula/">Apache Kandula2</a></li>
+    href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#coor">WS-Coordination</a>
+    and <a
+    href="http://www-128.ibm.com/developerworks/library/specification/ws-tx/#atom">WS-AtomicTransaction</a>
+    - Supported by <a href="http://ws.apache.org/kandula/">Apache
+  Kandula2</a></li>
   <li><a
-    href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss"
-    target="_blank">WS-Security</a> - Supported by <a
+    href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss">WS-Security</a>
+    - Supported by <a
     href="http://ws.apache.org/axis2/modules/index.html">Apache
   Rampart</a></li>
-  <li><a href="http://www.w3.org/Submission/ws-addressing/"
-    target="_blank">WS-Addressing</a> - <a
-    href="http://ws.apache.org/axis2/modules/index.html">Module</a> included
-    as part of Axis2 core</li>
+  <li><a href="http://www.w3.org/Submission/ws-addressing/">WS-Addressing</a>
+    - <a href="http://ws.apache.org/axis2/modules/index.html">Module</a>
+    included as part of Axis2 core</li>
 </ul>
 
 <p>Apache Axis2 is built on <a
@@ -86,7 +193,8 @@
   <li>Archived service deployment model</li>
   <li>Archived module deployment model supporting controlled extensibility
     with versioning support</li>
-  <li><a href="1_1/installationguide.html#hot_deployment">Hot deployment</a></li>
+  <li><a href="1_1/installationguide.html#hot_deployment">Hot
+  deployment</a></li>
   <li>WS-Policy driven code generation extensions</li>
   <li>Flexible service lifecyle model</li>
   <li>Support for querying service's WSDL (using ?wsdl), schema (using ?xsd)
@@ -120,24 +228,23 @@
   <li>JaxMe</li>
 </ul>
 
-<h2><a name="Tools_included_in this_Release">Tools Included In This
-Release</a></h2>
+<h2><a>Tools Included In This Release</a></h2>
 
-<p><a href="http://ws.apache.org/axis2/tools/index.html"
-target="_blank">[Download plug-ins]</a></p>
+<p><a href="http://ws.apache.org/axis2/tools/index.html">[Download
+plug-ins]</a></p>
 <ol type="1">
   <li>Axis2 Web Application (Web App)</li>
-  <li>WSDL2WS- <a href="../tools/1_0/eclipse/wsdl2java-plugin.html"
-    target="_blank">eclipse plug-in</a><a>/</a> <a
-    href="../tools/1_0/CodegenToolReference.html" target="_blank">Command
-    line version</a><a>/</a><a
-    href="../tools/1_0/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation"
-    target="_blank">IntelliJ IDEA plug-in</a></li>
+  <li>WSDL2WS- <a href="../tools/1_0/eclipse/wsdl2java-plugin.html">eclipse
+    plug-in</a><a>/</a> <a
+    href="../tools/1_0/CodegenToolReference.html">Command line
+    version</a><a>/</a><a
+    href="../tools/1_0/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation">IntelliJ
+    IDEA plug-in</a></li>
   <li>Service Archive Wizard- <a
-    href="../tools/1_0/eclipse/servicearchiver-plugin.html"
-    target="_blank">eclipse plug-in</a>/ <a
-    href="../tools/1_0/idea/Idea_plug-in_userguide.html#Create_Service_Archive"
-    target="_blank">IntelliJ IDEA plug-in</a></li>
+    href="../tools/1_0/eclipse/servicearchiver-plugin.html">eclipse
+    plug-in</a>/ <a
+    href="../tools/1_0/idea/Idea_plug-in_userguide.html#Create_Service_Archive">IntelliJ
+    IDEA plug-in</a></li>
 </ol>
 
 <h2>Extension Modules</h2>
@@ -170,8 +277,6 @@
   <li>No support yet for rpc/encoded style WSDL documents (in stub
   generation)</li>
 </ul>
-
-
 <a id="_0_95"></a>
 
 <h2>23 March 2006 - Apache Axis2 Version 0.95 Released!</h2>

Modified: webservices/axis2/trunk/java/xdocs/download.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download.html (original)
+++ webservices/axis2/trunk/java/xdocs/download.html Mon Jan 22 21:34:03 2007
@@ -1,85 +1,91 @@
-<html>
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Releases</title>
-  <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all" />
-</head>
-
-<body>
-<h2>Apache Axis2 Releases</h2>
-
-<div align="left">
-<p>This page has links to the release versions of Axis2 Java. For more
-information, please see <a
-href="http://www.apache.org/dev/release.html">Apache Release FAQ</a>.</p>
-</div>
-
-<div align="center">
-
-<table border="1" style="border-collapse: collapse" width="93%" id="table1">
-  <tbody>
-    <tr>
-      <th>Version</th>
-      <th>Date</th>
-      <th>Description</th>
-    </tr>
-    <tr>
-      <td><a href="download/1_1/download.cgi"><strong>1.1</strong></a></td>
-      <td>13 - 11 - 2006</td>
-      <td>1.1 Release (Mirrored)</td>
-    </tr>
-    <tr>
-      <td><a href="download/1_0/download.cgi"><strong>1.0</strong></a></td>
-      <td>04 - 05 - 2006</td>
-      <td>1.0 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_95/download.cgi"><strong>0.95</strong></a></td>
-      <td>23 - 03 - 2006</td>
-      <td>0.95 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_94/download.cgi"><strong>0.94</strong></a></td>
-      <td>11- 01 -2006</td>
-      <td>0.94 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_93/download.cgi"><strong>0.93</strong></a></td>
-      <td>12- 02 - 2005</td>
-      <td>0.93 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_92/download.cgi"><strong>0.92</strong></a></td>
-      <td>26 -08 - 2005</td>
-      <td>0.92 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_91/download.cgi"><strong>0.91</strong></a></td>
-      <td>16 -08 - 2005</td>
-      <td>0.91 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/0_9/download.cgi"><strong>0.9</strong></a></td>
-      <td>05 - 07 - 2005</td>
-      <td>0.9 Release (Archived)</td>
-    </tr>
-    <tr>
-      <td><a href="download/M2/download.cgi"><strong>M2</strong></a></td>
-      <td>08 - 06 - 2005</td>
-      <td>Milestone Release #2 (Archived)</td>
-    </tr>
-  </tbody>
-</table>
-</div>
-
-<h4>Axis2 Maven Repository</h4>
-
-<p>Released Axis2 jars are available <a
-href="http://www.apache.org/dist/java-repository/axis2/">here</a></p>
-
-<h4>Nightly Builds</h4>
-Nightly builds are available <a
-href="http://cvs.apache.org/dist/axis2/nightly">here</a> <br>
-Nightly snapshots are available <a
-href="http://cvs.apache.org/repository/org.apache.axis2/jars/">here</a></body>
-</html>
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Releases</title>
+  <link href="css/axis-docs.css" rel="stylesheet" type="text/css" media="all">
+</head>
+
+<body>
+<h2>Apache Axis2 Releases</h2>
+
+<div align="left">
+<p>This page has links to the release versions of Axis2 Java. For more
+information, please see <a
+href="http://www.apache.org/dev/release.html">Apache Release FAQ</a>.</p>
+</div>
+
+<div align="center">
+
+<table border="1" style="border-collapse: collapse" width="93%" id="table1">
+  <tbody>
+    <tr>
+      <th>Version</th>
+      <th>Date</th>
+      <th>Description</th>
+    </tr>
+    <tr>
+      <td><a
+      href="download/1_1_1/download.cgi"><strong>1.1.1</strong></a></td>
+      <td>20 - 12 - 2006</td>
+      <td>1.1.1 Release (Mirrored)</td>
+    </tr>
+    <tr>
+      <td><a href="download/1_1/download.cgi"><strong>1.1</strong></a></td>
+      <td>13 - 11 - 2006</td>
+      <td>1.1 Release (Mirrored)</td>
+    </tr>
+    <tr>
+      <td><a href="download/1_0/download.cgi"><strong>1.0</strong></a></td>
+      <td>04 - 05 - 2006</td>
+      <td>1.0 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_95/download.cgi"><strong>0.95</strong></a></td>
+      <td>23 - 03 - 2006</td>
+      <td>0.95 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_94/download.cgi"><strong>0.94</strong></a></td>
+      <td>11- 01 -2006</td>
+      <td>0.94 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_93/download.cgi"><strong>0.93</strong></a></td>
+      <td>12- 02 - 2005</td>
+      <td>0.93 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_92/download.cgi"><strong>0.92</strong></a></td>
+      <td>26 -08 - 2005</td>
+      <td>0.92 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_91/download.cgi"><strong>0.91</strong></a></td>
+      <td>16 -08 - 2005</td>
+      <td>0.91 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/0_9/download.cgi"><strong>0.9</strong></a></td>
+      <td>05 - 07 - 2005</td>
+      <td>0.9 Release (Archived)</td>
+    </tr>
+    <tr>
+      <td><a href="download/M2/download.cgi"><strong>M2</strong></a></td>
+      <td>08 - 06 - 2005</td>
+      <td>Milestone Release #2 (Archived)</td>
+    </tr>
+  </tbody>
+</table>
+</div>
+
+<h4>Axis2 Maven Repository</h4>
+
+<p>Released Axis2 jars are available <a
+href="http://www.apache.org/dist/java-repository/axis2/">here</a></p>
+
+<h4>Nightly Builds</h4>
+Nightly builds of Axis2 <strong>distributions</strong> are available <a
+href="http://cvs.apache.org/dist/axis2/nightly">here</a> <br>
+Nightly SNAPSHOT <strong>Maven Repository</strong> are available <a
+href="http://cvs.apache.org/repository/org.apache.axis2/jars/">here</a></body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/download/1_1/download.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/1_1/download.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/1_1/download.html (original)
+++ webservices/axis2/trunk/java/xdocs/download/1_1/download.html Mon Jan 22 21:34:03 2007
@@ -17,27 +17,7 @@
       <!--<th scope="col">Items</th>-->
       <th scope="col">Download</th>
     </tr>
-    <!--<tr>
-    <td><strong>Minimal Distribution - Source</strong></td>
-    <td background="#_Toc96698083"><p>This will contain the sources of
-    Axis2 minimal distribution. One can generate a binary distribution
-    from this by typing  <span class="style1">$maven dist-min-bin.
-    </span>(<a href="http://ws.apache.org/axis2/1_1/installationguide.html#_Toc96698083">Set
-    up Axis2 environment</a> before running this command)</p>
-    </td>
-    <td><ul>
-    <li>sources of Axis2 common, java2wsdl , adb and core modules</li>
-    <li>README.TXT and release-notes.html</li>
-    </ul>
-    </td>
-    <td><a href="[preferred]/ws/axis2/1_1/axis2-min-1.1-src.zip"
-    title="[preferred]/ws/axis2/1_1/axis2-min-1.1-src.zip">zip</a> <a
-    href="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-src.zip.md5"
-    title="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-src.zip.md5">MD5</a>
-    <a
-    href="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-src.zip.asc"
-    title="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-src.zip.asc">PGP</a></td>
-    </tr>-->
+
     <tr>
       <td><a name="std-bin"></a><strong>Standard Binary
       Distribution</strong></td>
@@ -47,42 +27,15 @@
         default, this distribution will contain addressing.mar. But  the
         other modules that are being developed within Axis2 will not be
         included here and are available to be downloaded separately from <a
-        href="../../modules/index.html">here</a>.)</td>
-      <!--<td><ul>
-          <li>all the content of minimal-binary distribution</li>
-          <li>Contents of codegen and doom modules</li>
-          <li>Samples</li>
-          <li>addressing-1.1.mar</li>
-        </ul>
-      </td>-->
-      <td><a href="[preferred]/ws/axis2/1_1/axis2-std-1.1-bin.zip"
-        title="[preferred]/ws/axis2/1_1/axis2-std-1.1-bin.zip">zip</a> <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-bin.zip.md5"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-bin.zip.md5">MD5</a>
-        <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-bin.zip.asc"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-bin.zip.asc">PGP</a></td>
-    </tr>
-    <!--<tr>
-      <td><strong>Minimal Binary Distribution</strong></td>
-      <td>This distribution is aimed at advanced users who will be embedding
-        Axis2. It will contain the minimal runtime required to act as a Web
-        service client and/or a server (axis2-kernel-1.1.jar will contain
-        compiled versions of common and core modules.)</td>
-      <td><ul>
-          <li>axis2-kernel-1.1.jar, axis2-adb-1.1.jar</li>
-          <li>third party distributable libraries</li>
-          <li>README.TXT and release-notes.html</li>
-        </ul>
-      </td>
-      <td><a href="[preferred]/ws/axis2/1_1/axis2-min-1.1-bin.zip"
-        title="[preferred]/ws/axis2/1_1/axis2-min-1.1-bin.zip">zip</a> <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-bin.zip.md5"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-bin.zip.md5">MD5</a>
+        href="../../modules/index.html">here</a>.)</td>
+      <td><a href="[preferred]/ws/axis2/1_1/axis2-1.1.zip"
+        title="[preferred]/ws/axis2/1_1/axis2-1.1.zip">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1.zip.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1.zip.md5">MD5</a>
         <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-bin.zip.asc"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-min-1.1-bin.zip.asc">PGP</a></td>
-    </tr>-->
+        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1.zip.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1.zip.asc">PGP</a></td>
+    </tr>
     <tr>
       <td><a name="src"></a><strong> Source Distribution</strong></td>
       <td>This will contain the sources of Axis2 standard distribution. One
@@ -90,30 +43,21 @@
         class="style1">$maven dist-standard-bin. </span>(<a
         href="http://ws.apache.org/axis2/1_1/installationguide.html#env-src">Set
         up Axis2 environment</a> before running this command)</td>
-      <!--<td><ul>
-          <li>all the content of minimal-source distribution</li>
-          <li>Contents of codegen and doom modules</li>
-          <li>Samples</li>
-        </ul>
-      </td>-->
-      <td><a href="[preferred]/ws/axis2/1_1/axis2-std-1.1-src.zip"
-        title="[preferred]/ws/axis2/1_1/axis2-std-1.1-src.zip">zip</a> <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-src.zip.md5"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-src.zip.md5">MD5</a>
+
+      <td><a href="[preferred]/ws/axis2/1_1/axis2-1.1-src.zip"
+        title="[preferred]/ws/axis2/1_1/axis2-1.1-src.zip">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-src.zip.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-src.zip.md5">MD5</a>
         <a
-        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-src.zip.asc"
-        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-std-1.1-src.zip.asc">PGP</a></td>
+        href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-src.zip.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-src.zip.asc">PGP</a></td>
     </tr>
     <tr>
       <td><a name="war"></a><strong>WAR (Web Archive)
       Distribution</strong></td>
       <td>This will be the web application of Axis2 which can be deployed in
         most of the servlet containers.</td>
-      <!--<td><ul>
-          <li>all the contents of the minimal distribution</li>
-          <li>Admin Web Application</li>
-        </ul>
-      </td>-->
+
       <td><a href="[preferred]/ws/axis2/1_1/axis2.war"
         title="[preferred]/ws/axis2/1_1/axis2.war">zip</a> <a
         href="http://www.apache.org/dist/ws/axis2/1_1/axis2.war.md5"
@@ -124,11 +68,7 @@
     <tr>
       <td><strong>Documents Distribution</strong></td>
       <td>This will contain all the documentation in one package.</td>
-      <!--<td><ul>
-          <li>xdocs</li>
-          <li>javadocs</li>
-        </ul>
-      </td>-->
+ 
       <td><a href="[preferred]/ws/axis2/1_1/axis2-1.1-docs.zip"
         title="[preferred]/ws/axis2/1_1/axis2-1.1-docs.zip">zip</a> <a
         href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-docs.zip.md5"
@@ -137,16 +77,7 @@
         href="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-docs.zip.asc"
         title="http://www.apache.org/dist/ws/axis2/1_1/axis2-1.1-docs.zip.asc">PGP</a></td>
     </tr>
-    <!--<tr>
-    <td><a name="Plugin" id="Plugin">Plugin Distribution</a></td>
-    <td>This will contain the plugins that are created for Eclipse and
-    IDEA.</td>
-    <td><ul>
-    <li>IntelliJ IDEA plugins</li>
-    <li>Eclipse plugins</li>
-    </ul>
-    </td>
-    </tr>-->
+ 
   </tbody>
 </table>
 </div>
@@ -180,9 +111,10 @@
 the <a href="http://www.apache.org/dev/release-signing#openpgp">OpenPGP</a>
 compatible signature from the main Apache site. These can be downloaded by
 following the links above. This <a
-href="http://www.apache.org/dist/ws/axis2/KEYS">KEYS</a> file contains the
-public keys used for signing release. It is recommended that (when possible)
-a <a href="http://www.apache.org/dev/release-signing#web-of-trust">Web of
+href="http://www.apache.org/dist/ws/axis2/KEYS">KEYS</a> file contains the 
+public keys that can be used for verifying signatures. It is recommended that 
+(when possible)a 
+<a href="http://www.apache.org/dev/release-signing#web-of-trust">Web of
 trust</a> is used to confirm the identity of these keys.</p>
 </div>
 </body>

Added: webservices/axis2/trunk/java/xdocs/download/1_1_1/download.cgi
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/1_1_1/download.cgi?view=auto&rev=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/1_1_1/download.cgi (added)
+++ webservices/axis2/trunk/java/xdocs/download/1_1_1/download.cgi Mon Jan 22 21:34:03 2007
@@ -0,0 +1,6 @@
+#!/bin/sh
+# Wrapper script around mirrors.cgi script
+# (we must change to that directory in order for python to pick up the
+#  python includes correctly)
+cd /www/www.apache.org/dyn/mirrors
+/www/www.apache.org/dyn/mirrors/mirrors.cgi $*
\ No newline at end of file

Added: webservices/axis2/trunk/java/xdocs/download/1_1_1/download.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/1_1_1/download.html?view=auto&rev=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/1_1_1/download.html (added)
+++ webservices/axis2/trunk/java/xdocs/download/1_1_1/download.html Mon Jan 22 21:34:03 2007
@@ -0,0 +1,121 @@
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Axis2 1.1.1 Release</title>
+</head>
+
+<body>
+<h2>Axis2 1.1.1 Release</h2>
+
+<div>
+
+<table border="1" cellpadding="1">
+  <tbody>
+    <tr>
+      <th scope="col">Distribution Name</th>
+      <th scope="col">Description</th>
+      <!--<th scope="col">Items</th>-->
+      <th scope="col">Download</th>
+    </tr>
+
+    <tr>
+      <td><a name="std-bin"></a><strong>Standard Binary
+      Distribution</strong></td>
+      <td>This is the complete version of Axis2 and will contain useful
+        samples as well. Useful for some one to get familiar with Axis2.
+        (Since WS-Addressing implementation module is engaged in to Axis2, by
+        default, this distribution will contain addressing.mar. But  the
+        other modules that are being developed within Axis2 will not be
+        included here and are available to be downloaded separately from <a
+        href="../../modules/index.html">here</a>.)</td>
+      <td><a href="[preferred]/ws/axis2/1_1_1/axis2-1.1.1.zip"
+        title="[preferred]/ws/axis2/1_1_1/axis2-1.1.1.zip">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1.zip.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1.zip.md5">MD5</a>
+        <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1.zip.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1.zip.asc">PGP</a></td>
+    </tr>
+    <tr>
+      <td><a name="src"></a><strong> Source Distribution</strong></td>
+      <td>This will contain the sources of Axis2 standard distribution. One
+        can generate a binary distribution from this by typing <span
+        class="style1">$maven dist-standard-bin. </span>(<a
+        href="http://ws.apache.org/axis2/1_1_1/installationguide.html#env-src">Set
+        up Axis2 environment</a> before running this command)</td>
+
+      <td><a href="[preferred]/ws/axis2/1_1_1/axis2-1.1.1-src.zip"
+        title="[preferred]/ws/axis2/1_1_1/axis2-1.1.1-src.zip">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-src.zip.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-src.zip.md5">MD5</a>
+        <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-src.zip.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-src.zip.asc">PGP</a></td>
+    </tr>
+    <tr>
+      <td><a name="war"></a><strong>WAR (Web Archive)
+      Distribution</strong></td>
+      <td>This will be the web application of Axis2 which can be deployed in
+        most of the servlet containers.</td>
+
+      <td><a href="[preferred]/ws/axis2/1_1_1/axis2.war"
+        title="[preferred]/ws/axis2/1_1_1/axis2.war">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2.war.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2.war.md5">MD5</a>
+        <a href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2.war.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2.war.asc">PGP</a></td>
+    </tr>
+    <tr>
+      <td><strong>Documents Distribution</strong></td>
+      <td>This will contain all the documentation in one package.</td>
+ 
+      <td><a href="[preferred]/ws/axis2/1_1_1/axis2-1.1.1-docs.zip"
+        title="[preferred]/ws/axis2/1_1_1/axis2-1.1.1-docs.zip">zip</a> <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-docs.zip.md5"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-docs.zip.md5">MD5</a>
+        <a
+        href="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-docs.zip.asc"
+        title="http://www.apache.org/dist/ws/axis2/1_1_1/axis2-1.1.1-docs.zip.asc">PGP</a></td>
+    </tr>
+ 
+  </tbody>
+</table>
+</div>
+
+<div align="left">
+<br>
+
+
+<p>[if-any logo] <a href="[link]"><img align="right" src="[logo]"
+border="0"></a>[end] The currently selected mirror is <b>[preferred]</b>.  If
+you encounter a problem with this mirror, please select another mirror.  If
+all mirrors are failing, there are <i>backup</i> mirrors (at the end of the
+mirrors list) that should be available.</p>
+
+<form action="[location]" method="get" id="SelectMirror">
+  Other mirrors: 
+  <select name="Preferred">[if-any http][for http]
+    <option value="[http]"
+    selected="selected">[http]</option>[end][end][if-any ftp][for ftp]
+    <option value="[ftp]">[ftp]</option>[end][end][if-any backup][for backup]
+    <option value="[backup]">[backup] (backup)</option>[end][end]
+  </select>
+   
+  <input type="submit" value="Change"></form>
+
+<p>You may also consult the <a href="http://www.apache.org/mirrors/">complete
+list of mirrors</a>.</p>
+
+<p><strong>Note:</strong> when downloading from a mirror please check the <a
+href="http://www.apache.org/dev/release-signing#md5">md5sum</a> and verify
+the <a href="http://www.apache.org/dev/release-signing#openpgp">OpenPGP</a>
+compatible signature from the main Apache site. These can be downloaded by
+following the links above. This <a
+href="http://www.apache.org/dist/ws/axis2/KEYS">KEYS</a> file contains the 
+public keys that can be used for verifying signatures. It is recommended that 
+(when possible)a 
+<a href="http://www.apache.org/dev/release-signing#web-of-trust">Web of
+trust</a> is used to confirm the identity of these keys.</p>
+</div>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/faq.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/faq.html?view=diff&rev=498925&r1=498924&r2=498925
==============================================================================
--- webservices/axis2/trunk/java/xdocs/faq.html (original)
+++ webservices/axis2/trunk/java/xdocs/faq.html Mon Jan 22 21:34:03 2007
@@ -29,9 +29,9 @@
   <li>General
     <ul>
       <li><a href="#a1">I'm having a problem using Axis2. What should I do?</a></li>
-      <li><a href="#a2">What is OMElement, What does it represents?</a></li>
-      <li><a href="#a3">Integration security tests fail with JDK 1.5<br>
-        </a></li>
+      <!--li><a href="#a2">What is OMElement, What does it represents?</a></li-->
+      <li><a href="#a3">Integration security tests fail with JDK 1.5</a></li>
+       <li><a href="#a4">Axis2 is not working with Java 6</a></li>
         
     </ul>
   </li>
@@ -108,6 +108,15 @@
     <p>NOTE: For Windows XP the correct version can be found using 'java
     -version'. The correct file is JRE (typically c:\Program
     Files\Java\jre&lt;version&gt;\lib\security\java.security.</p>
+  </li>
+    <li><a name="a4"></a><strong>Axis2 is not working with Java 6</strong><br>
+
+    <p>You have to copy the stax-api jar in the axis2 distribution
+     into your JRE's endorsed directory (see info on endorsed directory
+     here -<a href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/">
+     http://java.sun.com/j2se/1.4.2/docs/guide/standards/</a>).</p>
+    <p>This issue can also be resolved by copying the stax-api jar to tomcat's 
+    common/endorsed folder, when deploying Axis2 in tomcat,</p>
   </li>
 </ol>
 



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