197 lines
13 KiB
HTML
197 lines
13 KiB
HTML
<!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>Web services assembly properties</title>
|
|
</head>
|
|
|
|
<BODY>
|
|
<!-- Java sync-link -->
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
|
|
|
<h4><a name="wsassemprop"></a>Web services assembly properties</h4>
|
|
|
|
<p><strong>ibm-webservices-bnd.xmi properties</strong></p>
|
|
|
|
<p>The ibm-webservices-bnd.xmi file is a deployment descriptor for a Web Services-enabled Web module (WAR file). It contains information for the Web services runtime that is either WebSphere product-specific or is not specified by the Web services for J2EE specification.</p>
|
|
|
|
<p>You can edit these properties with the WebSphere Studio Development Client for iSeries:</p>
|
|
<ol>
|
|
<li>Locate the webservices.xml file in the module.</li>
|
|
<li>Double-click the webservices.xml file to open the Web Services editor.</li>
|
|
<li>Click the <strong>Bindings</strong> tab to access the Web Services Bindings editor.</li>
|
|
<li>Click the <strong>Binding Configurations</strong> tab to access the Web Services Binding Configurations editor.</li>
|
|
<li>After you edit the properties, click <strong>File</strong> --> <strong>Save</strong> to save your changes.</li>
|
|
</ol>
|
|
|
|
<p>The following user-definable assembly properties are supported:</p>
|
|
|
|
<ul>
|
|
<li><p><strong>wsDescNameLink</strong>
|
|
<br>Attribute of the wsdescBindings element that specifies the link to the corresponding <webservice-description-name> in webservices.xml. To set this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Click the <strong>Bindings</strong> tab.</li>
|
|
<li>Expand the <strong>Web Service Description Bindings</strong> section.</li>
|
|
<li>Click <strong>Add</strong> and choose the Web services description binding properties for which you want to apply the change.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>pc-name-link</strong>
|
|
<br>Attribute of the pcBindings element that specifies the link to the <port-component-name> in the webservices.xml file. To set this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Click the <strong>Bindings</strong> tab.</li>
|
|
<li>Expand the <strong>Port Component Binding</strong> section.</li>
|
|
<li>Click <strong>Add</strong>.</li>
|
|
<li>Select the port component name from the drop down list in the <strong>PC Name Link</strong> field.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>scope</strong>
|
|
<br>Attribute of the pcBindings element that specifies when new instances of implementation beans are created. Possible values are <tt>Request</tt>, <tt>Session</tt>, and <tt>Application</tt>. The value of scope for a deployed Web service can be changed using the administrative console:</p>
|
|
<ol>
|
|
<li>In the administrative console navigation menu, expand <strong>Applications</strong> and click <strong>Enterprise Applications</strong>.</li>
|
|
<li>Click the name of your enterprise application.</li>
|
|
<li>Under <strong>Additional Properties</strong>, click <strong>Web Modules</strong>.</li>
|
|
<li>Click the name of your Web Module.</li>
|
|
<li>Under <strong>Additional Properties</strong>, click <strong>Web Services Implementation Scope</strong>.</li>
|
|
</ol>
|
|
<p>To set this property for an undeployed Web service, perform the following steps in the WebSphere Studio Development Client for iSeries:</p>
|
|
<ol>
|
|
<li>Click the <strong>Bindings</strong> tab.</li>
|
|
<li>Expand the <strong>Port Component Binding</strong> section.</li>
|
|
<li>Click <strong>Add</strong>.</li>
|
|
<li>Select the implementation scope name from the drop down list in the <strong>Scope</strong> field.</li>
|
|
</ol></li>
|
|
</ul>
|
|
|
|
<p><strong>ibm-webservicesclient-bnd.xmi properties</strong></p>
|
|
|
|
<p>The ibm-webservicesclient-bnd.xmi file contains information for the Web Services runtime that is WebSphere product-specific.</p>
|
|
|
|
<p>You can edit these properties with the WebSphere Studio Development Client for iSeries:</p>
|
|
<ol>
|
|
<li>Locate the webservicesclient.xml file in the module.</li>
|
|
<li>Double-click the webservicesclient.xml file to open the Web Services Client editor.</li>
|
|
<li>Click the <strong>Client Binding</strong> tab to access the Web Services Client Bindings editor.</li>
|
|
<li>Click the <strong>Port Bindings</strong> tab to access the Web Services Client Port Bindings editor.</li>
|
|
<li>After you edit the properties, click <strong>File</strong> --> <strong>Save</strong> to save your changes.</li>
|
|
</ol>
|
|
|
|
<p><strong>Assembly properties</strong></p>
|
|
|
|
<p>The following user-definable assembly properties are supported:</p>
|
|
|
|
<ul>
|
|
<li><p><strong>componentNameLink</strong>
|
|
<br>Attribute of the componentScopedRefs element that specifies the link to the corresponding <component-scoped-refs> element in webservicesclient.xml file. To set this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Click the <strong>Client Binding</strong> tab.</li>
|
|
<li>Expand the <strong>Component scoped references</strong> section.</li>
|
|
<li>Click Add.</li>
|
|
<li>Select the component scoped references defined in the webservicesclient.xml file from the list.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>serviceRefLink</strong>
|
|
<br>Attribute of the serviceRefs element that specifies the link to the <service-ref-name> in the webservicesclient.xml file. To set this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Click the Services References tab.</li>
|
|
<li>Click Add.</li>
|
|
<li>From the list, select the service references that are defined in the webservicesclient.xml file.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>deployedWSDLFile</strong>
|
|
<br>Attribute of the serviceRefs element is optional and permits an alternate WSDL file to be used other than that specified in the <wsdl-file> element of webservicesclient.xml file. If this attribute is specified, the alternate WSDL file must be packaged in the same module and must be compatible with the development WSDL file. The deployedWSDLFile property is used to supply a new WSDL file containing a different endpoint URL than the original WSDL file.</p>
|
|
|
|
<p>To set this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Select the service references or component scoped reference that you want.</li>
|
|
<li>Expand the <strong>Service reference details</strong> section.</li>
|
|
<li>Click <strong>Browse</strong> on the <strong>Deployed WSDL file</strong> field.</li>
|
|
<li>Select the new WSDL file.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>defaultMappings element</strong>
|
|
<br>Identifies which port should be used for a given portType when none is explicitly selected by the client. This element has the following attributes: portTypeNamespace, portTypeLocalName, portNamespace, portLocalName. These attributes identify which wsdl:port should be used for a wsdl:portType. To edit this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Click <strong>Default Mappings</strong>.</li>
|
|
<li>Click <strong>Add</strong>.</li>
|
|
<li>Edit the entries in the new row to establish a mapping between a portType and port in the WSDL file. There can only be one entry for each portType.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>syncTimeout</strong>
|
|
<br>Attribute of the portQnameBindings element that specifies how long, in seconds, to wait for a response from a synchronous call. To edit this property with the WebSphere Studio Development Client for iSeries, perform these steps:</p>
|
|
|
|
<ol>
|
|
<li>Create a Port Qualified Name Bindings for the port.</li>
|
|
<li>Confirm that a service reference is selected in either the <strong>Component scoped references</strong> or <strong>Service references</strong> section.</li>
|
|
<li>Expand the <strong>Port qualified name bindings</strong> section.</li>
|
|
<li>Click <strong>Add</strong>. A new entry is added to the <strong>Port qualified name bindings</strong> list.</li>
|
|
<li>Click the new port qualified name bindings entry. The Web Services Client Port Bindings editor opens.</li>
|
|
<li>Expand the <strong>Port qualified name bindings details</strong> section.</li>
|
|
<li>In the <strong>Port Namespace Link</strong> field, enter the namespace of the WSDL file port that you want to configure.</li>
|
|
<li>In the <strong>Port Local Name Link</strong> field, enter the local name of the WSDL file port that you want to configure. The name that is displayed in the <strong>Port qualified name bindings</strong> list is the local name of the WSDL file port.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
<li>To configure the syncTimeout property, locate the <strong>Synchronization timeout</strong> field and enter the desired value.</li>
|
|
</ol></li>
|
|
|
|
<li><p><strong>basicAuth</strong>
|
|
<br>Element of the portQnameBindings element that can be used to authenticate a service client to the service endpoint, independent of the underlying transport that includes, HTTP, HTTPS, and JMS. Set the user ID and password attributes as needed. To configure this property with the WebSphere Studio Development Client for iSeries, follow these steps:</p>
|
|
<ol>
|
|
<li>Expand the <strong>Basic authentication</strong> section.</li>
|
|
<li>Type the desired values in the <strong>User ID</strong> and <strong>Password</strong> fields.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol><p></p></li>
|
|
|
|
<li><p><strong>sslConfig</strong>
|
|
<br>Element of the portQnameBindings element that specifies the Secure Sockets Layer (SSL) configuration of an HTTPS outbound request. The name attribute is the name of a SSL configuration entry or alias defined in the SSL Configuration Repertoire.</p>
|
|
<p><strong>Note:</strong> This attribute is only used when the client is running in the WebSphere Application Server - Express for iSeries.</p>
|
|
<p>To edit this property with the WebSphere Studio Development Client for iSeries, perform these steps:</p>
|
|
<ol>
|
|
<li>Expand the <strong>SSL Configuration</strong> section.</li>
|
|
<li>Type the desired value in the <strong>Name</strong> field.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol></li>
|
|
</ul>
|
|
|
|
<p>The values of deployedWSDLFile and the defaultMappings of a deployed Web service can also be changed using the administrative console. Using application management, navigate to the Web module of the Web service application and select Web Services Client Bindings.</p>
|
|
|
|
<p><strong>Example bindings files</strong></p>
|
|
|
|
<p>The following examples demonstrate the spelling and position of the various attributes. You cannot cut and paste these examples because they do not contain the required ID attributes. If you add elements to a binding file template generated by the WSDL2Java command, you must confirm that each element has an ID attribute whose value is a unique string. Review the template xmi files generated by the WSDL2Java command for examples of ID strings.</p>
|
|
|
|
<p><strong>Example ibm-webservices-bnd.xmi file</strong></p>
|
|
|
|
<pre><com.ibm.etools.webservice.wsbnd:WSBinding xmi:version="2.0"
|
|
xmlns:xmi="http://www.omg.org/XMI" xmlns:com.ibm.etools.webservice.wsbnd=
|
|
"http://www.ibm.com/websphere/appserver/schemas/5.0.2/wsbnd.xmi">
|
|
<wsdescBindings wsDescNameLink="AddressBookService">
|
|
<pcBindings pcNameLink="AddressBook" scope="Application"/>
|
|
</wsdescBindings>
|
|
</com.ibm.etools.webservice.wsbnd:WSBinding></pre>
|
|
|
|
<p><strong>Example ibm-webservicesclient-bnd.xmi file</strong></p>
|
|
|
|
<pre><com.ibm.etools.webservice.wscbnd:ClientBinding xmi:version="2.0"
|
|
xmlns:xmi="http://www.omg.org/XMI" xmlns:com.ibm.etools.webservice.wscbnd=
|
|
"http://www.ibm.com/websphere/appserver/schemas/5.0.2/wscbnd.xmi">
|
|
<componentScopedRefs componentNameLink="myComponent ref"/>
|
|
<serviceRefs serviceRefLink="myService ref" deployedWSDLFile="META-INF/wsdl/alternate.wsdl">
|
|
<defaultMappings portTypeLocalName="AddressBook"
|
|
portTypeNamespace="http://www.com.ibm" portLocalName="AddressBookPort"
|
|
portNamespace="http://www.com.ibm"/>
|
|
<portQnameBindings portQnameNamespaceLink="http://www.com.ibm"
|
|
portQnameLocalNameLink="AddressBookPort" syncTimeout="99">
|
|
<basicAuth userid="myId" password="myPassword"/>
|
|
<sslConfig name="mynode/DefaultSSLSettings"/>
|
|
</portQnameBindings>
|
|
</serviceRefs>
|
|
</com.ibm.etools.webservice.wscbnd:ClientBinding></pre>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|