Androidのデータベース「SQLite」の使い方は？
今回は、AndroidアプリからSQLiteを使用する際の、コードレベルでの使い方をみていきましょう。
長くなりそうなので、3記事に分けたいと思います。
今回は、SQLiteOpenHelperというクラスの使い方について触れたいと思います。
今回は、データベースのオープン処理の説明になります。
行の追加・更新・削除編は下記のページをご覧下さい。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 行の追加・更新・削除編
レコードの検索編は下記のページをご覧下さい。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 レコード検索編
まず、Androidでは、データの保存形式として、今回のSQLiteの他にも、「プリファレンス」「ローカルファイル」があります。以前にこれらの記事を書いています。
Androidアプリのデータ保存方法の一つ「プリファレンス」の使い方
Androidアプリのデータ保存方法の一つ「ローカルファイル」の使い方
まずは、この中から何を使ってデータを保持させるかを検討しましょう。
保存するデータ量が明らかに少なくて、プリファレンスで事足りるのであれば、プリファレンスで充分だと思います。
SQLiteは、同じような組み合わせのデータを複数保持させるような、例えば電話帳やブックマーク等のような感じでデータを保存させる場合に使うといいでしょう。
少し話しがそれました。それではSQLiteの使い方を見ていきます。
まず手始めに行う作業は、以下です。
SQLiteOpenHelperのサブクラスの実装
必須ではありませんが、SQLiteOpenHelperのサブクラスの実装を行います。
このクラスは、文字通り、データベースオープン時に使えば便利なクラスです。
HTTP通信や入出力ストリームと同じく、データベースを使用するときは、最初にオープン⇒読み取りや書込み⇒最後にクローズ、という手順を踏みます。
このクラスを使うと発生する利点は、以下のような点です。
・DBオープン時、もしテーブルが存在していないときはテーブル生成を行う事ができる。
・テーブルのバージョンアップが感知できる。
言葉で見てもよくわかりませんので、コードを見てみましょう。
例えば、以下のようなクラスを実装します。
class SubOpenHelper extends SQLiteOpenHelper{
public SubOpenHelper(Context c,String dbname,int version){
super(c,dbname,null,version);
}
public void onCreate(SQLiteDatabase db){
db.execSQL(“create table -省略-“);
}
public void onUpgrade(
SQLiteDatabase db,int oldVersion,int newVersion){
実装例
//現在のレコードを取得して、一旦メモリへ退避。
//テーブルの削除
//新しくテーブルを作り直して、
//メモリへ退避させたレコードを挿入する etc
}
}
スポンサーリンク
コンストラクタ
まずはコンストラクタを見ましょう。
スーパークラスのコンストラクタを呼び出してます。
第一引数は、Context型インスタンスです。
自身のアプリを示す場合は、getApplicationContext()を使って生成します。
第二引数は、DBファイル名です。
第四引数は、DBのバージョンで、作成するときに指定できます。
例えば、テーブルの仕様を変えた後であれば、この数値を上げてやる、という使い方が出来ます。
第3引数にはCursorFactory型インスタンスを渡すのですが、とりあえず普通に使う分には使わないのでnullでいいです。(私も良く知らないので、もし余力があれば調べて、別記事で紹介します。)
onCreateメソッド
このインスタンスを使ってデータベースをオープンする時に、もし指定されたデータベースが無い場合に、自動的に実行されるメソッドです。
ここでは、このデータベースで使用するテーブルのCreate文の発行を行えばよいでしょう。
その他、デフォルトで入れておきたいレコードがあれば挿入してやるなどの処理も行えます。
既にデータベースが存在しているときに、このインスタンスが生成されたとしても実行されません。
onUpgradeメソッド
データベースのバージョンが上がったときに自動的に実行されるメソッドです。
このインスタンスを使ってデータベースをオープンするときに、コンストラクタで渡したバージョンと、実際に存在しているデータベースのバージョンが違うときに呼び出され、古いバージョンの値と、新しいバージョンの値は引数としても渡されてきます。
サンプルコードでは、処理の実体を書いていませんが、例えば、テーブルの仕様を変えたという想定ですと、一旦データを取り出しておいてメモリに持たせておき、今のテーブルを消して、新しくテーブルを作り直して、取り出しておいたレコードをちゃんと挿入しなおす、という処理を行う事ができます。
不必要なら処理を書かなくてもいいですが、定義をしておかないとコンパイルが通りません。
こんな感じで、SQLiteOpenHelperを実装しておきます。
データベースのオープン処理
では、次は、データベースにテーブルを作ったり、レコードを挿入したり検索したりする前に、最初に行うべきデータベースのオープン処理をみてみましょう。
以下のようなコードになります。
SQLiteDatabase sdb;
SubOpenHelper helper =
new SubOpenHelper(getApplicationContext(),”test.db”,1);
try{
sdb = helper.getWritableDatabase();
//もしくは、
//sdb = helper.getReadableDatabase();
}catch(SQLiteException e){
//異常終了
return;
}
まずは、先ほど実装したSQLiteOpenHelperのサブクラスのインスタンスを生成します。
そして、そのインスタンスの、getWritableDatabase()メソッドを使って、データベースをオープンします。
読み取り専用でいいときは、getReadableDatabase()でも使用できます。
もし、getWritableDatabese()でデータベースをオープンしたとき、ディスクの容量が不足していると、SQLiteExceptionがスローされます。
この場合に、もし読み取り専用でいいから開きたい場合は、catch句の中にgetReadableDatabese()を記述してもいいです。
getWritableDatabase()、もしくはgetReadableDatabase()メソッドの戻り値SQLiteDatabase型インスタンスを使って、レコードの挿入や削除、検索を行っていきます。
今回はここまでとしまして、次回にその方法を紹介します。
レコードの追加、更新、削除に関しての記事は下記です。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 行の追加・更新・削除編
レコードの検索に関しての記事は下記です。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 レコード検索編