android.database.sqlite

Class SQLiteDatabase

java.lang.Object

android.database.sqlite.SQLiteClosable

android.database.sqlite.SQLiteDatabase

All Implemented Interfaces:

Closeable, AutoCloseable

public final class SQLiteDatabase
extends SQLiteClosable

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SQLiteDatabase.CursorFactory

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONFLICT_ABORT
static int	CONFLICT_FAIL
static int	CONFLICT_IGNORE
static int	CONFLICT_NONE
static int	CONFLICT_REPLACE
static int	CONFLICT_ROLLBACK
static int	CREATE_IF_NECESSARY
static int	ENABLE_WRITE_AHEAD_LOGGING
static int	MAX_SQL_CACHE_SIZE
static int	NO_LOCALIZED_COLLATORS
static int	OPEN_READONLY
static int	OPEN_READWRITE
static int	SQLITE_MAX_LIKE_PATTERN_LENGTH

Method Summary

Modifier and Type	Method and Description
void	beginTransaction()
void	beginTransactionNonExclusive()
void	beginTransactionWithListener(SQLiteTransactionListener transactionListener)
void	beginTransactionWithListenerNonExclusive(SQLiteTransactionListener transactionListener)
SQLiteStatement	compileStatement(String sql)
static SQLiteDatabase	create(SQLiteDatabase.CursorFactory factory)
int	delete(String table, String whereClause, String[] whereArgs)
static boolean	deleteDatabase(File file)
void	disableWriteAheadLogging()
boolean	enableWriteAheadLogging()
void	endTransaction()
void	execSQL(String sql)
void	execSQL(String sql, Object[] bindArgs)
protected void	finalize()
static String	findEditTable(String tables)
List<Pair<String,String>>	getAttachedDbs()
long	getMaximumSize()
long	getPageSize()
String	getPath()
Map<String,String>	getSyncedTables() Deprecated.
int	getVersion()
long	insert(String table, String nullColumnHack, ContentValues values)
long	insertOrThrow(String table, String nullColumnHack, ContentValues values)
long	insertWithOnConflict(String table, String nullColumnHack, ContentValues initialValues, int conflictAlgorithm)
boolean	inTransaction()
boolean	isDatabaseIntegrityOk()
boolean	isDbLockedByCurrentThread()
boolean	isDbLockedByOtherThreads() Deprecated.
boolean	isOpen()
boolean	isReadOnly()
boolean	isWriteAheadLoggingEnabled()
void	markTableSyncable(String table, String deletedTable) Deprecated.
void	markTableSyncable(String table, String foreignKey, String updateTable) Deprecated.
boolean	needUpgrade(int newVersion)
protected void	onAllReferencesReleased()
static SQLiteDatabase	openDatabase(String path, SQLiteDatabase.CursorFactory factory, int flags)
static SQLiteDatabase	openDatabase(String path, SQLiteDatabase.CursorFactory factory, int flags, DatabaseErrorHandler errorHandler)
static SQLiteDatabase	openOrCreateDatabase(File file, SQLiteDatabase.CursorFactory factory)
static SQLiteDatabase	openOrCreateDatabase(String path, SQLiteDatabase.CursorFactory factory)
static SQLiteDatabase	openOrCreateDatabase(String path, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)
Cursor	query(boolean distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit)
Cursor	query(boolean distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit, CancellationSignal cancellationSignal)
Cursor	query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy)
Cursor	query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit)
Cursor	queryWithFactory(SQLiteDatabase.CursorFactory cursorFactory, boolean distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit)
Cursor	queryWithFactory(SQLiteDatabase.CursorFactory cursorFactory, boolean distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit, CancellationSignal cancellationSignal)
Cursor	rawQuery(String sql, String[] selectionArgs)
Cursor	rawQuery(String sql, String[] selectionArgs, CancellationSignal cancellationSignal)
Cursor	rawQueryWithFactory(SQLiteDatabase.CursorFactory cursorFactory, String sql, String[] selectionArgs, String editTable)
Cursor	rawQueryWithFactory(SQLiteDatabase.CursorFactory cursorFactory, String sql, String[] selectionArgs, String editTable, CancellationSignal cancellationSignal)
static int	releaseMemory()
long	replace(String table, String nullColumnHack, ContentValues initialValues)
long	replaceOrThrow(String table, String nullColumnHack, ContentValues initialValues)
void	setForeignKeyConstraintsEnabled(boolean enable)
void	setLocale(Locale locale)
void	setLockingEnabled(boolean lockingEnabled) Deprecated.
long	setMaximumSize(long numBytes)
void	setMaxSqlCacheSize(int cacheSize)
void	setPageSize(long numBytes)
void	setTransactionSuccessful()
void	setVersion(int version)
String	toString()
int	update(String table, ContentValues values, String whereClause, String[] whereArgs)
int	updateWithOnConflict(String table, ContentValues values, String whereClause, String[] whereArgs, int conflictAlgorithm)
void	validateSql(String sql, CancellationSignal cancellationSignal)
boolean	yieldIfContended() Deprecated.
boolean	yieldIfContendedSafely()
boolean	yieldIfContendedSafely(long sleepAfterYieldDelay)

