Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.bea.wlai.control
Interface ApplicationViewControl

All Superinterfaces:
  com.bea.control.Control, Serializable, com.bea.control.XMLControl

public interface ApplicationViewControl
extends com.bea.control.XMLControl

ApplicationView Control base interface.

The methods of this interface may be invoked by any web service or business process with an Application View control instance.

The local transaction methods are not used in a container that controls transactions, such as the process container for WebLogic Integration or the web service container for WebLogic Workshop. This is because the WebLogic Server Transaction Manager (TM) automatically enlists any local resource (a maximum of one) into the active XA transaction. Thus, using application views and adapters that support only local transactions appears the same as using application views and adapters that support XA transactions.

You can have only one local-only resource in the transaction. The business process designer must ensure that only one local resource gets enlisted anywhere within a given set of explicit transaction tags (or the implicit outer transaction tags if none are given explicitly). If a second local-only resource is required, you must separate the first and second resources across transaction tags in the process definition language.

For containers that do not control the outer XA transaction (for example, a WebLogic Portal page group), you can use the local transaction methods. However, you can also start an XA transaction using the javax.transaction.UserTransaction interface, and allow the WebLogic Server Transaction Manager to automatically enlist the local resource.

Note: Any asynchronous service for the JCX is represented as a callback on the JCX. This allows the extension of the base control for callbacks. Asynchronous response callbacks use the XML type to represent the response document.

Nested Class Summary
`static interface` | `ApplicationViewControl.Callback` Callback interface that defines the generic events that can be delivered to any ApplicationView control instance.

Method Summary
`void` | `beginLocalTransaction()` Begin a local transaction on this control.
`void` | `commitLocalTransaction()` Commit the active local transaction for this control.
`String` | `getActiveAsyncRequestID()` Return the ID of the active asynchronous request being processed by this control instance, or null if no async request is active.
`boolean` | `isAsyncRequestActive()` Is this control instance currently processing an async request?
`void` | `rollbackLocalTransaction()` Rollback the active local transaction for this control.

Method Detail

### beginLocalTransaction

    public void beginLocalTransaction()
                               throws Exception

  Begin a local transaction on this control. This will begin a local transaction on the underlying ApplicationView instance. All work done by this control instance between this call, and a call to commitLocalTransaction() or rollbackLocalTransaction() will be committed or rolled back, respectively, as a unit. If the underlying adapter used by the ApplicationView for this control does not support local transactions, an exception is thrown.

  Throws:
    `Exception`

### commitLocalTransaction

    public void commitLocalTransaction()
                                throws Exception

  Commit the active local transaction for this control. All work done since the last call to beginLocalTransaction() will be committed into the EIS's permanent state. If the underlying adapter used by the ApplicationView for this control does not support local transactions, an exception is thrown.

  Throws:
    `Exception`

### rollbackLocalTransaction

    public void rollbackLocalTransaction()
                                  throws Exception

  Rollback the active local transaction for this control. All work done since the last call to beginLocalTransaction() will be discarded. If the underlying adapter used by the ApplicationView for this control does not support local transactions, an exception is thrown.

  Throws:
    `Exception`

### isAsyncRequestActive

    public boolean isAsyncRequestActive()

  Is this control instance currently processing an async request?

### getActiveAsyncRequestID

    public String getActiveAsyncRequestID()

  Return the ID of the active asynchronous request being processed by this control instance, or null if no async request is active.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD