【Android】SQLiteへのデータ挿入後にListViewを更新する方法を徹底解説

AndroidにおけるSQLiteデータベースとは

具体的な例を見ていく前に、AndroidにおけるSQLiteデータベースの基本をおさらいしておきましょう。SQLiteはオープンソースのSQLデータベースで、デバイス上のテキストファイルにデータを保存する仕組みです。AndroidにはSQLiteの実装が標準で組み込まれており、リレーショナルデータベースの主要な機能をすべて利用できます。また、JDBCやODBCのような接続設定を一切行うことなく、手軽にデータベースへアクセスできるのも大きな特徴です。

本記事では、AndroidのSQLiteに値を挿入した後に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" />
    <ListView
        android:id = "@+id/listView"
        android:layout_width = "match_parent"
        android:layout_height = "wrap_content">
    </ListView>
</LinearLayout>

このレイアウトでは、「名前」と「給与」を入力するためのEditTextを2つ配置しています。ユーザーが「Save」ボタンをタップすると、入力内容がSQLiteデータベースに保存され、その後「Refresh」ボタンをタップすると、Cursorから取得した最新データで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から全データを取得し、ArrayAdapter経由でListViewに表示します。
• 「Refresh」ボタンを押すと、リストを一旦クリアしてからデータベースの全レコードを再取得し、notifyDataSetChanged()でアダプターに変更を通知。さらにinvalidateViews()とrefreshDrawableState()を呼び出すことで、ListViewが確実に再描画されます。
• 「Save」ボタンでは入力チェックを行い、名前と給与の両方に入力がある場合のみinsert()メソッドでデータベースへ登録し、成功・失敗の結果をToastで通知します。未入力の場合はsetError()によってエラーメッセージが表示されます。

ステップ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, null );
        res.moveToFirst();
        while(res.isAfterLast() = = false) {
            array_list.add(res.getString(res.getColumnIndex("name")));
            res.moveToNext();
        }
        return array_list;
    }
}

このヘルパークラスはSQLiteOpenHelperを継承しています。onCreate()で「SalaryDetails」テーブルを生成し、onUpgrade()では既存テーブルを削除したうえで再作成します。insert()メソッドはContentValuesを使ってデータを登録し、getAllCotacts()メソッドはrawQuery()で全レコードを検索して、名前の一覧をArrayListとして返す役割を担っています。

アプリの実行と動作確認

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

次に、EditTextに適当な値を入力し、「Save」ボタンをタップします。

最後に「Refresh」ボタンをタップすると、挿入されたデータが反映されたListViewが表示されます。これで、SQLiteへのデータ挿入後にリストをリアルタイムに更新する仕組みが完成です。