【Android】SQLiteのWHERE句とIN演算子でデータを絞り込む方法

はじめに：AndroidにおけるSQLiteとは

具体的な実装例に入る前に、まずAndroidにおけるSQLiteデータベースについて簡単に確認しておきましょう。SQLiteはオープンソースのSQLデータベースエンジンで、端末内のテキストファイルとしてデータを保存します。Androidには標準でSQLiteの実装が組み込まれており、リレーショナルデータベースの基本的な機能をすべて利用できます。

また、SQLiteへのアクセスにはJDBCやODBCのような接続設定が一切不要です。アプリから直接データベースファイルを読み書きできるため、ローカルでのデータ永続化に最適です。

本記事では、WHERE句とIN演算子を使ってSQLiteのデータを条件で絞り込む方法を、実際のサンプルコードとともに段階的に解説していきます。

今回作成するサンプルアプリの概要

このサンプルでは、ユーザーが入力した「名前」と「給与」をSQLiteデータベースに保存し、「Refresh（更新）」ボタンを押すと、給与が10または10000のレコードだけをIN演算子で抽出してListViewに表示します。

ステップ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" />
    </LinearLayout>

    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </ListView>
</LinearLayout>

このレイアウトでは、名前と給与を入力するためのEditTextを2つ配置しています。「Save」ボタンをタップすると入力内容がSQLiteデータベースに保存され、「Refresh」ボタンをタップするとIN演算子を使ったクエリ結果で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に表示しています。「Save」ボタンでは未入力チェックを行い、名前・給与の両方が入力されていればデータを挿入し、Toastで結果を通知します。

ステップ4：DatabaseHelper.java を実装する

src/DatabaseHelper.java に以下のコードを追加します。ここが本記事のポイントとなる部分です。

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 salary IN ( '10', '10000' )", null );
        res.moveToFirst();

        while(res.isAfterLast() == false) {
            array_list.add(res.getString(res.getColumnIndex("name")));
            res.moveToNext();
        }
        return array_list;
    }
}

ポイント：IN演算子による絞り込み

注目すべきは getAllCotacts() メソッド内の次のSQL文です。

select * from SalaryDetails WHERE salary IN ('10', '10000')

IN演算子は、カッコ内に列挙した複数の値のいずれかに該当するレコードを一括で取得できる便利な構文です。OR条件を複数つなぐよりも可読性が高く、値の数が増えても簡潔に書けるのが特徴です。ここでは給与が「10」または「10000」のレコードだけを抽出し、その名前をCursorから順番に読み取ってArrayListに格納しています。

アプリを実行してみよう

それでは実際にアプリを動かしてみましょう。実機のAndroidスマートフォンをパソコンに接続していることを前提とします。Android Studioでプロジェクト内の任意のアクティビティファイルを開き、ツールバーのRunアイコンをクリックしてください。接続中のモバイルデバイスを選択して実行すると、スマートフォン側にアプリの初期画面が表示されます。

上記の実行結果のように、いくつかのデータを登録した後「Refresh」ボタンを押すと、給与が10〜10000の範囲に該当する値を持つ人物の名前だけがListViewに表示されます。これにより、WHERE句とIN演算子を組み合わせたデータ抽出が正しく動作していることが確認できます。

まとめ

今回は、AndroidのSQLiteデータベースにおいて、WHERE句とIN演算子を組み合わせて特定の条件に一致する複数の値を効率よく抽出する方法を解説しました。rawQueryでSQLを直接記述するだけでなく、selectionArgs（プレースホルダー）を使えば安全に動的な値を渡すこともできますので、応用としてぜひ試してみてください。