ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzamy_5.4.0.1/50/webserv/wssoapdc.htm

57 lines
3.4 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>Deploy a programming component as a SOAP accessible Web service</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h5><A NAME="wssoapdc">Deploy a programming component as a SOAP accessible Web service</A></h5>
<p>Complete these steps to deploy a SOAP-accessible Web service on WebSphere Application Server - Express:</p>
<ol>
<li><strong>Create or locate the software resource to be published as a service</strong><br>
To deploy a service, create one or more of the supported programming components (beans, DB2 stored procedure, or BSF script), or locate an existing piece of code of the supported type.</li>
<li><strong>Assemble an Enterprise Archive (EAR) file</strong><br>
Package the component into an Enterprise Archive (EAR) file. This step is a deployment packaging requirement of WebSphere Application Server - Express. Create the EAR file.</li>
<li><strong>Create the SOAP deployment descriptor for the desired service</strong><br>
In order to deploy a component as a SOAP service, create an Apache SOAP deployment descriptor that describes the service you are creating. This step designates the programming component as a <strong>service</strong>. The descriptor describes and defines the parts of the code that are invoked through SOAP calls.
<p>The information contained in the deployment descriptor varies, depending on the type of artifact you are publishing. For example, this deployment descriptor could be used with the StockQuoteSample:</p>
<pre>
&lt;isd:service xmlns:isd=&quot;http://xml.apache.org/xml-soap/deployment&quot;
id=&quot;urn:service-urn&quot; [type=&quot;message&quot;]&gt;
&lt;isd:provider type=&quot;java&quot; scope=&quot;Request | Session | Application&quot; methods=&quot;exposed-methods&quot;>
&lt;isd:java class=&quot;implementing-class&quot; [static=&quot;true|false&quot;]/&gt;
&lt;/isd:provider&gt;
&lt;isd:faultListener&gt;org.apache.soap.server.DOMFaultListener&lt;/isd:faultListener&gt;
&lt;/isd:service&gt;
</pre>
</li>
<li><strong>Run the SoapEarEnabler tool to enable your Web service</strong><br>
You must first package your component into an Enterprise Archive (EAR) file. Next, using the deployment descriptor as input data, add the necessary pieces to the EAR file to enable the component as a Web service. To facilitate this process, use the Java<sup>(TM)</sup>-based tool, SoapEarEnabler. Depending on whether you secure the Web service, this tool adds two Web modules: soap.war and soap-sec.war to the EAR file. These Web modules include the SOAP deployment descriptors plus the necessary parts to deploy the service into the WebSphere Application Server - Express run time.
<p><strong>Note:</strong> The service does not become available until you install the SOAP enabled EAR file and restart the application server.</p>
</li>
<li><strong>Install the modified EAR file into your WebSphere Application Server - Express instance</strong><br>
Install the modified EAR file into your WebSphere Application Server - Express instance.</li>
<li><strong>Restart your WebSphere Application Server - Express instance.</strong></li>
</ol>
</body>
</html>