-
SQLiteOpenHelper Class
- SQLite DB를 사용하기 위해서는 일단 이 클래스를 상속하여 구현해야 한다.
- 이 클래스는 DB 생성하고 버전 관리를 하는 클래스이다. 그러므로 DB생성을 위해 필요하다.
- 따라서 이 클래스의 멤버함수인 onCreate(SQLiteDatabase), onUpgrade(SQLiteDatabase, int, int) 함수를 오버라이딩 해야 한다.
- 즉 이 클래스는 DB가 있으면 열고, 없으면 새로 만든다. 또한 필요하면 DB를 업그레이드 한다.
- 이 클래스를 생성할 때는 생성자에 Context 클래스가 필요하며, Activity Class 가 바로 컨텍스트 클래스를 구현한 것이므로 , Activity Class를 구현한 this 를 넘겨준다.
-
SQLiteDatabase Class
- 이 클래스는 create, delete, execute SQL commands 메소드를 가지고 있다.
- 따라서 기본적인 쿼리부터 DB를 관리하는 메소드가 있다.
- 대표적인 메소드가 insert(), delete, query, execSQL() 등 이다.
- 이 클래스를 얻기 위해서는 위의 헬퍼 클래스를 생성하여 getWritableDatabase() 메소드를 통해 얻고,
- 이 클래스는 위의 SQLiteOpenHelper 클래스의 onCreate, onUpgrade 에서 파라미터로 사용된다.
-
Cursor Interface
- 이 인터페이스는 DB 쿼리로부터의 결과 셋에 랜덤으로 read, write 하는 기능을 제공한다.
- 즉, DB쿼리 결과로 이 커서를 받고, 이 커서의 메소드인 getString() 등을 이용해서 key 값(컬럼명)을 넘겨주고, 매칭되는 값(해당 데이터)을 추출한다.
- 또한 SimpleCursorAdapter 와 같은 클래스의 생성자에 넘겨주어, 레이아웃에 DB쿼리의 결과값을 매칭 시켜 보여줄 수 있도록 한다.
-
아래는 안드로이드 개발자 페이지의 샘플 프로그램인 노트패드 예제에서의 사용법
package com.android.demo.notepad3;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;
/**
* Simple notes database access helper class. Defines the basic CRUD operations
* for the notepad example, and gives the ability to list all notes as well as
* retrieve or modify a specific note.
*
* This has been improved from the first version of this tutorial through the
* addition of better error handling and also using returning a Cursor instead
* of using a collection of inner classes (which is less scalable and not
* recommended).
*/
public class NotesDbAdapter {
public static final String KEY_TITLE = "title";
public static final String KEY_BODY = "body";
public static final String KEY_ROWID = "_id";
private static final String TAG = "NotesDbAdapter";
private DatabaseHelper mDbHelper;
private SQLiteDatabase mDb;
/**
* Database creation sql statement
*/
private static final String DATABASE_CREATE =
"create table notes (_id integer primary key autoincrement, "
+ "title text not null, body text not null);";
private static final String DATABASE_NAME = "data";
private static final String DATABASE_TABLE = "notes";
private static final int DATABASE_VERSION = 2;
private final Context mCtx;
private static class DatabaseHelper extends SQLiteOpenHelper {
DatabaseHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
@Override
public void onCreate(SQLiteDatabase db) {
db.execSQL(DATABASE_CREATE);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
Log.w(TAG, "Upgrading database from version " + oldVersion + " to "
+ newVersion + ", which will destroy all old data");
db.execSQL("DROP TABLE IF EXISTS notes");
onCreate(db);
}
}
/**
* Constructor - takes the context to allow the database to be
* opened/created
*
* @param ctx the Context within which to work
*/
public NotesDbAdapter(Context ctx) {
this.mCtx = ctx;
}
/**
* Open the notes database. If it cannot be opened, try to create a new
* instance of the database. If it cannot be created, throw an exception to
* signal the failure
*
* @return this (self reference, allowing this to be chained in an
* initialization call)
* @throws SQLException if the database could be neither opened or created
*/
public NotesDbAdapter open() throws SQLException {
mDbHelper = new DatabaseHelper(mCtx);
mDb = mDbHelper.getWritableDatabase();
return this;
}
public void close() {
mDbHelper.close();
}
/**
* Create a new note using the title and body provided. If the note is
* successfully created return the new rowId for that note, otherwise return
* a -1 to indicate failure.
*
* @param title the title of the note
* @param body the body of the note
* @return rowId or -1 if failed
*/
public long createNote(String title, String body) {
ContentValues initialValues = new ContentValues();
initialValues.put(KEY_TITLE, title);
initialValues.put(KEY_BODY, body);
return mDb.insert(DATABASE_TABLE, null, initialValues);
}
/**
* Delete the note with the given rowId
*
* @param rowId id of note to delete
* @return true if deleted, false otherwise
*/
public boolean deleteNote(long rowId) {
return mDb.delete(DATABASE_TABLE, KEY_ROWID + "=" + rowId, null) > 0;
}
/**
* Return a Cursor over the list of all notes in the database
*
* @return Cursor over all notes
*/
public Cursor fetchAllNotes() {
return mDb.query(DATABASE_TABLE, new String[] {KEY_ROWID, KEY_TITLE,
KEY_BODY}, null, null, null, null, null);
}
/**
* Return a Cursor positioned at the note that matches the given rowId
*
* @param rowId id of note to retrieve
* @return Cursor positioned to matching note, if found
* @throws SQLException if note could not be found/retrieved
*/
public Cursor fetchNote(long rowId) throws SQLException {
Cursor mCursor =
mDb.query(true, DATABASE_TABLE, new String[] {KEY_ROWID,
KEY_TITLE, KEY_BODY}, KEY_ROWID + "=" + rowId, null,
null, null, null, null);
if (mCursor != null) {
mCursor.moveToFirst();
}
return mCursor;
}
/**
* Update the note using the details provided. The note to be updated is
* specified using the rowId, and it is altered to use the title and body
* values passed in
*
* @param rowId id of note to update
* @param title value to set note title to
* @param body value to set note body to
* @return true if the note was successfully updated, false otherwise
*/
public boolean updateNote(long rowId, String title, String body) {
ContentValues args = new ContentValues();
args.put(KEY_TITLE, title);
args.put(KEY_BODY, body);
return mDb.update(DATABASE_TABLE, args, KEY_ROWID + "=" + rowId, null) > 0;
}
}