Web services assembly properties

ibm-webservices-bnd.xmi properties

The ibm-webservices-bnd.xmi file is a deployment descriptor for a Web Services-enabled Web module or enterprise JavaBean (EJB) module. It contains information for the Web services runtime that is either WebSphere product-specific or was not specified by Web services for J2EE.

The following user-definable assembly properties are supported:

• wsDescNameLink
  Attribute of the wsdescBindings element that specifies the link to the corresponding <webservice-description-name> in webservices.xml.

• pc-name-link
  Attribute of the pcBindings element that specifies the link to the <port-component-name> in the webservices.xml file.

• scope
  Attribute of the pcBindings element that specifies when new instances of implementation beans are created. Possible values are Request, Session, and Application. The value of scope for a deployed Web service can be changed using the administrative console. Using application management, navigate to the Web module of the Web service application and select Web Services Implementation Scope.

ibm-webservicesclient-bnd.xmi properties

The ibm-webservicesclient-bnd.xmi file contains information for the Web Services runtime that is WebSphere product-specific.

Assembly properties

The following user-definable assembly properties are supported:

• componentNameLink
  Attribute of the componentScopedRefs element that specifies the link to the corresponding <component-scoped-refs> element in webservicesclient.xml file.

• serviceRefLink
  Attribute of the serviceRefs element that specifies the link to the <service-ref-name> in the webservicesclient.xml file.

• deployedWSDLFile
  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.

• defaultMappings element
  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.

• syncTimeout
  Attribute of the portQnameBindings element that specifies how long, in seconds, to wait for a response from a synchronous call.

• basicAuth
  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.

• sslConfig
  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.

  Note: This attribute is only used when the client is running in the WAS.

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 or EJB module of the Web service application and select Web Services Client Bindings.

Example bindings files

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, 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.

Example ibm-webservices-bnd.xmi file

<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>

Example ibm-webservicesclient-bnd.xmi file

<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>