AbstractDao ( greenDAO 2.1.0 API)

java.lang.Object
- de.greenrobot.dao.AbstractDao<T,K>

Type Parameters:
T - Entity type
K - Primary key (PK) type; use Void if entity does not have exactly one PK
```
public abstract class AbstractDao<T,K>
extends java.lang.Object
```
Base class for all DAOs: Implements entity operations like insert, load, delete, and query.
This class is thread-safe.

Field Summary

Fields
Modifier and Type	Field and Description
`protected de.greenrobot.dao.internal.DaoConfig`	`config`
`protected android.database.sqlite.SQLiteDatabase`	`db`
`protected IdentityScope<K,T>`	`identityScope`
`protected IdentityScopeLong<T>`	`identityScopeLong`
`protected int`	`pkOrdinal`
`protected AbstractDaoSession`	`session`
`protected de.greenrobot.dao.internal.TableStatements`	`statements`

Constructor Summary

Constructors
Constructor and Description
`AbstractDao(de.greenrobot.dao.internal.DaoConfig config)`
`AbstractDao(de.greenrobot.dao.internal.DaoConfig config, AbstractDaoSession daoSession)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`assertSinglePk()`
`protected void`	`attachEntity(K key, T entity, boolean lock)` Attaches the entity to the identity scope.
`protected void`	`attachEntity(T entity)` Sub classes with relations additionally set the DaoMaster here.
`protected abstract void`	`bindValues(android.database.sqlite.SQLiteStatement stmt, T entity)` Binds the entity's values to the statement.
`long`	`count()`
`void`	`delete(T entity)` Deletes the given entity from the database.
`void`	`deleteAll()`
`void`	`deleteByKey(K key)` Deletes an entity with the given PK from the database.
`void`	`deleteByKeyInTx(java.lang.Iterable<K> keys)` Deletes all entities with the given keys in the database using a transaction.
`void`	`deleteByKeyInTx(K... keys)` Deletes all entities with the given keys in the database using a transaction.
`void`	`deleteInTx(java.lang.Iterable<T> entities)` Deletes the given entities in the database using a transaction.
`void`	`deleteInTx(T... entities)` Deletes the given entities in the database using a transaction.
`boolean`	`detach(T entity)` Detaches an entity from the identity scope (session).
`java.lang.String[]`	`getAllColumns()`
`android.database.sqlite.SQLiteDatabase`	`getDatabase()` Gets the SQLiteDatabase for custom database access.
`protected abstract K`	`getKey(T entity)` Returns the value of the primary key, if the entity has a single primary key, or, if not, null.
`protected K`	`getKeyVerified(T entity)` See `getKey(Object)`, but guarantees that the returned key is never null (throws if null).
`java.lang.String[]`	`getNonPkColumns()`
`java.lang.String[]`	`getPkColumns()`
`Property`	`getPkProperty()`
`Property[]`	`getProperties()`
`AbstractDaoSession`	`getSession()`
`java.lang.String`	`getTablename()`
`long`	`insert(T entity)` Insert an entity into the table associated with a concrete DAO.
`void`	`insertInTx(java.lang.Iterable<T> entities)` Inserts the given entities in the database using a transaction.
`void`	`insertInTx(java.lang.Iterable<T> entities, boolean setPrimaryKey)` Inserts the given entities in the database using a transaction.
`void`	`insertInTx(T... entities)` Inserts the given entities in the database using a transaction.
`long`	`insertOrReplace(T entity)` Insert an entity into the table associated with a concrete DAO.
`void`	`insertOrReplaceInTx(java.lang.Iterable<T> entities)` Inserts or replaces the given entities in the database using a transaction.
`void`	`insertOrReplaceInTx(java.lang.Iterable<T> entities, boolean setPrimaryKey)` Inserts or replaces the given entities in the database using a transaction.
`void`	`insertOrReplaceInTx(T... entities)` Inserts or replaces the given entities in the database using a transaction.
`long`	`insertWithoutSettingPk(T entity)` Insert an entity into the table associated with a concrete DAO without setting key property.
`protected abstract boolean`	`isEntityUpdateable()` Returns true if the Entity class can be updated, e.g. for setting the PK after insert.
`T`	`load(K key)` Loads and entity for the given PK.
`java.util.List<T>`	`loadAll()` Loads all available entities from the database.
`protected java.util.List<T>`	`loadAllAndCloseCursor(android.database.Cursor cursor)`
`protected java.util.List<T>`	`loadAllFromCursor(android.database.Cursor cursor)` Reads all available rows from the given cursor and returns a list of entities.
`T`	`loadByRowId(long rowId)`
`protected T`	`loadCurrent(android.database.Cursor cursor, int offset, boolean lock)` Internal use only.
`protected <O> O`	`loadCurrentOther(AbstractDao<O,?> dao, android.database.Cursor cursor, int offset)` Internal use only.
`protected T`	`loadUnique(android.database.Cursor cursor)`
`protected T`	`loadUniqueAndCloseCursor(android.database.Cursor cursor)`
`QueryBuilder<T>`	`queryBuilder()`
`java.util.List<T>`	`queryRaw(java.lang.String where, java.lang.String... selectionArg)` A raw-style query where you can pass any WHERE clause and arguments.
`Query<T>`	`queryRawCreate(java.lang.String where, java.lang.Object... selectionArg)` Creates a repeatable `Query` object based on the given raw SQL where you can pass any WHERE clause and arguments.
`Query<T>`	`queryRawCreateListArgs(java.lang.String where, java.util.Collection<java.lang.Object> selectionArg)` Creates a repeatable `Query` object based on the given raw SQL where you can pass any WHERE clause and arguments.
`protected abstract T`	`readEntity(android.database.Cursor cursor, int offset)` Reads the values from the current position of the given cursor and returns a new entity.
`protected abstract void`	`readEntity(android.database.Cursor cursor, T entity, int offset)` Reads the values from the current position of the given cursor into an existing entity.
`protected abstract K`	`readKey(android.database.Cursor cursor, int offset)` Reads the key from the current position of the given cursor, or returns null if there's no single-value key.
`void`	`refresh(T entity)` Resets all locally changed properties of the entity by reloading the values from the database.
`void`	`update(T entity)`
`protected void`	`updateInsideSynchronized(T entity, android.database.sqlite.SQLiteStatement stmt, boolean lock)`
`void`	`updateInTx(java.lang.Iterable<T> entities)` Updates the given entities in the database using a transaction.
`void`	`updateInTx(T... entities)` Updates the given entities in the database using a transaction.
`protected abstract K`	`updateKeyAfterInsert(T entity, long rowId)` Updates the entity's key if possible (only for Long PKs currently).
`protected void`	`updateKeyAfterInsertAndAttach(T entity, long rowId, boolean lock)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - db
```
protected final android.database.sqlite.SQLiteDatabase db
```
  - config
