AndroidのListViewで要素の存在を確認する方法を解説

この記事では、AndroidアプリのListViewにおいて、特定の要素がすでに存在するかどうかをチェックする方法を実例とともに紹介します。EditTextに入力された値がリスト内に重複していないかを検証し、存在しない場合のみリストに追加するという、実用的なデータバリデーションの手法を学べます。

手順1：Android Studioで新規プロジェクトを作成する

まず、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"
    android:orientation="vertical"
    android:gravity="center_horizontal"
    android:layout_marginTop="30dp"
    tools:context=".MainActivity">
    <EditText
        android:id="@+id/edit_query"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <Button
        android:id="@+id/buttonPanel"
        android:text="Check"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
    <ListView
        android:id="@+id/list"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">
    </ListView>
</LinearLayout>

上記のコードでは、EditText（テキスト入力欄）、Button（チェックボタン）、ListView（リスト表示エリア）の3つのUI要素を配置しています。ユーザーがEditTextに値を入力してボタンをタップすると、入力された値とListViewのアイテムとの照合（データバリデーション）が行われます。

手順3：MainActivity.javaにコードを追加する

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

package com.example.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;
import java.util.Arrays;

public class MainActivity extends AppCompatActivity {
    ListView list;
    String[] mobileArray = {"Android", "IPhone", "WindowsMobile", "Blackberry", "WebOS", "Ubuntu", "Windows7", "Max OS X"};
    EditText edit_query;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        edit_query = findViewById(R.id.edit_query);
        list = findViewById(R.id.list);
        final ArrayList<String> arrayList = new ArrayList<String>(Arrays.asList(mobileArray));
        findViewById(R.id.buttonPanel).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if(!edit_query.getText().toString().isEmpty()) {
                    if(arrayList.contains(edit_query.getText().toString())) {
                        Toast.makeText(MainActivity.this,"Already it is in list",Toast.LENGTH_LONG).show();
                    } else {
                       arrayList.add(edit_query.getText().toString());
                       ArrayAdapter adapter = new ArrayAdapter<String>(MainActivity.this,
                       android.R.layout.simple_list_item_1, arrayList);
                       list.setAdapter(adapter);
                    }
                }
            }
        });

        ArrayAdapter adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, arrayList);
        list.setAdapter(adapter);
    }
}

コードのポイント

このサンプルの核となるのは ArrayList の contains() メソッドです。ボタンがクリックされると、まず入力欄が空でないかを確認し、その後 arrayList.contains(入力値) を呼び出して要素の存在を判定します。

• 要素が存在する場合： Toastメッセージで「Already it is in list（すでにリストに存在します）」と表示し、重複登録を防ぎます。
• 要素が存在しない場合： 入力された値をArrayListに追加し、ArrayAdapterを通じてListViewの表示を更新します。

アプリを実行して動作を確認する

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

上記の結果では、新しい要素をListViewに追加した状態です。ここで、同じ値をもう一度入力してボタンを押すと、データバリデーションが働き、以下のように重複チェックのメッセージが表示されます。

まとめ

このように、ArrayList.contains() を使うことで、ListViewの要素に重複がないかを簡単にチェックできます。ユーザー入力のバリデーションやリスト管理の基本的なテクニックとして、さまざまなAndroidアプリ開発の場面で応用できるでしょう。