![]() ![]() ![]() ![]() |
Before you begin
You must install a Web service before you can configure atomic transactions. See Install a Web service.
Note: This section applies to JAX-WS Web services only.
WebLogic Web services enable interoperability with other external transaction processing systems, such as Websphere, JBoss, Microsoft .NET, and so on, through the support of the following specifications: WS-AtomicTransaction Version 1.2 and WS-Coordination Version 1.2.
These specifications define an extensible framework for coordinating distributed activities among a set of participants. The coordinator is the central component, managing the transactional state (coordination context) and enabling Web services and clients to register as participants.
At development time, you can enable Web services atomic transactions
using the @weblogic.wsee.wstx.wsat.Transactional
annotation in the JWS file or client application, or by passing the
weblogic.wsee.wstx.wsat.TransactionalFeature
as a
parameter when creating the Web service client. For more information
about these annotations, see "Using Web Service Atomic Transactions" in Programming Advanced Features of
JAX-WS Web Services for Oracle WebLogic Server.
At deployment time, you can configure Web service atomic transaction properties at the domain, Web service endpoint, and Web service operation levels.
At the domain level, you set properties to configure the atomic transaction coordinator and participant, including:
At the Web service endpoint or operation level, you can enable Web service atomic transactions, and configure the following information:
Valid values include WSAT 10
, WSAT
11
, and WSAT 12
, and
Default
. The Default
value for Web
services is all three versions (driven by the inbound request); the
Default
value for Web service clients is WSAT
10
.
The following table
summarizes the valid values and their meaning on the Web service and
client. The table also summarizes the valid value combinations when
configuring Web service atomic transactions for an EJB-style web
service that uses the @TransacationAttribute
annotation.
Value | Web Service Client | Web Service | Valid EJB @TransacdtionAttribute Values |
---|---|---|---|
Never |
JTA Transaction: Do not export transaction
coordination context. No JTA Transaction: Do not export transaction coordination context. |
Transaction flow exists: Do not import
transaction coordination context. If the CoordinationContext
header contains mustunderstand="true" , a SOAP
fault is thrown.No JTA Transaction: Do not import transaction coordination context. |
NEVER , NOT_SUPPORTED ,
REQUIRED REQUIRES_NEW,
SUPPORTS |
Supports (Default) |
JTA Transaction: Export transaction coordination
context. No JTA Transaction: Do not export transaction coordination context. |
Transaction flow exists: Import transaction
context. No JTA Transaction: Do not import transaction coordination context. |
SUPPORTS ,
REQUIRED |
Mandatory |
JTA Transaction: Export transaction coordination
context. No JTA Transaction: An exception is thrown. |
Transaction flow exists: Import transaction
context. No JTA Transaction: Service-side exception is thrown. |
MANDATORY , REQUIRED,
SUPPORTS |
For more information about Web service atomic transactions, see "Using Web Service Atomic Transactions" in Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server.
The following steps describe how to configure Web services atomic transactions:
Note: Web services are deployed as part of an Enterprise application, Web application, or EJB. To understand how Web services are displayed in the Administration Console, see View installed Web services.
![]() |