```
protected final de.greenrobot.dao.internal.DaoConfig config
```
  - identityScope
```
protected IdentityScope<K,T> identityScope
```
  - identityScopeLong
```
protected IdentityScopeLong<T> identityScopeLong
```
  - statements
```
protected de.greenrobot.dao.internal.TableStatements statements
```
  - session
```
protected final AbstractDaoSession session
```
  - pkOrdinal
```
protected final int pkOrdinal
```
- Constructor Detail
  - AbstractDao
```
public AbstractDao(de.greenrobot.dao.internal.DaoConfig config)
```
  - AbstractDao
```
public AbstractDao(de.greenrobot.dao.internal.DaoConfig config,
           AbstractDaoSession daoSession)
```
- Method Detail
  - getSession
```
public AbstractDaoSession getSession()
```
  - getTablename
```
public java.lang.String getTablename()
```
  - getProperties
```
public Property[] getProperties()
```
  - getPkProperty
```
public Property getPkProperty()
```
  - getAllColumns
```
public java.lang.String[] getAllColumns()
```
  - getPkColumns
```
public java.lang.String[] getPkColumns()
```
  - getNonPkColumns
```
public java.lang.String[] getNonPkColumns()
```
  - load
```
public T load(K key)
```
    Loads and entity for the given PK.
    
    Parameters:
    key - a PK value or null
    
    Returns:
    The entity or null, if no entity matched the PK value
  - loadByRowId
```
public T loadByRowId(long rowId)
```
  - loadUniqueAndCloseCursor
```
protected T loadUniqueAndCloseCursor(android.database.Cursor cursor)
```
  - loadUnique
```
protected T loadUnique(android.database.Cursor cursor)
```
  - loadAll
```
public java.util.List<T> loadAll()
```
    Loads all available entities from the database.
  - detach
