Android : 안드로이드에서 SQLite DB 사용하기

1. SQLiteOpenHelper Class
   1. SQLite DB를 사용하기 위해서는 일단 이 클래스를 상속하여 구현해야 한다.
   2. 이 클래스는 DB 생성하고 버전 관리를 하는 클래스이다. 그러므로 DB생성을 위해 필요하다.
   3. 따라서 이 클래스의 멤버함수인 onCreate(SQLiteDatabase), onUpgrade(SQLiteDatabase, int, int) 함수를 오버라이딩 해야 한다.
   4. 즉 이 클래스는 DB가 있으면 열고, 없으면 새로 만든다. 또한 필요하면 DB를 업그레이드 한다.
   5. 이 클래스를 생성할 때는 생성자에 Context 클래스가 필요하며, Activity Class 가 바로 컨텍스트 클래스를 구현한 것이므로 , Activity Class를 구현한 this 를 넘겨준다.
2. SQLiteDatabase Class
   1. 이 클래스는 create, delete, execute SQL commands 메소드를 가지고 있다.
   2. 따라서 기본적인 쿼리부터 DB를 관리하는 메소드가 있다.
   3. 대표적인 메소드가 insert(), delete, query, execSQL() 등 이다.
   4. 이 클래스를 얻기 위해서는 위의 헬퍼 클래스를 생성하여 getWritableDatabase() 메소드를 통해 얻고,
   5. 이 클래스는 위의 SQLiteOpenHelper 클래스의 onCreate, onUpgrade 에서 파라미터로 사용된다.
3. Cursor Interface
   1. 이 인터페이스는 DB 쿼리로부터의 결과 셋에 랜덤으로 read, write 하는 기능을 제공한다.
   2. 즉, DB쿼리 결과로 이 커서를 받고, 이 커서의 메소드인 getString() 등을 이용해서 key 값(컬럼명)을 넘겨주고, 매칭되는 값(해당 데이터)을 추출한다.
   3. 또한 SimpleCursorAdapter 와 같은 클래스의 생성자에 넘겨주어, 레이아웃에 DB쿼리의 결과값을 매칭 시켜 보여줄 수 있도록 한다.
4. 아래는 안드로이드 개발자 페이지의 샘플 프로그램인 노트패드 예제에서의 사용법

    

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; } }