Skip Headers
Oracle® Fusion Middleware WebLogic Web Services Reference for Oracle WebLogic Server
11g Release 1 (10.3.6)

Part Number E13750-06
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

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:

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.

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