Return-Path: Delivered-To: apmail-ws-axis-dev-archive@www.apache.org Received: (qmail 30153 invoked from network); 20 Apr 2006 05:32:46 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 20 Apr 2006 05:32:46 -0000 Received: (qmail 69599 invoked by uid 500); 20 Apr 2006 05:32:40 -0000 Delivered-To: apmail-ws-axis-dev-archive@ws.apache.org Received: (qmail 69499 invoked by uid 500); 20 Apr 2006 05:32:39 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 68989 invoked by uid 500); 20 Apr 2006 05:32:35 -0000 Delivered-To: apmail-ws-axis2-cvs@ws.apache.org Received: (qmail 68879 invoked by uid 99); 20 Apr 2006 05:32:35 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 19 Apr 2006 22:32:35 -0700 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Wed, 19 Apr 2006 22:32:30 -0700 Received: (qmail 29482 invoked by uid 65534); 20 Apr 2006 05:32:09 -0000 Message-ID: <20060420053209.29481.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r395490 [1/3] - in /webservices/axis2/trunk/java/xdocs: ./ latest/ Date: Thu, 20 Apr 2006 05:32:07 -0000 To: axis2-cvs@ws.apache.org From: chatra@apache.org X-Mailer: svnmailer-1.0.8 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Author: chatra Date: Wed Apr 19 22:32:05 2006 New Revision: 395490 URL: http://svn.apache.org/viewcvs?rev=395490&view=rev Log: making updates & improvements Modified: webservices/axis2/trunk/java/xdocs/index.html webservices/axis2/trunk/java/xdocs/latest/index.html webservices/axis2/trunk/java/xdocs/latest/installationguide.html webservices/axis2/trunk/java/xdocs/latest/userguide.html webservices/axis2/trunk/java/xdocs/latest/userguide1.html webservices/axis2/trunk/java/xdocs/latest/userguide2.html webservices/axis2/trunk/java/xdocs/latest/userguide3.html webservices/axis2/trunk/java/xdocs/latest/userguide4.html webservices/axis2/trunk/java/xdocs/latest/userguide5.html Modified: webservices/axis2/trunk/java/xdocs/index.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/index.html?rev=395490&r1=395489&r2=395490&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/index.html (original) +++ webservices/axis2/trunk/java/xdocs/index.html Wed Apr 19 22:32:05 2006 @@ -13,6 +13,7 @@ + @@ -58,7 +59,7 @@

This release includes the following features:

-

Axis2 Complete +

Axis2 Completed Features List

  1. AXIOM, an XML object model working on StAX (Streaming API for XML) @@ -92,16 +93,16 @@
  2. Module disengagement support
  3. Loading module (.mar) from classpath
  4. Session scoping for Application, SOAP, Transport and Request levels
  5. -
- -

Axis2 -Experimental Features List

-
  1. Server side & client side Web service policy support
  2. ?wsdl and ?xsd support
  3. Generating ServiceClient for a given WSDL and invoke the corresponding service using generated client.
+

Axis2 Background and Motivation

Modified: webservices/axis2/trunk/java/xdocs/latest/index.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/index.html?rev=395490&r1=395489&r2=395490&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/latest/index.html (original) +++ webservices/axis2/trunk/java/xdocs/latest/index.html Wed Apr 19 22:32:05 2006 @@ -11,8 +11,10 @@

Getting Started with Axis2

