The chapter provides reference information about Web service MakeConnection policy assertions in a WS-Policy file.
This chapter includes the following sections:
Note:This section applies only to JAX-WS Web services, and not to JAX-RPC Web services.
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
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
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.
The following sections describe how to create a WS-Policy file with Web service MakeConnection assertions that are based on WS-MakeConnection specification at
The following graphic describes the element hierarchy of Web service MakeConnection policy assertions in a WS-Policy file.
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>
The following sections describe the elements in the Web services MakeConnection WS-Policy file.
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
Specifies whether MakeConnection must be used by the Web service client. Valid values for this attribute are