IDBObjectStore (GWT Elemental 2.7.0)

All Known Implementing Classes:

JsIDBObjectStore
```
public interface IDBObjectStore
```
The IDBObjectStore interface of the IndexedDB API represents an object store in a database. Records within an object store are sorted according to their keys. This sorting enable fast insertion, look-up, and ordered retrieval.

Method Summary

Methods
Modifier and Type	Method and Description
`IDBRequest`	`_delete(IDBKeyRange keyRange)` Immediately returns an `IDBRequest` object, and removes the record specified by the given key from this object store, and any indexes that reference it, in a separate thread.
`IDBRequest`	`_delete(Object key)` Immediately returns an `IDBRequest` object, and removes the record specified by the given key from this object store, and any indexes that reference it, in a separate thread.
`IDBRequest`	`add(Object value)` Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the `value`, and stores the cloned value in the object store.
`IDBRequest`	`add(Object value, Object key)` Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the `value`, and stores the cloned value in the object store.
`IDBRequest`	`clear()` If the mode of the transaction that this object store belongs to is `READ_ONLY`, this method raises an IDBDatabaseException with its code set to `READ_ONLY_ERR`.
`IDBRequest`	`count()` Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range.
`IDBRequest`	`count(IDBKeyRange range)` Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range.
`IDBRequest`	`count(Object key)` Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range.
`IDBIndex`	`createIndex(String name, String keyPath)` Creates and returns a new index in the connected database.
`IDBIndex`	`createIndex(String name, String keyPath, Mappable options)` Creates and returns a new index in the connected database.
`void`	`deleteIndex(String name)` Destroys the index with the specified name in the connected database.
`Indexable`	`getIndexNames()` A list of the names of indexes on objects in this object store.
`Object`	`getKeyPath()` The key path of this object store.
`String`	`getName()` The name of this object store.
`IDBRequest`	`getObject(IDBKeyRange key)`
`IDBRequest`	`getObject(Object key)`
`IDBTransaction`	`getTransaction()`
`IDBIndex`	`index(String name)` Opens the named index in this object store.
`boolean`	`isAutoIncrement()`
`IDBRequest`	`openCursor(IDBKeyRange range)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`openCursor(IDBKeyRange range, int direction)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`openCursor(IDBKeyRange range, String direction)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`openCursor(Object key)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`openCursor(Object key, int direction)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`openCursor(Object key, String direction)` Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread.
`IDBRequest`	`put(Object value)` Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the `value`, and stores the cloned value in the object store.
`IDBRequest`	`put(Object value, Object key)` Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the `value`, and stores the cloned value in the object store.

Method Detail

isAutoIncrement
```
boolean isAutoIncrement()
```

getIndexNames
```
Indexable getIndexNames()
```
A list of the names of indexes on objects in this object store.

getKeyPath
```
Object getKeyPath()
```
The key path of this object store. If this attribute is null, the application must provide a key for each modification operation.

getName
```
String getName()
```
The name of this object store.

getTransaction
```
IDBTransaction getTransaction()
```

add
```
IDBRequest add(Object value)
```
Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store. If the record is successfully stored, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to the key for the stored record, and transaction set to the transaction in which this object store is opened. If a record already exists in the object store with the key parameter as its key, then an error event is fired on the returned request object, with code set to CONSTRAINT_ERR.

Parameters

value

The value to be stored.

key

The key to use to identify the record. If unspecified, it results to null.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

DATA_ERR

If the object store uses in-line keys or has a key generator, and a key parameter was provided.
If the object store uses out-of-line keys and has no key generator, and no key parameter was provided.
If the object store uses in-line keys but no key generator, and the object store's key path does not yield a valid key.
If the key parameter was provided but does not contain a valid key.
If there are indexed on this object store, and using their key path on the value parameter yields a value that is not a valid key.

READ_ONLY_ERR

If the mode of the associated transaction is READ_ONLY.

TRANSACTION_INACTIVE_ERR

If the associated transaction is not active.

This method can raise a DOMException with the following code:

DATA_CLONE_ERR

If the data being stored could not be cloned by the internal structured cloning algorithm.

add
```
IDBRequest add(Object value,
             Object key)
