blob: 38cdb800609020c62ce3b47164f226f1b00581b8 [file] [log] [blame]
kprice6decb032008-04-01 19:05:41 +00001<?xml version="1.0" encoding="utf-8"?>
2<!--Arbortext, Inc., 1988-2006, v.4002-->
3<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
4 "concept.dtd">
5<concept id="axisoverview" xml:lang="en-us">
6<title>Creating Web services with the Apache Axis2 runtime environments</title>
7<shortdesc>This runtime environment is for users who prefer to develop for
8the open Apache Axis platform. Both Axis1 and Axis2 are supported by the Web
9services tools.</shortdesc>
10<prolog><metadata>
11<keywords><indexterm>Axis runtime environment<indexterm>Web services<indexterm>overview</indexterm></indexterm></indexterm>
12<indexterm>Web services<indexterm>Axis runtime environment</indexterm></indexterm>
13</keywords>
14</metadata></prolog>
15<conbody>
16<section><title>Apache Axis2 Overview</title><p>Axis2 evolved from the Apache
17Axis1.x architecture and is more flexible, configurable, and efficient, while
18retaining the positive aspects of Apache Axis1.x architecture.</p><p>The Web
19service tools provided with this product support the following specifications
20when creating Apache Axis2 Web services and clients:<ul>
21<li>SOAP 1.1 and 1.2</li>
22<li>WSDL 1.1, including both SOAP and HTTP bindings </li>
23<li>HTTP transports</li>
24</ul>The levels of Axis2 currently supported by the tools is 1.2 and 1.3.
25Axis2 can be deployed to any server that supports <tm tmclass="special" tmowner="Sun Microsystems, Inc."
26tmtype="tm" trademark="Java">Java</tm> Servlet 2.2 specification or higher,
27including <tm tmclass="ibm" tmowner="IBM Corporation" tmtype="reg" trademark="IBM">IBM</tm> <tm
28tmclass="ibm" tmowner="IBM Corporation" tmtype="reg" trademark="WebSphere">WebSphere</tm> Application
29Server 6.1, and Apache Tomcat server. For more information on Axis2, refer
30to <xref format="html" href="http://ws.apache.org/axis2/" scope="external">http://ws.apache.org/axis2</xref>. </p><p>The
31support for Apache Axis2 is limited to validation that the application is
32invoking the Axis2 emitters correctly. Support for other Axis2 issues should
33be directed to <xref format="html" href="http://ws.apache.org/axis2/" scope="external">http://ws.apache.org/axis2</xref></p></section>
34<section><title>Installing the Apache Axis2 runtime</title><p>Unlike creating
35Web services in the Apache Axis1.x runtime, before creating a Web service
36using Apache Axis2 you must download the Axis2 runtime and install it the
37workbench using the Web services Axis2 preferences page.<ol>
38<li>Download Apache Axis2 v1.2 or v1.3 from the following site: <xref format="html"
39href="http://ws.apache.org/axis2/download.cgi" scope="external">http://ws.apache.org/axis2/download.cgi</xref>.</li>
40<li>Follow the instructions in the appropriate Apache Axis2 installation guide: <ul>
41<li>Apache Axis2 v1.2<xref format="html" href="http://ws.apache.org/axis2/1_2/installationguide.html"
42scope="external">http://ws.apache.org/axis2/1_2/installationguide.html</xref></li>
43<li>Apache Axis2 v1.3<xref format="html" href="http://ws.apache.org/axis2/1_3/installationguide.html"
44scope="external">http://ws.apache.org/axis2/1_3/installationguide.html</xref></li>
45</ul></li>
46<li>Once the Apache Axis2 runtime is installed, you need to associate it with
47the workbench. In the workbench, open <menucascade><uicontrol>Window</uicontrol>
48<uicontrol>Preferences</uicontrol><uicontrol>Web services</uicontrol><uicontrol>Axis2
49Preferences</uicontrol></menucascade>. On the <uicontrol>Axis2 Runtime</uicontrol> tab,
50browse to the location where you installed Apache Axis2. A message will display
51if the runtime is installed successfully.</li>
52</ol></p></section>
53<section><title>Creating projects for Axis2 Web services</title><p>The Web
54service wizards will automatically add the correct facets to a dynamic Web
55project. However if you want to manually create a dynamic Web project enabled
56for Axis2 Web service development complete the following:<ol>
57<li>Create the service Web project by clicking <uicontrol>File > New > Project
58> Dynamic Web project</uicontrol>. Enter the following information: <ol>
59<li>Project Name: Type a project name</li>
60<li>If you are deploying to a Tomcat server, ensure that <uicontrol>Add project
61to an EAR</uicontrol> is not selected. If you do not clear this checkbox you
62will be unable to select the Tomcat server. If you are deploying to <tm tmclass="ibm"
63tmowner="IBM Corporation" tmtype="reg" trademark="WebSphere">WebSphere</tm> Application
64server you will need to add the project to an EAR.</li>
65<li>Target runtime: Select the version of the server to which you will deploy
66your Web service. If it is not listed, click <uicontrol>New</uicontrol> and
67browse to the location where it is installed.</li>
68<li>Configurations: Select the default configuration for your server type.</li>
69<li>Click <uicontrol>Finish</uicontrol>.</li>
70</ol></li>
71<li>Add the Axis2 facet. Right-click your project and click <menucascade>
72<uicontrol>Properties</uicontrol><uicontrol>Project Facets</uicontrol><uicontrol>Modify
73project</uicontrol><uicontrol>Axis2 Web Services</uicontrol></menucascade>,
74and click <uicontrol>Finish</uicontrol>.</li>
75<li>If you have chosen to deploy to a server in which the Axis2 JAR files
76will reside on the server (such as WebSphere Application Server), you must
77change the classloading for the EAR from PARENT_FIRST to PARENT_LAST. Expand
78the EAR associated with your Axis2 project, and launch its deployment descriptor.
79On the <uicontrol>Deployment</uicontrol> tab, expand the <uicontrol>Application</uicontrol> section.
80Change the <uicontrol>Classloader mode</uicontrol> field to PARENT_LAST and
81save your changes.</li>
82</ol></p></section>
83</conbody>
84<related-links>
85<linklist><title>Related Concepts</title>
86<link href="../../org.eclipse.jst.ws.doc.user/concepts/cws.dita" scope="peer">
87<linktext>Web services</linktext></link>
88<link href="../../org.eclipse.jst.ws.doc.user/concepts/cwsinwsa.dita" scope="peer">
89<linktext>Tools for Web services development</linktext></link>
90<link href="../../org.eclipse.jst.ws.doc.user/concepts/cjaxrpc.dita" scope="peer">
91<linktext>JAX-RPC</linktext></link>
92</linklist>
93<linklist><title>Related Tasks</title>
94<link href="../../org.eclipse.jst.ws.doc.user/tasks/toverws.dita" scope="peer">
95<linktext> Developing Web services</linktext></link>
96</linklist>
97</related-links>
98</concept>