5 Web Service MakeConnection Policy Assertion Reference

The chapter provides reference information about Web service MakeConnection policy assertions in a WS-Policy file.

This chapter includes the following sections:

Overview of a WS-Policy File That Contains MakeConnection Assertions
WS-Policy File With Web Service MakeConnection

Note:

This section applies only to JAX-WS Web services, and not to JAX-RPC Web services.

Overview of a WS-Policy File That Contains MakeConnection Assertions

You use WS-Policy files to enable and configure MakeConnection on a Web service. Use the @Policy JWS annotations in the JWS file that implements the Web service to specify the name of the WS-Policy file that is associated with a Web service. A WS-Policy file is an XML file that conforms to the WS-Policy specification at http://www.w3.org/TR/ws-policy/.

The root element of a WS-Policy file is always <wsp:Policy>. To configure Web service MakeConnection, you simply add a <wsmc:MCSupported> child element. The policy assertions conform to the WS-PolicyAssertions specification at http://www.ibm.com/developerworks/library/specification/ws-polas.

WebLogic Server includes default WS-Policy files that contain typical MakeConnection assertions that you can use if you do not want to create your own WS-Policy file. The default WS-Policy files are defined in "Pre-Packaged WS-Policy Files for Web Services Reliable Messaging and MakeConnection" in Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server.

For task-oriented information about enabling and configuring MakeConnection, see "Using Asynchronous Web Service Clients Through a Firewall (MakeConnection)" in Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server.

WS-Policy File With Web Service MakeConnection

The following sections describe how to create a WS-Policy file with Web service MakeConnection assertions that are based on WS-MakeConnection specification at http://docs.oasis-open.org/ws-rx/wsmc/200702.

Graphical Representation

The following graphic describes the element hierarchy of Web service MakeConnection policy assertions in a WS-Policy file.

Figure 5-1 Element Hierarchy of Web Service MakeConnection 1.1 and 1.0

Description of "Figure 5-1 Element Hierarchy of Web Service MakeConnection 1.1 and 1.0"

Example of a WS-Policy File With MakeConnection and WS-Policy 1.5

The following example shows a simple WS-Policy file used to configure MakeConnection for a WebLogic Web service. It specifies support for WS-Policy 1.5.

<?xml version="1.0"?>
<wsp15:Policy  xmlns:wsp15="http://www.w3.org/ns/ws-policy" 
  xmlns:wsmc="http://docs.oasis-open.org/ws-rx/wsmc/200702">
  <wsmc:MCSupported wsp15:Optional="true" />
</wsp15:Policy>

Element Descriptions

The following sections describe the elements in the Web services MakeConnection WS-Policy file.

wsp:Policy

Groups nested policy assertions.

wsmc:MCSupported

The presence of this assertion in a WS-Policy file indicates that the corresponding Web service uses MakeConnection as the transport model.

The following table summarizes the attributes of the wsmc:MCSupport element.

Table 5-1 Attributes of <wsmc:MCSupport>

Attribute	Description	Required?
optional	Specifies whether MakeConnection must be used by the Web service client. Valid values for this attribute are `true` and `false`. Default value is `true`. If set to `false`, both ReplyTo and FaultTo headers must contain MakeConnection anonymous URIs.	No