```
Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store. If the record is successfully stored, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to the key for the stored record, and transaction set to the transaction in which this object store is opened. If a record already exists in the object store with the key parameter as its key, then an error event is fired on the returned request object, with code set to CONSTRAINT_ERR.

Parameters

value

The value to be stored.

key

The key to use to identify the record. If unspecified, it results to null.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

DATA_ERR

If the object store uses in-line keys or has a key generator, and a key parameter was provided.
If the object store uses out-of-line keys and has no key generator, and no key parameter was provided.
If the object store uses in-line keys but no key generator, and the object store's key path does not yield a valid key.
If the key parameter was provided but does not contain a valid key.
If there are indexed on this object store, and using their key path on the value parameter yields a value that is not a valid key.

READ_ONLY_ERR

If the mode of the associated transaction is READ_ONLY.

TRANSACTION_INACTIVE_ERR

If the associated transaction is not active.

This method can raise a DOMException with the following code:

DATA_CLONE_ERR

If the data being stored could not be cloned by the internal structured cloning algorithm.

clear
```
IDBRequest clear()
```
If the mode of the transaction that this object store belongs to is READ_ONLY, this method raises an IDBDatabaseException with its code set to READ_ONLY_ERR. Otherwise, this method creates and immediately returns an IDBRequest object, and clears this object store in a separate thread. Clearing an object store consists of removing all records from the object store and removing all records in indexes that reference the object store.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

READ_ONLY_ERR

If the mode of the transaction that this object store belongs to is READ_ONLY.

TRANSACTION_INACTIVE_ERR

If the transaction that this object store belongs to is not active.

count
```
IDBRequest count()
```
Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range. If the parameter is not valid returns an exception.

Parameters

key

The key or key range that identifies the records to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

DATA_ERR

If the object store uses in-line keys or has a key generator, and a key parameter was provided.
If the object store uses out-of-line keys and has no key generator, and no key parameter was provided.
If the object store uses in-line keys but no key generator, and the object store's key path does not yield a valid key.
If the key parameter was provided but does not contain a valid key.
If there are indexed on this object store, and using their key path on the value parameter yields a value that is not a valid key.

NOT_ALLOWED_ERR

The request was made on a source object that has been deleted or removed.

count
```
IDBRequest count(IDBKeyRange range)
```
Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range. If the parameter is not valid returns an exception.

Parameters

key

The key or key range that identifies the records to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

DATA_ERR

If the object store uses in-line keys or has a key generator, and a key parameter was provided.
If the object store uses out-of-line keys and has no key generator, and no key parameter was provided.
If the object store uses in-line keys but no key generator, and the object store's key path does not yield a valid key.
If the key parameter was provided but does not contain a valid key.
If there are indexed on this object store, and using their key path on the value parameter yields a value that is not a valid key.

NOT_ALLOWED_ERR

The request was made on a source object that has been deleted or removed.

count
```
IDBRequest count(Object key)
```
Immediately returns an IDBRequest object and asynchronously count the amount of objects in the object store that match the parameter, a key or a key range. If the parameter is not valid returns an exception.

Parameters

key

The key or key range that identifies the records to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

DATA_ERR

If the object store uses in-line keys or has a key generator, and a key parameter was provided.
If the object store uses out-of-line keys and has no key generator, and no key parameter was provided.
If the object store uses in-line keys but no key generator, and the object store's key path does not yield a valid key.
If the key parameter was provided but does not contain a valid key.
If there are indexed on this object store, and using their key path on the value parameter yields a value that is not a valid key.

NOT_ALLOWED_ERR

The request was made on a source object that has been deleted or removed.

createIndex

IDBIndex createIndex(String name,
                   String keyPath)

Creates and returns a new index in the connected database. Note that this method must be called only from a VERSION_CHANGE transaction callback.

IDBIndex createIndex (
  in DOMString name, 
  in DOMString keyPath, 
  in Object optionalParameters
) raises (IDBDatabaseException);

Parameters

name

The name of the index to create.

keyPath

The key path for the index to use.

optionalParameters

Warning: The latest draft of the specification changed this to IDBIndexParameters, which is not yet recognized by any browser

Options object whose attributes are optional parameters to the method. It includes the following properties:

Attribute	Description
`unique`	If true, the index will not allow duplicate values for a single key.
`multientry`	If true, the index will add an entry in the index for each array element when the keypath resolves to an Array. If false, it will add one single entry containing the Array.

Unknown parameters are ignored.

Returns

IDBIndex: The newly created index.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

CONSTRAINT_ERR: If an index with the same name (based on case-sensitive comparison) already exists in the connected database.
NOT_ALLOWED_ERR: If this method was not called from a VERSION_CHANGE transaction callback.

createIndex

IDBIndex createIndex(String name,
                   String keyPath,
                   Mappable options)

Creates and returns a new index in the connected database. Note that this method must be called only from a VERSION_CHANGE transaction callback.

IDBIndex createIndex (
  in DOMString name, 
  in DOMString keyPath, 
  in Object optionalParameters
) raises (IDBDatabaseException);

Parameters

name

The name of the index to create.

keyPath

The key path for the index to use.

optionalParameters

Warning: The latest draft of the specification changed this to IDBIndexParameters, which is not yet recognized by any browser

Options object whose attributes are optional parameters to the method. It includes the following properties:

Attribute	Description
`unique`	If true, the index will not allow duplicate values for a single key.
`multientry`	If true, the index will add an entry in the index for each array element when the keypath resolves to an Array. If false, it will add one single entry containing the Array.

Unknown parameters are ignored.

Returns

IDBIndex: The newly created index.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

CONSTRAINT_ERR: If an index with the same name (based on case-sensitive comparison) already exists in the connected database.
NOT_ALLOWED_ERR: If this method was not called from a VERSION_CHANGE transaction callback.

_delete
```
IDBRequest _delete(IDBKeyRange keyRange)
```
Immediately returns an IDBRequest object, and removes the record specified by the given key from this object store, and any indexes that reference it, in a separate thread. If no record exists in this object store corresponding to the key, an error event is fired on the returned request object, with its code set to NOT_FOUND_ERR and an appropriate message. If the record is successfully removed, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to undefined, and transaction set to the transaction in which this object store is opened.
```
IDBRequest delete (
  in any key
) raises (IDBDatabaseException); 
```
Parameters

key

The key to use to identify the record.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

_delete
```
IDBRequest _delete(Object key)
```
Immediately returns an IDBRequest object, and removes the record specified by the given key from this object store, and any indexes that reference it, in a separate thread. If no record exists in this object store corresponding to the key, an error event is fired on the returned request object, with its code set to NOT_FOUND_ERR and an appropriate message. If the record is successfully removed, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to undefined, and transaction set to the transaction in which this object store is opened.
```
IDBRequest delete (
  in any key
) raises (IDBDatabaseException); 
```
Parameters

key

The key to use to identify the record.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

deleteIndex
```
void deleteIndex(String name)
```
Destroys the index with the specified name in the connected database. Note that this method must be called only from a VERSION_CHANGE transaction callback.
```
void removeIndex(
  in DOMString indexName
) raises (IDBDatabaseException); 
```
Parameters

NOT_ALLOWED_ERR

If the object store is not in the scope of any existing transaction, or if the associated transaction's mode is READ_ONLY or SNAPSHOT_READ.

TRANSACTION_INACTIVE_ERR

If the associated transaction is not active.

indexName

The name of the existing index to remove.

Exceptions

This method can raise an IDBDatabaseException with the following codes:

NOT_ALLOWED_ERR

If this method was not called from a VERSION_CHANGE transaction callback.

NOT_FOUND_ERR

If no index exists with the specified name (based on case-sensitive comparison) in the connected database.

getObject
```
IDBRequest getObject(IDBKeyRange key)
```

getObject
```
IDBRequest getObject(Object key)
```

index
```
IDBIndex index(String name)
```
Opens the named index in this object store.

Parameters

name

The name of the index to open.

Returns

IDBIndex

An object for accessing the index.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_FOUND_ERR

If no index exists with the specified name (based on case-sensitive comparison) in the connected database.

openCursor
```
IDBRequest openCursor(IDBKeyRange range)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

