Android - An Open Handset Alliance Project

android.database.sqlite
public abstract class

android.database.sqlite.SQLiteOpenHelper

java.lang.Object
	android.database.sqlite.SQLiteOpenHelper

A helper class to manage database creation and version management. See the Notepad ContentProvider sample for example code.

Summary

Public Constructors

SQLiteOpenHelper()

Public Methods

abstract	void	onCreate(SQLiteDatabase db)
		Called when the database is created for the first time.
	void	onOpen(SQLiteDatabase db)
		Called when the database has been opened.
abstract	void	onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
		Called when the database needs to be upgraded.
	SQLiteDatabase	openDatabase(Context context, String name, CursorFactory factory, int newVersion)

Methods inherited from class java.lang.Object

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

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Details

Public Constructors

public SQLiteOpenHelper()

Public Methods

public abstract void onCreate(SQLiteDatabase db)

Called when the database is created for the first time. This is where the creation of tables and the initial population of the tables should happen.

Parameters

db	The database.

public void onOpen(SQLiteDatabase db)

Called when the database has been opened.

Parameters

db	The database.

public abstract void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)

Called when the database needs to be upgraded. The implementation should use this method to drop tables, add tables, or do anything else it needs to upgrade to the new database.

Parameters

db	The database.
oldVersion	The old database version.
newVersion	The new database version.

public SQLiteDatabase openDatabase(Context context, String name, CursorFactory factory, int newVersion)

Parameters

context	A context to use to open or create the database.
name	The name of the database to open.
factory	An optional factory class that is called to instantiate a cursor when the database is opened.
newVersion	The version of the database to open. If this is a new version (that is, newVersion is > the existing version number), then onUpgrade() will be called, and the implementation has the option to update the database.

Returns

Returns a SQLiteDatabase to use.

Android - An Open Handset Alliance Project

Documentation

Goodies

android.database.sqlite.SQLiteOpenHelper

Summary

Public Constructors

Public Methods

Methods inherited from class java.lang.Object

Details

Public Constructors

public SQLiteOpenHelper()

Public Methods

public abstract void onCreate(SQLiteDatabase db)

Parameters

public void onOpen(SQLiteDatabase db)

Parameters

public abstract void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)

Parameters

public SQLiteDatabase openDatabase(Context context, String name, CursorFactory factory, int newVersion)

Parameters

Returns


e.g. "intent" or "activity"