android.lib.database

Class DatabaseOpenHelper

java.lang.Object

android.database.sqlite.SQLiteOpenHelper

android.lib.database.DatabaseOpenHelper

public class DatabaseOpenHelper
extends android.database.sqlite.SQLiteOpenHelper

Handles database table creation.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Class<?>[]	tables The tables of the database to create in onCreate(SQLiteDatabase).

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DatabaseOpenHelper(android.content.Context context, java.lang.String name, int version, java.lang.Class<?>... tables) Creates a new instance of DatabaseOpenHelper by invoking its super-class SQLiteOpenHelper, and optionally stores the given tables for database table creation when onCreate(SQLiteDatabase) is called.

Method Summary

Methods

Modifier and Type	Method and Description
static DatabaseOpenHelper	newInstance(android.content.Context context, java.lang.Class<?>... tables) Creates a new instance of DatabaseOpenHelper.
static DatabaseOpenHelper	newInstance(android.content.Context context, int version, java.lang.Class<?>... tables) Creates a new instance of DatabaseOpenHelper with the given version.
static DatabaseOpenHelper	newInstance(android.content.Context context, java.lang.String name, java.lang.Class<?>... tables) Creates a new instance of DatabaseOpenHelper with the given name.
static DatabaseOpenHelper	newInstance(android.content.Context context, java.lang.String name, int version, java.lang.Class<?>... tables) Creates a new instance of DatabaseOpenHelper with the given name and version.
void	onCreate(android.database.sqlite.SQLiteDatabase database)
void	onUpgrade(android.database.sqlite.SQLiteDatabase database, int oldVersion, int newVersion)

Methods inherited from class android.database.sqlite.SQLiteOpenHelper

close, getDatabaseName, getReadableDatabase, getWritableDatabase, onConfigure, onDowngrade, onOpen, setWriteAheadLoggingEnabled

Methods inherited from class java.lang.Object

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

Field Detail

tables

protected final java.lang.Class<?>[] tables

The tables of the database to create in onCreate(SQLiteDatabase).

Constructor Detail

DatabaseOpenHelper

protected DatabaseOpenHelper(android.content.Context context,
                  java.lang.String name,
                  int version,
                  java.lang.Class<?>... tables)

Creates a new instance of DatabaseOpenHelper by invoking its super-class SQLiteOpenHelper, and optionally stores the given tables for database table creation when onCreate(SQLiteDatabase) is called.

Parameters:

context - the context to use to open or create the database

name - the file name of the database file, or null for an in-memory database

version - the version number of the database (starting at 1); if the database is older, onUpgrade(SQLiteDatabase, int, int) will be used to upgrade the database; if the database is newer, SQLiteOpenHelper.onDowngrade(SQLiteDatabase, int, int) will be used to downgrade the database

tables - the tables of the database to create in onCreate(SQLiteDatabase). For subsequent call, tables can be null.

Method Detail

newInstance

public static DatabaseOpenHelper newInstance(android.content.Context context,
                             java.lang.String name,
                             int version,
                             java.lang.Class<?>... tables)

Creates a new instance of DatabaseOpenHelper with the given name and version.

Parameters:

context - the context to use to open or create the database

name - the file name of the database file, or null for an in-memory database

version - the version number of the database (starting at 1); if the database is older, onUpgrade(SQLiteDatabase, int, int) will be used to upgrade the database; if the database is newer, SQLiteOpenHelper.onDowngrade(SQLiteDatabase, int, int) will be used to downgrade the database

tables - the tables of the database to create in onCreate(SQLiteDatabase). For subsequent call, tables can be null.

newInstance

public static DatabaseOpenHelper newInstance(android.content.Context context,
                             int version,
                             java.lang.Class<?>... tables)

Creates a new instance of DatabaseOpenHelper with the given version.

The application package name will be used as the name of the database.

Parameters:

context - the context to use to open or create the database

version - the version number of the database (starting at 1); if the database is older, onUpgrade(SQLiteDatabase, int, int) will be used to upgrade the database; if the database is newer, SQLiteOpenHelper.onDowngrade(SQLiteDatabase, int, int) will be used to downgrade the database

tables - the tables of the database to create in onCreate(SQLiteDatabase). For subsequent call, tables can be null.

newInstance

public static DatabaseOpenHelper newInstance(android.content.Context context,
                             java.lang.String name,
                             java.lang.Class<?>... tables)

Creates a new instance of DatabaseOpenHelper with the given name.

The application version code will be used as the database version.

Parameters:

context - the context to use to open or create the database

name - the file name of the database file, or null for an in-memory database

tables - the tables of the database to create in onCreate(SQLiteDatabase). For subsequent call, tables can be null.

newInstance

public static DatabaseOpenHelper newInstance(android.content.Context context,
                             java.lang.Class<?>... tables)

Creates a new instance of DatabaseOpenHelper.

The application package name and version code will be used as the name and version of the database respectively.

Parameters:

context - the context to use to open or create the database

tables - the tables of the database to create in onCreate(SQLiteDatabase). For subsequent call, tables can be null.

onCreate

public void onCreate(android.database.sqlite.SQLiteDatabase database)

Specified by:

onCreate in class android.database.sqlite.SQLiteOpenHelper

onUpgrade

public void onUpgrade(android.database.sqlite.SQLiteDatabase database,
             int oldVersion,
             int newVersion)

Specified by:

onUpgrade in class android.database.sqlite.SQLiteOpenHelper