Apache Axis2/Java Version 1.6.2 

Introduction

Apache Axis2, the third generation Web services engine is more efficient, more modular and more XML-oriented than its predecessor Apache Axis. It is carefully designed to support the easy addition of plug-in modules that extend its functionality for features such as security and increased reliability.

Apache Axis2 Version 1.6.2 is a bugfix release, fixing several problems in version 1.5. Please see the release notes for more details.

This page describes our list of available documents.

Apache Axis2 User's Guide

You can get started with Axis2 with the assistance of the following documents. They will guide you through the Axis2 download, installation (both as a standalone Web services engine and as part of a J2EE compliant servlet container), and instructions on how to write Web services and Web services client using Apache Axis2.

• Introduction- Gives you an introduction to what Axis2 is, the life cycle of a Web services message, how Axis2 handles SOAP messages and also includes a basic description on Axis2 distributions, and how Axis2 behaves as part of a Web application or as a standalone client that is not part of a J2EE application.
• Download and Installation- Lists the different distribution packages offered by Axis2 and gives in-depth instructions on the installation of the standalone method and as part of a J2EE servlet container.
• Testing Client Code - The best way to make sure that your system is running Axis2 is to install and test both a service and a client. This document describes this process in easy to understand steps.
• Introduction to Services - The term "Web services" can apply to a number of different ways of sending information back and forth. However, this guide focuses on the sending and receiving of SOAP messages and Message Exchange Patterns (MEPs).
• Creating Clients from WSDL - When it comes to creating a Web service client, you can do it manually as described in the next document. However, in most cases, you will have a Web Service Description Language (WSDL) definition that describes the messages that clients should send and expect to receive. Axis2 provides several ways to use this definition to automatically generate a client. This document explains how to create a client using WSDL definitions.
• Building Services from Scratch - Now that you know how to use Axis2 to generate clients from WSDL as described in the document before, this document digs a little deeper, showing you how to create services, and how to create both services and clients "from scratch", so to speak.
• Samples - The Axis2 Standard Distribution provides a number of samples you can use as a guide for implementing specific features and capabilities. These services are listed in this document along with basic introductions for each one.
• For Further Study - This section lists resource documents for further study.
  • POJO Web Services using Apache Axis2-This guide will show you how to create a Plain Old Java Object (POJO) for deploying using Apache Axis2 on Apache Tomcat. POJOs are fast to build and easy to maintain, which means you'll save a lot of time building and debugging your code
  • Axis2 Quick Start Guide-The purpose of this guide is to get you started on creating services and clients using Axis2 as quickly as possible. It demonstrates how to create Web services using a variety of different technologies.

Also see our FAQ page to answer those common questions in mind.

How To

This section deals with more advanced topics including Axis2 support features such as Transports, Attachments, Pluggable Data Binding, Security, and REST Web services in detail.

• Web Administrator's Guide - Detailed instructions on the administration console of Axis2 Web application, which provides run-time configuration of Axis2.
• Migrating from Axis 1.x to Axis 2 - Guiding Axis 1.x users in upgrading to Axis2
• Application Server Specific Configuration Guide - Provides extra configuration information required for application servers to run Axis2 to its fullest potential
• Axiom User Guide - An introduction to Axis2's Object Model
• REST Support-Introduction on Representational State Transfer
• Axis2 RPC Support - This document talks about the Axis2's Remote Procedure Calls support in a set of easy to understand implementation steps
• MTOM Guide -Sending Binary Data with SOAP - Explains how to send binary data using the SOAP Message Transmission Optimization Mechanism
• Axis2 Configuration Guide - Explains the three configurations in Axis2: global, service, and module
• SOAP Monitor How-to - A guide on the utilities used to monitor the SOAP messages that invoke Web services, along with the results of those messages
• Web Services Policy Support In Axis2 - Introduction to the role of Web services policy in Axis2
• Spring Framework - A guide on how to use Axis2 with the Spring Framework
• JSON Support - This document explains how to use JSON support implementation in Axis2. Includes details on test cases and samples
• Exposing CORBA Services as Web Services - This guide explains how to expose a CORBA Services as a Web Services in Axis2 using an example
• Guide to using EJB Provider in Axis2 - This guide explains how to use an EJB provider in Axis2 using an example
• Clustering Guide - This guide will show how you can leverage clustering support to improve Scalability, Failover and High Availability of your Web Services

