# Class ThreadSafeDatabase

java.lang.Object
com.codename1.db.Database
com.codename1.db.ThreadSafeDatabase

public class ThreadSafeDatabase extends Database
Wraps all database calls in a single thread so they are all proxied thru that thread

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `ThreadSafeDatabase(Database db)`
  Wraps the given database with a threadsafe version

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `beginTransaction()`
  Starts a transaction
  `void`
  `close()`
  Closes the database
  `void`
  `commitTransaction()`
  Commits current transaction
  `void`
  `execute(String sql)`
  Execute an update query.
  `void`
  `execute(String sql, Object... params)`
  Execute an update query with params.
  `void`
  `execute(String sql, String[] params)`
  Execute an update query with params.
  `Cursor`
  `executeQuery(String sql)`
  This method should be called with SELECT type statements that return row set.
  `Cursor`
  `executeQuery(String sql, Object... params)`
  This method should be called with SELECT type statements that return row set it accepts object with params.
  `Cursor`
  `executeQuery(String sql, String[] params)`
  This method should be called with SELECT type statements that return row set.
  `EasyThread`
  `getThread()`
  Returns the underlying easy thread we can use to pipe tasks to the db thread
  `void`
  `rollbackTransaction()`
  Rolls back current transaction

  ### Methods inherited from class Database

  `delete, exists, getDatabasePath, isCustomPathSupported, openOrCreate, supportsWasNull, wasNull`

  ### Methods inherited from class Object

  `clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### ThreadSafeDatabase

    public ThreadSafeDatabase(Database db)

    Wraps the given database with a threadsafe version

    ###### Parameters

    - `db`: the database

- ## Method Details

  - ### getThread

    public EasyThread getThread()

    Returns the underlying easy thread we can use to pipe tasks to the db thread

    ###### Returns

    the easy thread object

  - ### beginTransaction

    public void beginTransaction() throws IOException
    Description copied from class: `Database`

    Starts a transaction

    NOTE: Not supported in Javascript port. This method will do nothing when running in Javascript.

    ###### Throws

    - `IOException`: if database is not opened
    Specified by:
      `beginTransaction` in class `Database`
    Throws:
      `IOException`

  - ### commitTransaction

    public void commitTransaction() throws IOException
    Description copied from class: `Database`

    Commits current transaction

    NOTE: Not supported in Javascript port. This method will do nothing when running in Javascript.

    ###### Throws

    - `IOException`: if database is not opened or transaction was not started
    Specified by:
      `commitTransaction` in class `Database`
    Throws:
      `IOException`

  - ### rollbackTransaction

    public void rollbackTransaction() throws IOException
    Description copied from class: `Database`

    Rolls back current transaction

    NOTE: Not supported in Javascript port. This method will do nothing when running in Javascript.

    ###### Throws

    - `IOException`: if database is not opened or transaction was not started
    Specified by:
      `rollbackTransaction` in class `Database`
    Throws:
      `IOException`

  - ### close

    public void close()
    Description copied from class: `Database`

    Closes the database

    ###### Throws

    - `IOException`
    Specified by:
      `close` in class `Database`

  - ### execute

    public void execute(String sql) throws IOException
    Description copied from class: `Database`

    Execute an update query. Used for INSERT, UPDATE, DELETE and similar sql statements.

    ###### Parameters

    - `sql`: the sql to execute

    ###### Throws

    - `IOException`
    Specified by:
      `execute` in class `Database`
    Throws:
      `IOException`

  - ### execute

    public void execute(String sql, String[] params) throws IOException
    Description copied from class: `Database`

    Execute an update query with params. Used for INSERT, UPDATE, DELETE and similar sql statements. The sql can be constructed with '?' and the params will be binded to the query

    ###### Parameters

    - `sql`: the sql to execute

    - `params`: to bind to the query where the '?' exists

    ###### Throws

    - `IOException`
    Specified by:
      `execute` in class `Database`
    Throws:
      `IOException`

  - ### executeQuery

    public Cursor executeQuery(String sql, String[] params) throws IOException
    Description copied from class: `Database`

    This method should be called with SELECT type statements that return row set.

    ###### Parameters

    - `sql`: the sql to execute

    - `params`: to bind to the query where the '?' exists

    ###### Returns

    a cursor to iterate over the results

    ###### Throws

    - `IOException`
    Specified by:
      `executeQuery` in class `Database`
    Throws:
      `IOException`

  - ### executeQuery

    public Cursor executeQuery(String sql) throws IOException
    Description copied from class: `Database`

    This method should be called with SELECT type statements that return row set.

    ###### Parameters

    - `sql`: the sql to execute

    ###### Returns

    a cursor to iterate over the results

    ###### Throws

    - `IOException`
    Specified by:
      `executeQuery` in class `Database`
    Throws:
      `IOException`

  - ### executeQuery

    public Cursor executeQuery(String sql, Object... params) throws IOException
    Description copied from class: `Database`

    This method should be called with SELECT type statements that return row set it accepts object with params.

    ###### Parameters

    - `sql`: the sql to execute

    - `params`: @param params to bind to the query where the '?' exists, supported object types are String, byte[], Double, Long and null

    ###### Returns

    a cursor to iterate over the results

    ###### Throws

    - `IOException`
    Overrides:
      `executeQuery` in class `Database`
    Throws:
      `IOException`

  - ### execute

    public void execute(String sql, Object... params) throws IOException
    Description copied from class: `Database`

    Execute an update query with params. Used for INSERT, UPDATE, DELETE and similar sql statements. The sql can be constructed with '?' and the params will be binded to the query

    ###### Parameters

    - `sql`: the sql to execute

    - `params`: @param params to bind to the query where the '?' exists, supported object types are String, byte[], Double, Long and null

    ###### Throws

    - `IOException`
    Overrides:
      `execute` in class `Database`
    Throws:
      `IOException`