Methods inherited from class android.database.sqlite.SQLiteClosable

acquireReference, close, onAllReferencesReleasedFromContainer, releaseReference, releaseReferenceFromContainer

Methods inherited from class java.lang.Object

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

Field Detail

CONFLICT_ABORT

public static final int CONFLICT_ABORT

See Also:

Constant Field Values

CONFLICT_FAIL

public static final int CONFLICT_FAIL

See Also:

Constant Field Values

CONFLICT_IGNORE

public static final int CONFLICT_IGNORE

See Also:

Constant Field Values

CONFLICT_NONE

public static final int CONFLICT_NONE

See Also:

Constant Field Values

CONFLICT_REPLACE

public static final int CONFLICT_REPLACE

See Also:

Constant Field Values

CONFLICT_ROLLBACK

public static final int CONFLICT_ROLLBACK

See Also:

Constant Field Values

CREATE_IF_NECESSARY

public static final int CREATE_IF_NECESSARY

See Also:

Constant Field Values

ENABLE_WRITE_AHEAD_LOGGING

public static final int ENABLE_WRITE_AHEAD_LOGGING

See Also:

Constant Field Values

MAX_SQL_CACHE_SIZE

public static final int MAX_SQL_CACHE_SIZE

See Also:

Constant Field Values

NO_LOCALIZED_COLLATORS

public static final int NO_LOCALIZED_COLLATORS

See Also:

Constant Field Values

OPEN_READONLY

public static final int OPEN_READONLY

See Also:

Constant Field Values

OPEN_READWRITE

public static final int OPEN_READWRITE

See Also:

Constant Field Values

SQLITE_MAX_LIKE_PATTERN_LENGTH

public static final int SQLITE_MAX_LIKE_PATTERN_LENGTH

See Also:

Constant Field Values

Method Detail

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

onAllReferencesReleased

protected void onAllReferencesReleased()

Specified by:

onAllReferencesReleased in class SQLiteClosable

releaseMemory

public static int releaseMemory()

setLockingEnabled

@Deprecated
public void setLockingEnabled(boolean lockingEnabled)

Deprecated.

beginTransaction

public void beginTransaction()

beginTransactionNonExclusive

public void beginTransactionNonExclusive()

beginTransactionWithListener

public void beginTransactionWithListener(SQLiteTransactionListener transactionListener)

beginTransactionWithListenerNonExclusive

public void beginTransactionWithListenerNonExclusive(SQLiteTransactionListener transactionListener)

endTransaction

public void endTransaction()

setTransactionSuccessful

public void setTransactionSuccessful()

inTransaction

public boolean inTransaction()

isDbLockedByCurrentThread

public boolean isDbLockedByCurrentThread()

isDbLockedByOtherThreads

@Deprecated
public boolean isDbLockedByOtherThreads()

Deprecated.

yieldIfContended

@Deprecated
public boolean yieldIfContended()

Deprecated.

yieldIfContendedSafely

public boolean yieldIfContendedSafely()

yieldIfContendedSafely

public boolean yieldIfContendedSafely(long sleepAfterYieldDelay)

getSyncedTables

@Deprecated
public Map<String,String> getSyncedTables()

Deprecated.

openDatabase

public static SQLiteDatabase openDatabase(String path,
                                          SQLiteDatabase.CursorFactory factory,
                                          int flags)

openDatabase

public static SQLiteDatabase openDatabase(String path,
                                          SQLiteDatabase.CursorFactory factory,
                                          int flags,
                                          DatabaseErrorHandler errorHandler)

openOrCreateDatabase

public static SQLiteDatabase openOrCreateDatabase(File file,
                                                  SQLiteDatabase.CursorFactory factory)

openOrCreateDatabase

public static SQLiteDatabase openOrCreateDatabase(String path,
                                                  SQLiteDatabase.CursorFactory factory)

openOrCreateDatabase

public static SQLiteDatabase openOrCreateDatabase(String path,
                                                  SQLiteDatabase.CursorFactory factory,
                                                  DatabaseErrorHandler errorHandler)

deleteDatabase

public static boolean deleteDatabase(File file)

create

public static SQLiteDatabase create(SQLiteDatabase.CursorFactory factory)

getVersion

public int getVersion()

setVersion

public void setVersion(int version)

getMaximumSize

public long getMaximumSize()

setMaximumSize

public long setMaximumSize(long numBytes)

getPageSize

public long getPageSize()

setPageSize

