Androidのデータベース「SQLite」の使い方は？
今回は、以下の記事の続編になります。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 SQLiteOpenHelper編
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 行の追加・更新・削除編
これまで、データベースのオープンと、レコードの追加・更新・削除についての説明をしました。
今回は、SQLでいうselect文、レコードの検索について説明していきます。
一概にはいえませんが、データベースを取り扱う上で、コード的には最も実装する場面が多いのが、このselectじゃないかなと思います。
これから示すサンプルコードでは、「Androidアプリのデータ保存方法の一つ「SQLite」の使い方 SQLiteOpenHelper編で掲載しているサンプルコードにて、既にSQLiteDatabase型インスタンスを生成しているものとします。
変数名は、sdbとします。
なお、テーブル定義は、テーブル名は「bookmarklist」で、_id列とbookmark列の2列が存在する事とします。
※_id列については、別記事「Androidアプリで使用するSQLiteのテーブル作成時の注意点」を参照してください。
レコードの検索を行った後、検索結果は、Cursorというインスタンスとして返されてきます。
このCursorインスタンスの取得方法は、大きく2通りありますので、まずはその方法を紹介します。
SQLiteDatabase.query()の使い方
まずは一つ目の、SQLiteDatabase.query()メソッドの使い方を説明します。
final String[] columns = new String[]{“_id”,”bookmark”};
String where = “bookmark like ?”;
String param = “%android%”;
Cursor c =
sdb.query(“bookmarklist”,columns,where,new String[]{param},
null,null,”_id desc”,”10″);
SQLiteDatabase.query()メソッドの第一引数はテーブル名です。
第二引数は、取得する列名(カラム名、フィールド名)の配列を指定します。
第三引数、第四引数は取得するレコードの条件を指定します。
今回は、bookmark列の文字列に、「android」という文言が含まれる文字列、という条件にしています。
第五引数は、group by句を指定します。
第六引数は、Having句を指定します。
第七引数は、order by句を指定します。
第八引数は、limit句(取得するレコードの上限数)を指定します。
使わない場合は、nullを指定します。
今回の処理をSQL文で表現すると、以下のようになります。
select _id,bookmark
from bookmarklist
where bookmark like ‘%android%’
order by _id desc
limit 10
Cursorオブジェクトの操作方法は後述します。
SQLiteDatabase.rawQuery()の使い方
それでは次は、rawQuery()メソッドの使い方を説明します。
rawQuery()メソッドは、文字通り、生のクエリを使用します。
String sqlstr = “select _id,bookmark ” +
”from bookmarklist ” +
”where bookmark like ‘%android%’ ” +
”order by _id desc ” +
”limit 10″;
Cursor c = sdb.rawQuery(sqlstr);
SQLiteDatabase.rawQuery()メソッドの引数は、SQL文です。
個人的には、先ほどのquery()メソッドより使いやすいと思うんですが、どうでしょうか。
query()メソッドは、どの引数に何のパラメータを与えればよかったんだっけ？といちいち調べないといけなさそうなのですが、rawQuery()メソッドは明確です。
それに、inner joinやleft outer join等を使って、複数テーブルを結合させるようなSQLだったら、このrawQuery()の方がいいでしょう。
好き好きかもしれませんが、Androidアプリで使われる程度のSQLは難しいとは思えませんので、生のSQLを実行できるrawQuery()の方が、可読性もいいのではないかと思います。
あくまで個人的にはですけど。
ちなみに、rawQuery()はselect文専用です。
insert、update、delete等は、execSQL()メソッドを使います。
詳しくは下記をご覧下さい。
Androidアプリのデータ保存方法の一つ「SQLite」の使い方 行の追加・更新・削除編
スポンサーリンク
それでは、次はCursorインスタンスの基本的な使い方を見ていきましょう。
Cursorインスタンスの使い方
基本的には、取得したレコードを最初から最後までループで回して何かをする、という用法になると思います。
例えば以下のようなサンプルコードを見てください。
//query()またはrawQuery()の実行
Cursor c = -省略-;
if(c.moveToFirst()){
do{
long id = c.getLong(c.getColumnIndex(“_id”));
String bookmark = c.getString(c.getColumnIndex(“bookmark”));
System.out.println(id + “:” + bookmark);
}while(c.moveToNext());
}
単純に取得した全レコードを標準出力で出力させているだけですが、上からみてみましょう。
まず、最初のif文ではCursor.moveToFirst()を実行していますね。
これは、取得した結果に対するカーソルを先頭に移動させる、という意味です。
成功したらtrueが返却されます。
その後の処理は、このmoveToFirst()が成功したら実行する、という事です。
ちなみに、取得したレコード件数が0件であった場合は、moveToFirst()の戻り値はfalseになります。
次は、後判定のループ処理となってますね。
Cursor.moveToNext()は、カーソルを次のレコードへ移動させる、という意味合いです。
このmoveToNext()の戻り値は、次のレコードがあればカーソルを移動させてtrueを戻します。
次のレコードが無ければfalseを返します。
ちなみに、後判定としているのは、一番最初のレコードの処理を行う為です。
レコードの内容を取り出す処理は、それぞれの列の型に合わせて、getLong()、getString()、getInt()等を使います。
引数は、カラムのインデックスで、要は何列目にあるのか？の数値です。
これは、列名を引数にして、getColumnIndex()で取得できます。
なんとも回りくどい仕様です・・・。
なぜ、引数に列名を指定しても取れるようにオーバーロードしてくれなかったの？と言いたいトコロです。
もちろん、インデックスがわかっていれば、メソッドを使わずにベタ書きでもいいですが、途中でテーブル定義を変えちゃっても正しく動作するように、今回のように実装しておいた方がいいのではないかなと思います。
JSPやサーブレットなどで、DBを使ったシステムの経験があれば難なく理解できるかと思います。
しかし、携帯組込みでは、データベースを取り扱うなんて今までは無かったかと思いますが、大体理解できましたでしょうか。