blob: cf5c1aab3bee7eae77d12746fdf9769546b14e7e [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Axis2/Java @axis2_version@ Documentation Home</title>
<link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
media="all">
</head>
<body lang="en">
<h1>Apache Axis2/Java Version @axis2_version@ Documentation Index</h1>
<h2>Introduction</h2>
<p>Apache Axis2, the third generation Web services engine is more efficient,
more modular and more XML-oriented than its predecessor <a
href="http://ws.apache.org/axis/">Apache Axis</a>. 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.</p>
<p>Apache Axis2 Version @axis2_version@ comes to you with performance
improvements and bug fixes over the 1.1 release.</p>
<p>This page will take you through the list of documents that we have in
store for you.</p>
<h2>Apache Axis2 User's Guide</h2>
<p>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.</p>
<ul>
<li><a href="userguide.html#intro">Introduction</a>- 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.</li>
<li><a href="installationguide.html">Download and Installation</a>- 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.</li>
<li><a href="userguide-installingtesting.html">Testing Client Code</a> -
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.</li>
<li><a href="userguide-introtoservices.html">Introduction to Services</a> -
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).</li>
<li><a href="userguide-creatingclients.html">Creating Clients from WSDL</a>
- 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.</li>
<li><a href="userguide-buildingservices.html">Building Services from
Scratch</a> - 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.</li>
<li><a href="userguide-samples.html">Samples</a> - 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.</li>
<li><a href="userguide-forfurtherstudy.html">For Further Study</a> - This
section lists resource documents for further study.
<ul>
<li><a href="pojoguide.html">POJO Web Services using Apache
Axis2</a>-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</li>
<li><a href="quickstartguide.html">Axis2 Quick Start Guide</a>-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.</></li>
</ul>
</li>
</ul>
Also see our <a href="../faq.html">FAQ page</a> to answer those common
questions in mind.
<h2>How To</h2>
<p>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.</p>
<ul>
<li><a href="webadminguide.html">Web Administrator's Guide</a> - Detailed
instructions on the administration console of Axis2 Web application,
which provides run-time configuration of Axis2.</li>
<li><a href="migration.html">Migrating from Axis 1.x to Axis 2</a> -
Guiding Axis 1.x users in upgrading to Axis2</li>
<li><a href="app_server.html">Application Server Specific Configuration
Guide</a> - Provides extra configuration information required for
application servers to run Axis2 to its fullest potential</li>
<li><a href="http://ws.apache.org/commons/axiom/OMTutorial.html">AXIOM
Tutorial</a>-An introduction to Axis2's Object Model</li>
<li><a href="rest-ws.html">REST Support</a>-Introduction on
Representational State Transfer</li>
<li><a href="Axis2-rpc-support.html">Axis2 RPC Support</a> - This document
talks about the Axis2's Remote Procedure Calls support in a set of easy
to understand implementation steps</li>
<li><a href="mtom-guide.html">MTOM Guide -Sending Binary Data with SOAP</a>
- Explains how to send binary data using the SOAP Message Transmission
Optimization Mechanism</li>
<li><a href="axis2config.html">Axis2 Configuration Guide</a> - Explains the
three configurations in Axis2: global, service, and module</li>
<li><a href="soapmonitor-module.html">SOAP Monitor How-to</a> - A guide on
the utilities used to monitor the SOAP messages that invoke Web services,
along with the results of those messages</li>
<li><a href="WS_policy.html">Web Services Policy Support In Axis2</a> -
Introduction to the role of Web services policy in Axis2</li>
<li><a href="spring.html">Spring Framework</a> - A guide on how to use
Axis2 with the Spring Framework</li>
<li><a href="json_support.html">JSON Support</a> - This document explains
how to use JSON support implementation in Axis2. Includes details on test
cases and samples</li>
<li><a href="ejb-provider.html">Guide to using EJB Provider in Axis2</a> -
This guide explains how to use an EJB provider in Axis2 using an
example</li>
</ul>
<p><strong>Data Bindings:</strong></p>
<ul>
<li><a href="adb/adb-howto.html">ADB How-to</a> - A guide on the Axis2
Databinding Framework (ADB)</li>
<li><a href="adb/adb-advanced.html">Advanced ADB Framework Features</a> -
Provides an insight into the newly added advanced features of ADB</li>
<li><a href="adb/adb-tweaking.html">Tweaking the ADB Code Generator</a> -
Explains the available mechanisms to extend ADB</li>
<li><a href="adb/adb-codegen-integration.html">ADB Integration with
Axis2</a> - A guide to writing an extension using the integrator in order
to integrate ADB with Axis2</li>
<li><a href="jibx/jibx-codegen-integration.html">JiBX Integration With
Axis2</a> - 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</li>
</ul>
<p><strong>Transports:</strong></p>
<ul>
<li><a href="tcp-transport.html">TCP Transport</a> - A guide to sending and
receiving SOAP messages via TCP in Axis2</li>
<li><a href="mail-transport.html">Mail Transport</a> - Explains how to
invoke a service using a Mail transport</li>
<li><a href="mail-configuration.html">Mail Transport Configuration</a> - A
guide to configuring Axis2 in order to get mail transport working</li>
<li><a>HTTP Transports</a> - A description on HTTP sender and HTTP receiver
in Axis2</li>
<li><a href="jms-transport.html">JMS Transport</a> - A description on JMS
sender and JMS receiver in Axis2</li>
<li><a href="transport_howto.html">Write Your Own Axis2 Transport</a> - A
quick and easy guide to create your own Axis2 Transport protocol</li>
</ul>
<p><strong>Axis2 Tools:</strong></p>
<ul>
<li><a href="../tools/@axis2_version_dir@/CodegenToolReference.html">Code
Generator Tool Guide for Command Line and Ant Tasks</a> - 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</li>
<li><a
href="../tools/@axis2_version_dir@/eclipse/wsdl2java-plugin.html">Code
Generator Wizard Guide for Eclipse Plug-in</a> - Explains the usage of
the code generator Eclipse plug-in for WSDL2Java and/or Java2WSDL
operations</li>
<li><a
href="../tools/@axis2_version_dir@/eclipse/servicearchiver-plugin.html">Service
Archive Generator Wizard Guide for Eclipse Plug-in</a> - Describes the
functionality of the Eclipse plugin service archive generator tool</li>
<li><a
href="../tools/@axis2_version_dir@/idea/Idea_plug-in_userguide.html">Code
Generator Wizard Guide for IntelliJ IDEA Plug-in</a> - A guide on the
usage of the IDEA code generation plug-in to create service archives and
generate Java class files from WSDL files</li>
<li><a
href="../tools/@axis2_version_dir@/maven-plugins/maven-aar-plugin.html">Maven2
AAR Plug-in Guide</a> - A guide to generate an Axis 2 service file (AAR
file) using the Maven plug-in.</li>
<li><a
href="../tools/@axis2_version_dir@/maven-plugins/maven-java2wsdl-plugin.html">Maven2
Java2WSDL Plug-in Guide</a> - 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</li>
<li><a
href="../tools/@axis2_version_dir@/maven-plugins/maven-wsdl2code-plugin.html">Maven2
WSDL2Code Plug-in Guide</a> - 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.</li>
</ul>
<h2>Apache Axis2 Developers</h2>
<ul>
<li><a href="adv-userguide.html">Advanced User's Guide</a> - 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.
<ul>
<li><a href="adv-userguide.html#introduction">Introduction</a> -
Outlines the overall direction of the user guide, with a high level
introduction on Axis2</li>
<li><a href="installationguide.html">Download and Installation</a> -
Lists the different distribution packages offered by Axis2, and the
installations for the standalone and as part of a J2EE servlet
container methods.</li>
<li><a href="adv-userguide.html#ws_codegen">Creating a new Web Service
with Code Generation</a> - 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</li>
<li><a href="xmlbased-server.html">Writing Web Services Using Axis2's
Primary APIs</a> - Explains how to create new Web Services using XML
based primary APIs</li>
<li><a href="adv-userguide.html#client">Writing a Web Service Client
with Code Generation </a>- 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</li>
<li><a href="dii.html">Writing Web Service Clients Using Axis2's
Primary APIs</a> - This section presents complex yet powerful XML
based client APIs, which is intended for advanced users to write Web
services clients</li>
<li><a href="adv-userguide.html#config">Configuring Axis2</a> - 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.</li>
</ul>
</li>
<li><a href="Axis2ArchitectureGuide.html">Axis2 Architecture Guide</a> -
Introduction to Axis2's modular architecture</li>
<!--<li><a href="api/index.html">Online Java Docs</a>-Java API
documentation</li>-->
<li><a
href="http://ws.apache.org/axis2/@axis2_version_dir@/api/index.html">Online
Java Docs</a> - Java API documentation</li>
<li><a href="../refLib.html">Reference Library</a> - This document provides
additional information to developers on WS-* specifications, Java
language specifications, Subversion (SVN) control etc.</li>
</ul>
<h2>References</h2>
<p>Gives you a list of published articles, tutorials and Questions-Answers on
Apache Axis2. <a href="../articles.html">Check them out</a> for that extra
knowledge on the next generation Web services engine Apache Axis2. Be
Informed and up-to-date!</p>
</body>
</html>