【Android開発】SQLiteデータベースを使ってデータを保存する方法をステップごとに解説

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

SQLiteは、デバイス上のテキストファイルにデータを保存できるオープンソースのSQLデータベースです。AndroidにはSQLiteが標準で組み込まれており、リレーショナルデータベースの主要な機能をすべてサポートしています。

最大の特徴は、JDBCやODBCのように接続設定を確立する必要がない点です。そのため、少ないコード量で簡単にデータの保存・読み出しが行えます。

この記事では、「名前」と「給与」を入力してSQLiteデータベースに保存するシンプルなサンプルアプリを通じて、具体的な実装方法をステップごとに解説します。

ステップ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 = "名前を入力"
        android:layout_height = "wrap_content" />
    <EditText
        android:id = "@+id/salary"
        android:layout_width = "match_parent"
        android:inputType = "numberDecimal"
        android:hint = "給与を入力"
        android:layout_height = "wrap_content" />
    <Button
        android:id = "@+id/save"
        android:text = "保存"
        android:layout_width = "wrap_content"
        android:layout_height = "wrap_content" />
</LinearLayout>

このコードでは、名前と給与を入力するためのEditTextを2つ配置しています。ユーザーが「保存」ボタンをタップすると、入力されたデータがSQLiteデータベースに書き込まれます。

ステップ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.Button;
import android.widget.EditText;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
    Button save;
    EditText name, salary;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        final DatabaseHelper helper = new DatabaseHelper(this);
        name = findViewById(R.id.name);
        salary = findViewById(R.id.salary);
        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, "保存しました", Toast.LENGTH_LONG).show();
                    } else {
                        Toast.makeText(MainActivity.this, "保存できませんでした", Toast.LENGTH_LONG).show();
                    }
                } else {
                    name.setError("名前を入力してください");
                    salary.setError("給与を入力してください");
                }
            }
        });
    }
}

このアクティビティでは、保存ボタンのクリックリスナー内で入力チェックを行い、両方のフィールドが空でなければDatabaseHelperのinsertメソッドを呼び出してデータを登録します。登録の成否はToastメッセージで通知され、未入力の場合はエラーメッセージが表示されます。

なお、新しいバージョンのAndroid Studioで作成したプロジェクトでは、インポート文が androidx.appcompat.app.AppCompatActivity になっている点に注意してください。

ステップ4：DatabaseHelper.java を作成する

src/DatabaseHelper.java という新しいクラスファイルを作成し、以下のコードを記述します。

package com.example.andy.myapplication;
import android.content.ContentValues;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
class DatabaseHelper extends SQLiteOpenHelper {
    public static final String DATABASE_NAME = "MyDBName";
    public static final String CONTACTS_TABLE_NAME = "SalaryDetails";
    public DatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, 1);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(
            "create table " + CONTACTS_TABLE_NAME + "(id integer primary key, name text, salary text)"
        );
    }
    @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;
    }
}

このクラスはSQLiteOpenHelperを継承しており、データベースの作成やバージョン管理を担当します。onCreateメソッドで「SalaryDetails」テーブルを作成し、onUpgradeメソッドでは既存テーブルを削除して再生成しています。insertメソッドではContentValuesオブジェクトを使ってカラム名と値を紐付け、テーブルへデータを挿入します。

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

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

次に、下の画像のように名前と給与の値を入力し、ボタンをタップします。

保存処理が正しく行われたかを確認するには、Android StudioのDevice File Explorerやadbコマンドでデータベースファイルの中身をチェックします。以下のように、入力したデータがテーブルに登録されていれば成功です。

まとめ

本記事では、SQLiteOpenHelperクラスを活用してAndroidアプリ内にSQLiteデータベースを構築し、EditTextに入力したデータを保存する基本的な流れを紹介しました。SQLiteは外部サーバーや複雑な接続設定が不要なため、小規模なローカルデータ管理に最適です。まずはこのサンプルをベースに、検索・更新・削除などの機能を追加して、データベース操作に慣れていくことをおすすめします。