【Android】ListViewのCheckBoxにデータベースのデータをバインドする方法

はじめに

この記事では、データベースから取得したデータを、AndroidアプリのListView内に配置したCheckBox（チェックボックス）にバインドする方法を、実際のコード例をもとにステップごとに解説します。サンプルでは、Androidのバージョンコードネームの一覧をリスト形式で表示し、各行のチェックボックスで選択状態を切り替えられるようにします。

ステップ1：新規プロジェクトを作成する

Android Studioを起動し、メニューから「File」⇒「New Project」を選択して、新しいプロジェクトを作成します。必要な項目をすべて入力し、プロジェクトのセットアップを完了させてください。

ステップ2：activity_main.xml を編集する

res/layout/activity_main.xml に以下のコードを追加します。画面全体をConstraintLayoutで構成し、その中にListViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        tools:ignore="MissingConstraints" />
</androidx.constraintlayout.widget.ConstraintLayout>

ステップ3：row_item.xml を作成する

res/layout/row_item.xml に以下のコードを追加します。このレイアウトはListViewの各行の見た目を定義するもので、左側に項目名を表示するTextView、右側にCheckBoxを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:padding="10dp"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <TextView
        android:id="@+id/txtName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_alignParentStart="true"
        android:layout_centerVertical="true"
        android:textSize="16sp" />
    <CheckBox
        android:id="@+id/checkBox"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentEnd="true"
        android:layout_alignParentRight="true"
        android:layout_alignParentTop="true" />
</RelativeLayout>

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

src/MainActivity.java に以下のコードを追加します。ここではDataModelオブジェクトのリストを作成し、カスタムアダプターを介してListViewにセットしています。さらに、行をタップするとその項目のチェック状態が切り替わるように、OnItemClickListenerも設定しています。

package com.app.sample;
import androidx.appcompat.app.AppCompatActivity;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import java.util.ArrayList;
import android.os.Bundle;
public class MainActivity extends AppCompatActivity {
    ArrayList dataModels;
    ListView listView;
    private CustomAdapter adapter;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = (ListView) findViewById(R.id.listView);
        dataModels = new ArrayList();
        dataModels.add(new DataModel("Apple Pie", false));
        dataModels.add(new DataModel("Banana Bread", false));
        dataModels.add(new DataModel("Cupcake", false));
        dataModels.add(new DataModel("Donut", true));
        dataModels.add(new DataModel("Eclair", true));
        dataModels.add(new DataModel("Froyo", true));
        dataModels.add(new DataModel("Gingerbread", true));
        dataModels.add(new DataModel("Honeycomb", false));
        dataModels.add(new DataModel("Ice Cream Sandwich", false));
        dataModels.add(new DataModel("Jelly Bean", false));
        dataModels.add(new DataModel("Kitkat", false));
        dataModels.add(new DataModel("Lollipop", false));
        dataModels.add(new DataModel("Marshmallow", false));
        dataModels.add(new DataModel("Nougat", false));
        adapter = new CustomAdapter(dataModels, getApplicationContext());
        listView.setAdapter(adapter);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView parent, View view, int position, long id) {
                DataModel dataModel= (DataModel) dataModels.get(position);
                dataModel.checked = !dataModel.checked;
                adapter.notifyDataSetChanged();
            }
        });
    }
}

ステップ5：DataModel.java を作成する

src/DataModel.java に以下のコードを追加します。このクラスは、表示する項目名（name）とチェック状態（checked）を保持する、シンプルなデータモデルです。

package com.app.sample;
public class DataModel {
    public String name;
    boolean checked;
    DataModel(String name, boolean checked) {
        this.name = name;
        this.checked = checked;
    }
}

ステップ6：CustomAdapter.java を作成する

src/CustomAdapter.java に以下のコードを追加します。ArrayAdapterを継承したカスタムアダプターで、ViewHolderパターンを採用することにより、リストスクロール時のパフォーマンス低下を抑えています。getView()メソッド内で、各項目の名前とチェック状態をビューに反映させます。

package com.app.sample;
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.CheckBox;
import android.widget.TextView;
import androidx.annotation.NonNull;
import java.util.ArrayList;
public class CustomAdapter extends ArrayAdapter{
    private ArrayList dataSet;
    Context mContext;
    // View lookup cache
    private static class ViewHolder {
        TextView txtName;
        CheckBox checkBox;
    }
    public CustomAdapter(ArrayList data, Context context) {
        super(context, R.layout.row_item, data);
        this.dataSet = data;
        this.mContext = context;
    }
    @Override
    public int getCount() {
        return dataSet.size();
    }
    @Override
    public DataModel getItem(int position) {
        return (DataModel) dataSet.get(position);
    }
    @Override
    public View getView(int position, View convertView, @NonNull ViewGroup parent){
        ViewHolder viewHolder;
        final View result;
        if (convertView == null) {
            viewHolder = new ViewHolder();
            convertView = LayoutInflater.from(parent.getContext()).inflate(R.layout.row_item, parent, false);
            viewHolder.txtName = (TextView) convertView.findViewById(R.id.txtName);
            viewHolder.checkBox = (CheckBox) convertView.findViewById(R.id.checkBox);
            result=convertView;
            convertView.setTag(viewHolder);
        } else {
            viewHolder = (ViewHolder) convertView.getTag();
            result=convertView;
        }
        DataModel item = getItem(position);
        viewHolder.txtName.setText(item.name);
        viewHolder.checkBox.setChecked(item.checked);
        return result;
    }
}

ステップ7：AndroidManifest.xml を確認する

Manifests/AndroidManifest.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.app.sample">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行してみよう

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