Data Bindings:

• ADB How-to - A guide on the Axis2 Databinding Framework (ADB)
• Advanced ADB Framework Features - Provides an insight into the newly added advanced features of ADB
• Tweaking the ADB Code Generator - Explains the available mechanisms to extend ADB
• ADB Integration with Axis2 - A guide to writing an extension using the integrator in order to integrate ADB with Axis2
• JiBX Integration With Axis2 - A guide to using JiBX with Axis2 in order to expose existing Java code as a Web service and to implement a client for an existing Web service

Transports:

• HTTP Transports - A description on HTTP sender and HTTP receiver in Axis2
• Write Your Own Axis2 Transport - A quick and easy guide to create your own Axis2 Transport protocol

Axis2 Tools:

• Code Generator Tool Guide for Command Line and Ant Tasks - Lists command line and Ant task references. How to build a file using custom Ant tasks and how to invoke a Code Generator from Ant
• Code Generator Wizard Guide for Eclipse Plug-in - Explains the usage of the code generator Eclipse plug-in for WSDL2Java and/or Java2WSDL operations
• Service Archive Generator Wizard Guide for Eclipse Plug-in - Describes the functionality of the Eclipse plugin service archive generator tool
• Code Generator Wizard Guide for IntelliJ IDEA Plug-in - A guide on the usage of the IDEA code generation plug-in to create service archives and generate Java class files from WSDL files
• Maven2 AAR Plug-in Guide - A guide to generate an Axis 2 service file (AAR file) using the Maven plug-in.
• Maven2 Java2WSDL Plug-in Guide - A guide to using Java2WSDL Maven 2 Plug-in that takes a Java class as input and generates a WSDL, which describes a Web service for invoking the class methods
• Maven2 WSDL2Code Plug-in Guide - A guide to using this plugin that takes as input a WSDL and generates client and server stubs for calling or implementing a Web service matching the WSDL.

Apache Axis2 Developers

• Advanced User's Guide - A quick start user's guide for more experienced users and developers on how to install, create Web services and Web service clients using Axis2.
  • Introduction - Outlines the overall direction of the user guide, with a high level introduction on Axis2
  • Download and Installation - Lists the different distribution packages offered by Axis2, and the installations for the standalone and as part of a J2EE servlet container methods.
  • Creating a new Web Service with Code Generation - Axis2 provides two ways to create new Web Services: using code generation and XML based primary APIs. This section explains how to start from a WSDL, and create a new Service with code generation
  • Writing Web Services Using Axis2's Primary APIs - Explains how to create new Web Services using XML based primary APIs
  • Writing a Web Service Client with Code Generation - Axis2 also provides a more complex, yet powerful XML based client API that is intended for advanced users. However, if you are a new user we recommend using the code generation approach presented below
  • Writing Web Service Clients Using Axis2's Primary APIs - This section presents complex yet powerful XML based client APIs, which is intended for advanced users to write Web services clients
  • Configuring Axis2 - Axis2 configuration is based on a repository and standard archive formats. Here you will find details on how to configure Axis2. You will also find reference documents that lead to greater detail in this area.
• Axis2 Architecture Guide - Introduction to Axis2's modular architecture
• Online Java Docs - Java API documentation
• Reference Library - This document provides additional information to developers on WS-* specifications, Java language specifications, Subversion (SVN) control etc.

References

Gives you a list of published articles, tutorials and Questions-Answers on Apache Axis2. Check them out for that extra knowledge on the next generation Web services engine Apache Axis2. Be informed and up-to-date!