Oracle® Fusion Middleware Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server 11g Release 1 (10.3.5) Part Number E13734-04 |
|
|
View PDF |
WebLogic Server includes pre-packaged WS-Policy files to support reliable messaging, MakeConnection, or both features together.
You cannot change these pre-packaged files. If their values do not suit your needs, you must create your own WS-Policy file. For details, see:
For reference information about the reliable messaging and MakeConnection policy assertions, see:
"Web Service Reliable Messaging Policy Assertion Reference" in WebLogic Web Services Reference for Oracle WebLogic Server
"Web Service MakeConnection Policy Assertion Reference" in WebLogic Web Services Reference for Oracle WebLogic Server
The following table summarizes the pre-packaged WS-Policy files. This table also specifies whether the WS-Policy file can be attached at the method level; if the value in this column is no, then the WS-Policy file can be attached at the class level only.
Table A-1 Pre-packaged WS-Policy Files That Support Reliable Messaging
Pre-packaged WS-Policy File | Description | Method Level Attachment? |
---|---|---|
DefaultReliability1.2.xml |
Specifies policy assertions related to delivery assurance. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at |
Yes |
DefaultReliability1.1.xml |
Specifies policy assertions related to quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at |
Yes |
DefaultRelibility.xml |
Deprecated. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion Version 1.0 at Specifies typical values for the reliable messaging policy assertions, such as inactivity timeout of 10 minutes, acknowledgement interval of 200 milliseconds, and base retransmission interval of 3 seconds. See DefaultReliability.xml WS-Policy File (WS-Policy) [Deprecated]. |
Yes |
LongRunningReliability.xml |
Deprecated. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion Version 1.0 for long running processes. In this release, many of the reliable messaging policy assertions are managed through JWS annotations or configuration. Similar to the preceding default reliable messaging WS-Policy file, except that it specifies a much longer activity timeout interval (24 hours.) See LongRunningReliability.xml WS-Policy File (WS-Policy) [Deprecated]. |
Yes |
|
Enables MakeConnection support on the Web service and specifies usage as optional on the Web service client. The WS-Policy 1.5 protocol is used. See Mc1.1.xml (WS-Policy File). |
No |
|
Enables MakeConnection support on the Web service and specifies usage as optional on the Web service client. The WS-Policy 1.2 protocol is used. See Mc.xml (WS-Policy File). |
No |
|
Specifies policy assertions related to quality of service. It enables MakeConnection support on the Web service and specifies usage as optional on the Web service client. See Reliability1.2_ExactlyOnce_WithMC1.1.xml (WS-Policy File). |
No |
Reliability1.2_SequenceSTRSecurity |
Specifies that in order to secure messages in a reliable sequence, the runtime will use the |
No |
Reliability1.1_SequenceSTRSecurity |
The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at |
Yes |
Reliability1.2_SequenceTransportSecurity |
Specifies policy assertions related to transport-level security and quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at |
Yes |
Reliability1.1_SequenceTransportSecurity |
Specifies policy assertions related to transport-level security and quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at |
Yes |
Reliability1.0_1.2.xml |
Combines 1.2 and 1.0 WS-Reliable Messaging policy assertions. The policy assertions for the 1.2 version MakeConnection support on the Web service and specifies usage as optional on the Web service client. This sample relies on smart policy selection to determine the policy assertion that is applied at runtime. See Reliability1.0_1.2.xml (WS-Policy File). |
No |
Reliability1.0_1.1.xml |
Combines 1.1 and 1.0 WS Reliable Messaging policy assertions. See Reliability1.0_1.1.xml (WS-Policy.xml File). |
Yes |
The DefaultRealiability1.2.xml
WS-Policy file specifies policy assertions related to delivery assurance. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at http://docs.oasis-open.org/ws-rx/wsrm/200702/wsrm-1.2-spec-os.html
.
<?xml version="1.0" encoding="UTF-8"?> <wsp15:Policy xmlns:wsp15="http://www.w3.org/ns/ws-policy"> <wsp15:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:DeliveryAssurance> <wsp15:Policy> <wsrmp:ExactlyOnce/> <wsrmp:InOrder/> </wsp15:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp15:All> </wsp15:Policy>
The DefaultRealiability1.1.xml
WS-Policy file specifies policy assertions related to quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at http://docs.oasis-open.org/ws-rx/wsrmp/200702/wsrmp-1.1-spec-os-01.html
.
<?xml version="1.0"?> <wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" > <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702" > <wsrmp:DeliveryAssurance> <wsp:Policy> <wsrmp:ExactlyOnce /> </wsp:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp:Policy>
This WS-Policy file is deprecated. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion Version 1.0 at http://schemas.xmlsoap.org/ws/2005/02/rm/policy/
. In the current release, many of the reliable messaging policy assertions are managed through JWS annotations or configuration.
The DefaultReliability.xml
WS-Policy file specifies typical values for the reliable messaging policy assertions, such as inactivity timeout of 10 minutes, acknowledgement interval of 200 milliseconds, and base retransmission interval of 3 seconds.
<?xml version="1.0"?> <wsp:Policy xmlns:wsrm="http://schemas.xmlsoap.org/ws/2005/02/rm/policy" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:beapolicy="http://www.bea.com/wsrm/policy" > <wsrm:RMAssertion > <wsrm:InactivityTimeout Milliseconds="600000" /> <wsrm:BaseRetransmissionInterval Milliseconds="3000" /> <wsrm:ExponentialBackoff /> <wsrm:AcknowledgementInterval Milliseconds="200" /> <beapolicy:Expires Expires="P1D" optional="true"/> </wsrm:RMAssertion> </wsp:Policy>
This WS-Policy file is deprecated. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion Version 1.0 at http://schemas.xmlsoap.org/ws/2005/02/rm/policy/
. In the current release, many of the reliable messaging policy assertions are managed through JWS annotations or configuration.
The LongRunningRelibility.xml
WS-Policy files specifies values that are similar to the DefaultReliability.xml
WS-Policy file, except that it specifies a much longer activity timeout interval (24 hours). See LongRunningReliability.xml WS-Policy File (WS-Policy) [Deprecated].
<?xml version="1.0"?> <wsp:Policy xmlns:wsrm="http://schemas.xmlsoap.org/ws/2005/02/rm/policy" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:beapolicy="http://www.bea.com/wsrm/policy" > <wsrm:RMAssertion > <wsrm:InactivityTimeout Milliseconds="86400000" /> <wsrm:BaseRetransmissionInterval Milliseconds="3000" /> <wsrm:ExponentialBackoff /> <wsrm:AcknowledgementInterval Milliseconds="200" /> <beapolicy:Expires Expires="P1M" optional="true"/> </wsrm:RMAssertion> </wsp:Policy>
The Mc1.1.xml
WS-Policy file enables MakeConnection support on the Web service and sets usage as optional on the Web service client. In this case, the WS-Policy 1.5 protocol is used. The assertions are based on the MakeConnection policy assertion defined at http://docs.oasis-open.org/ws-rx/wsmc/200702/wsmc-1.1-spec-os.html
.
<?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 Mc.xml
WS-Policy file enables MakeConnection support on the Web service and sets usage as optional on the Web service client. The assertions are based on the MakeConnection policy assertion defined at http://docs.oasis-open.org/ws-rx/wsmc/200702/wsmc-1.1-spec-os.html
.
<?xml version="1.0"?> <wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsmc="http://docs.oasis-open.org/ws-rx/wsmc/200702"> <wsmc:MCSupported wsp:Optional="true" /> </wsp:Policy>
The Reliability1.2_ExactlyOnce_WithMC1.1.xml
WS-Policy file specifies policy assertions related to quality of service. It enables MakeConnection support on the Web service and specifies usage as optional on the Web service client.
The assertions are based on the following specifications:
Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at http://docs.oasis-open.org/ws-rx/wsrm/200702/wsrm-1.2-spec-os.html
.
MakeConnection assertions are based on the MakeConnection policy assertion defined at http://docs.oasis-open.org/ws-rx/wsmc/200702/wsmc-1.1-spec-os.html
.
<?xml version="1.0" encoding="UTF-8" ?> <wsp15:Policy xmlns:wsp15="http://www.w3.org/ns/ws-policy"> <wsp15:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:DeliveryAssurance> <wsp15:Policy> <wsrmp:ExactlyOnce /> </wsp15:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> <wsmc:MCSupported xmlns:wsmc="http://docs.oasis-open.org/ws-rx/wsmc/200702" wsp15:Optional="true" /> </wsp15:All> </wsp15:Policy>
The Reliability1.2_SequenceSTR.xml
file specifies that in order to secure messages in a reliable sequence, the runtime will use the wsse:SecurityTokenReference
that is referenced in the CreateSequence
message. It enables MakeConnection support on the Web service and specifies usage as optional on the Web service client.
The assertions are based on the following specifications:
Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at http://docs.oasis-open.org/ws-rx/wsrm/200702/wsrm-1.2-spec-os.html
.
MakeConnection assertions are based on the MakeConnection policy assertion defined at http://docs.oasis-open.org/ws-rx/wsmc/200702/wsmc-1.1-spec-os.html
.
<?xml version="1.0" encoding="UTF-8"?> <wsp15:Policy xmlns:wsp15="http://www.w3.org/ns/ws-policy"> <wsp15:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:SequenceSTR/> <wsrmp:DeliveryAssurance> <wsp15:Policy> <wsrmp:ExactlyOnce/> </wsp15:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> <wsmc:MCSupported xmlns:wsmc="http://docs.oasis-open.org/ws-rx/wsmc/200702" wsp15:Optional="true"/> </wsp15:All> </wsp15:Policy>
The Reliability1.1_SequenceSTR.xml
file specifies that in order to secure messages in a reliable sequence, the runtime will use the wsse:SecurityTokenReference
that is referenced in the CreateSequence
message. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at http://docs.oasis-open.org/ws-rx/wsrmp/200702/wsrmp-1.1-spec-os-01.html
.
<wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:SequenceSTR/> <wsrmp:DeliveryAssurance> <wsp:Policy> <wsrmp:ExactlyOnce/> </wsp:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp:Policy>
The Reliability1.2_SequenceTransportSecurity.xml
file specifies policy assertions related to transport-level security and quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.2 at http://docs.oasis-open.org/ws-rx/wsrm/200702/wsrm-1.2-spec-os.html
.
<?xml version="1.0" encoding="UTF-8"?> <wsp15:Policy xmlns:wsp15="http://www.w3.org/ns/ws-policy"> <wsp15:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:SequenceTransportSecurity/> <wsrmp:DeliveryAssurance> <wsp15:Policy> <wsrmp:ExactlyOnce/> </wsp15:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp15:All> </wsp15:Policy>
The Reliability1.1_SequenceTransportSecurity.xml
file specifies policy assertions related to transport-level security and quality of service. The Web service reliable messaging assertions are based on WS Reliable Messaging Policy Assertion 1.1 at http://docs.oasis-open.org/ws-rx/wsrmp/200702/wsrmp-1.1-spec-os-01.html
.
<wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:SequenceTransportSecurity/> <wsrmp:DeliveryAssurance> <wsp:Policy> <wsrmp:ExactlyOnce/> </wsp:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp:Policy>
The Reliability1.0_1.2.xml
WS-Policy file combines 1.2 and 1.0 WS-Reliable Messaging policy assertions.
This sample relies on smart policy selection to determine the policy assertion that is applied at runtime. For more information about smart policy selection, see Using Multiple Policy Alternatives.
<?xml version="1.0" encoding="UTF-8"?> <wsp15:Policy xmlns:wsp15="http://www.w3.org/ns/ws-policy"> <wsp15:ExactlyOne> <wsp15:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:DeliveryAssurance> <wsp15:Policy> <wsrmp:ExactlyOnce/> </wsp15:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> <wsmc:MCSupported xmlns:wsmc="http://docs.oasis-open.org/ws-rx/wsmc/200702" wsp15:Optional="true"/> </wsp15:All> <wsp15:All> <wsrmp10:RMAssertion xmlns:wsrmp10="http://schemas.xmlsoap.org/ws/2005/02/rm/policy"> <wsrmp10:InactivityTimeout Milliseconds="600000"/> <wsrmp10:BaseRetransmissionInterval Milliseconds="3000"/> <wsrmp10:ExponentialBackoff/> <wsrmp10:AcknowledgementInterval Milliseconds="200"/> </wsrmp10:RMAssertion> </wsp15:All> </wsp15:ExactlyOne> </wsp15:Policy>
The Reliability1.0_1.1.xml
WS-Policy file combines 1.1 and 1.0 WS-Reliable Messaging policy assertions. This sample relies on smart policy selection to determine the policy assertion that is applied at runtime. For more information about smart policy selection, see Using Multiple Policy Alternatives.
Note:
The 1.0 Web service reliable messaging assertions are prefixed bywsrmp10
.<wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"> <wsp:ExactlyOne> <wsp:All> <wsrmp:RMAssertion xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"> <wsrmp:DeliveryAssurance> <wsp:Policy> <wsrmp:ExactlyOnce/> </wsp:Policy> </wsrmp:DeliveryAssurance> </wsrmp:RMAssertion> </wsp:All> <wsp:All> <wsrmp10:RMAssertion xmlns:wsrmp10="http://schemas.xmlsoap.org/ws/2005/02/rm/policy"> <wsrmp10:InactivityTimeout Milliseconds="600000"/> <wsrmp10:BaseRetransmissionInterval Milliseconds="3000"/> <wsrmp10:ExponentialBackoff/> <wsrmp10:AcknowledgementInterval Milliseconds="200"/> </wsrmp10:RMAssertion> </wsp:All> </wsp:ExactlyOne> </wsp:Policy>