elemental.html

Interface DatabaseSync

All Known Implementing Classes:

JsDatabaseSync

public interface DatabaseSync

DRAFT

This page is not complete.

The DatabaseSync interface in the IndexedDB API represents a synchronous connection to a database.

Method Summary

Modifier and Type	Method and Description
void	changeVersion(String oldVersion, String newVersion)
void	changeVersion(String oldVersion, String newVersion, SQLTransactionSyncCallback callback)
String	getLastErrorMessage()
String	getVersion() The version of the connected database.
void	readTransaction(SQLTransactionSyncCallback callback)
void	transaction(SQLTransactionSyncCallback callback) Creates and returns a transaction, acquiring locks on the given database objects, within the specified timeout duration, if possible.

Method Detail

getLastErrorMessage

String getLastErrorMessage()

getVersion

String getVersion()

The version of the connected database. Has the null value when the database is first created.

changeVersion

void changeVersion(String oldVersion,
                   String newVersion)

changeVersion

void changeVersion(String oldVersion,
                   String newVersion,
                   SQLTransactionSyncCallback callback)

readTransaction

void readTransaction(SQLTransactionSyncCallback callback)

transaction

void transaction(SQLTransactionSyncCallback callback)

Creates and returns a transaction, acquiring locks on the given database objects, within the specified timeout duration, if possible.

IDBTransactionSync transaction (
  in optional DOMStringList storeNames,
  in optional unsigned int timeout
) raises (IDBDatabaseException);

Parameters

storeNames

The names of object stores and indexes in the scope of the new transaction.

timeout

The interval that this operation is allowed to take to acquire locks on all the objects stores and indexes identified in storeNames.

Returns

IDBTransactionSync

An object to access the newly created transaction.

Exceptions

This method can raise an IDBDatabaseException with the following code:

TIMEOUT_ERR

If reserving all the database objects identified in storeNames takes longer than the timeout interval.