IDBTransaction (GWT Elemental 2.7.0)

All Superinterfaces:

EventTarget

All Known Implementing Classes:

JsIDBTransaction
```
public interface IDBTransaction
extends EventTarget
```
The IDBTransaction interface of the IndexedDB API provides a static, asynchronous transaction on a database using event handler attributes. All reading and writing of data are done within transactions. You actually use IDBDatabase to start transactions and use IDBTransaction to set the mode of the transaction and access an object store and make your request. You can also use it to abort transactions.

Inherits from: EventTarget

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`READ_ONLY` Allows data to be read but not changed.
`static int`	`READ_WRITE` Allows reading and writing of data in existing data stores to be changed.
`static int`	`VERSION_CHANGE` Allows any operation to be performed, including ones that delete and create object stores and indexes.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`abort()` Returns immediately, and undoes all the changes to objects in the database associated with this transaction.
`EventRemover`	`addEventListener(String type, EventListener listener)` Register an event handler of a specific event type on the `EventTarget`.
`EventRemover`	`addEventListener(String type, EventListener listener, boolean useCapture)` Register an event handler of a specific event type on the `EventTarget`.
`boolean`	`dispatchEvent(Event evt)` Dispatch an event to this `EventTarget`.
`IDBDatabase`	`getDb()` The database connection that this transaction is associated with.
`DOMError`	`getError()`
`String`	`getMode()` The mode for isolating access to data in the object stores that are in the scope of the transaction.
`EventListener`	`getOnabort()`
`EventListener`	`getOncomplete()`
`EventListener`	`getOnerror()`
`IDBObjectStore`	`objectStore(String name)` Returns an object store that has already been added to the scope of this transaction.
`void`	`removeEventListener(String type, EventListener listener)` Removes an event listener from the `EventTarget`.
`void`	`removeEventListener(String type, EventListener listener, boolean useCapture)` Removes an event listener from the `EventTarget`.
`void`	`setOnabort(EventListener arg)`
`void`	`setOncomplete(EventListener arg)`
`void`	`setOnerror(EventListener arg)`

- Field Detail
  - READ_ONLY
```
static final int READ_ONLY
```
    Allows data to be read but not changed.
    
    See Also:
    
    Constant Field Values
  - READ_WRITE
```
static final int READ_WRITE
```
    Allows reading and writing of data in existing data stores to be changed.
    
    See Also:
    
    Constant Field Values
  - VERSION_CHANGE
```
static final int VERSION_CHANGE
```
    Allows any operation to be performed, including ones that delete and create object stores and indexes. This mode is for updating the version number of transactions that were started using the setVersion() method of IDBDatabase objects. Transactions of this mode cannot run concurrently with other transactions.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getDb
```
IDBDatabase getDb()
```
    The database connection that this transaction is associated with.
  - getError
```
DOMError getError()
```
  - getMode
```
String getMode()
```
    The mode for isolating access to data in the object stores that are in the scope of the transaction. For possible values, see Constants. The default value is READ_ONLY.
  - getOnabort
```
EventListener getOnabort()
```
  - setOnabort
```
void setOnabort(EventListener arg)
```
  - getOncomplete
```
EventListener getOncomplete()
```
  - setOncomplete
```
void setOncomplete(EventListener arg)
```
  - getOnerror
```
EventListener getOnerror()
```
  - setOnerror
```
void setOnerror(EventListener arg)
```
  - abort
```
void abort()
```
    Returns immediately, and undoes all the changes to objects in the database associated with this transaction. If this transaction has been aborted or completed, then this method throws an error event, with its code set to ABORT_ERR and a suitable message.
    
    All pending IDBRequest objects created during this transaction have their errorCode set to ABORT_ERR.
    
    Exceptions
    
    This method can raise an IDBDatabaseException, with the following code:
    
    NOT_ALLOWED_ERR
    
    The transaction has already been committed or aborted.
  - addEventListener
```
EventRemover addEventListener(String type,
                              EventListener listener)
```
    Description copied from interface: EventTarget
    
    Register an event handler of a specific event type on the EventTarget.
    
    Specified by:
    
    addEventListener in interface EventTarget
  - addEventListener
```
EventRemover addEventListener(String type,
                              EventListener listener,
                              boolean useCapture)
```
    Description copied from interface: EventTarget
    
    Register an event handler of a specific event type on the EventTarget.
    
    Specified by:
    
    addEventListener in interface EventTarget
  - dispatchEvent
```
boolean dispatchEvent(Event evt)
```
    Description copied from interface: EventTarget
    
    Dispatch an event to this EventTarget.
    
    Specified by:
    
    dispatchEvent in interface EventTarget
  - objectStore
```
IDBObjectStore objectStore(String name)
```
    Returns an object store that has already been added to the scope of this transaction. Every call to this method on the same transaction object, with the same name, returns the same IDBObjectStore instance. If this method is called on a different transaction object, a different IDBObjectStore instance is returned.
    
    Parameters
    
    name
    
    The name of the requested object store.
    
    Returns
    
    IDBObjectStore
    
    An object for accessing the requested object store.
    
    Exceptions
    
    The method can raise an IDBDatabaseException with the following code:
    
    NOT_FOUND_ERR
    
    The requested object store is not in this transaction's scope.
    
    NOT_ALLOWED_ERR
    
    request is made on a source object that has been deleted or removed..
  - removeEventListener
```
void removeEventListener(String type,
                         EventListener listener)
```
    Description copied from interface: EventTarget
    
    Removes an event listener from the EventTarget.
    
    Specified by:
    
    removeEventListener in interface EventTarget
  - removeEventListener
```
void removeEventListener(String type,
                         EventListener listener,
                         boolean useCapture)
```
    Description copied from interface: EventTarget
    
    Removes an event listener from the EventTarget.
    
    Specified by:
    
    removeEventListener in interface EventTarget

Interface IDBTransaction

Field Summary

Method Summary

Field Detail

READ_ONLY

READ_WRITE

VERSION_CHANGE

Method Detail

getDb

getError

getMode

getOnabort

setOnabort

getOncomplete

setOncomplete

getOnerror

setOnerror

abort

Exceptions

addEventListener

addEventListener

dispatchEvent

objectStore

Parameters

Returns

Exceptions

removeEventListener

removeEventListener