@@ -41,6 +43,9 @@
  • WS-Security How-to
  • Web Services Policy Support In Axis2
  • SOAP Monitor How-to
  • +
  • TCP Transport
  • +
  • Mail Transport
  • +
  • HTTP Transports
  • Articles & Tutorials

    @@ -60,9 +65,7 @@
  • Axis2 Deployment Model
  • -
  • Undertanding - Axis2 Deployment Architecture
  • +
  • Undertanding Axis2 Deployment Architecture
  • Utilizing a Non-Java Web Servive with Axis2
  • Modified: webservices/axis2/trunk/java/xdocs/latest/installationguide.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/installationguide.html?rev=395490&r1=395489&r2=395490&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/latest/installationguide.html (original) +++ webservices/axis2/trunk/java/xdocs/latest/installationguide.html Wed Apr 19 22:32:05 2006 @@ -1,335 +1,347 @@ - - - - Axis2 Installation Guide - - - - -

    Axis2 Installation Guide

    - -

    Version 1.0

    -Feedback: axis-dev@ws.apache.org - -

    Contents

    - - -

    Download Axis2

    - -

    Axis2 is distributed in several convenient distribution packages and can -be installed either as a standalone server or as part of a J2EE compliant -servlet container. Axis2 is distributed under the Apache License, version -2.0. You can download Axis2 here. Latest release of -Axis2 is version 1.0.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Distribution NameDescriptionItems
    Minimal Distribution - BinaryThis 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-core-1.0.jar will contain - compiled versions of common, xml, wsdl and core modules.)
      -
    • axis2-core-1.0.jar, axis2-adb-1.0.jar
    • -
    • third party distributable libraries
    • -
    • README.TXT and release-notes.html
    • -
    -
    Minimal Distribution - Source

    This will contain the sources of - Axis2 minimal distribution. One can generate a binary distribution - from this by typing $maven dist-min-bin. - (Set up Axis2 environment before - running this command)

    -
      -
    • sources of Axis2 common, xml, wsdl, adb and core modules
    • -
    • README.TXT and release-notes.html
    • -
    -
    Standard Distribution - BinaryThis 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 here.)
      -
    • all the content of minimal-binary distribution
    • -
    • Contents of codegen and DOOM modules
    • -
    • Samples
    • -
    • addressing.mar
    • -
    -
    Standard Distribution - SourceThis will contain the sources of Axis2 standard distribution. One - can generate a binary distribution from this by typing $maven dist-standard-bin. (Set up Axis2 environment before running this - command)
      -
    • all the content of minimal-source distribution
    • -
    • Contents of codegen and DOOM modules
    • -
    • Samples
    • -
    -
    WAR (Web Archive) DistributionThis will be the web application of Axis2 which can be deployed in - most of the servlet containers.
      -
    • all the contents of the minimal distribution
    • -
    • Admin web app
    • -
    -
    Documents DistributionThis will contain all the documentation in one package.
      -
    • xdocs
    • -
    • javadocs
    • -
    -
    Plugin DistributionThis will contain the plugins that are created for Eclipse and - IDEA.
      -
    • Intellij IDEA plugins
    • -
    • Eclipse plugins
    • -
    -
    - -

    System Requirements

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    Java Runtime - -

    Environment

    -
    1.4 (It has not been fully tested on the latest JRE 1.5) - -

    For instructions on setting up the JRE in different operating - systems, visit http://java.sun.com

    -
    Maven1.0.2 or higher in Maven 1.x series (download). Please - download maven 1.x version. Axis2 is not compatible with maven2 - yet. - -

    Required only for building Axis2 from source distribution

    -
    MemoryNo minimum requirement
    DiskNo minimum requirement. - -

    Approximately 20 MB will be used for war distribution

    -
    Operating systemTested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, - Gentoo
    - - -

    All the required jars are shipped with the binary distribution.

    - -

    Running the Maven build will automatically download the required jars when -using source distribution.

    - -

    Setting up the Environment and Tools

    - -

    Maven

    - -

    The Axis2 build is based on

    -Maven . Hence the only -prerequisite to build Axis2 from source distribution is to have Maven -installed. Extensive instruction guides are available at the Maven site.This -guide however contains the easiest path for quick environment setting. -Advanced users who wish to know more about Maven can visit here . -
      -
    • Windows
    • -
    -
      -
    1. Download and run the Windows installer package
    2. -
    3. Set the 'Environment Variables' ( create system variable MAVEN_HOME and - edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2"; - path %MAVEN_HOME%\bin)
    4. -
    5. Make sure that system variable JAVA_HOME is set to the location of your - JDK, eg. C:\Program Files\Java\jdk1.5.0_02
    6. -
    7. Run maven --version to verify that it is correctly installed.
    8. -
    - -

    clip_image002 (15K)

    -
      -
    • Unix based OS (Linux etc)
    • -
    - -

    The tar ball or the zip archive is the best option. Once the archive is -downloaded expand it to a directory of choice and set the environment -variable MAVEN_HOME and add MAVEN_HOME/bin to the path as well. More -instructions for installing Maven in Unix based operating systems can be -found here .

    - -

    Once maven is properly installed you can start building Axis2.

    - - -

    The Axis2 source distribution

    - -

    The source distribution - is available as a zipped archive. All the necessary build scripts are -included with the source distribution. Once the source archive is expanded -into a directory of choice, moving to the particular directory and running -maven command will build the Axis2 jar file.

    - -

    clip_image004 (43K)

    - -

    Once the command completes, the binaries (jar files in this case) can be -found at a newly created "target" directory.

    - -

    Note: For the first Maven build (if the maven repository is not -built first) it will take a while since required jars need to be downloaded. -However this is a once only process and will not affect any successive -builds.

    - -

    The default maven build will however build only the Axis2 -jar file. To obtain a WAR (Web Archive), "maven war" command should be -issued. This will create a complete WAR with the name axis2.war inside the -target directory.

    - -

    Once this build step is complete, the binaries are ready to be -deployed.

    - - -

    Installing Axis2 in a Servlet container

    -
      -
    1. Download Axis2 war file
    2. -
    3. Drop the war in the webapps folder. Most servlet containers will - automatically install war. (some servlet containers may require a restart - in order to capture the new web application. Refer your servlet container - documentation for more information about this.)
    4. -
    5. Once the WAR is successfully installed, test it by pointing the web - browser to the http:// <host :port>/ axis2. It - should produce the following page which is the Axis2 Web - Application Home Page.
    6. - -

      - -

      -
    7. Use validate link to ensure that everything is fine and smooth. If the - validation fails then the war has failed to install properly or some - essential jars are missing. At such a situation the documentation of the - particular servlet container should be consulted to find the problem. The - following page is a successful validation. Note the statement core Axis2 - libraries are present. -

      -
    8. - -

      -
    - -

    Uploading services

    -
      -

      The Axis2 web application also provides an interface to upload services. - Once a service is created according to the service specification as - described in userguide that jar file can be uploaded using the upload - page.

      - -

      - -

      The uploaded jar files will be stored in the default service directory. - For Axis2 this will be the <webapps>/axis2/WEB-INF/services - directory. Once a service is uploaded it will be installed instantly.

      - -

      Since Axis2 supports hot deployment one can drop the service jar - directly through the file system to the above mentioned services - directory.It will also cause the service to be automatically installed - without the container being restarted.

      - -

      Use the 'Services' link on the Web Application home page to check the - successful installation of a service. The services and the operations of - successfully installed services will be displayed in the available services - page.

      - -

      - -

      - -

      If the service has deployment time error it will list those services as - faulty services. If you click on the link you can see the your deployment - fault error message(s).

      - -

      - -

      Deployment time error message

      - -

      - -

      - -

      Axis2 Administration is all about configuring Axis2 at the run time and - the configuration will be transient. More descriptions are available in Axis2 Web Administration Guide

      -
    - - + + + + Axis2 Installation Guide + + + + +

    Apache Axis2 Installation Guide

    + +

    -Axis2 Version 1.0

    + +

    This document will give you information on Axis2 distribution packages, +system prerequisites & setting up environment variables and tools +followed by detailed instructions on installation methods.

    + +

    Send your feedback to: axis-dev@ws.apache.org. Prefix subject with [Axis2]. To subscribe to mailing list see here.

    + +

    Contents

    + + + +

    Download Axis2

    + +

    Axis2 is distributed in several convenient distribution packages and can +be installed either as a standalone server or as part of a J2EE compliant +servlet container. Axis2 is distributed under the Apache License, version +2.0. You can download Axis2 here. Latest release of +Axis2 is version 1.0.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Distribution NameDescriptionItems
    Minimal Distribution - BinaryThis 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-core-1.0.jar will contain + compiled versions of common, xml, wsdl and core modules.)
      +
    • axis2-core-1.0.jar, axis2-adb-1.0.jar
    • +
    • third party distributable libraries
    • +
    • README.TXT and release-notes.html
    • +
    +
    Minimal Distribution - Source

    This will contain the sources of + Axis2 minimal distribution. One can generate a binary distribution + from this by typing $maven dist-min-bin. + (Set up Axis2 environment before + running this command)

    +
      +
    • sources of Axis2 common, xml, wsdl, adb and core modules
    • +
    • README.TXT and release-notes.html
    • +
    +
    Standard Distribution - BinaryThis 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 here.)
      +
    • all the content of minimal-binary distribution
    • +
    • Contents of codegen and DOOM modules
    • +
    • Samples
    • +
    • addressing.mar
    • +
    +
    Standard Distribution - SourceThis will contain the sources of Axis2 standard distribution. One + can generate a binary distribution from this by typing $maven dist-standard-bin. (Set up Axis2 environment before running this + command)
      +
    • all the content of minimal-source distribution
    • +
    • Contents of codegen and DOOM modules
    • +
    • Samples
    • +
    +
    WAR (Web Archive) DistributionThis will be the web application of Axis2 which can be deployed in + most of the servlet containers.
      +
    • all the contents of the minimal distribution
    • +
    • Admin web app
    • +
    +
    Documents DistributionThis will contain all the documentation in one package.
      +
    • xdocs
    • +
    • javadocs
    • +
    +
    Plugin DistributionThis will contain the plugins that are created for Eclipse and + IDEA.
      +
    • Intellij IDEA plugins
    • +
    • Eclipse plugins
    • +
    +
    + + +

    System Requirements

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    Java Runtime + +

    Environment

    +
    1.4 (It has not been fully tested on the latest JRE 1.5) + +

    For instructions on setting up the JRE in different operating + systems, visit http://java.sun.com

    +
    Maven1.0.2 or higher in Maven 1.x series (download). Please + download maven 1.x version. Axis2 is not compatible with maven2 + yet. + +

    Required only for building Axis2 from source distribution

    +
    MemoryNo minimum requirement
    DiskNo minimum requirement. + +

    Approximately 20 MB will be used for war distribution

    +
    Operating systemTested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu, + Gentoo
    + +

    All the required jars are shipped with the binary distribution.

    + +

    Running the Maven build will automatically download the required jars when +using source distribution.

    + + +

    Setting up the Environment and Tools

    + + +

    Maven

    + +

    The Axis2 build is based on

    +Maven . Hence the only +prerequisite to build Axis2 from source distribution is to have Maven +installed. Extensive instruction guides are available at the Maven site.This +guide however contains the easiest path for quick environment setting. +Advanced users who wish to know more about Maven can visit here . +
      +
    • Windows
    • +
    +
      +
    1. Download and run the Windows installer package
    2. +
    3. Set the 'Environment Variables' ( create system variable MAVEN_HOME and + edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2"; + path %MAVEN_HOME%\bin)
    4. +
    5. Make sure that system variable JAVA_HOME is set to the location of your + JDK, eg. C:\Program Files\Java\jdk1.5.0_02
    6. +
    7. Run maven --version to verify that it is correctly installed.
    8. +
    + +

    clip_image002 (15K)

    +
      +
    • Unix based OS (Linux etc)
    • +
    + +

    The tar ball or the zip archive is the best option. Once the archive is +downloaded expand it to a directory of choice and set the environment +variable MAVEN_HOME and add MAVEN_HOME/bin to the path as well. More +instructions for installing Maven in Unix based operating systems can be +found here .

    + +

    Once maven is properly installed you can start building Axis2.

    + + +

    The Axis2 source distribution

    + +

    The source distribution + is available as a zipped archive. All the necessary build scripts are +included with the source distribution. Once the source archive is expanded +into a directory of choice, moving to the particular directory and running +maven command will build the Axis2 jar file.

    + +

    clip_image004 (43K)
    +

    + +

    Once the command completes, the binaries (jar files in this case) can be +found at a newly created "target" directory.

    + +

    Note: For the first Maven build (if the maven repository is not +built first) it will take a while since required jars need to be downloaded. +However this is a once only process and will not affect any successive +builds.

    + +

    The default maven build will however build only the Axis2 +jar file. To obtain a WAR (Web Archive), "maven war" command should be +issued. This will create a complete WAR with the name axis2.war inside the +target directory.

    + +

    Once this build step is complete, the binaries are ready to be +deployed.

    + + +

    Installing Axis2 in a Servlet container

    +
      +
    1. Download Axis2 + war file
    2. +
    3. Drop the war in the webapps folder. Most servlet containers will + automatically install war. (some servlet containers may require a restart + in order to capture the new web application. Refer your servlet container + documentation for more information about this.)
    4. +
    5. Once the WAR is successfully installed, test it by pointing the web + browser to the http:// <host :port>/ axis2. It + should produce the following page which is the Axis2 Web + Application Home Page.
    6. + +

      + +

      +
    7. Use validate link to ensure that everything is fine and smooth. If the + validation fails then the war has failed to install properly or some + essential jars are missing. At such a situation the documentation of the + particular servlet container should be consulted to find the problem. The + following page is a successful validation. Note the statement core Axis2 + libraries are present. +

      +
    8. + +

      +
    + + +

    Uploading services

    +
      +

      The Axis2 web application also provides an interface to upload services. + Once a service is created according to the service specification as + described in userguide that jar file can be uploaded using the upload + page.

      + +

      + +

      The uploaded jar files will be stored in the default service directory. + For Axis2 this will be the <webapps>/axis2/WEB-INF/services + directory. Once a service is uploaded it will be installed instantly.

      + +

      Since Axis2 supports hot deployment one can drop the service jar + directly through the file system to the above mentioned services + directory.It will also cause the service to be automatically installed + without the container being restarted.

      + +

      Use the 'Services' link on the Web Application home page to check the + successful installation of a service. The services and the operations of + successfully installed services will be displayed in the available services + page.

      + +

      + +

      + +

      If the service has deployment time error it will list those services as + faulty services. If you click on the link you can see the your deployment + fault error message(s).

      + +

      + +

      Deployment time error message

      + +

      + +

      + +

      Axis2 Administration is all about configuring Axis2 at the run time and + the configuration will be transient. More descriptions are available in Axis2 Web Administration Guide

      +
    + + Modified: webservices/axis2/trunk/java/xdocs/latest/userguide.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/userguide.html?rev=395490&r1=395489&r2=395490&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/latest/userguide.html (original) +++ webservices/axis2/trunk/java/xdocs/latest/userguide.html Wed Apr 19 22:32:05 2006 @@ -1,183 +1,191 @@ - - - - - Axis2 User's Guide - - - -

    Axis2 User's -Guide

    - -

    Version 1.0

    - -

    Pages: Content, 1, 2, 3, 4, 5

    - -

    Content

    - - - -

    Next Page

    - -

    Pages: Content, 1, 2, 3, 4, 5

    - - + + + + + Axis2 User's Guide + + + +

    Apache Axis2 +User's Guide

    + +

    -Axis2 Version 1.0

    + +

    This document mainly contains data on how to write Web services & Web +service clients using Axis2, also creating a custom module and deploying it +to a Web service. Samples shipped with the binary distribution of Axis2 is +also described here.

    + +

    Pages: Content, 1, 2, 3, 4, 5

    + +

    Content

    + + + +

    Next Page

    + +

    Pages: Content, 1, 2, 3, 4, 5

    + + Modified: webservices/axis2/trunk/java/xdocs/latest/userguide1.html URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/userguide1.html?rev=395490&r1=395489&r2=395490&view=diff ============================================================================== --- webservices/axis2/trunk/java/xdocs/latest/userguide1.html (original) +++ webservices/axis2/trunk/java/xdocs/latest/userguide1.html Wed Apr 19 22:32:05 2006 @@ -1,228 +1,230 @@ - - - - - Axis2 User's Guide - - - -

    Axis2 User's Guide

    - -

    Version 1.0

    -User Feedback: axis-user@ws.apache.org - -

    Pages: Content, 1, 2, 3, 4, 5

    - -

    Introduction

    - -

    Welcome to Axis2, the next generation of Apache Axis!!! This User's Guide -will help you to understand what Axis2 has to offer and how to get started -with it. We hope you will benefit from the power of Axis2.

    - -

    Attention

    -
      -
    • This User's Guide is written based on - Axis2 standard binary distribution. (The standard binary distribution can - be created from the source distribution using the maven goal $maven - dist-std-bin). Please refer the installation guide for further - information on the downloadables available in this release.

      -
    • -
    • If you are new to Axis, it's highly recommended that you read Axis 1.x User's - Guide before you go any further in this guide.

      -
    • -
    - -

    What is Axis2?

    - -

    Axis2 is the next generation of Apache Axis. In late August 2004, during -the Axis2 Summit held in Colombo, Sri Lanka, a new architecture for Axis was -introduced which was much more flexible, efficient and configurable. Although -the architecture is new, some of the well established concepts from Axis 1.x -like handlers are preserved in Axis2. Axis2 comes with many new features, -enhancements and industry specification implementations.

    - -

    After months of continued discussion and coding in this direction, Axis2 -now delivers the following key features:

    -
      -
    • Speed - Axis2 uses its - own object model and StAX (Streaming API for XML) parsing to achieve - significantly greater speed than earlier versions of Apache Axis.

      -
    • -
    • Low memory foot print- - Axis2 was designed ground-up keeping low memory foot print in mind.

      -
    • -
    • AXIOM - Axis2 comes with - its own light-weight object model, AXIOM, for message processing which is - extensible, high performance and developer convenient

      -
    • -
    • Hot - Deployment - Axis2 is equipped with the capability of - deploying web service & handlers while system is up and running. In - other words, new services can be added to the system without having to - shut down server.Drop the required Web service archive into the services - directory in the repository and deployment model will automatically - deploy the service and make it available for use.

      -
    • -
    • Asynchronous Web - Services - Axis2 now supports asynchronous web services & - asynchronous web services invocation using non-blocking clients and - transports .

      -
    • -
    • MEP Support - Axis2 now - comes handy with the flexibility to support Message Exchange Patterns - (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.

      -
    • -
    • Flexibility - The Axis2 - architecture gives the developer complete freedom to insert extensions - into the engine for custom header processing, system management, or - anything else you can imagine.

      -
    • -
    • Stability - Axis2 - defines a set of published interfaces which change relatively slowly - compared to the rest of Axis.

      -
    • -
    • Component-oriented - Deployment - You can easily define reusable networks of Handlers - to implement common patterns of processing for your applications, or to - distribute to partners.

      -
    • -
    • Transport Framework - We - have a clean and simple abstraction for integrating and using Transports - (i.e., senders and listeners for SOAP over various protocols such as - SMTP, FTP, message-oriented middleware, etc), and the core of the engine - is completely transport-independent.

      -
    • -
    • WSDL support - Axis2 - supports the Web Service Description - Language, version 1.1 and 2.0, which allows you to easily build stubs - to access remote services, and also to automatically export - machine-readable descriptions of your deployed services from Axis2.

      -
    • -
    • Add-ons Several web - services specifications have been incorporated including WSS4J for security, Sandesha for reliable - messaging, Kandula which is - an encapsulation of WS-Coordination, WS-AtomicTransaction and - WS-BusinessActivity.

      -
    • -
    • Composition and - Extensibility - modules and phases improve support for - composability and extensibility. Modules supports composability and is - able to add support for new WS-* specifications in a simple and clean - manner. They are however not hot deployable - as they change the overall behavior of the system.

      -
    • -
    - -

    We hope you enjoy using Axis2. Please note that this is an open-source -effort. If you feel the code could use some new features or fixes, please get -involved and lend us a hand! The Axis developer community welcomes your -participation.

    - -

    Let us know what you think!

    - -

    Please send your feedback on Axis2 to "axis-user@ws.apache.org" and make -sure to prefix the subject of the mail with [Axis2].

    - -

    Axis2 Complete Features -List

    -
      -
    1. 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.
    2. -
    3. Support for One-Way Messaging (In-Only) and Request Response Messaging (In-Out)
    4. -
    5. Module Architecture, mechanism to extend the SOAP Processing Model
    6. -
    7. Module version support , can have multiple versions of the same module and use them depending on the requirement.
    8. -
    9. Content hierarchy
    10. -
    11. Archive based deployment Model and Directory based deployment model
    12. -
    13. JWS like deployment (making Java class into Web service)
    14. -
    15. WSDL Code Generation Tool for Stub and skeletons
    16. -
    17. WS-Addressing, both the submission (2004/08) and final (2005/08) versions
    18. -
    19. WSS4J module for security
    20. -
    21. Improved and user friendly Client API
    22. -
    23. WSDL2Java and Java2WSDL
    24. -
    25. REST (REpresentational State Transfer) Support
    26. -
    27. Transports supports: HTTP, SMTP, TCP, JMS
    28. -
    29. Raw XML providers
    30. -
    31. Support for MTOM/ MIME/ SwA
    32. -
    33. SAAJ implementation
    34. -
    35. DOOM
    36. -
    37. Pack/Unpack capability for the generated code
    38. -
    39. Axis Data Binding - ADB (Framework and Schema Compiler)
    40. -
    41. Numerous bug fixes since last release
    42. -
    43. Transport framework improvements (ListenerManager)- New
    44. -
    45. AxisServlet auto start when application server get start up- New
    46. -
    47. Module dis-engagemnt support- New
    48. -
    49. Loading module (.mar) from classpath- New
    50. -
    51. Sessions scoping for Application, SOAP, Transport and Request levels-New
    52. -
    - -

    Experimental Features List

    -
      -
    1. Server side & client side Web Service Policy support
    2. -
    3. ?wsdl and ?xsd support
    4. -
    5. Generating ServiceClient for a given WSDL and invoke the corresponding service using generated client.
    6. -
    - -

    Major Changes Since Last -Release

    -
      -
    1. Transport framework improvements (ListenerManager)
    2. -
    3. Changed the way of adding action to mapping (wsamapping) from parameter to child element so with this version onward the way of adding mapping is as follows:
    4. -
      -   
      -<actionMapping>MyMapping</actionMapping>
      -
      -
      -
    5. Refactored following packages in Axiom. -
        -
      • org.apache.axiom.om.impl.llom.builder to org.apache.axiom.om.impl.builder
      • -
      • org.apache.axiom.om.impl.llom.mtom to org.apache.axiom.om.impl.mtom
      • -
      • org.apache.axiom.om.impl.llom.serialize to org.apache.axiom.om.impl.serialize
      • -
      • org.apache.axiom.om.impl.llom.traverse to org.apache.axiom.om.impl.traverse
      • -
      -
    6. -
    - -

    Tools Included In This -Release

    -
      -
    1. Axis2 Web Application (Web App)
    2. -
    3. WSDL2WS- Command line - version
    4. - -
    -

    Download above plugins

    - -

    What's Still To Do?

    - -

    See list of what we think needs to be done, and consider helping out if -you're interested & able!

    -
      -
    1. JAX-RPC 1.1 and/or JAX-WS compliance
    2. -
    3. SOAP Encoding
    4. -
    5. Binary serialization and de-serialization support
    6. -
    7. Management Interface for Axis2
    8. -
    9. Implementation of other Transports.
    10. -
    11. Resource framework implementation (WS-RF) and Enterprise web services such as JSR 109 support
    12. -
    13. Completion of Interop tests
    14. -
    - -

    Previous | Next

    - -Pages: Content, -1, 2, 3, 4, 5 - + + + + + Axis2 User's Guide + + + +

    Axis2 User's Guide

    + +

    Version 1.0

    +

    User Feedback: axis-user@ws.apache.org. Prefix +subject with [Axis2]. To subscribe to mailing list see here.

    + +

    Pages: Content, 1, 2, 3, 4, 5

    + +

    Introduction

    + +

    Welcome to Axis2, the next generation of Apache Axis!!! This User's Guide +will help you to understand what Axis2 has to offer and how to get started +with it. We hope you will benefit from the power of Axis2.

    + +

    Attention

    +
      +
    • This User's Guide is written based on + Axis2 standard binary distribution. (The standard binary distribution can + be created from the source distribution using the maven goal $maven + dist-std-bin). Please refer the installation guide for further + information on the downloadables available in this release.

      +
    • +
    • If you are new to Axis, it's highly recommended that you read Axis 1.x User's + Guide before you go any further in this guide.

      +
    • +
    + +

    What is Axis2?

    + +

    Axis2 is the next generation of Apache Axis. In late August 2004, during +the Axis2 Summit held in Colombo, Sri Lanka, a new architecture for Axis was +introduced which was much more flexible, efficient and configurable. Although +the architecture is new, some of the well established concepts from Axis 1.x +like handlers are preserved in Axis2. Axis2 comes with many new features, +enhancements and industry specification implementations.

    + +

    After months of continued discussion and coding in this direction, Axis2 +now delivers the following key features:

    +
      +
    • Speed - Axis2 uses its + own object model and StAX (Streaming API for XML) parsing to achieve + significantly greater speed than earlier versions of Apache Axis.

      +
    • +
    • Low memory foot print- + Axis2 was designed ground-up keeping low memory foot print in mind.

      +
    • +
    • AXIOM - Axis2 comes with + its own light-weight object model, AXIOM, for message processing which is + extensible, high performance and developer convenient

      +
    • +
    • Hot + Deployment - Axis2 is equipped with the capability of + deploying web service & handlers while system is up and running. In + other words, new services can be added to the system without having to + shut down server.Drop the required Web service archive into the services + directory in the repository and deployment model will automatically + deploy the service and make it available for use.

      +
    • +
    • Asynchronous Web + Services - Axis2 now supports asynchronous web services & + asynchronous web services invocation using non-blocking clients and + transports .

      +
    • +
    • MEP Support - Axis2 now + comes handy with the flexibility to support Message Exchange Patterns + (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.

      +
    • +
    • Flexibility - The Axis2 + architecture gives the developer complete freedom to insert extensions + into the engine for custom header processing, system management, or + anything else you can imagine.

      +
    • +
    • Stability - Axis2 + defines a set of published interfaces which change relatively slowly + compared to the rest of Axis.

      +
    • +
    • Component-oriented + Deployment - You can easily define reusable networks of Handlers + to implement common patterns of processing for your applications, or to + distribute to partners.

      +
    • +
    • Transport Framework - We + have a clean and simple abstraction for integrating and using Transports + (i.e., senders and listeners for SOAP over various protocols such as + SMTP, FTP, message-oriented middleware, etc), and the core of the engine + is completely transport-independent.

      +
    • +
    • WSDL support - Axis2 + supports the Web Service Description + Language, version 1.1 and 2.0, which allows you to easily build stubs + to access remote services, and also to automatically export + machine-readable descriptions of your deployed services from Axis2.

      +
    • +
    • Add-ons Several web + services specifications have been incorporated including WSS4J for security, Sandesha for reliable + messaging, Kandula which is + an encapsulation of WS-Coordination, WS-AtomicTransaction and + WS-BusinessActivity.

      +
    • +
    • Composition and + Extensibility - modules and phases improve support for + composability and extensibility. Modules supports composability and is + able to add support for new WS-* specifications in a simple and clean + manner. They are however not hot deployable + as they change the overall behavior of the system.

      +
    • +
    + +

    We hope you enjoy using Axis2. Please note that this is an open-source +effort. If you feel the code could use some new features or fixes, please get +involved and lend us a hand! The Axis developer community welcomes your +participation.

    + +

    Let us know what you think!

    + +

    Please send your feedback on Axis2 to "axis-user@ws.apache.org" and make +sure to prefix the subject of the mail with [Axis2].

    + +

    Axis2 Complete Features +List

    +
      +
    1. 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.
    2. +
    3. Support for One-Way Messaging (In-Only) and Request Response Messaging (In-Out)
    4. +
    5. Module Architecture, mechanism to extend the SOAP Processing Model
    6. +
    7. Module version support , can have multiple versions of the same module and use them depending on the requirement.
    8. +
    9. Content hierarchy
    10. +
    11. Archive based deployment Model and Directory based deployment model
    12. +
    13. JWS like deployment (making Java class into Web service)
    14. +
    15. WSDL Code Generation Tool for Stub and skeletons
    16. +
    17. WS-Addressing, both the submission (2004/08) and final (2005/08) versions
    18. +
    19. WSS4J module for security
    20. +
    21. Improved and user friendly Client API
    22. +
    23. WSDL2Java and Java2WSDL
    24. +
    25. REST (REpresentational State Transfer) Support
    26. +
    27. Transports supports: HTTP, SMTP, TCP, JMS
    28. +
    29. Raw XML providers
    30. +
    31. Support for MTOM/ MIME/ SwA
    32. +
    33. SAAJ implementation
    34. +
    35. DOOM
    36. +
    37. Pack/Unpack capability for the generated code
    38. +
    39. Axis Data Binding - ADB (Framework and Schema Compiler)
    40. +
    41. Numerous bug fixes since last release
    42. +
    43. Transport framework improvements (ListenerManager)- New
    44. +
    45. AxisServlet auto start when application server get start up- New
    46. +
    47. Module dis-engagemnt support- New
    48. +
    49. Loading module (.mar) from classpath- New
    50. +
    51. Sessions scoping for Application, SOAP, Transport and Request levels-New
    52. +
    + +

    Experimental Features List

    +
      +
    1. Server side & client side Web Service Policy support
    2. +
    3. ?wsdl and ?xsd support
    4. +
    5. Generating ServiceClient for a given WSDL and invoke the corresponding service using generated client.
    6. +
    + +

    Major Changes Since Last +Release

    +
      +
    1. Transport framework improvements (ListenerManager)
    2. +
    3. Changed the way of adding action to mapping (wsamapping) from parameter to child element so with this version onward the way of adding mapping is as follows:
    4. +
      +   
      +<actionMapping>MyMapping</actionMapping>
      +
      +
      +
    5. Refactored following packages in Axiom. +
        +
      • org.apache.axiom.om.impl.llom.builder to org.apache.axiom.om.impl.builder
      • +
      • org.apache.axiom.om.impl.llom.mtom to org.apache.axiom.om.impl.mtom
      • +
      • org.apache.axiom.om.impl.llom.serialize to org.apache.axiom.om.impl.serialize
      • +
      • org.apache.axiom.om.impl.llom.traverse to org.apache.axiom.om.impl.traverse
      • +
      +
    6. +
    + +

    Tools Included In This +Release

    +
      +
    1. Axis2 Web Application (Web App)
    2. +
    3. WSDL2WS- Command line + version
    4. + +
    +

    Download above plugins

    + +

    What's Still To Do?

    + +

    See list of what we think needs to be done, and consider helping out if +you're interested & able!

    +
      +
    1. JAX-RPC 1.1 and/or JAX-WS compliance
    2. +
    3. SOAP Encoding
    4. +
    5. Binary serialization and de-serialization support
    6. +
    7. Management Interface for Axis2
    8. +
    9. Implementation of other Transports.
    10. +
    11. Resource framework implementation (WS-RF) and Enterprise web services such as JSR 109 support
    12. +
    13. Completion of Interop tests
    14. +
    + +

    Previous | Next

    + +Pages: Content, +1, 2, 3, 4, 5 +