Table of Contents Previous Next PDF


Oracle Service Architecture Leveraging Tuxedo WS-AT Assertion Reference

Oracle Service Architecture Leveraging Tuxedo WS-AT Assertion Reference
The following sections provide Oracle Service Architecture Leveraging Tuxedo (SALT) WS-AT Assertion reference information:
Overview
WS-AT defines a policy assertion that allows requests to indicate whether an operation call must or may be made as part of an Atomic Transaction. For the configuration impact of Atomic Transaction policy assertions, see the "Configuration Changes" chapter.
Depending on the direction of the calls and meaning of the policy assertion setting, the runtime inbound/outbound transaction behavior is as follows:
For inbound transactions, there are no particular runtime behavior changes. The client consuming the WSDL accepts transactions based on the configured value. Runtime behavior is normal.
If an ATAssertion element without "Optional=true" is configured for a service, the call has to be made in a transaction. If no corresponding XA transaction exists at the time, the WS-TX transaction is initiated (but not associated with any Oracle Tuxedo XA transactions). If an XA transaction exists, there is no change in behavior.
If an ATAssertion element with "Optional=true" is configured for a service, an outbound transaction context is requested only if a corresponding Oracle Tuxedo XA transaction exists in the context of the call.
If no ATAssertion element is configured for a service, the corresponding service call is made outside of any transaction. When a call is made to an external Web Service in the context of an Oracle Tuxedo XA transaction, the Web Service call does not propagate the transaction. This allows excluding certain Web Service calls from a global transaction, and represents the default for most existing Web Services calls that do not support WS-TX.
Policy File Example
The existing policy file mechanism includes the addition of WS-AT policy elements.WS-AT defines the ATAssertion element, with an Optional attribute, as follows:
/wsat:ATAssertion/@wsp:Optional="true"
Listing C‑1 shows an example policy.xml file with an ATAssertion element.
Listing C‑1 policy.xml File with an ATAssertion Element
<?xml version="1.0"?>
<wsp:Policy wsp:Name="TransactionalServicePolicy"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
xmlns:wsat="http://docs.oasis-open.org/ws-tx/wsat/2006/06">
<wsat:ATAssertion wsp:Optional="true"/>
</wsp:Policy>
 

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.