AndroidのSQLiteでWHERE句を使ってデータを抽出する方法【サンプルコード付き】

AndroidにおけるSQLiteとは

例に入る前に、まずAndroidにおけるSQLiteデータベースについて簡単に確認しておきましょう。SQLiteは、デバイス上のテキストファイルにデータを保存するオープンソースのSQLデータベースです。Androidには標準でSQLiteの実装が組み込まれており、リレーショナルデータベースの機能をすべてサポートしています。

また、このデータベースへアクセスする際、JDBCやODBCのように接続を確立する必要はありません。非常にシンプルに扱えるのが特徴です。

本記事では、AndroidのSQLiteでWHERE句を使用し、条件に一致するデータだけを抽出する方法を、実際のサンプルアプリのコードとともにステップごとに解説します。

実装の手順

ステップ1：新規プロジェクトの作成

まずはAndroid Studioで新しいプロジェクトを作成します。メニューから「File」→「New Project」を選択し、必要な項目を入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）の編集

次に、res/layout/activity_main.xml に以下のコードを追加します。

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
   xmlns:tools = "https://schemas.android.com/tools"
   android:layout_width = "match_parent"
   android:layout_height = "match_parent"
   tools:context = ".MainActivity"
   android:orientation = "vertical">
   <EditText
      android:id = "@+id/name"
      android:layout_width = "match_parent"
      android:hint = "Enter Name"
      android:layout_height = "wrap_content" />
   <EditText
      android:id = "@+id/salary"
      android:layout_width = "match_parent"
      android:inputType = "numberDecimal"
      android:hint = "Enter Salary"
      android:layout_height = "wrap_content" />
   <LinearLayout
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content"><Button
      android:id = "@+id/save"
      android:text = "Save"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content" />
   <Button
      android:id = "@+id/refresh"
      android:text = "Refresh"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content" />
   <ListView
      android:id = "@+id/listView"
      android:layout_width = "match_parent"
      android:layout_height = "wrap_content">
   </ListView>
</LinearLayout>

上記のコードでは、「名前」と「給与」を入力するためのEditTextを2つ配置しています。ユーザーが「Save」ボタンをタップすると、入力したデータがSQLiteデータベースに保存されます。また、データ挿入後に「Refresh」ボタンをタップすると、カーソルの内容をもとにListViewが更新される仕組みです。

ステップ3：MainActivity.java の実装

続いて、src/MainActivity.java に以下のコードを追加します。

package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
   Button save, refresh;
   EditText name, salary;
   private ListView listView;
   @Override
   protected void onCreate(Bundle readdInstanceState) {
      super.onCreate(readdInstanceState);
      setContentView(R.layout.activity_main);
      final DatabaseHelper helper = new DatabaseHelper(this);
      final ArrayList array_list = helper.getAllCotacts();
      name = findViewById(R.id.name);
      salary = findViewById(R.id.salary);
      listView = findViewById(R.id.listView);
      final ArrayAdapter arrayAdapter = new ArrayAdapter(MainActivity.this,       android.R.layout.simple_list_item_1, array_list);
      listView.setAdapter(arrayAdapter);
      findViewById(R.id.refresh).setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            array_list.clear();
            array_list.addAll(helper.getAllCotacts());
            arrayAdapter.notifyDataSetChanged();
            listView.invalidateViews();
            listView.refreshDrawableState();
         }
      });
      findViewById(R.id.save).setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            if (!name.getText().toString().isEmpty() && !salary.getText().toString().isEmpty()) {
               if (helper.insert(name.getText().toString(), salary.getText().toString())) {
                  Toast.makeText(MainActivity.this, "Inserted", Toast.LENGTH_LONG).show();
               } else {
                  Toast.makeText(MainActivity.this, "NOT Inserted", Toast.LENGTH_LONG).show();
               }
            } else {
               name.setError("Enter NAME");
               salary.setError("Enter Salary");
            }
         }
      });
   }
}

このアクティビティでは、保存ボタン押下時に名前と給与が空でないかをチェックし、問題がなければDatabaseHelper経由でデータを挿入します。更新ボタンでは、データベースから取得した最新の一覧をListViewに再描画しています。

ステップ4：DatabaseHelper.java の実装

最後に、src/DatabaseHelper.java に以下のコードを追加します。ここがWHERE句を使ったデータ抽出の中核となる部分です。

package com.example.andy.myapplication;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteException;
import android.database.sqlite.SQLiteOpenHelper;
import java.io.IOException;
import java.util.ArrayList;
class DatabaseHelper extends SQLiteOpenHelper {
   public static final String DATABASE_NAME = "salaryDatabase3";
   public static final String CONTACTS_TABLE_NAME = "SalaryDetails";
   public DatabaseHelper(Context context) {
      super(context,DATABASE_NAME,null,1);
   }
   @Override
   public void onCreate(SQLiteDatabase db) {
      try {
         db.execSQL(
            "create table "+ CONTACTS_TABLE_NAME +"(id INTEGER PRIMARY KEY, name text,salary text )"
         );
      } catch (SQLiteException e) {
         try {
            throw new IOException(e);
         } catch (IOException e1) {
            e1.printStackTrace();
         }
      }
   }
   @Override
   public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
      db.execSQL("DROP TABLE IF EXISTS "+CONTACTS_TABLE_NAME);
      onCreate(db);
   }
   public boolean insert(String s, String s1) {
      SQLiteDatabase db = this.getWritableDatabase();
      ContentValues contentValues = new ContentValues();
      contentValues.put("name", s);
      contentValues.put("salary", s1);
      db.insert(CONTACTS_TABLE_NAME, null, contentValues);
      return true;
   }
   public ArrayList getAllCotacts() {
      SQLiteDatabase db = this.getReadableDatabase();
      ArrayList<String> array_list = new ArrayList<String>();
      Cursor res = db.rawQuery( "select * from "+CONTACTS_TABLE_NAME+" WHERE name = 'Me'", null );
      res.moveToFirst();
      while(res.isAfterLast() = = false) {
         array_list.add(res.getString(res.getColumnIndex("name")));
         res.moveToNext();
      }
      return array_list;
   }
}

注目すべきは getAllCotacts() メソッド内の rawQuery() です。SELECT文に WHERE name = 'Me' という条件を付けることで、「Me」という名前に一致するレコードのみを取得しています。これがSQLiteにおけるWHERE句の基本的な使い方です。

アプリの実行と結果の確認

それではアプリケーションを実行してみましょう。ここでは、実際のAndroidスマートフォンがパソコンに接続されているものとして説明します。Android Studioからアプリを起動するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。表示された選択肢から自分のモバイルデバイスを選ぶと、端末に以下のデフォルト画面が表示されます。

実行結果を見ると、ListViewには「Me」という名前だけが表示されています。これは、SELECTコマンドにWHERE句を指定しているため、名前が「Me」であるレコードだけがフィルタリングされて抽出されるからです。

このように、WHERE句を活用することで、大量のデータの中から特定の条件に合致するレコードだけを効率よく取り出すことができます。条件値を変数化したい場合は、? プレースホルダーとselectionArgsを併用すると、SQLインジェクション対策にもなり安全です。ぜひ応用してみてください。