```
public boolean detach(T entity)
```
    Detaches an entity from the identity scope (session). Subsequent query results won't return this object.
  - loadAllAndCloseCursor
```
protected java.util.List<T> loadAllAndCloseCursor(android.database.Cursor cursor)
```
  - insertInTx
```
public void insertInTx(java.lang.Iterable<T> entities)
```
    Inserts the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to insert.
  - insertInTx
```
public void insertInTx(T... entities)
```
    Inserts the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to insert.
  - insertInTx
```
public void insertInTx(java.lang.Iterable<T> entities,
              boolean setPrimaryKey)
```
    Inserts the given entities in the database using a transaction. The given entities will become tracked if the PK is set.
    
    Parameters:
    entities - The entities to insert.
    setPrimaryKey - if true, the PKs of the given will be set after the insert; pass false to improve performance.
  - insertOrReplaceInTx
```
public void insertOrReplaceInTx(java.lang.Iterable<T> entities,
                       boolean setPrimaryKey)
```
    Inserts or replaces the given entities in the database using a transaction. The given entities will become tracked if the PK is set.
    
    Parameters:
    entities - The entities to insert.
    setPrimaryKey - if true, the PKs of the given will be set after the insert; pass false to improve performance.
  - insertOrReplaceInTx
```
public void insertOrReplaceInTx(java.lang.Iterable<T> entities)
```
    Inserts or replaces the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to insert.
  - insertOrReplaceInTx
```
public void insertOrReplaceInTx(T... entities)
```
    Inserts or replaces the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to insert.
  - insert
```
public long insert(T entity)
```
    Insert an entity into the table associated with a concrete DAO.
    
    Returns:
    row ID of newly inserted entity
  - insertWithoutSettingPk
```
public long insertWithoutSettingPk(T entity)
```
    Insert an entity into the table associated with a concrete DAO without setting key property. Warning: This may be faster, but the entity should not be used anymore. The entity also won't be attached to identy scope.
    
    Returns:
    row ID of newly inserted entity
  - insertOrReplace
```
public long insertOrReplace(T entity)
```
    Insert an entity into the table associated with a concrete DAO.
    
    Returns:
    row ID of newly inserted entity
  - updateKeyAfterInsertAndAttach
```
protected void updateKeyAfterInsertAndAttach(T entity,
                                 long rowId,
                                 boolean lock)
```
  - loadAllFromCursor
```
protected java.util.List<T> loadAllFromCursor(android.database.Cursor cursor)
```
    Reads all available rows from the given cursor and returns a list of entities.
  - loadCurrent
```
protected final T loadCurrent(android.database.Cursor cursor,
            int offset,
            boolean lock)
```
    Internal use only. Considers identity scope.
  - loadCurrentOther
```
protected final <O> O loadCurrentOther(AbstractDao<O,?> dao,
                     android.database.Cursor cursor,
                     int offset)
```
    Internal use only. Considers identity scope.
  - queryRaw
```
public java.util.List<T> queryRaw(java.lang.String where,
                         java.lang.String... selectionArg)
```
    A raw-style query where you can pass any WHERE clause and arguments.
  - queryRawCreate
```
public Query<T> queryRawCreate(java.lang.String where,
                      java.lang.Object... selectionArg)
```
    Creates a repeatable Query object based on the given raw SQL where you can pass any WHERE clause and arguments.
  - queryRawCreateListArgs
```
public Query<T> queryRawCreateListArgs(java.lang.String where,
                              java.util.Collection<java.lang.Object> selectionArg)
```
    Creates a repeatable Query object based on the given raw SQL where you can pass any WHERE clause and arguments.
  - deleteAll
```
public void deleteAll()
```
  - delete
```
public void delete(T entity)
```
    Deletes the given entity from the database. Currently, only single value PK entities are supported.
  - deleteByKey
```
public void deleteByKey(K key)
```
    Deletes an entity with the given PK from the database. Currently, only single value PK entities are supported.
  - deleteInTx
```
public void deleteInTx(java.lang.Iterable<T> entities)
```
    Deletes the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to delete.
  - deleteInTx
```
public void deleteInTx(T... entities)
```
    Deletes the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to delete.
  - deleteByKeyInTx
```
public void deleteByKeyInTx(java.lang.Iterable<K> keys)
```
    Deletes all entities with the given keys in the database using a transaction.
    
    Parameters:
    keys - Keys of the entities to delete.
  - deleteByKeyInTx
