|Oracle® Fusion Middleware WebLogic Web Services Reference for Oracle WebLogic Server
11g Release 1 (10.3.6)
Part Number E13750-05
|PDF · Mobi · ePub|
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.
Figure 5-1 Element Hierarchy of Web Service MakeConnection 1.1 and 1.0
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
Table 5-1 Attributes of <wsmc:MCSupport>
Specifies whether MakeConnection must be used by the Web service client. Valid values for this attribute are