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 ch...@apache.org on 2007/05/25 10:09:37 UTC
svn commit: r541579 [11/18] - in /webservices/axis2/trunk/java/xdocs: ./
@axis2_version_dir@/ @axis2_version_dir@/adb/
@axis2_version_dir@/adb/images/ @axis2_version_dir@/images/
@axis2_version_dir@/images/archi-guide/ @axis2_version_dir@/images/usergu...
Added: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/userguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/userguide.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/userguide.html (added)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/userguide.html Fri May 25 01:09:03 2007
@@ -0,0 +1,361 @@
+<?xml version="1.0" encoding=""?>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+ <meta http-equiv="content-type" content="" />
+ <title>Apache Axis2 User's Guide- Introducing Axis2</title>
+ <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+ media="all" />
+</head>
+
+<body xml:lang="en" lang="en">
+<h1>Apache Axis2 User's Guide</h1>
+
+<p>This guide provides a starting place for users who are new to Apache
+Axis2. It also covers some advanced topics, such as how to use Axis2 to
+create and deploy Web services as well as how to use WSDL to generate both
+clients and services.</p>
+For experienced users of Apache Axis2, we recommend the <a
+href="adv-userguide.html">Advanced User's Guide.</a> <a name="intro"></a>
+
+<h1>Introducing Axis2</h1>
+
+<p>This section introduces Axis2 and its structure, including an explanation
+of various directories/files included in the latest Axis2 <a
+href="http://ws.apache.org/axis2/download.cgi">download</a>.</p>
+
+<h2>Content</h2>
+<ul>
+ <li><a href="userguide.html#intro"><strong>Introducing
+ Axis2</strong></a><br />
+
+ <ul>
+ <li><a href="userguide.html#whatis"><strong>What is
+ Axis2?</strong></a></li>
+ <li><a href="userguide.html#underhood"><strong>What's under the
+ hood?</strong></a></li>
+ <li><a href="userguide.html#handlessoap"><strong>How Axis2 handles SOAP
+ messages</strong></a></li>
+ <li><a href="userguide.html#distributions"><strong>Axis2
+ Distributions</strong></a></li>
+ <li><a href="userguide.html#sbd"><strong>The Axis2 Standard Binary
+ Distribution</strong></a></li>
+ <li><a href="userguide.html#hierarchy"><strong>Axis2.war Directory
+ Hierarchy</strong></a></li>
+ <li><a href="userguide.html#docs"><strong>Axis2 Documents
+ Distribution</strong></a></li>
+ <li><a href="userguide.html#clients"><strong>Axis2 and
+ Clients</strong></a></li>
+ </ul>
+ </li>
+ <li><a href="userguide-installingtesting.html#installingtesting">Installing
+ and Testing Client Code</a></li>
+ <li><a href="userguide-introtoservices.html#introservices">Introduction to
+ Services</a><br />
+
+ <ul>
+ <li><a href="userguide-introtoservices.html#messageexchange">Message
+ Exchange Patterns</a></li>
+ </ul>
+ </li>
+ <li><a href="userguide-creatingclients.html#createclients">Creating
+ Clients</a><br />
+
+ <ul>
+ <li><a href="userguide-creatingclients.html#choosingclient">Choosing a
+ Client Generation Method</a></li>
+ <li><a href="userguide-creatingclients.html#generating">Generating
+ Clients</a></li>
+ <li><a href="userguide-creatingclients.html#adb">Axis Data Binding
+ (ADB)</a></li>
+ </ul>
+ </li>
+ <li><a href="userguide-buildingservices.html#buildservices">Building
+ Services</a><br />
+
+ <ul>
+ <li><a href="userguide-buildingservices.html#getcomfortable">Getting
+ Comfortable with Available Options</a></li>
+ <li><a href="userguide-buildingservices.html#createscratch">Creating a
+ Service from Scratch</a></li>
+ <li><a href="userguide-buildingservices.html#deploypojo">Deploying
+ Plain Old Java Objects</a></li>
+ <li><a href="userguide-buildingservices.html#deployrun">Deploying and
+ Running an Axis2 Service Created from WSDL</a></li>
+ </ul>
+ </li>
+ <li><a href="userguide-samples.html">Samples</a></li>
+ <li><a href="userguide-forfurtherstudy.html">For Further Study</a></li>
+</ul>
+<a name="whatis"></a>
+
+<h2>What is Axis2?</h2>
+
+<p>The Apache Axis2 project is a Java-based implementation of both the client
+and server sides of the Web services equation. Designed to take advantage of
+the lessons learned from Apache Axis 1.0, Apache Axis2 provides a complete
+object model and a modular architecture that makes it easy to add
+functionality and support for new Web services-related specifications and
+recommendations.</p>
+
+<p>Axis2 enables you to easily perform the following tasks:</p>
+<ul>
+ <li>Send SOAP messages</li>
+ <li>Receive and process SOAP messages</li>
+ <li>Create a Web service out of a plain Java class</li>
+ <li>Create implementation classes for both the server and client using
+ WSDL</li>
+ <li>Easily retrieve the WSDL for a service</li>
+ <li>Send and receive SOAP messages with attachments</li>
+ <li>Create or utilize a REST-based Web service</li>
+ <li>Create or utilize services that take advantage of the <a
+ href="http://www.oasis-open.org/committees/download.php/16790/wss-v1.1-spec-os-SOAPMessageSecurity.pdf">WS-Security</a>,
+ <a
+ href="http://xml.coverpages.org/ws-reliablemessaging20030313.pdf">WS-ReliableMessaging</a>,
+ <a href="http://www.w3.org/2002/ws/addr/">WS-Addressing</a>, <a
+ href="http://dev2dev.bea.com/pub/a/2004/03/ws-coordination.html">WS-Coordination</a>,
+ and <a
+ href="ftp://www6.software.ibm.com/software/developer/library/WS-AtomicTransaction.pdf">WS-Atomic
+ Transaction</a> recommendations</li>
+ <li>Use Axis2's modular structure to easily add support for new
+ recommendations as they emerge</li>
+</ul>
+
+<p>Many more features exist as well, but this user guide concentrates on
+showing you how to accomplish the first five tasks on this list.</p>
+<a name="underhood"></a>
+
+<h2>What's Under the Hood?</h2>
+
+<p>To understand Axis2 and what it does, you must have a good idea of the
+life cycle of a Web services message. Typically, it looks something like
+this:</p>
+
+<p><img alt="Lifecycle of a Web services message" src="images/fig01.jpg"
+/><br clear="all" />
+</p>
+
+<p>The sending application creates the original SOAP message, an XML message
+that consists of headers and a body. (For more information on SOAP, see "<a
+href="userguide-introtoservices.html/">Introduction to Services</a>".) If the
+system requires the use of WS* recommendations such as WS-Addressing or
+WS-Security, the message may undergo additional processing before it leaves
+the sender. Once the message is ready, it is sent via a particular transport
+such as HTTP, JMS, and so on.</p>
+
+<p>The message works its way over to the receiver, which takes in the message
+via the transport listener. (In other words, if the application doesn't have
+an HTTP listener running, it's not going to receive any HTTP messages.)
+Again, if the message is part of a system that requires the use of
+WS-Security or other recommendations, it may need additional processing for
+the purpose of checking credentials or decrypting sensitive information.
+Finally, a dispatcher determines the specific application (or other
+component, such as a Java method) for which the message was intended, and
+sends it to that component. That component is part of an overall application
+designed to work with the data being sent back and forth.</p>
+<a name="handlessoap"></a>
+
+<h2>How Axis2 Handles SOAP Messages</h2>
+
+<p>Axis2 can handle processing for both the sender and the receiver in a
+transaction. From the Axis2 perspective, the structure looks like this:</p>
+
+<p><img alt="Axis2 handles SOAP messages" src="images/fig02.jpg" /><br
+clear="all" />
+</p>
+
+<p>On each end, you have an application designed to deal with the (sent or
+received) messages. In the middle, you have Axis2, or rather, you
+<em>can</em> have Axis2. The value of Web services is that the sender and
+receiver (each of which can be either the server or the client) don't even
+have to be on the same platform, much less running the same application.
+Assuming that Axis2 is running on both sides, the process looks like this:</p>
+<ul>
+ <li>The sender creates the SOAP message.</li>
+ <li>Axis "handlers" perform any necessary actions on that message such as
+ encryption of WS-Security related messages.</li>
+ <li>The transport sender sends the message.</li>
+ <li>On the receiving end, the transport listener detects the message.</li>
+ <li>The transport listener passes the message on to any handlers on the
+ receiving side.</li>
+ <li>Once the message has been processed in the "pre-dispatch" phase, it is
+ handed off to the dispatchers, which pass it on to the appropriate
+ application.</li>
+</ul>
+
+<p>In Axis2, these actions are broken down into "phases", with several
+pre-defined phases, such as the "pre-dispatch", "dispatch," and "message
+processing", being built into Axis2. Each phase is a collection of
+"handlers". Axis2 enables you to control what handlers go into which phases,
+and the order in which the handlers are executed within the phases. You can
+also add your own phases and handlers.</p>
+
+<p>Handlers come from "modules" that can be plugged into a running Axis2
+system. These modules, such as Rampart, which provides an implementation of
+WS-Security, and Sandesha, which provides an implementation of
+WS-ReliableMessaging, are the main extensibility mechanisms in Axis2.</p>
+<a name="distributions"></a>
+
+<h2>Axis2 Distributions</h2>
+
+<p>Axis2 is released in several <a
+href="http://ws.apache.org/axis2/download/@axis2_version_dir@/download.cgi">distributions</a>.
+Which one you need depends on what you'll be doing with it.</p>
+<a name="sbd"></a>
+
+<h3>The Axis2 Standard Binary Distribution</h3>
+
+<p>If you're developing services and applications, you'll need the Axis2 <a
+href="http://ws.apache.org/axis2/download/@axis2_version_dir@/download.cgi#std-bin">Standard
+Binary Distribution</a>. The distribution includes all the necessary *.jar
+files, as well as a variety of scripts that ease development. It has the
+following structure.</p>
+
+<p><b>Code Listing 1: Axis2 Standard Binary Distribution</b></p>
+<pre>bin
+ axis2.bat
+ axis2.sh
+ axis2server.bat
+ axis2server.sh
+ java2wsdl.bat
+ java2wsdl.sh
+ wsdl2java.bat
+ wsdl2java.sh
+ setenv.sh
+lib
+ activation-1.1.jar
+ ...
+ XmlSchema.jar
+repository
+ modules
+ modules.list
+ addressing-1.1.mar
+ ..
+ services
+ services.list
+ version.aar
+ ..
+samples
+ ...
+webapp
+ ...
+conf
+ axis2.xml
+
+LICENSE.txt
+README.txt
+NOTICE.txt
+INSTALL.txt
+release-notes.html</pre>
+
+<p>The bin directory includes a number of useful scripts. They include
+axis2.bat (or axis2.sh), which enables you to easily execute a Java command
+without having to manually add all the Axis2 jar files to the classpath,
+java2wsdl.bat (and .sh) and wsdl2java.bat (and .sh), which enable you to
+easily generate Java code from a WSDL file and vice versa, and
+axis2server.bat (and sh), a simple Web server that enables you to build
+Axis2's capability to send and receive messages into your own application.</p>
+
+<p>As expected, the lib directory includes all the necessary .jar files.
+Services and modules are added to the repository directory. Axis2 comes with
+a standard module implementing WS-Addressing, and you can add any other
+necessary module such as Rampart to the repository/modules directory.</p>
+
+<p>conf directory includes the axis2.xml which is the global deployment
+descriptor.</p>
+
+<p>Finally, the samples directory includes all the sample code distributed
+with Axis2. See the list of <a href="userguide-samples.html">samples and
+their descriptions</a>.</p>
+<a name="hierarchy"></a>
+
+<h2>axis2.war Distribution Directory Hierarchy</h2>
+
+<p>axis2.war is available in <a
+href="http://ws.apache.org/axis2/download/@axis2_version_dir@/download.cgi#war">WAR (Web
+Archive) Distribution</a>. The server side of Axis2 ships as a J2EE
+application, and has the following structure shown in Code Listing 2.</p>
+
+<p><b>Code Listing 2: Server Side of Axis2</b></p>
+<pre>axis2-web
+META-INF
+WEB-INF
+ classes
+ conf
+ axis2.xml
+ lib
+ activation.jar
+ ...
+ xmlSchema.jar
+ modules
+ modules.list
+ addressing.mar
+ ...
+ soapmonitor.mar
+ services
+ services.list
+ aservice.aar
+ ...
+ version.aar
+ web.xml</pre>
+
+<p>Starting at the top, axis2-web is a collection of JSPs that make up the <a
+href="webadminguide.html">Axis2 administration application</a>, through which
+you can perform any needed actions such as adding services and engaging and
+dis-engaging modules. The WEB-INF directory represents the actual Axis2
+application, including all the *.jar files, any included modules, and even
+the deployed services themselves.</p>
+
+<p>The classes directory holds any class or property files that are needed by
+Axis2 itself, such as log4j.properties. Any actual services to be handled by
+the system reside in the services directory in the form of an axis archive,
+or *.aar file. This file contains any classes related to the service, as well
+as the services.xml file, which controls any additional requirements, such as
+the definition of message senders and message receivers.</p>
+
+<p>The main file in all this is axis2.xml, which controls how the application
+deals with received messages. It defines message receivers and transport
+receivers, as well as defining transport senders and determining which
+modules are active. It also defines the order of phases, and the handlers to
+be executed within each phase.</p>
+
+<p>You can control all of this information through the use of the Web
+application, but if you restart the Axis2 application, these changes are lost
+and the server goes back to the definitions in the axis2.xml file.</p>
+
+<p>Axis2 also provides a third distribution, the <a
+href="http://ws.apache.org/axis2/download/@axis2_version_dir@/download.cgi#src">source
+distribution</a>, which enables you to generate this .war file yourself.</p>
+<a id="docs"></a>
+
+<h2>Axis2 Documentation Distribution Directory Hierarchy</h2>
+
+<p>The Documents distribution includes all Axis2 documentation including the
+xdcos and javadocs. It has the following structure:</p>
+
+<p><b>Code Listing 3: Axis2 Documents Distribution</b></p>
+<pre>docs
+ javadocs
+ xdocs
+
+LICENSE.txt
+README.txt
+release-notes.html</pre>
+
+<p>The javadocs directory includes all the standard <a
+href="../../javadocs/index.html">API documentation</a> for the Axis2 API,
+with other documentation (like this document) in the xdocs directory.</p>
+<a name="clients"></a>
+
+<h2>Axis2 and Clients</h2>
+
+<p>Now that explains how Axis2 behaves as part of a Web application. What
+about a standalone client that is not part of a J2EE application? In that
+case, a sender can use the Axis2 default properties, in other words, no
+special handlers, and so on. But you also have the option to tell the client
+to load its own copy of the axis2.xml file and behave accordingly.</p>
+
+<p><strong>See Next Section</strong> - <a
+href="userguide-installingtesting.html#installingtesting">Installing and
+Testing Client Code</a></p>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/webadminguide.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/webadminguide.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/webadminguide.html (added)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/webadminguide.html Fri May 25 01:09:03 2007
@@ -0,0 +1,346 @@
+<!-- saved from url=(0022)http://internet.e-mail -->
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="content-type" content="">
+ <title>Apache Axis2 Web Administrator's Guide</title>
+ <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+ media="all">
+</head>
+
+<body lang="en">
+<h1 align="center">Apache Axis2 Web Administrator's Guide</h1>
+
+<p>This document gives you detailed information on the administration console
+of the Apache Axis2 Web application. Apache Axis2 Administration is all about
+configuring Apache Axis2 at run time, where the configuration is
+transient.</p>
+
+<p><i>Send your feedback to: <a
+href="mailto:axis-dev@ws.apache.org?subject=[Axis2]">axis-dev@ws.apache.org</a></i>.
+(Subscription details are available on the <a
+href="http://ws.apache.org/axis2/mail-lists.html">Axis2 site</a>.) Kindly
+prefix every email subject with [Axis2].</p>
+
+<h2>Contents</h2>
+<ul>
+ <li><a href="#Intro">Introduction</a>
+ <ul>
+ <li><p><a href="#login">Login into Administration Site</a></p>
+ </li>
+ </ul>
+ </li>
+ <li><a href="#adminoptions">Administration Options</a>
+ <ul>
+ <li><p><a href="#tools">Tools</a></p>
+ <ul>
+ <li><a href="#upservice">Upload Service</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#syscomponents">System components</a></p>
+ <ul>
+ <li><a href="#heading1">Available services</a></li>
+ <li><a href="#servgroups">Available service groups</a></li>
+ <li><a href="#avmodules">Available modules</a></li>
+ <li><a href="#globalmodules">Globally engaged modules</a></li>
+ <li><a href="#phases">Available phases</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#executionchains">Execution chains</a></p>
+ <ul>
+ <li><a href="#globalchains">Global chains</a></li>
+ <li><a href="#operationchains">Operation specific chains</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#engaginmodule">Engage module</a></p>
+ </li>
+ <li><a href="#services">Services</a>
+ <ul>
+ <li><a href="#turnoffservice">Deactivate Service</a></li>
+ <li><a href="#turnonservice">Activate Service</a></li>
+ <li><a href="#editservicepara">Edit service parameters</a></li>
+ </ul>
+ </li>
+ <li><p><a href="#context">Contexts</a></p>
+ <ul>
+ <li><a href="#viewhierarchy">View Hierarchy</a></li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul>
+<a name="Intro"></a>
+
+<h3>Introduction</h3>
+
+<p>The Apache Axis2 Web application has three main sections: 'Services' lists
+all the available services deployed in this server, 'Validate' checks the
+system to see whether all the required libraries are in place and views the
+system information, and 'Administration' is the Axis2 Web Administration
+module which is the console for administering the Apache Axis2
+installation.</p>
+
+<p>The Axis2 Web Administration module provides a way to configure Axis2
+dynamically. It's important to note that this dynamic configuration will NOT
+be persistent, i.e., if the servlet container is restarted, then all the
+dynamic configuration changes will be lost.</p>
+<a name="login"></a>
+
+<h4>Log on to the Administration Site</h4>
+
+<p>Once Apache Axis2 is successfully installed, the Web application can be
+accessed (see <a href="installationguide.html">Installation Guide</a> for
+instructions). From the <a href="#homepage">Axis2 Web Application Home
+page</a> you can go to the Administration page by clicking the
+'Administration' link. The Login page shown below will appear requesting the
+user name and password. The default user name is 'admin' (without quotes) and
+default password is 'axis2' (without quotes).</p>
+
+<p align="center"><img alt="" src="images/adminlogin.jpg"></p>
+
+<p>You can change the user name and password values by changing the following
+two parameters in the axis2.xml as required.</p>
+
+<p align="center"><img alt="" src="images/parameters.jpg"></p>
+
+<p>If the log on is successful, you will see the screen below. This is where
+you can view the configuration and the status of the running system and
+dynamically configure it.</p>
+
+<p align="center"><img alt="" src="images/admin.jpg"></p>
+<a name="adminoptions"></a>
+
+<h3>Administration Options</h3>
+<ul>
+ <a name="tools"><b>Tools</b></a>
+ <ul>
+ <li><a href="#upservice">Upload Service</a></li>
+ </ul>
+ <a name="syscomponents"><b>System components</b></a>
+ <ul>
+ <li><a href="#heading1">Available services</a></li>
+ <li><a href="#servgroups">Available service groups</a></li>
+ <li><a href="#avmodules">Available modules</a></li>
+ <li><a href="#globalmodules">Globally engaged modules</a></li>
+ <li><a href="#phases">Available phases</a></li>
+ </ul>
+ <a name="executionchains"><b>Execution chains</b></a>
+ <ul>
+ <li><a href="#globalchains">Global chains</a></li>
+ <li><a href="#operationchains">Operation specific chains</a></li>
+ </ul>
+ <b><a href="#engaginmodule">Engage module</a></b> <br>
+
+ <ul>
+ <li>For all Services</li>
+ <li>For a Service Group</li>
+ <li>For a Service</li>
+ <li>For an Operation</li>
+ </ul>
+ <a name="services"><b>Services</b></a>
+ <ul>
+ <li><a href="#turnoffservice">Deactivate service</a></li>
+ <li><a href="#turnonservice">Activate service</a></li>
+ <li><a href="#editservicepara">Edit service parameters</a></li>
+ </ul>
+ <a name="context"><b>Contexts</b></a>
+ <ul>
+ <li><a href="#viewhierarchy">View Hierarchy</a></li>
+ </ul>
+</ul>
+<a name="homepage"></a>
+
+<h3>Apache Axis2 Web Application Home Page</h3>
+
+<p align="center"><strong><img alt=""
+src="images/clip_image006.jpg"></strong></p>
+<a name="upservice"></a>
+
+<h3>Upload Services</h3>
+
+<p>You can upload packaged Apache Axis2<em> </em>service archive files using
+this page. This can be done in two simple steps:</p>
+<ul>
+ <li>Browse to the location and select the axisService archive file you wish
+ to upload</li>
+ <li>Then click Upload</li>
+</ul>
+
+<p align="center"><img alt="" src="images/clip_image010.jpg"></p>
+<a name="heading1"></a>
+
+<h3>Available Services</h3>
+
+<p>The functionality of the 'Available Services' option is almost the same as
+the functionality of the 'Services' option on the Axis2 Web Application Home
+page, where it displays a list of deployed services and their operations. As
+an additional feature, the 'Available Services' page lists details of modules
+that are engaged to the deployed services and their operations on a global,
+service or on an operation level.</p>
+
+<p>Using the 'Disengage' link, you can disengage the corresponding module as
+long as the module is not globally engaged (i.e., engaged to all the services
+and operations).</p>
+
+<p>Click on a specific service and it will give you the WSDL file of that
+particular service.</p>
+
+<p><strong>Faulty services</strong> of this system will also be listed on
+this page. Click on a faulty service to view a page that lists the exception
+stack trace of the exception, which caused the service to be faulty.</p>
+
+<p align="center"><img alt="" src="images/adminmain.jpg"></p>
+<a name="servgroups"></a>
+
+<h3>Available Service Groups</h3>
+
+<p>Service group is a logical collection of related services, and the
+'Available Service Groups' link will list all the available service groups in
+the system.</p>
+
+<p align="center"><img alt="" src="images/servicegroups.jpg"></p>
+<a name="avmodules"></a>
+
+<h3>Available Modules</h3>
+
+<p>To view the available modules in the 'modules' directory of the
+repository, click 'Available Modules'. This will show you all the available
+modules in the system. Those modules can be engaged dynamically.</p>
+
+<p align="center"><img alt="" src="images/modules.jpg"></p>
+<br>
+<a name="globalmodules"></a>
+
+<h3>Globally Engaged Modules</h3>
+
+<p>Click the 'Globally Engaged Modules' to view the globally engaged modules,
+if any. If a module is engaged globally, then the handlers that belong to
+that module will be executed irrespective of the service.</p>
+<a name="phases"></a>
+
+<h3>Available Phases</h3>
+
+<p>The 'Available Phases' link will display all the available phases. In
+Axis2, there are two levels of phases:</p>
+<ul>
+ <li>System predefined phases (not allowed to be changed)</li>
+ <li>User defined phases</li>
+</ul>
+
+<p>The main difference between these two levels is that system predefined
+phases will be invoked irrespective of the services, while the user defined
+phases will be invoked when the dispatcher finds the operation. Note that it
+is essential for module developers and service writers to have a good
+understanding of phases and phase ordering.</p>
+
+<p align="center"><img alt="" src="images/viewphases.jpg"></p>
+<br>
+<a name="globalchains"></a>
+
+<h3>Global Chains</h3>
+
+<p>The 'Global Chains' link will display all the Global Execution Chains. The
+most interesting feature of the Axis2 Web Administration Module is that it
+provides a very basic method of viewing the global phase list and handlers
+inside the phases depending on both the phase and handler orders. This kind
+of information is extremely useful in debugging the system, as there is no
+other way to list out handlers in the global chains. If you engage a new
+module, the new handlers will be added to the global chains and will be
+displayed on this page.</p>
+
+<p align="center"><img alt="" src="images/globalchain.jpg"></p>
+<br>
+<a name="operationchains"></a>
+
+<h3>Operation Specific Chains</h3>
+
+<p>The 'Operation Specific Chains' link can be used to view the handlers
+corresponding to a given service in the same order as it is in the real
+execution chain.</p>
+
+<p align="center"><img alt="" src="images/select_service_for_handler.jpg"></p>
+<br>
+
+
+<p>Select the service of whose service handlers you wish to view from the
+list, and click 'View' to view the handlers. The page below shows the service
+handlers of the service <em>version</em></p>
+
+<p align="center"><img alt="" src="images/serviceHandlers.jpg"></p>
+<br>
+<a name="engaginmodule"></a>
+
+<h3>Engaging Modules</h3>
+
+<p>The 'Engaging Modules' link allows you to engage modules either globally
+(to all services), to a service group, to a service, or to an operation
+depending on the module implementation. If the module was designed to engage
+the handlers globally, then the handlers in the module can be included in any
+phase in the system. It can be either a system predefined phase or a user
+defined phase.</p>
+
+<p>On the other hand, if the module was implemented in such a way that it is
+going to be deployed to a service or to an operation, then the module cannot
+be included in any of the <a href="#phases">System Predefined Phases</a>.
+Thus it can only be included in <a href="#phases">User Defined Phases</a>.</p>
+
+<p>Immediately after engaging the module, you can see the status of the
+engagement indicating whether it is engaged properly or not.</p>
+
+<p align="center"><img alt="" src="images/moduleengage.jpg"></p>
+<a name="turnoffservice"></a>
+
+<h3>Deactivate Service</h3>
+
+<p>The 'Deactivate Service' link under the 'Services' list will lead to the
+page below. The Deactivate service functionality provides a way to remove
+unnecessary services from the running system, but the removal is
+transient--which means that if you restart the system, the service will be
+active.</p>
+
+<p>To deactivate a service, select a service from the list, select the
+'Deactivate service' check box, and then click 'Deactivate'.. The 'Clear'
+button will clear the 'Deactivate service' check box.</p>
+
+<p align="center"><img alt="" src="images/inactivate.jpg"></p>
+<br>
+<a name="turnonservice"></a>
+
+<h3>Activate Service</h3>
+
+<p>The 'Activate Service' link under the 'Services' list will lead to the
+page below. The Activate service functionality provides a way to activate
+services while the system is running, but the activation is transient-- which
+means that if you restart the system, the service will be inactive.</p>
+
+<p>To activate a service, select a service from the list, select the
+'Activate Service' check box, then click 'Activate'. The 'Clear' button will
+clear the 'Activate service' check box.</p>
+
+<p align="center"><img alt="" src="images/activate.jpg"></p>
+<br>
+<a name="editservicepara"></a>
+
+<h3>Edit Service Parameters</h3>
+
+<p>This functionality provides a way to change the parameters in a service or
+its operations. These changes will be transient too, which means if you
+restart the system, the changes will not be reflected.</p>
+
+<p>The 'Edit Parameters' link under the 'Services' list (on the navigation
+bar) will link to the page where you can select the services of which you
+want to edit the parameters. Once the service is selected, click 'Edit
+Parameters'.. This will open the page shown below.</p>
+
+<p align="center"><img alt="" src="images/editserviecpara.jpg"></p>
+<br>
+<a name="viewhierarchy"></a>
+
+<h3>View Hierarchy</h3>
+
+<p>By listing the current context hierarchy, the 'View Hierarchy' link
+provides a means to look at the system state at run time. This will list out
+all the available service group contexts, service contexts, operation
+contexts, etc.</p>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/xmlbased-server.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/xmlbased-server.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/xmlbased-server.html (added)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/xmlbased-server.html Fri May 25 01:09:03 2007
@@ -0,0 +1,169 @@
+<html>
+<head>
+ <meta http-equiv="content-type" content="">
+ <title>Writing Web Services Using Axis2's Primary APIs</title>
+ <link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
+ media="all">
+</head>
+
+<body>
+<a name="Writing_Web_Services_Using Axis2's_Primary_APIs"></a>
+
+<h1>Writing Web Services Using Apache Axis2's Primary APIs</h1>
+
+<p>Apache Axis2 dispatches a component called
+<strong>MessageReceiver</strong> when Receiving a Message to the server.
+Apache Axis2 provides different implementations of this class and it can be
+configured by adding a messageReceiver tag to services.xml. Apache Axis2
+provides an implementation for a class of Message receivers called RawXml
+Message receivers. They work at the XML level and can only handle OMElements
+as parameters. This section explains how to write a service using them.</p>
+
+<p>In our example, the Web service will have two operations.</p>
+<pre>public void ping(OMElement element){} //IN-ONLY operation, just accepts the OMElement and does some processing.
+public OMElement echo(OMElement element){}//IN-OUT operation, accepts an OMElement and
+ // sends back the same again </pre>
+<a name="How_to_write_the_Web_Service_"></a>
+
+<h4>How to Write a Web Service?</h4>
+Writing a new Web service with Apache Axis2 involves four steps:
+<ol>
+ <li>Write the Implementation Class.</li>
+ <li>Write a services.xml file to explain the Web service.</li>
+ <li>Create a *.aar archive (Axis Archive) for the Web service.</li>
+ <li>Deploy the Web service.</li>
+</ol>
+<a name="Step1_:Write_the_Implementation_Class"></a>
+
+<h4>Step1: Write the Implementation Class</h4>
+
+<p>An implementation class has the business logic for the Web service and
+implements the operations provided by the Web service. Unless you have data
+binding, the signature of the methods can have only one parameter of the type
+OMElement.</p>
+
+<p>For more details on OMElement see the <a
+href="http://ws.apache.org/commons/axiom/OMTutorial.html">OM Tutorial</a>.</p>
+<pre>public class MyService{
+ public void ping(OMElement element){
+ // Business Logic
+ ......
+ }
+ public OMElement echo(OMElement element){
+ ......
+ }
+}</pre>
+<a name="Step2_:Write_the_services_xml_file"></a>
+
+<h4>Step2: Write the services.xml file</h4>
+
+<p>"services.xml" has the configuration for a Web service. Each Web service,
+deployed in Apache Axis2 , must have its configuration in "services.xml". The
+configuration for MyService is as follows:</p>
+<pre><service >
+ <description>
+ This is a sample Web service with two operations, echo and ping.
+ </description>
+ <parameter name="ServiceClass" locked="false">userguide.example1.MyService</parameter>
+ <operation name="echo">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
+ <actionMapping>urn:echo</actionMapping>
+ </operation>
+ <operation name="ping">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
+ <actionMapping>urn:ping</actionMapping>
+ </operation>
+ </service></pre>
+
+<p>The above XML tags can be explained as follows:</p>
+
+<p>1. The description of the service class is provided in the description
+tag.</p>
+<pre><service >
+ <description>
+ This is a sample Web service with two operations, echo and ping.
+ </description></pre>
+
+<p>2. The name of the service class is provided as a parameter.</p>
+<pre><parameter name="serviceClass" locked="false">userguide.example1.MyService</parameter></pre>
+
+<p>3. The "operation" XML tag describes the operations that are available in
+this service with respective message receivers.</p>
+<pre> <operation name="echo">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
+ <actionMapping>urn:echo</actionMapping>
+ </operation>
+ <operation name="ping">
+ <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
+ <actionMapping>urn:ping</actionMapping>
+ </operation></pre>
+
+<p>4. Every operation must map to a corresponding MessageReceiver class.
+After a message is processed by the handlers, the Axis2 engine hands it over
+to a MessageReceiver.</p>
+
+<p>5. For the "echo" operation, we have used a
+<strong>RawXMLINOutMessageReceiver</strong> since it is an IN-OUT operation.
+For the IN-ONLY operation "ping", we have used
+<strong>RawXMLINOnlyMessageReceiver</strong> as the message receiver.</p>
+
+<p>6. The actionMapping is required only if you want to enable WS-Addressing.
+This will be used later in this user guide.</p>
+
+<p>7. You can write a services.xml file to include a group of services
+instead of a single service. This makes the management and deployment of a
+set of related services very easy. At runtime, you can share information
+between these services within a single interaction using the
+ServiceGroupContext. If you hope to use this functionality, the services.xml
+file should have the following format.</p>
+<pre><ServiceGroup>
+ <service name="Service1">
+ <!-- details for Service1 -->
+ </service>
+ <service name="Service2">
+ <!-- details for Service2 -->
+ </service>
+ <module ref="ModuleName" />
+ <parameter name="serviceGroupParam1" locked="false">value 1</parameter>
+</serviceGroup></pre>
+
+<p>Note : The name of the service is a compulsory attribute.</p>
+<a name="Step3_:Create_the_Web_Service_Archive"></a>
+
+<h4>Step3: Create the Web Service Archive</h4>
+
+<p>Apache Axis2 uses the ".aar" (Axis Archive) file as the deployment package
+for Web services. Therefore, for MyService we will use "MyService.aar" with
+the "services.xml" packaged in the META-INF in the directory structure shown
+below. Please note that the name of the archive file will be the same as that
+of the service only if the services.xml contains only one service element.</p>
+
+<p><img src="images/userguide/ServiceItems.jpg" name="Graphic1"
+align="bottom" width="176" height="91" border="0"></p>
+
+<p>To create the archive file, you can create a .jar file containing all the
+necessary files and then rename it to a .aar file. This archive file can be
+found in the "Axis2_HOME/samples/userguide" directory. This file has to be
+deployed now.</p>
+<a name="Step4_:Deploy_the_Web_Service"></a>
+
+<h4>Step4: Deploy the Web Service</h4>
+
+<p>The service can be deployed by dropping the ".aar" file into the
+"services" directory in "/webapps/axis2/WEB-INF" of your servlet container.
+Start the servlet container (if you have not already started), click the link
+"Services" on the <a href="http://localhost:8080/axis2/" target="_blank">Home
+Page of Axis2 Web Application</a> (http://localhost:8080/axis2) and see
+whether MyService is deployed properly. If you can see the following output,
+then you have successfully deployed MyService on Apache Axis2.
+Congratulations !!</p>
+
+<p align="center"><img src="images/userguide/MyServiceDeployed.jpg"
+name="Graphic2" align="bottom" border="0"></p>
+
+<p>Note: Apache Axis2 provides an easy way to deploy Web services using the
+"Upload Service" tool on the Axis2 Web Application's Administration module.
+Please refer to the <a href="webadminguide.html" target="_blank">Web
+Administration Guide</a> for more information.</p>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/archived_news.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/archived_news.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/archived_news.html (added)
+++ webservices/axis2/trunk/java/xdocs/archived_news.html Fri May 25 01:09:03 2007
@@ -0,0 +1,700 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html>
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
+ <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"
+ />
+</head>
+
+<body xml:lang="en">
+<h1>Apache Axis2 Archived News</h1>
+
+<p>This document contains details of each Axis2 version that was released, up
+to the current version.</p>
+
+<h2>Content</h2>
+
+<h3>Apache Axis2 Releases:</h3>
+<ul>
+ <li><a href="#1_1_1">09th January 2007- Version 1.1.1</a></li>
+ <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>
+ <li><a href="#0_93">02 December 2005 - Version 0.93</a></li>
+ <li><a href="#0_92">26 September 2005 - Version 0.92</a></li>
+ <li><a href="#0_91">12 August 2005 - Version 0.91</a></li>
+ <li><a href="#0_90">02 July 2005 - Version 0.9</a></li>
+ <li><a href="#M2">07 June 2005 - Milestone 2</a></li>
+ <li><a href="#M1">24 February 2005 - Milestone 1</a></li>
+</ul>
+<a id="1_1_1"></a>
+
+<h2>09th January 2007- Apache Axis2/Java Version 1.1.1 Released!</h2>
+<p>[<a href="http://ws.apache.org/axis2/download/1_1_1/download.cgi">Download 1.1.1</a>]</p>
+<p>Apache Axis2 Version 1.1.1 comes with performance improvements and bug
+fixes over the 1.1 release. Check out the complete list of features 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 a 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>
+
+<h2><a>Tools Included in This Release</a></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/@axis2_version_dir@/eclipse/wsdl2java-plugin.html">eclipse
+ plug-in</a><a>/</a> <a
+ href="tools/@axis2_version_dir@/CodegenToolReference.html">Command line
+ version</a><a>/</a><a
+ href="tools/@axis2_version_dir@/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation">IntelliJ
+ IDEA plug-in</a><a>/</a><a
+ href="tools/@axis2_version_dir@/maven-plugins/maven-wsdl2code-plugin.html">Maven2
+ WSDL2Code Plug-in</a></li>
+ <li>Service Archive Wizard- <a
+ href="tools/@axis2_version_dir@/eclipse/servicearchiver-plugin.html">eclipse
+ plug-in</a>/ <a
+ href="tools/@axis2_version_dir@/idea/Idea_plug-in_userguide.html#Create_Service_Archive">IntelliJ
+ IDEA plug-in</a>/ <a
+ href="tools/@axis2_version_dir@/maven-plugins/maven-aar-plugin.html">Maven2
+ AAR Plug-in</a></li>
+ <li>Java2WSDL- <a
+ href="tools/@axis2_version_dir@/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>ADB does not support unwrapping of response messages(coming in 1.2)</li>
+ <li>JSR 181/183 Annotation support (coming in 1.2)</li>
+ <li>JaxMe and JAXBRI data binding support is experimental</li>
+ <li>Simple Axis Server does not support POX/REST</li>
+ <li>RPC Message Receiver does not validate a request against the schema
+ (AXIS2-1943)</li>
+ <li>Axis2 Idea plugin shows random behavior when XMLBeans is used</li>
+</ul>
+<a id="1_1"></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 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 list of features 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 the 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 constructs:
+ <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 id="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>
+
+<p>Apache Axis2 is a complete re-design and re-write of the widely used
+Apache Axis SOAP stack, built on the lessons learnt from Apache Axis.</p>
+
+<p>Apache Axis2 not only supports SOAP 1.1 and SOAP 1.2, but it also has
+integrated support for the widely popular REST style of Web services. The
+same business logic implementation can offer both a WS-* style interface as
+well as a REST style interface simultaneously.</p>
+
+<p>Apache Axis2 is more efficient, more modular and more XML-oriented than
+the older version. It is designed to support the easy addition of plug-in
+"modules" that extend their functionality for features such as security and
+reliability. The modules currently available or under development include:</p>
+<ul>
+ <li><a
+ 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">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">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/">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
+href="http://ws.apache.org/commons/axiom/index.html">Apache Axiom</a>, a new
+high performant, pull-based XML object model that was released on 02 May
+2006.</p>
+
+<h2>Features</h2>
+
+<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="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 a 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>
+
+<h2><a>Tools Included in This Release</a></h2>
+
+<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">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">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>
+<ul>
+ <li>Apache Rampart: Supporting WS-Security (and soon WS-Policy)</li>
+ <li>Apache Sandesha2: Supporting WS-Reliable Messaging</li>
+</ul>
+(Apache Axis2 comes with a built in module that supports WS-Addressing.)
+
+<h2>Known Issues and Limitations</h2>
+<ul>
+ <li>Recursive schemas (A includes B which includes A) may cause
+ problems</li>
+ <li>JaxMe data binding support is experimental</li>
+ <li>Axis2-595: Hot re-deployment in Apache Tomcat has problems</li>
+ <li>Axis2-666: AddressingSubmissionInHandler does not deserialize EPR
+ extensibility attributes and elements</li>
+ <li>AXIS2-667: Operation dispatch based on message body has a known
+ issue</li>
+ <li>Axis Data Binding (ADB) does not cover all of the XML Schema; its an
+ 80-20 design point. Unsupported XML Schema features include:
+ <ol>
+ <li>Simple content extension and restriction</li>
+ <li>Complex content restriction</li>
+ </ol>
+ </li>
+ <li>ADB does not support xsi:type based deserialization at runtime</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>
+</ul>
+<a id="0_95"></a>
+
+<h2>23 March 2006 - Apache Axis2 Version 0.95 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.95</a>]</p>
+
+<p>This release includes the following features:</p>
+
+<h3 id="head-215f3945a40558f9ad055ed5b6601e8f93706558">Axis2 Complete List of
+Features</h3>
+<ol type="1">
+ <li>AXIOM, an XML object model working on StAX (Streaming API for XML)
+ parsing optimized for SOAP 1.1/1.2 messages. This has complete XML
+ infoset support.</li>
+ <li>Support for One-Way Messaging (In-Only) and Request Response Messaging
+ (In-Out)</li>
+ <li>Module Architecture, a mechanism to extend the SOAP Processing
+ Model</li>
+ <li>Module version support; you can have multiple versions of the same
+ module and use them depending on the requirement.</li>
+ <li>Context hierarchy</li>
+ <li>Archive based deployment model and Directory based deployment model</li>
+ <li>JWS-like deployment (making a Java class into a Web service)</li>
+ <li>WSDL Code Generation Tool for Stub and skeletons</li>
+ <li>WS-Addressing, both in the submission (2004/08) and final (2005/08)
+ versions</li>
+ <li>WSS4J module for security</li>
+ <li>Improved and user friendly Client API</li>
+ <li>WSDL2Java and Java2WSDL</li>
+ <li>REST (REpresentational State Transfer) Support</li>
+ <li>Transports supports: HTTP, SMTP, TCP, JMS</li>
+ <li>Raw XML providers</li>
+ <li>Support for MTOM/ MIME/ SwA</li>
+ <li>SAAJ implementation</li>
+ <li>DOOM</li>
+ <li>Pack/Unpack capability for the generated code</li>
+ <li>Axis Data Binding - ADB (Framework and Schema Compiler)</li>
+ <li>Numerous bug fixes since last release</li>
+ <li>Transport framework improvements (ListenerManager)-<span
+ style="color: #FF0000">New</span></li>
+ <li>AxisServlet auto start when the application server starts up-<span
+ style="color: #FF0000">New</span></li>
+ <li>Module disengagement support-<span
+ style="color: #FF0000">New</span></li>
+ <li>Loading module (.mar) from classpath-<span
+ style="color: #FF0000">New</span></li>
+ <li>Sessions scoping for Application, SOAP, Transport and Request
+ levels-<span style="color: #FF0000">New</span></li>
+</ol>
+
+<p id="head-5bb5aa099717d1d49642f7ae2d63ce5cf94487ad"><strong><em>Axis2 List
+of Experimental Features</em></strong></p>
+<ol type="1">
+ <li>Server side and client side Web Service Policy support</li>
+ <li>?wsdl and ?xsd support</li>
+ <li>Generate ServiceClient for a given WSDL and invoke the corresponding
+ service using the generated client.</li>
+</ol>
+
+<h3 id="head-7dd8e783bb9e22fb00f88748855bb6e500111e12">Major Changes Since
+Last Release</h3>
+<ol type="1">
+ <li>Transport framework improvements (ListenerManager)</li>
+ <li>Changed the way you add action to mapping (wsamapping) from a parameter
+ to a child element. Therefore, from this version onward, adding mapping
+ is as follows:</li>
+ <pre> <actionMapping>MyMapping</actionMapping>
+ </pre>
+ <li>Refactored the following packages in Axiom.
+ <ul>
+ <li>org.apache.axiom.om.impl.llom.builder to
+ org.apache.axiom.om.impl.builder</li>
+ <li>org.apache.axiom.om.impl.llom.mtom to
+ org.apache.axiom.om.impl.mtom</li>
+ <li>org.apache.axiom.om.impl.llom.serialize to
+ org.apache.axiom.om.impl.serialize</li>
+ <li>org.apache.axiom.om.impl.llom.traverse to
+ org.apache.axiom.om.impl.traverse</li>
+ </ul>
+ </li>
+</ol>
+
+<h3 id="head-83371cc3d6961295be042f584c7b74d81cca23c4">Tools Included in This
+Release</h3>
+<ol type="1">
+ <li>Axis2 Web Application (Web App)</li>
+ <li>WSDL2WS- Command line version</li>
+ <!--<li>Service Archive Wizard- eclipse Plugin</li>-->
+</ol>
+
+<h3 id="head-599c5a50552f02ebdeb5f58ef8da289234812ca4">What Still Needs to be
+Done</h3>
+
+<p>The list of what we think needs to be done. Even you can consider helping
+out if you are interested.</p>
+<ol type="1">
+ <li>JAX-RPC 1.1 and/or JAX-WS compliance</li>
+ <li>SOAP Encoding</li>
+ <li>Binary serialization and de-serialization support</li>
+ <li>Management Interface for Axis2</li>
+ <li>Implementation of other Transports.</li>
+ <li>Resource framework implementation (WS-RF) and Enterprise web services
+ such as JSR 109 support</li>
+ <li>Completion of Interop tests</li>
+</ol>
+<a id="0_94"></a>
+
+<h2>11 January 2006 - Apache Axis2 Version 0.94 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.94</a>]</p>
+
+<p>This release includes the following features:</p>
+
+<h3 id="head-215f3945a40558f9ad055ed5b6601e8f93706558">The Complete List of
+Features</h3>
+<ol type="1">
+ <li>AXIOM, an XML object model working on StAX (Streaming API for XML)
+ parsing optimized for SOAP 1.1/1.2 Messages. This has complete XML
+ infoset support.</li>
+ <li>Support for One-Way Messaging (In-Only) and Request Response Messaging
+ (In-Out)</li>
+ <li>Module Architecture, mechanism to extend the SOAP Processing Model</li>
+ <li>Module version support; you can have multiple versions of the same
+ module and use them depending on the requirement.</li>
+ <li>Context hierarchy</li>
+ <li>Archive based deployment Model, and Directory based deployment
+ model</li>
+ <li>JWS-like deployment (making a Java class into a Web service)</li>
+ <li>WSDL Code Generation Tool for Stub and skeletons</li>
+ <li>WS-Addressing, both the submission (2004/08) and final (2005/08)
+ versions</li>
+ <li>WSS4J module for security</li>
+ <li>Improved and user friendly Client API</li>
+ <li>WSDL2Java</li>
+ <li>REST (REpresentational State Transfer) Support</li>
+ <li>Transports supports: HTTP, SMTP, TCP, JMS</li>
+ <li>Raw XML providers</li>
+ <li>Support for MTOM/ MIME/ SwA</li>
+ <li>SAAJ implementation</li>
+ <li>DOOM - <span style="color: #FF0000">New</span></li>
+ <li>Pack/Unpack capability for the generated code - <span
+ style="color: #FF0000">New</span></li>
+ <li>Axis Data Binding - ADB (Framework and Schema Compiler)</li>
+ <li>Numerous bug fixes since last release</li>
+</ol>
+
+<h4 id="head-5bb5aa099717d1d49642f7ae2d63ce5cf94487ad">Axis2 List of
+Experimental Features</h4>
+<ol type="1">
+ <li>Sessions scoping for Application, SOAP, Transport and Request
+ levels</li>
+ <li>Server side Web Service Policy support</li>
+ <li>?wsdl and ?xsd support</li>
+ <li>Java2WSDL</li>
+ <li>Generate ServiceClient for a given WSDL and invoke the corresponding
+ service using the generated client.</li>
+</ol>
+
+<h3 id="head-7dd8e783bb9e22fb00f88748855bb6e500111e12">Major Changes Since
+the Last Release</h3>
+<ol type="1">
+ <li>Fixing of memory leaks.</li>
+ <li>Client API changes. Introducing ServiceClient instead of MEPClient,
+ InOnlyMEPClient, InOutMEPClient, Call. (Please note that the above
+ classes will be deprecated in this release.)</li>
+ <li>Module versioning support. You can have multiple versions of the same
+ module and use them depending on the requirement.</li>
+ <li>Code generator improved to process multi-port WSDLs</li>
+ <li>Packing and unpacking options for the code generated classes</li>
+</ol>
+
+<h3 id="head-83371cc3d6961295be042f584c7b74d81cca23c4">Tools Included in this
+Release</h3>
+<ol type="1">
+ <li>Axis2 Web Application (Web App)</li>
+ <li>WSDL2WS- Eclipse plugin/ Command line version/ IntelliJ IDEA plugin</li>
+ <li>Service Archive Wizard- Eclipse plugin/ IntelliJ IDEA plugin</li>
+</ol>
+
+<h3 id="head-599c5a50552f02ebdeb5f58ef8da289234812ca4">What Still Needs to be
+Done</h3>
+<ol type="1">
+ <li>JAX-RPC 1.1 and/or JAX-WS compliance</li>
+ <li>SOAP Encoding</li>
+ <li>Binary serialization and de-serialization support</li>
+ <li>Management interface for Axis2</li>
+ <li>Implementation of other Transports.</li>
+ <li>Resource framework implementation (WS-RF) and Enterprise web services
+ such as JSR 109 support</li>
+ <li>Completion of interop tests</li>
+</ol>
+<a id="0_93"></a>
+
+<h2>02 December 2005 - Apache Axis2 Version 0.93 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.93</a>]</p>
+
+<p>Axis2 is becoming more and more stable. This 0.93 release contains the
+following additional features:</p>
+<ul>
+ <li>JDK 1.5 compatibility</li>
+ <li>Configurable handler chains using axis2.xml</li>
+ <li>Improved class loader hierarchy</li>
+ <li>Improved security module with dynamic configurability</li>
+ <li>ADB (Axis Data Binding) with complete simple type support and limited
+ complex type support</li>
+ <li>Jalopy based code formatting of generated code</li>
+ <li>Proxy support and NTLM authentication</li>
+ <li>Support for rpc/literal</li>
+ <li>And numerous bug fixes after 0.92 release</li>
+</ul>
+
+<h3>List of Experimental Features</h3>
+<ol type="1">
+ <li>DOOM - DOM implementation over OM</li>
+ <li>Java2WSDL</li>
+ <li>RPC Support</li>
+</ol>
+
+<h3>Major Changes Since the Last Release</h3>
+<ol>
+ <li>Refactored org.apache.axis2.clientapi to org.apache.axis2.client</li>
+ <li>Introduction of Options to configure clients</li>
+ <li>Renaming of descriptors. OperationDescription -> AxisOperation,
+ ServiceDescription -> AxisService, ServiceGroupDescription ->
+ AxisServiceGroup</li>
+</ol>
+We are getting closer to a 1.0 release, and the remaining tasks to be
+completed before the 1.0 release include: SOAP 1.1 and 1.2 validation, our
+own data binding implementation, and WSDL generation. <a id="0_92"></a>
+
+<h2>26 September 2005 - Apache Axis2 Version 0.92 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.92</a>]</p>
+
+<p>This 0.92 release contains the following additional features:</p>
+<ul>
+ <li>WS-Security support using WSS4J</li>
+ <li>Support for context hierarchy serialization</li>
+ <li>Service Groups</li>
+ <li>Numerous bug fixes after 0.91 release</li>
+</ul>
+
+<h3>The Release Includes the Following Tools</h3>
+<ul>
+ <li>Admin Web App</li>
+ <li>WSDL2Java, eclipse Plugin/Command line version</li>
+ <li>Service Archive Wizard, eclipse Plugin</li>
+ <li>Module Archive Wizard, eclipse Plugin</li>
+ <li>Service Archive Wizard, IntelliJ IDEA Plugin</li>
+</ul>
+
+<p>We are getting closer to a 1.0 release, and the remaining tasks to be
+completed before a 1.0 release include: SOAP 1.1 and 1.2 validation, our own
+data binding implementation, and WSDL generation.</p>
+<a id="0_91"></a>
+
+<h2>12 August 2005 - Apache Axis2 Version 0.91 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.91</a>]</p>
+
+<p>This 0.91 release is a glimpse of the 1.0 that should be coming soon. This
+0.91 release contains the following additional features:</p>
+<ul>
+ <li>File Caching for MTOM</li>
+ <li>SOAP faults based on the SOAP version and better fault handling</li>
+ <li>Different character encoding support</li>
+ <li>Improved infoset support in AXIOM</li>
+ <li>Improved code generation templates</li>
+ <li>Numerous bug fixes</li>
+</ul>
+<a id="0_90"></a>
+
+<h2>02 July 2005 - Apache Axis2 Version 0.9 Released!</h2>
+
+<p>[<a href="http://ws.apache.org/axis2/download.cgi">Download 0.9</a>]</p>
+
+<p>Axis2 is taking shape. This 0.9 release is a glimpse of the 1.0 that
+should be coming soon. This 0.9 release contains the following additional
+features:</p>
+<ul>
+ <li>XML Beans based data binding support</li>
+ <li>Support for WS-Addressing, both the submission and final versions</li>
+ <li>REST Web Service Support</li>
+ <li>MTOM/SWA attachments support</li>
+ <li>SAAJ implementation</li>
+</ul>
+<a id="M2"></a>
+
+<h2>07 June 2005 - Apache Axis2 Milestone 2 (M2) Released</h2>
+
+<p>Apache Axis2 is starting to take shape. Features implemented in this
+second milestone release are:</p>
+<ul>
+ <li>Modules - a mechanism to extend the SOAP Processing Model</li>
+ <li>Support for WS-Addressing</li>
+ <li>Axis2 Client API - Blocking and Non-Blocking API</li>
+ <li>Support for One-Way Messaging and Request Response Messaging</li>
+ <li>WSDL Code Generation Tool.</li>
+ <li>HTTP, SMTP, and TCP transport support</li>
+</ul>
+<b>This release also includes the following tools:</b>
+<ul>
+ <li>Administration web application,</li>
+ <li>WSDL2WS-Eclipse plug-in</li>
+ <li>Service Archive Wizard- Eclipse plug-in</li>
+ <li>Module Archive Wizard-Eclipse plug-in</li>
+</ul>
+<a id="M1"></a>
+
+<h2>24 February 2005 - Apache Axis2 Milestone 1 (M1) Released</h2>
+
+<p>This first milestone release of Axis2 includes the following features:</p>
+<ul>
+ <li>AXIOM, a SOAP specific streaming XML infoset model for SOAP 1.1/1.2
+ Messages</li>
+ <li>WSDL Object Model built based on the proposed WSDL 2.0 Component
+ Model.</li>
+ <li>Handler framework with the support to specify the location of the
+ Handler in a specific Phase</li>
+ <li>Support to bundle and enable the Handlers as Modules</li>
+ <li>Support for the Synchronous and Asynchronous IN-OUT messaging over HTTP
+ transport</li>
+ <li>Hot deployment of Web Services</li>
+</ul>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/articles.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/articles.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/articles.html (added)
+++ webservices/axis2/trunk/java/xdocs/articles.html Fri May 25 01:09:03 2007
@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html>
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+ <title>Axis2 Knowledge Base</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"
+ />
+</head>
+
+<body xml:lang="en">
+<h1>Apache Axis2 References</h1>
+
+<p>This page contains articles, tutorials, presentations and question and
+answers published on various Web sites on the Apache Axis2 engine. These
+references will prove to be a great help in boosting your knowledge on
+Axis2.</p>
+
+<h2>Articles:</h2>
+<ul>
+ <li><a
+ href="http://www.jaxmag.com/itr/online_artikel/psecom,id,747,nodeid,147.html">Axis2
+ - The Future of Web Services</a>- By Srinath Perera, Ajith Ranabahu</li>
+ <li><a
+ href="http://www.developer.com/services/article.php/3525481">Introducing
+ Axis2, the Next Generation of the Apache Web Service Stack</a>- By
+ Srinath Perera</li>
+ <li><a href="http://www.onjava.com/pub/a/onjava/2005/07/27/axis2.html">Web
+ Services Messaging with Apache Axis2: Concepts and Techniques</a>- By
+ Srinath Perera, Ajith Ranabahu (27 July 2005)</li>
+ <li><a href="http://developer.com/java/web/article.php/3529321">Axis2
+ Execution Framework</a>- By Deepal Jayasinghe</li>
+ <li><a
+ href="http://jaxmag.com/itr/online_artikel/psecom,id,757,nodeid,147.html">Axis2
+ Deployment Model</a>- By Deepal Jayasinghe</li>
+ <li><a
+ href="http://www.developer.com/open/article.php/3557741">Understanding
+ Axis2 Deployment Architecture</a>- By Deepal Jayasinghe</li>
+ <li><a
+ href="http://www.wso2.net/articles/axis2/java/2006/02/06/inside-codegen">Inside
+ the Axis2 Code Generator</a>- By Ajith Ranabahu (06 Feb 2006)</li>
+ <li><a
+ href="http://www.developer.com/java/other/article.php/3570031">Utilizing
+ a Non-Java Web Service with Axis2</a>- By Deepal Jayasinghe</li>
+ <li><a href="http://www.developer.com/open/article.php/3589126">Avoiding
+ Mistakes Made Using Axis2</a>- By Deepal Jayasinghe</li>
+ <li><a
+ href="http://www-128.ibm.com/developerworks/java/library/os-ag-axis2mig/index.html">Migrating
+ Apache Axis apps to Axis2 using Apache Geronimo</a>- By Tyler Anderson
+ (07 Mar 2006)</li>
+ <li><a href="http://www.developer.com/java/ent/article.php/3606466">The
+ Axis2 Transport Framework</a>- By Deepal Jayasinghe</li>
+ <li><a
+ href="http://www.wso2.net/articles/axis2/java/2006/08/01/client-api-parameters">Reference
+ Guide to Apache Axis2 Client API Parameters</a>- By Eran Chinthaka (01
+ Aug 2006)</li>
+ <li><a
+ href="http://www.wso2.net/articles/axis2/java/2006/05/17/axis2-performance-testing-round-1">Axis2
+ â Performance Testing Round #1</a>- By Devanum Sirinivas (17 May
+ 2006)</li>
+ <li><a
+ href="http://www.wso2.net/articles/axis2/java/2006/09/13/working-with-axis2">Working
+ With Apache Axis2</a>- Deepal Jayasinghe (13 Sep 2006)</li>
+ <li><a href="http://www.developer.com/java/ent/article.php/3613896">Writing
+ an Apache Axis2 Service from Scratch</a>- By Deepal Jayasinghe (20 June
+ 2006)</li>
+ <li><a href="http://www.developer.com/java/web/article.php/3620661">Apache
+ Axis2 Session Management</a>- By Deepal Jayasinghe</li>
+ <li><a href="http://www.devx.com/Java/Article/33839">Apache
+ Axis2 with POJO's and Spring</a>- By Ramanujam A. Rao</li>
+</ul>
+
+<h2>Tutorials</h2>
+<ul>
+ <li><a
+ href="http://www.wso2.net/tutorials/axis2/java/2006/06/05/introducing-axis2">Introducing
+ Axis2</a>- By Eran Chinthaka, Chathura Herath (05 June 2006)</li>
+ <li><a
+ href="http://www.wso2.net/tutorials/axis2/2006/06/05/accelerating-web-services">Accelerating
+ Web Services Development with Axis2</a>- By Deepal Jayasinghe, Ajith
+ Ranabahu (05 June 2006)</li>
+ <li><a
+ href="http://www.wso2.net/tutorials/axis2/java/2006/05/29/hello-world">Hello
+ World with Apache Axis2</a>- By Ruchith Fernando (29 May 2006)</li>
+ <li><a
+ href="http://www.wso2.net/tutorials/axis2/java/2006/06/18/operation-service-message-is-destined-to">How
+ Apache Axis2 Finds the Operation and Service a Message is Destined
+ To</a>- By Eran Chinthaka(18 June 2006)</li>
+ <li><a
+ href="http://www.wso2.net/tutorials/axis2/java/2006/07/28/debug-ws">How
+ to Debug a Web Service?</a>- By Ajith Ranabahu (28 July 2006)</li>
+</ul>
+
+<h2>Presentations</h2>
+<ul>
+ <li><a
+ href="http://www.wso2.net/presentations/axis2/java/2006/06/05/why-axis2-the-future-of-web-services">Why
+ Axis2: The Future of Web Services</a>- By Eran Chinthaka (05 June
+ 2006)</li>
+ <li><a
+ href="http://www.wso2.net/presentations/axis2/java/2006/08/30/enterprise-applications">Building
+ Enterprise Applications with Axis2-Tutorial from ApacheCon Asia 2006</a>-
+ By Deepal Jayasinghe, Ruchith Fernando (30 Aug 2006)</li>
+ <li><a
+ href="http://www.wso2.net/presentations/axis2/java/2006/06/05/introducing-axis2">Introducing
+ Axis2</a>- By Ajith Ranabahu (05 June 2006)</li>
+</ul>
+
+<h2>Questions & Answers</h2>
+<ul>
+ <li><a href="http://www.wso2.net/kb/67">Setting up Apache Axis2 in eclipse
+ IDE</a>- By Ruchith Fernando (04 April 2006)</li>
+ <li><a href="http://www.wso2.net/kb/83">How do I Embed SimpleHTTPServer in
+ My Application and Deploy a POJO?</a>- By Davanum Sirinivas (09 May
+ 2006)</li>
+ <li><a href="http://www.wso2.net/kb/209">How to Configure Axis2's HTTP
+ Transport Sender at Client Side?</a>- By Saminda Abeysinghe (11July
+ 2006)</li>
+ <li><a href="http://www.wso2.net/kb/175">How to do REST invocation with
+ Axis2/Java ServiceClient?</a>- By Eran Chinthaka (17 June 2006)</li>
+ <li><a href="http://www.wso2.net/kb/90">How to Embed an Axis2 based Web
+ Service in your Webapp?</a>- By Davanum Sirinivas(17 May 2006)</li>
+</ul>
+<h2>Othere resources</h2>
+<ul>
+ <li>
+<a href="http://pzf.fremantle.org/2007/05/getting-started-with-wsrm-and-axis2.html">
+Getting started with Axis2 and Sandesha2 to do WS-ReliableMessaging</li>
+</ul>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/css/axis-docs.css
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/css/axis-docs.css?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/css/axis-docs.css (added)
+++ webservices/axis2/trunk/java/xdocs/css/axis-docs.css Fri May 25 01:09:03 2007
@@ -0,0 +1,135 @@
+.img-title {
+ text-align: center
+}
+
+.img {
+ text-align: center
+}
+
+.special-td {
+ font-family: Arial;
+ font-size: 10pt;
+ font-weight: bold
+}
+
+.special {
+ font-family: Arial;
+ font-weight: bold;
+ border-style: solid;
+ border-width: 1;
+ padding-left: 4;
+ padding-right: 4;
+ padding-top: 1;
+ padding-bottom: 1;
+ background-color: #C0C0C0;
+ font-size: 10pt
+}
+
+.xml {
+ font-family: Arial;
+ font-size: 10pt;
+ color: #0000FF;
+ font-style: italic
+}
+
+.code {
+ font-family: Courier New;
+ font-size: 10pt;
+ color: #800000
+}
+
+/*
+-----------------------------------------------------------------------
+Generic element styles
+----------------------------------------------------------------------- */
+body {
+ color: #111;
+ font: 11px / 1.5 verdana, arial;
+ margin: 10;
+ padding: 5;
+ border-width: 0;
+ outline-width: 0;
+ list-style-position: outside;
+ display: block;
+}
+
+p {
+}
+
+a, a:link {
+ color: #039;
+ font-size: 11px;
+}
+
+a:hover {
+ color: #03c;
+ font-size: 11px;
+ text-decoration: none;
+}
+
+a:visited {
+ font-size: 11px; /* color: #969; */
+/* No need to discolour visited links as this is a system */
+}
+
+ul, ol {
+ font-size: 11px;
+ text-align: left;
+ list-style-position: outside;
+ display: block;
+ white-space: normal;
+}
+
+table td {
+ font-size: 11px;
+ padding: 0px;
+ spacing: 0px;
+ text-align: left;
+ vertical-align: top;
+}
+
+h1 {
+ color: #000;
+ font-size: 16px;
+ font-weight: bold;
+ background-color: #dcdcdc;
+ padding-left: 10px;
+}
+
+h2 {
+ font-size: 15px;
+ padding-left: 10px;
+ border-bottom: 1px solid #a9a9a9;
+ border-left-color: black;
+}
+
+h3 {
+ font-size: 14px;
+ padding-left: 10px;
+ border-bottom: 1px solid #d3d3d3;
+}
+
+h4 {
+ font-size: 13px;
+}
+
+th {
+ background-color: #f5f5f5;
+ height: 20;
+ paddong: 0px;
+ spacing: 0px;
+}
+
+table {
+ margin: 0;
+ padding: 0;
+ border: solid 0 #dcdcdc;
+}
+
+.header {
+ height: 80px;
+ background-image: url( ../images/doc_header.jpg );
+ background-repeat: no-repeat;
+ background-attachment: scroll;
+ background-position: left top;
+}
\ No newline at end of file
Added: webservices/axis2/trunk/java/xdocs/download.cgi
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download.cgi?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download.cgi (added)
+++ webservices/axis2/trunk/java/xdocs/download.cgi Fri May 25 01:09: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.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download.html (added)
+++ webservices/axis2/trunk/java/xdocs/download.html Fri May 25 01:09:03 2007
@@ -0,0 +1,103 @@
+<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 provides 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_2/download.cgi"><strong>1.2</strong></a></td>
+ <td>27 - 04 - 2007</td>
+ <td>1.2 Release (Mirrored)</td>
+ </tr>
+ <tr>
+ <td><a
+ href="download/1_1_1/download.cgi"><strong>1.1.1</strong></a></td>
+ <td>09 - 01 - 2007</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 (Archived)</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>
+
+<p></p>
+
+<p><strong>Axis2 Distributions : <a
+href="http://cvs.apache.org/dist/axis2/nightly">Nightly
+builds</a></strong></p>
+
+<p></p>
+
+<p><strong>Axis2 Maven Repository: <a
+href="http://people.apache.org/repo/m1-ibiblio-rsync-repository/org.apache.axis2/">Released
+Axis2 jars</a> | <a
+href="http://cvs.apache.org/repository/org.apache.axis2/jars/">Nightly
+SNAPSHOT</a><a
+href="http://cvs.apache.org/repository/org.apache.axis2/jars/"></a></strong></p>
+
+<p></p>
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/download/0_9/download.cgi
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/0_9/download.cgi?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/0_9/download.cgi (added)
+++ webservices/axis2/trunk/java/xdocs/download/0_9/download.cgi Fri May 25 01:09: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/0_9/download.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/0_9/download.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/0_9/download.html (added)
+++ webservices/axis2/trunk/java/xdocs/download/0_9/download.html Fri May 25 01:09:03 2007
@@ -0,0 +1,62 @@
+<html>
+<head>
+ <meta http-equiv="content-type" content="">
+ <title>Axis2 0.9 Release</title>
+</head>
+
+<body>
+<h2>Axis2 0.9 Release</h2>
+
+<div align="left">
+
+<h3>Source Distribution</h3>
+
+ <p> <a
+ href="http://archive.apache.org/dist/ws/axis2/0_9/axis2-0.9-src.zip"
+ title="http://archive.apache.org/dist/ws/axis2/0_9/axis2-0.9-src.zip">zip</a><br>
+ </p>
+
+ <h3>Binary Distribution</h3>
+
+ <p> <a
+ href="http://archive.apache.org/dist/ws/axis2/0_9/axis2-0.9-bin.zip"
+ title="http://archive.apache.org/dist/ws/axis2/0_9/axis2-0.9-bin.zip">zip</a></p>
+
+</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 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
+trust</a> is used to confirm the identity of these keys.</p>
+</div>-->
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/download/0_91/download.cgi
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/0_91/download.cgi?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/0_91/download.cgi (added)
+++ webservices/axis2/trunk/java/xdocs/download/0_91/download.cgi Fri May 25 01:09: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/0_91/download.html
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/0_91/download.html?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/0_91/download.html (added)
+++ webservices/axis2/trunk/java/xdocs/download/0_91/download.html Fri May 25 01:09:03 2007
@@ -0,0 +1,69 @@
+<html>
+<head>
+ <meta http-equiv="content-type" content="">
+ <title>Axis2 0.91 Release</title>
+</head>
+
+<body>
+<h2>Axis2 0.91 Release</h2>
+
+<div align="left">
+<h3>Source Distribution</h3>
+
+<p> <a href="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip"
+title="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip">zip</a>
+<a href="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip.md5"
+title="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip.md5">MD5</a>
+<a href="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip.asc"
+title="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-src.zip.asc">PGP</a>
+<br>
+</p>
+
+<h3>Binary Distribution</h3>
+
+<p> <a href="http://archive.apache.org/ws/axis2/0_91/axis2-0.91-bin.zip"
+title="http://archive.apache.org/ws/axis2/0_91/axis2-0.91-bin.zip">zip</a> <a
+href="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-bin.zip.md5"
+title="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-bin.zip.md5">MD5</a>
+<a href="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-bin.zip.asc"
+title="http://archive.apache.org/dist/ws/axis2/0_91/axis2-0.91-bin.zip.asc">PGP</a>
+<br>
+</p>
+</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 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
+trust</a> is used to confirm the identity of these keys.</p>
+</div>-->
+</body>
+</html>
Added: webservices/axis2/trunk/java/xdocs/download/0_92/download.cgi
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/download/0_92/download.cgi?view=auto&rev=541579
==============================================================================
--- webservices/axis2/trunk/java/xdocs/download/0_92/download.cgi (added)
+++ webservices/axis2/trunk/java/xdocs/download/0_92/download.cgi Fri May 25 01:09: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
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org