```
public void deleteByKeyInTx(K... keys)
```
    Deletes all entities with the given keys in the database using a transaction.
    
    Parameters:
    keys - Keys of the entities to delete.
  - refresh
```
public void refresh(T entity)
```
    Resets all locally changed properties of the entity by reloading the values from the database.
  - update
```
public void update(T entity)
```
  - queryBuilder
```
public QueryBuilder<T> queryBuilder()
```
  - updateInsideSynchronized
```
protected void updateInsideSynchronized(T entity,
                            android.database.sqlite.SQLiteStatement stmt,
                            boolean lock)
```
  - attachEntity
```
protected final void attachEntity(K key,
                T entity,
                boolean lock)
```
    Attaches the entity to the identity scope. Calls attachEntity(T entity).
    
    Parameters:
    key - Needed only for identity scope, pass null if there's none.
    entity - The entitiy to attach
  - attachEntity
```
protected void attachEntity(T entity)
```
    Sub classes with relations additionally set the DaoMaster here. Must be called before the entity is attached to the identity scope.
    
    Parameters:
    entity - The entitiy to attach
  - updateInTx
```
public void updateInTx(java.lang.Iterable<T> entities)
```
    Updates the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to insert.
  - updateInTx
```
public void updateInTx(T... entities)
```
    Updates the given entities in the database using a transaction.
    
    Parameters:
    entities - The entities to update.
  - assertSinglePk
```
protected void assertSinglePk()
```
  - count
```
public long count()
```
  - getKeyVerified
```
protected K getKeyVerified(T entity)
```
    See getKey(Object), but guarantees that the returned key is never null (throws if null).
  - getDatabase
```
public android.database.sqlite.SQLiteDatabase getDatabase()
```
    Gets the SQLiteDatabase for custom database access. Not needed for greenDAO entities.
  - readEntity
```
protected abstract T readEntity(android.database.Cursor cursor,
           int offset)
```
    Reads the values from the current position of the given cursor and returns a new entity.
  - readKey
```
protected abstract K readKey(android.database.Cursor cursor,
        int offset)
```
    Reads the key from the current position of the given cursor, or returns null if there's no single-value key.
  - readEntity
```
protected abstract void readEntity(android.database.Cursor cursor,
              T entity,
              int offset)
```
    Reads the values from the current position of the given cursor into an existing entity.
  - bindValues
```
protected abstract void bindValues(android.database.sqlite.SQLiteStatement stmt,
              T entity)
```
    Binds the entity's values to the statement. Make sure to synchronize the statement outside of the method.
  - updateKeyAfterInsert
```
protected abstract K updateKeyAfterInsert(T entity,
                     long rowId)
```
    Updates the entity's key if possible (only for Long PKs currently). This method must always return the entity's key regardless of whether the key existed before or not.
  - getKey
```
protected abstract K getKey(T entity)
```
    Returns the value of the primary key, if the entity has a single primary key, or, if not, null. Returns null if entity is null.
  - isEntityUpdateable
```
protected abstract boolean isEntityUpdateable()
```
    Returns true if the Entity class can be updated, e.g. for setting the PK after insert.

Class AbstractDao<T,K>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

db

config

identityScope

identityScopeLong

statements

session

pkOrdinal

Constructor Detail

AbstractDao

AbstractDao

Method Detail

getSession

getTablename

getProperties

getPkProperty

getAllColumns

getPkColumns

getNonPkColumns

load

loadByRowId

loadUniqueAndCloseCursor

loadUnique

loadAll

detach

loadAllAndCloseCursor

insertInTx

insertInTx

insertInTx

insertOrReplaceInTx

insertOrReplaceInTx

insertOrReplaceInTx

insert

insertWithoutSettingPk

insertOrReplace

updateKeyAfterInsertAndAttach

loadAllFromCursor

loadCurrent

loadCurrentOther

queryRaw

queryRawCreate

queryRawCreateListArgs

deleteAll

delete

deleteByKey

deleteInTx

deleteInTx

deleteByKeyInTx

deleteByKeyInTx

refresh

update

queryBuilder

updateInsideSynchronized

attachEntity

attachEntity

updateInTx

updateInTx

assertSinglePk

count

getKeyVerified

getDatabase

readEntity

readKey

readEntity

bindValues

updateKeyAfterInsert

getKey

isEntityUpdateable