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 di...@apache.org on 2007/07/14 06:37:36 UTC
svn commit: r556222 [4/22] - in /webservices/axis2/trunk/java/xdocs: ./
@axis2_version_dir@/ @axis2_version_dir@/adb/ @axis2_version_dir@/jibx/
@axis2_version_dir@/src/ download/0_9/ download/0_91/ download/0_92/
download/0_93/ download/0_94/ download/...
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/app_server.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/app_server.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/app_server.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/app_server.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/app_server.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/app_server.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/app_server.xml Fri Jul 13 21:37:26 2007
@@ -1,108 +1,104 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<!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>Application Server Specific Configuration Guide</title>
- <meta 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>
-<h1>Application Server Specific Configuration Guide</h1>
-
-<p>This document provides configuration information required for your
-Application Server to run Apache Axis2 to its fullest potential.</p>
-
-<h3>WebLogic/ WebSphere</h3>
-
-<p><strong>1. Use exploded configuration to deploy Axis2 WAR</strong></p>
-
-<p>We recommend using the exploded configuration to deploy Axis2 WAR in
-WebLogic and WebSphere application servers to support the hotupdate/
-hotdeployment features in Axis2. However, if you want to deploy custom
-WARs, say in a clustering environment, you need to add two additional files
-into the WEB-INF named "services.list" and "modules.list" under the modules
-and services directory respectively.</p>
-<ul>
- <li><b>WEB-INF/services/services.list</b> : should list all the services
- (aar files) that you want to expose.</li>
- <li><b>WEB-INF/modules/modules.list</b> : should list all the modules (mar
- files) that you want to use.</li>
-</ul>
-NOTE: In both cases, please list one entry per line.
-
-<p>WebLogic ships with JARs that conflict with JARs present in Axis2.
-Therefore use <prefer-web-inf-classes> to ensure that JARs packaged in
-Axis2 WAR are picked up from WEB-INF/lib. You can do this by setting the
-<prefer-web-inf-classes> element in WEB-INF/weblogic.xml to true. An
-example of weblogic.xml is shown below:</p>
-<pre><weblogic-web-app>
- <container-descriptor>
- <prefer-web-inf-classes>true</prefer-web-inf-classes>
- </container-descriptor>
-</weblogic-web-app></pre>
-
-<p>If set to true, the <prefer-web-inf-classes> element will force
-WebLogic's classloader to load classes located in the WEB-INF directory of a
-Web application in preference to application or system classes. This is a
-recommended approach since it only impacts a single Web module.</p>
-
-<p>Please refer to the following documents in WebLogic/ WebSphere for more
-information:</p>
-<ul>
- <li><a
- href="http://e-docs.bea.com/wls/docs81/programming/classloading.html">WebLogic
- ServerApplication Classloading</a>- For more information on how
- WebLogic's class loader works</li>
- <li><a
- href="http://e-docs.bea.com/wls/docs81/webapp/deployment.html">Redeploying
- a Web Application in Exploded Directory Format</a></li>
- <li><a
- href="http://publib.boulder.ibm.com/infocenter/wsiihelp/v8r3/index.jsp?topic=/com.ibm.websphere.ii.product.ce.doc/configuring/iiyviigdepwebexpl.htm">Deploying
- the Web application in exploded form</a></li>
-</ul>
-
-<p><strong>2. Lack of namespacing on serialised items</strong></p>
-
-<p>BEA WebLogic Server 9.0 comes with its own StAX implementation. This
-results in lack of namespacing on serialised items. In turn, WebLogic server
-(WLS) breaks with AXIOM on the WLS classpath. Hence a filtering classloader
-is required:</p>
-
-<p></p>
-
-<p>Adding the following to weblogic-application.xml should resolve this
-issue:</p>
-<pre><prefer-application-packages>
-<package-name>com.ctc.wstx.*</package-name>
-<package-name>javax.xml.*</package-name>
-<package-name>org.apache.*</package-name>
-</prefer-application-packages></pre>
-
-<p></p>
-
-<p>Note that the libraries listed--Xerces, StAX API, Woodstox--need to be on the
-application classpath.</p>
-</body>
-</html>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content=
+"HTML Tidy for Windows (vers 14 June 2007), see www.w3.org" />
+<meta http-equiv="content-type" content=
+"text/html; charset=us-ascii" />
+<title>Application Server Specific Configuration Guide</title>
+<meta 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>
+<h1>Application Server Specific Configuration Guide</h1>
+<p>This document provides configuration information required for
+your Application Server to run Apache Axis2 to its fullest
+potential.</p>
+<h3>WebLogic/ WebSphere</h3>
+<p><strong>1. Use exploded configuration to deploy Axis2
+WAR</strong></p>
+<p>We recommend using the exploded configuration to deploy Axis2
+WAR in WebLogic and WebSphere application servers to support the
+hotupdate/ hotdeployment features in Axis2. However, if you want to
+deploy custom WARs, say in a clustering environment, you need to
+add two additional files into the WEB-INF named "services.list" and
+"modules.list" under the modules and services directory
+respectively.</p>
+<ul>
+<li><b>WEB-INF/services/services.list</b> : should list all the
+services (aar files) that you want to expose.</li>
+<li><b>WEB-INF/modules/modules.list</b> : should list all the
+modules (mar files) that you want to use.</li>
+</ul>
+NOTE: In both cases, please list one entry per line.
+<p>WebLogic ships with JARs that conflict with JARs present in
+Axis2. Therefore use <prefer-web-inf-classes> to ensure that
+JARs packaged in Axis2 WAR are picked up from WEB-INF/lib. You can
+do this by setting the <prefer-web-inf-classes> element in
+WEB-INF/weblogic.xml to true. An example of weblogic.xml is shown
+below:</p>
+<pre>
+<weblogic-web-app>
+ <container-descriptor>
+ <prefer-web-inf-classes>true</prefer-web-inf-classes>
+ </container-descriptor>
+</weblogic-web-app>
+</pre>
+<p>If set to true, the <prefer-web-inf-classes> element will
+force WebLogic's classloader to load classes located in the WEB-INF
+directory of a Web application in preference to application or
+system classes. This is a recommended approach since it only
+impacts a single Web module.</p>
+<p>Please refer to the following documents in WebLogic/ WebSphere
+for more information:</p>
+<ul>
+<li><a href=
+"http://e-docs.bea.com/wls/docs81/programming/classloading.html">WebLogic
+ServerApplication Classloading</a>- For more information on how
+WebLogic's class loader works</li>
+<li><a href=
+"http://e-docs.bea.com/wls/docs81/webapp/deployment.html">Redeploying
+a Web Application in Exploded Directory Format</a></li>
+<li><a href=
+"http://publib.boulder.ibm.com/infocenter/wsiihelp/v8r3/index.jsp?topic=/com.ibm.websphere.ii.product.ce.doc/configuring/iiyviigdepwebexpl.htm">
+Deploying the Web application in exploded form</a></li>
+</ul>
+<p><strong>2. Lack of namespacing on serialised items</strong></p>
+<p>BEA WebLogic Server 9.0 comes with its own StAX implementation.
+This results in lack of namespacing on serialised items. In turn,
+WebLogic server (WLS) breaks with AXIOM on the WLS classpath. Hence
+a filtering classloader is required:</p>
+<p>Adding the following to weblogic-application.xml should resolve
+this issue:</p>
+<pre>
+<prefer-application-packages>
+<package-name>com.ctc.wstx.*</package-name>
+<package-name>javax.xml.*</package-name>
+<package-name>org.apache.*</package-name>
+</prefer-application-packages>
+</pre>
+<p>Note that the libraries listed--Xerces, StAX API, Woodstox--need
+to be on the application classpath.</p>
+</body>
+</html>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/axis2config.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/axis2config.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/axis2config.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/axis2config.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/axis2config.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/axis2config.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/axis2config.xml Fri Jul 13 21:37:26 2007
@@ -19,10 +19,10 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
- <meta http-equiv="content-type" content="">
+ <meta http-equiv="content-type" content=""/>
<title>Axis2 Configuration Documents</title>
<link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
- media="all">
+ media="all"/>
</head>
<body lang="en">
@@ -81,8 +81,8 @@
<p>Depending on the underlying transport on which Axis2 is going to run, you
need to have different transport receivers. The way you add them to the
-system is as follows:</p>
-<pre>
+system is as follows:</p> <source>
+<pre>
<transportReceiver name="http" class="org.apache.axis2.transport.http.SimpleHTTPServer">
<parameter name="port" >6060</parameter>
</transportReceiver>
@@ -135,7 +135,7 @@
that by adding a handler element into it. In addition to that, there is no
hard coding work for the handler chain anywhere in Axis2 (at any Axis*). So
all those configurations are also done in the phase order element. The
-complete configurations will look as follows: <source></p>
+complete configurations will look as follows: </p><source>
<pre><phaseOrder type="InFlow">
<!-- Global phases -->
<phase name="Transport">
@@ -228,10 +228,10 @@
<p>In addition to that, the only child element that is allowed inside
"phaseOrder" is the "phase" element which represents the available phases in
the execution chain. The method of specifying phases inside "phaseOrder" is
-as follows:</p>
+as follows:</p><source>
<pre> <phase name="Transport"/></pre>
</source>
-<p><strong>name:</strong> Name of the phase. <br>
+<p><strong>name:</strong> Name of the phase. <br/>
</p>
<p>There are a number of things that one has to keep in mind when changing a
@@ -264,7 +264,7 @@
<h3>Module References</h3>
<p>If you want to engage a module, system wide, you can do it by adding a top
-level module element in axis2.xml. It should look as follows:</p>
+level module element in axis2.xml. It should look as follows:</p><source>
<pre><module ref="addressing"/> </pre>
</source>
<p><strong>ref:</strong> the module name which is going to be engaged, system
@@ -287,7 +287,7 @@
<p>Registering Observers is very useful for additional features such as RSS
feed generation, which will provide service information to subscribers. The
-correct way of registering observers should as follows:</p>
+correct way of registering observers should as follows:</p><source>
<pre><listener class="org.apache.axis2.ObserverIMPL">
<parameter name="RSS_URL" >http://127.0.0.1/rss</parameter>
</listener></pre>
@@ -370,7 +370,7 @@
has to add the "operation" tag and override it. In a non-Java scenario or if
you do not have a service class, then all the operations the user wants to
expose by the service has to be indicated in the services.xml. It is
-specified as follows:</p>
+specified as follows:</p> <source>
<pre> <operation name="echoString">
<module ref=" a module name "/>
<messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
@@ -382,7 +382,7 @@
that you can register custom message receivers per operation. Then the
registered message receiver will be the message receiver for the
corresponding operation. If you do not specify the message receiver, then the
-default message receiver will perform the operation. <br>
+default message receiver will perform the operation. <br/>
<a name="Module_Configuration"></a></p>
<h2>Module Configuration</h2>
@@ -392,10 +392,10 @@
<p>The description of the module is specified using the module.xml. Each
module archive file needs to have a module.xml in order to be a valid module,
-and it should be available in the META-INF directory of the archive file. <br>
+and it should be available in the META-INF directory of the archive file. <br/>
</p>
-<p>A very simple module.xml is shown below:</p>
+<p>A very simple module.xml is shown below:</p> <source>
<pre><module class="org.apache.module.Module1Impl">
<InFlow>
.
@@ -451,29 +451,29 @@
in services.xml.</p>
<p><b>handler:</b> The Handler element consists of compulsory and optional
-attributes. The method of defining a handler will look as follows:</p>
+attributes. The method of defining a handler will look as follows:</p> <source>
<pre><handler name="handler1" class="handlerClass ">
<order phase="userphase1" />
</handler></pre>
</source>
-<p><b><i>Compulsory Attributes</i></b> <br>
-<b>name:</b> Name of the handler.<br>
-<b>class:</b> Handler implementation class.<br>
+<p><b><i>Compulsory Attributes</i></b> <br/>
+<b>name:</b> Name of the handler.<br/>
+<b>class:</b> Handler implementation class.<br/>
<b>phase:</b> Name of the phase that the handler should remain, in the
-execution chain. <br>
-<br>
-<i><b>Optional Attributes :</b></i><br>
+execution chain. <br/>
+<br/>
+<i><b>Optional Attributes :</b></i><br/>
<b>phaseLast:</b> Indicates that the handler is the last handler of the
-phase.<br>
+phase.<br/>
<b>phaseFirst:</b> Indicate that the handler is the first handler of the
-phase.<br>
+phase.<br/>
<b>before :</b> Indicates that the current handler should be invoked before
-the handler specified by the before handler<br>
+the handler specified by the before handler<br/>
<b>after:</b> Indicates that the current handler should be invoked after the
-handler specified by the after handler<br>
+handler specified by the after handler<br/>
</p>
-<p><br>
+<p><br/>
</p>
</body>
</html>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/contents.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/contents.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/contents.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/contents.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/contents.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/contents.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/contents.xml Fri Jul 13 21:37:26 2007
@@ -1,272 +1,281 @@
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<!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>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content=
+"HTML Tidy for Windows (vers 14 June 2007), see www.w3.org" />
+<meta http-equiv="content-type" content=
+"text/html; charset=us-ascii" />
+<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" xml: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>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/dii.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/dii.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/dii.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/dii.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/dii.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/dii.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/dii.xml Fri Jul 13 21:37:26 2007
@@ -18,10 +18,10 @@
-->
<html>
<head>
- <meta http-equiv="content-type" content="">
+ <meta http-equiv="content-type" content=""/>
<title></title>
<link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
- media="all">
+ media="all"/>
</head>
<body>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/ejb-provider.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/ejb-provider.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/ejb-provider.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/ejb-provider.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/ejb-provider.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/ejb-provider.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/ejb-provider.xml Fri Jul 13 21:37:26 2007
@@ -1,284 +1,286 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!--
- ~ Licensed to the Apache Software Foundation (ASF) under one
- ~ or more contributor license agreements. See the NOTICE file
- ~ distributed with this work for additional information
- ~ regarding copyright ownership. The ASF licenses this file
- ~ to you under the Apache License, Version 2.0 (the
- ~ "License"); you may not use this file except in compliance
- ~ with the License. You may obtain a copy of the License at
- ~
- ~ http://www.apache.org/licenses/LICENSE-2.0
- ~
- ~ Unless required by applicable law or agreed to in writing,
- ~ software distributed under the License is distributed on an
- ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~ KIND, either express or implied. See the License for the
- ~ specific language governing permissions and limitations
- ~ under the License.
- -->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
- <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
- <title>Guide to using EJB Provider for Axis2</title>
- <meta name="generator" content="amaya 9.2.1, see http://www.w3.org/Amaya/"
- />
-</head>
-
-<body xml:lang="en">
-<h1>Guide to using EJB Provider for Axis2</h1>
-
-<p>The EJB message receiver allows one to access stateless session EJBs
-(Enterprise JavaBeans) through Web services. The example used in this guide
-illustrates how to use the EJB provider that ships with Axis2 to access EJBs
-deployed on a J2EE server such as Geronimo or JBoss.</p>
-
-<p>This example explains how to use Geronimo 1.1 and JBoss 4.0.4.GA as
-application server. </p>
-
-<p>The following steps will take you through the example through which we
-will explain how to use an EJB provider in Axis2</p>
-
-<h2>1. Creating a Simple Stateless Session EJB</h2>
-
-<p>First we need to create a stateless session EJB. Use the following files
-to make an EJB for testing:</p>
-<pre>Remote interface (Hello.java)
-package my.ejb;
-import javax.ejb.EJBObject;
-
-public interface Hello extends EJBObject, HelloBusiness {
-}</pre>
-
-<p>The following interface defines the business methods available in</p>
-
-<p><code>1.</code>HelloBusiness.java</p>
-<pre>package my.ejb;
-import java.rmi.RemoteException;
-
-public interface HelloBusiness {
- public String sayHello(String name) throws RemoteException;
-}</pre>
-
-<p>2, Remote home interface - HelloHome.java</p>
-<pre>package my.ejb;
-import javax.ejb.EJBHome;
-import javax.ejb.CreateException;
-import java.rmi.RemoteException;
-
-public interface HelloHome extends EJBHome {
- public Hello create() throws CreateException, RemoteException;
-}</pre>
-
-<p>3. Bean class - HelloBean.java</p>
-<pre>package my.ejb;
-import javax.ejb.SessionBean;
-import javax.ejb.SessionContext;
-import javax.ejb.EJBException;
-import javax.ejb.CreateException;
-
-public class HelloBean implements SessionBean {
- public void setSessionContext(SessionContext sessionContext) throws
- EJBException {}
-
- public void ejbRemove() throws EJBException {}
- public void ejbActivate() throws EJBException {}
- public void ejbPassivate() throws EJBException {}
- public void ejbCreate() throws CreateException {}
-
- public String sayHello(String name) {
- return "Hello " + name + ", Have a nice day!";
- }
-
-}</pre>
-
-<p>4. Deployment descriptor - ejb-jar.xml</p>
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
- http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd"
- version="2.1">
-
- <enterprise-beans>
- <session>
- <ejb-name>Hello</ejb-name>
- <home>my.ejb.HelloHome</home>
- <remote>my.ejb.Hello</remote>
- <ejb-class>my.ejb.HelloBean</ejb-class>
- <session-type>Stateless</session-type>
- <transaction-type>Bean</transaction-type>
- </session>
- </enterprise-beans>
- <assembly-descriptor>
- <container-transaction>
- <method>
- <ejb-name>Hello</ejb-name>
- <method-name>*</method-name>
- </method>
- <trans-attribute>Required</trans-attribute>
- </container-transaction>
- </assembly-descriptor>
-</ejb-jar></pre>
-
-<p>Now we have to write application server specific deployment descriptor(s)
-for the Hello EJB. The following listing shows an example Geronimo/OpenEJB
-deployment descriptor (openejb-jar.xml)</p>
-<pre><?xml version="1.0" encoding="UTF-8"?>
-<openejb-jar
- xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1"
- xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.1"
- xmlns:security="http://geronimo.apache.org/xml/ns/security-1.1"
- xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.1"
- xmlns:pkgen="http://www.openejb.org/xml/ns/pkgen-2.0">
- <enterprise-beans>
- <session>
- <ejb-name>Hello</ejb-name>
- <jndi-name>my/ejb/HelloBean</jndi-name>
- </session>
- </enterprise-beans>
-</openejb-jar></pre>
-
-<p>If you want to test on JBoss, use the following JBoss deployment
-descriptor (jboss.xml)</p>
-<pre><?xml version="1.0"?>
-<!DOCTYPE jboss PUBLIC "-//JBoss//DTD JBOSS 4.0//EN"
- "http://www.jboss.org/j2ee/dtd/jboss_4_0.dtd">
-<jboss>
- <enterprise-beans>
- <session>
- <ejb-name>Hello</ejb-name>
- <jndi-name>my/ejb/HelloBean</jndi-name>
- </session>
- </enterprise-beans>
-</jboss></pre>
-
-<p>Compile the above java classes and bundle the compiled classes and the XML
-files into a jar file (HelloEJB.jar) as shown below.</p>
-<pre>
-HelloEJB.jar
- |
- +--META-INF
- | +--ejb-jar.xml
- | +--jboss.xml [If you want to deploy on Jboss]
- | +--openejb-jar.xml [If you want to deploy on Geronimo/Openejb]
- |
- +--my
- +--ejb
- |
- +--Hello.class
- +--HelloBean.class
- +--HelloBusiness.class
- +--HelloHome.class
- </pre>
-
-<p>Next, deploy the HelloEJB.jar file onto the appropriate J2EE application server.</p>
-
-<h2>Creating the Axis2 Service Archive</h2>
-
-<p>Now we need to make the services.xml file.</p>
-<pre><serviceGroup>
- <service name="HelloBeanService">
- <description>Hello! web service</description>
- <messageReceivers>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
- class="org.apache.axis2.rpc.receivers.ejb.EJBInOnlyMessageReceiver"/>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
- class="org.apache.axis2.rpc.receivers.ejb.EJBMessageReceiver"/>
- </messageReceivers>
- <parameter name="ServiceClass">my.ejb.HelloBusiness</parameter>
- <parameter name="remoteInterfaceName">my.ejb.Hello</parameter>
- <parameter name="homeInterfaceName">my.ejb.HelloHome</parameter>
- <parameter name="beanJndiName">my/ejb/HelloBean</parameter>
- <parameter name="providerUrl">[URL]</parameter>
- <parameter name="jndiContextClass">[Context Factory Class
- Name]</parameter>
- </service>
-</serviceGroup></pre>
-
-<p>In the above services.xml file, replace the [URL] and [Context Factory
-Class Name] with valid values as follows:</p>
-
-<p><strong>i.e. If the EJB is deployed on Geronimo:</strong></p>
-
-<p>Replace [URL] by 127.0.0.1:4201</p>
-
-<p>Replace [Context Factory Class Name] by org.openejb.client.JNDIContext</p>
-
-<p><strong>For Jboss:</strong></p>
-
-<p>Replace [URL] by jnp://localhost:1099</p>
-
-<p>Replace [Context Factory Class Name] by
-org.jnp.interfaces.NamingContextFactory</p>
-
-<p>Bundle the HelloBeanService.wsdl, services.xml, remote interface class and
-home interface class as illustrated below:</p>
-<pre>
-HelloBeanService.aar
- |
- +--META-INF
- | +--services.xml
- |
- +--lib
- | +--[jars used by the ejb client eg.initial context factory classes]
- |
- +--my
- +--ejb
- +--Hello.class
- +--HelloBusiness.class
- +--HelloHome.class
- </pre>
-
-<p>The lib directory of HelloBeanService.aar must contain all the libraries
-needed to access the EJB. If the EJB is deployed on
-<strong>Geronimo</strong>, add the following jar files to the lib
-directory.</p>
-<ul>
- <li>cglib-nodep-2.1_3.jar</li>
- <li>geronimo-ejb_2.1_spec-1.0.1.jar</li>
- <li>geronimo-j2ee-jacc_1.0_spec-1.0.1.jar</li>
- <li>geronimo-kernel-1.1.jar</li>
- <li>geronimo-security-1.1.jar</li>
- <li>openejb-core-2.1.jar</li>
-</ul>
-
-<p>For <strong>JBoss</strong> add the following jar files.</p>
-<ul>
- <li>jnp-client.jar</li>
- <li>jboss-client.jar</li>
- <li>jboss-common-client.jar</li>
- <li>jboss-remoting.jar</li>
- <li>jboss-serialization.jar</li>
- <li>jboss-transaction-client.jar</li>
- <li>concurrent.jar</li>
- <li>jbosssx-client.jar</li>
- <li>jboss-j2ee.jar</li>
-</ul>
-
-<p>Deploy HelloBeanService.aar on an Axis2 server.</p>
-
-<p>Now you can access the Hello EJB through Web services. Since our EJB
-message receivers extend RPC message receivers,
-org.apache.axis2.rpc.client.RPCServiceClient can be used to invoke the
-service as illustrated in the following code fragment.</p>
-<pre>...
-
-RPCServiceClient serviceClient = new RPCServiceClient();
-Options options = serviceClient.getOptions();
-
-EndpointReference targetEPR = new
- EndpointReference("http://localhost:8080/axis2/services/HelloBeanService");
-
-options.setTo(targetEPR);
-QName hello = new QName("http://ejb.my/xsd", "sayHello");
-Object[] helloArgs = new Object[] {"John"};
-
-System.out.println(serviceClient.invokeBlocking(hello,
- helloArgs).getFirstElement().getText());
-
-...</pre>
-</body>
-</html>
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content=
+"HTML Tidy for Windows (vers 14 June 2007), see www.w3.org" />
+<meta http-equiv="content-type" content=
+"text/html; charset=us-ascii" />
+<title>Guide to using EJB Provider for Axis2</title>
+<meta name="generator" content=
+"amaya 9.2.1, see http://www.w3.org/Amaya/" />
+</head>
+<body xml:lang="en">
+<h1>Guide to using EJB Provider for Axis2</h1>
+<p>The EJB message receiver allows one to access stateless session
+EJBs (Enterprise JavaBeans) through Web services. The example used
+in this guide illustrates how to use the EJB provider that ships
+with Axis2 to access EJBs deployed on a J2EE server such as
+Geronimo or JBoss.</p>
+<p>This example explains how to use Geronimo 1.1 and JBoss 4.0.4.GA
+as application server.</p>
+<p>The following steps will take you through the example through
+which we will explain how to use an EJB provider in Axis2</p>
+<h2>1. Creating a Simple Stateless Session EJB</h2>
+<p>First we need to create a stateless session EJB. Use the
+following files to make an EJB for testing:</p>
+<pre>
+Remote interface (Hello.java)
+package my.ejb;
+import javax.ejb.EJBObject;
+
+public interface Hello extends EJBObject, HelloBusiness {
+}
+</pre>
+<p>The following interface defines the business methods available
+in</p>
+<p><code>1.</code>HelloBusiness.java</p>
+<pre>
+package my.ejb;
+import java.rmi.RemoteException;
+
+public interface HelloBusiness {
+ public String sayHello(String name) throws RemoteException;
+}
+</pre>
+<p>2, Remote home interface - HelloHome.java</p>
+<pre>
+package my.ejb;
+import javax.ejb.EJBHome;
+import javax.ejb.CreateException;
+import java.rmi.RemoteException;
+
+public interface HelloHome extends EJBHome {
+ public Hello create() throws CreateException, RemoteException;
+}
+</pre>
+<p>3. Bean class - HelloBean.java</p>
+<pre>
+package my.ejb;
+import javax.ejb.SessionBean;
+import javax.ejb.SessionContext;
+import javax.ejb.EJBException;
+import javax.ejb.CreateException;
+
+public class HelloBean implements SessionBean {
+ public void setSessionContext(SessionContext sessionContext) throws
+ EJBException {}
+
+ public void ejbRemove() throws EJBException {}
+ public void ejbActivate() throws EJBException {}
+ public void ejbPassivate() throws EJBException {}
+ public void ejbCreate() throws CreateException {}
+
+ public String sayHello(String name) {
+ return "Hello " + name + ", Have a nice day!";
+ }
+
+}
+</pre>
+<p>4. Deployment descriptor - ejb-jar.xml</p>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
+ http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd"
+ version="2.1">
+
+ <enterprise-beans>
+ <session>
+ <ejb-name>Hello</ejb-name>
+ <home>my.ejb.HelloHome</home>
+ <remote>my.ejb.Hello</remote>
+ <ejb-class>my.ejb.HelloBean</ejb-class>
+ <session-type>Stateless</session-type>
+ <transaction-type>Bean</transaction-type>
+ </session>
+ </enterprise-beans>
+ <assembly-descriptor>
+ <container-transaction>
+ <method>
+ <ejb-name>Hello</ejb-name>
+ <method-name>*</method-name>
+ </method>
+ <trans-attribute>Required</trans-attribute>
+ </container-transaction>
+ </assembly-descriptor>
+</ejb-jar>
+</pre>
+<p>Now we have to write application server specific deployment
+descriptor(s) for the Hello EJB. The following listing shows an
+example Geronimo/OpenEJB deployment descriptor
+(openejb-jar.xml)</p>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<openejb-jar
+ xmlns="http://www.openejb.org/xml/ns/openejb-jar-2.1"
+ xmlns:naming="http://geronimo.apache.org/xml/ns/naming-1.1"
+ xmlns:security="http://geronimo.apache.org/xml/ns/security-1.1"
+ xmlns:sys="http://geronimo.apache.org/xml/ns/deployment-1.1"
+ xmlns:pkgen="http://www.openejb.org/xml/ns/pkgen-2.0">
+ <enterprise-beans>
+ <session>
+ <ejb-name>Hello</ejb-name>
+ <jndi-name>my/ejb/HelloBean</jndi-name>
+ </session>
+ </enterprise-beans>
+</openejb-jar>
+</pre>
+<p>If you want to test on JBoss, use the following JBoss deployment
+descriptor (jboss.xml)</p>
+<pre>
+<?xml version="1.0"?>
+<!DOCTYPE jboss PUBLIC "-//JBoss//DTD JBOSS 4.0//EN"
+ "http://www.jboss.org/j2ee/dtd/jboss_4_0.dtd">
+<jboss>
+ <enterprise-beans>
+ <session>
+ <ejb-name>Hello</ejb-name>
+ <jndi-name>my/ejb/HelloBean</jndi-name>
+ </session>
+ </enterprise-beans>
+</jboss>
+</pre>
+<p>Compile the above java classes and bundle the compiled classes
+and the XML files into a jar file (HelloEJB.jar) as shown
+below.</p>
+<pre>
+
+HelloEJB.jar
+ |
+ +--META-INF
+ | +--ejb-jar.xml
+ | +--jboss.xml [If you want to deploy on Jboss]
+ | +--openejb-jar.xml [If you want to deploy on Geronimo/Openejb]
+ |
+ +--my
+ +--ejb
+ |
+ +--Hello.class
+ +--HelloBean.class
+ +--HelloBusiness.class
+ +--HelloHome.class
+
+</pre>
+<p>Next, deploy the HelloEJB.jar file onto the appropriate J2EE
+application server.</p>
+<h2>Creating the Axis2 Service Archive</h2>
+<p>Now we need to make the services.xml file.</p>
+<pre>
+<serviceGroup>
+ <service name="HelloBeanService">
+ <description>Hello! web service</description>
+ <messageReceivers>
+ <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
+ class="org.apache.axis2.rpc.receivers.ejb.EJBInOnlyMessageReceiver"/>
+ <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
+ class="org.apache.axis2.rpc.receivers.ejb.EJBMessageReceiver"/>
+ </messageReceivers>
+ <parameter name="ServiceClass">my.ejb.HelloBusiness</parameter>
+ <parameter name="remoteInterfaceName">my.ejb.Hello</parameter>
+ <parameter name="homeInterfaceName">my.ejb.HelloHome</parameter>
+ <parameter name="beanJndiName">my/ejb/HelloBean</parameter>
+ <parameter name="providerUrl">[URL]</parameter>
+ <parameter name="jndiContextClass">[Context Factory Class
+ Name]</parameter>
+ </service>
+</serviceGroup>
+</pre>
+<p>In the above services.xml file, replace the [URL] and [Context
+Factory Class Name] with valid values as follows:</p>
+<p><strong>i.e. If the EJB is deployed on Geronimo:</strong></p>
+<p>Replace [URL] by 127.0.0.1:4201</p>
+<p>Replace [Context Factory Class Name] by
+org.openejb.client.JNDIContext</p>
+<p><strong>For Jboss:</strong></p>
+<p>Replace [URL] by jnp://localhost:1099</p>
+<p>Replace [Context Factory Class Name] by
+org.jnp.interfaces.NamingContextFactory</p>
+<p>Bundle the HelloBeanService.wsdl, services.xml, remote interface
+class and home interface class as illustrated below:</p>
+<pre>
+
+HelloBeanService.aar
+ |
+ +--META-INF
+ | +--services.xml
+ |
+ +--lib
+ | +--[jars used by the ejb client eg.initial context factory classes]
+ |
+ +--my
+ +--ejb
+ +--Hello.class
+ +--HelloBusiness.class
+ +--HelloHome.class
+
+</pre>
+<p>The lib directory of HelloBeanService.aar must contain all the
+libraries needed to access the EJB. If the EJB is deployed on
+<strong>Geronimo</strong>, add the following jar files to the lib
+directory.</p>
+<ul>
+<li>cglib-nodep-2.1_3.jar</li>
+<li>geronimo-ejb_2.1_spec-1.0.1.jar</li>
+<li>geronimo-j2ee-jacc_1.0_spec-1.0.1.jar</li>
+<li>geronimo-kernel-1.1.jar</li>
+<li>geronimo-security-1.1.jar</li>
+<li>openejb-core-2.1.jar</li>
+</ul>
+<p>For <strong>JBoss</strong> add the following jar files.</p>
+<ul>
+<li>jnp-client.jar</li>
+<li>jboss-client.jar</li>
+<li>jboss-common-client.jar</li>
+<li>jboss-remoting.jar</li>
+<li>jboss-serialization.jar</li>
+<li>jboss-transaction-client.jar</li>
+<li>concurrent.jar</li>
+<li>jbosssx-client.jar</li>
+<li>jboss-j2ee.jar</li>
+</ul>
+<p>Deploy HelloBeanService.aar on an Axis2 server.</p>
+<p>Now you can access the Hello EJB through Web services. Since our
+EJB message receivers extend RPC message receivers,
+org.apache.axis2.rpc.client.RPCServiceClient can be used to invoke
+the service as illustrated in the following code fragment.</p>
+<pre>
+...
+
+RPCServiceClient serviceClient = new RPCServiceClient();
+Options options = serviceClient.getOptions();
+
+EndpointReference targetEPR = new
+ EndpointReference("http://localhost:8080/axis2/services/HelloBeanService");
+
+options.setTo(targetEPR);
+QName hello = new QName("http://ejb.my/xsd", "sayHello");
+Object[] helloArgs = new Object[] {"John"};
+
+System.out.println(serviceClient.invokeBlocking(hello,
+ helloArgs).getFirstElement().getText());
+
+...
+</pre>
+</body>
+</html>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/http-transport.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/http-transport.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/http-transport.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/http-transport.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/http-transport.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/http-transport.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/http-transport.xml Fri Jul 13 21:37:26 2007
@@ -19,10 +19,10 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
- <meta http-equiv="content-type" content="">
+ <meta http-equiv="content-type" content=""/>
<title>HTTP transports</title>
<link href="../css/axis-docs.css" rel="stylesheet" type="text/css"
- media="all">
+ media="all"/>
</head>
<body lang="en">
@@ -105,7 +105,7 @@
<p>For Connection timeout:</p>
<pre> <parameter name="CONNECTION_TIMEOUT">some_integer_value</parameter></pre>
-<br>
+<br/>
For runtime configuration, it can be set as follows within the client stub:<source>
<pre>
Copied: webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/index.xml (from r556217, webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/index.html)
URL: http://svn.apache.org/viewvc/webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/index.xml?view=diff&rev=556222&p1=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/index.html&r1=556217&p2=webservices/axis2/trunk/java/xdocs/%40axis2_version_dir%40/index.xml&r2=556222
==============================================================================
--- webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/index.html (original)
+++ webservices/axis2/trunk/java/xdocs/@axis2_version_dir@/index.xml Fri Jul 13 21:37:26 2007
@@ -16,15 +16,20 @@
~ specific language governing permissions and limitations
~ under the License.
-->
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+<html xmlns="http://www.w3.org/1999/xhtml">
<head>
+<meta name="generator" content=
+"HTML Tidy for Windows (vers 14 June 2007), see www.w3.org" />
+<title></title>
</head>
- <frameset cols="260,*" border="1" frameborder="yes" framespacing="0" margin="0">
- <frame name="leftFrame" src="toc.html" noresize="noresize" scrolling="yes" />
- <frame name="mainFrame" src="contents.html" />
- <noframes>
- <body></body>
- </noframes>
- </frameset>
-</html>
\ No newline at end of file
+<frameset cols="260,*" border="1" frameborder="yes" framespacing=
+"0" margin="0">
+<frame name="leftFrame" src="toc.html" noresize="noresize"
+scrolling="yes" />
+<frame name="mainFrame" src="contents.html" />
+<noframes>
+<body>
+</body>
+</noframes>
+</frameset>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org