openCursor
```
IDBRequest openCursor(IDBKeyRange range,
                    String direction)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

openCursor
```
IDBRequest openCursor(Object key)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

openCursor
```
IDBRequest openCursor(Object key,
                    String direction)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

openCursor
```
IDBRequest openCursor(IDBKeyRange range,
                    int direction)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

openCursor
```
IDBRequest openCursor(Object key,
                    int direction)
```
Immediately returns an IDBRequest object, and creates a cursor over the records in this object store, in a separate thread. If there is even a single record that matches the key range, then a success event is fired on the returned object, with its result set to the IDBCursor object for the new cursor. If no records match the key range, then a success event is fired on the returned object, with its result set to null.
```
IDBRequest openCursor (
  in optional IDBKeyRange range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);
```
Parameters

range

The key range to use as the cursor's range. If this parameter is unspecified or null, then the range includes all the records in the object store.

direction

The cursor's direction.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If this object store is not in the scope of any existing transaction on the connected database.

put
```
IDBRequest put(Object value)
```
Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store. If the record is successfully stored, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to the key for the stored record, and transaction set to the transaction in which this object store is opened.

Parameters

value

The value to be stored.

key

The key to use to identify the record. If unspecified, it results to null.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.
Exceptions

This method can raise an IDBDatabaseException with the following codes:
If this object store uses out-of-line keys and does not use a key generator, but the key parameter was not passed