public void setPageSize(long numBytes)

markTableSyncable

@Deprecated
public void markTableSyncable(String table,
                                           String deletedTable)

Deprecated.

markTableSyncable

@Deprecated
public void markTableSyncable(String table,
                                           String foreignKey,
                                           String updateTable)

Deprecated.

findEditTable

public static String findEditTable(String tables)

compileStatement

public SQLiteStatement compileStatement(String sql)
                                 throws SQLException

Throws:

SQLException

query

public Cursor query(boolean distinct,
                    String table,
                    String[] columns,
                    String selection,
                    String[] selectionArgs,
                    String groupBy,
                    String having,
                    String orderBy,
                    String limit)

query

public Cursor query(boolean distinct,
                    String table,
                    String[] columns,
                    String selection,
                    String[] selectionArgs,
                    String groupBy,
                    String having,
                    String orderBy,
                    String limit,
                    CancellationSignal cancellationSignal)

queryWithFactory

public Cursor queryWithFactory(SQLiteDatabase.CursorFactory cursorFactory,
                               boolean distinct,
                               String table,
                               String[] columns,
                               String selection,
                               String[] selectionArgs,
                               String groupBy,
                               String having,
                               String orderBy,
                               String limit)

queryWithFactory

public Cursor queryWithFactory(SQLiteDatabase.CursorFactory cursorFactory,
                               boolean distinct,
                               String table,
                               String[] columns,
                               String selection,
                               String[] selectionArgs,
                               String groupBy,
                               String having,
                               String orderBy,
                               String limit,
                               CancellationSignal cancellationSignal)

query

public Cursor query(String table,
                    String[] columns,
                    String selection,
                    String[] selectionArgs,
                    String groupBy,
                    String having,
                    String orderBy)

query

public Cursor query(String table,
                    String[] columns,
                    String selection,
                    String[] selectionArgs,
                    String groupBy,
                    String having,
                    String orderBy,
                    String limit)

rawQuery

public Cursor rawQuery(String sql,
                       String[] selectionArgs)

rawQuery

public Cursor rawQuery(String sql,
                       String[] selectionArgs,
                       CancellationSignal cancellationSignal)

rawQueryWithFactory

public Cursor rawQueryWithFactory(SQLiteDatabase.CursorFactory cursorFactory,
                                  String sql,
                                  String[] selectionArgs,
                                  String editTable)

rawQueryWithFactory

public Cursor rawQueryWithFactory(SQLiteDatabase.CursorFactory cursorFactory,
                                  String sql,
                                  String[] selectionArgs,
                                  String editTable,
                                  CancellationSignal cancellationSignal)

insert

public long insert(String table,
                   String nullColumnHack,
                   ContentValues values)

insertOrThrow

public long insertOrThrow(String table,
                          String nullColumnHack,
                          ContentValues values)
                   throws SQLException

Throws:

SQLException

replace

public long replace(String table,
                    String nullColumnHack,
                    ContentValues initialValues)

replaceOrThrow

public long replaceOrThrow(String table,
                           String nullColumnHack,
                           ContentValues initialValues)
                    throws SQLException

Throws:

SQLException

insertWithOnConflict

public long insertWithOnConflict(String table,
                                 String nullColumnHack,
                                 ContentValues initialValues,
                                 int conflictAlgorithm)

delete

public int delete(String table,
                  String whereClause,
                  String[] whereArgs)

update

public int update(String table,
                  ContentValues values,
                  String whereClause,
                  String[] whereArgs)

updateWithOnConflict

public int updateWithOnConflict(String table,
                                ContentValues values,
                                String whereClause,
                                String[] whereArgs,
                                int conflictAlgorithm)

execSQL

public void execSQL(String sql)
             throws SQLException

Throws:

SQLException

execSQL

public void execSQL(String sql,
                    Object[] bindArgs)
             throws SQLException

Throws:

SQLException

validateSql

public void validateSql(String sql,
                        CancellationSignal cancellationSignal)

isReadOnly

public boolean isReadOnly()

isOpen

public boolean isOpen()

needUpgrade

public boolean needUpgrade(int newVersion)

getPath

public final String getPath()

setLocale

public void setLocale(Locale locale)

setMaxSqlCacheSize

public void setMaxSqlCacheSize(int cacheSize)

setForeignKeyConstraintsEnabled

public void setForeignKeyConstraintsEnabled(boolean enable)

enableWriteAheadLogging

public boolean enableWriteAheadLogging()

disableWriteAheadLogging

public void disableWriteAheadLogging()

isWriteAheadLoggingEnabled

public boolean isWriteAheadLoggingEnabled()

getAttachedDbs

public List<Pair<String,String>> getAttachedDbs()

isDatabaseIntegrityOk

public boolean isDatabaseIntegrityOk()

toString

public String toString()

Overrides:

toString in class Object