If the object store uses in-line keys, but the value object does not have a property identified by the object store's key path.
NOT_ALLOWED_ERR

If the object store is not in the scope of any existing transaction, or if the associated transaction's mode is READ_ONLY or SNAPSHOT_READ.

SERIAL_ERR

If the data being stored could not be serialized by the internal structured cloning algorithm.
This method can raise a DOMException with the following code:

DATA_CLONE_ERR

If the data being stored could not be cloned by the internal structured cloning algorithm.

put
```
IDBRequest put(Object value,
             Object key)
```
Returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store. If the record is successfully stored, then a success event is fired on the returned request object, using the IDBTransactionEvent interface, with the result set to the key for the stored record, and transaction set to the transaction in which this object store is opened.

Parameters

value

The value to be stored.

key

The key to use to identify the record. If unspecified, it results to null.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.
Exceptions

This method can raise an IDBDatabaseException with the following codes:
If this object store uses out-of-line keys and does not use a key generator, but the key parameter was not passed

If the object store uses in-line keys, but the value object does not have a property identified by the object store's key path.
NOT_ALLOWED_ERR

If the object store is not in the scope of any existing transaction, or if the associated transaction's mode is READ_ONLY or SNAPSHOT_READ.

SERIAL_ERR

If the data being stored could not be serialized by the internal structured cloning algorithm.
This method can raise a DOMException with the following code:

DATA_CLONE_ERR

If the data being stored could not be cloned by the internal structured cloning algorithm.

Interface IDBObjectStore

Method Summary

Method Detail

isAutoIncrement

getIndexNames

getKeyPath

getName

getTransaction

add

Parameters

Returns

Exceptions

add

Parameters

Returns

Exceptions

clear

Returns

Exceptions

count

Parameters

Returns

Exceptions

count

Parameters

Returns

Exceptions

count

Parameters

Returns

Exceptions

createIndex

Parameters

Returns

Exceptions

createIndex

Parameters

Returns

Exceptions

_delete

Parameters

Returns

Exceptions

_delete

Parameters

Returns

Exceptions

deleteIndex

Parameters

Exceptions

getObject

getObject

index

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions