Android
 Computer >> コンピューター >  >> プログラミング >> Android

AndroidアプリでSQLiteデータベースを使う方法を徹底解説【CRUD実装の手順】

この記事では、AndroidアプリケーションでSQLiteデータベースを活用する方法を、実際のコード例とともに段階的に解説します。データの追加・一覧表示・更新・削除（CRUD操作）をすべて網羅したサンプルアプリを作成しながら、SQLiteの基本的な使い方をマスターしましょう。

全体の流れ

本チュートリアルでは、サッカー選手の名前と所属国を管理するシンプルなアプリを題材にします。主な構成要素は以下の通りです。

  • DatabaseHelper：SQLiteOpenHelperを継承し、データベースの作成・管理を行うクラス
  • DataBaseManager：データの挿入・取得・更新・削除を担当するクラス
  • MainActivity：登録済みレコードをListViewで一覧表示する画面
  • AddPlayerActivity：新規レコードを追加する画面
  • ModifyPlayerActivity：既存レコードを更新・削除する画面

ステップ1：新規プロジェクトの作成

Android Studioを起動し、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトを完成させてください。

ステップ2：メインレイアウトの作成

res/layout/activity_main.xml に以下のコードを追加します。レコードの一覧を表示するListViewと、リストが空のときに表示されるTextViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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:padding="8dp"
    tools:context=".MainActivity">
    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:dividerHeight="1dp"
        android:padding="10dp" >
    </ListView>
    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="" />
</RelativeLayout>

ステップ3：DataBaseManagerクラスの作成

次に、データベース操作を担うJavaクラス「DataBaseManager」を新規作成し、以下のコードを記述します。このクラスは、レコードの挿入（insert）、取得（fetch）、更新（update）、削除（delete）の各メソッドを提供します。

import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;
public class DataBaseManager {
private DatabaseHelper databaseHelper;
private Context context;
private SQLiteDatabase database;
DataBaseManager(Context c) {
    context = c;
    }
    DataBaseManager open() throws SQLException {
        databaseHelper = new DatabaseHelper(context);
        database = databaseHelper.getWritableDatabase();
        return this;
    }
    public void close() {
        databaseHelper.close();
    }
    void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESCRIPTION, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }
    Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESCRIPTION };
        Cursor cursor = database.query(DatabaseHelper.TABLE_NAME, columns, null, null, null, null, null);
    if (cursor != null) {
        cursor.moveToFirst();
    }
    return cursor;
}
public int update(long _id, String name, String desc) {
    ContentValues contentValues = new ContentValues();
    contentValues.put(DatabaseHelper.SUBJECT, name);
    contentValues.put(DatabaseHelper.DESCRIPTION, desc);
    return database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
}
public void delete(long _id) {
    database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
}

ステップ4：DatabaseHelperクラスの作成

続いて、SQLiteOpenHelperを継承した「DatabaseHelper」クラスを作成します。ここではデータベース名、テーブル名、カラム定義などを定数として宣言し、テーブルの生成処理をonCreate()メソッド内に実装しています。

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
class DatabaseHelper extends SQLiteOpenHelper {
    static final String TABLE_NAME = "FOOTBALLPLAYERS";
    static final String _ID = "_id";
    static final String SUBJECT = "subject";
    static final String DESCRIPTION = "description";
    private static final String DB_NAME = "PLAYER_COUNTRIES.DB";
    private static final int DB_VERSION = 1;
    private static final String CREATE_TABLE = "create table " + TABLE_NAME + "("
        + _ID + " INTEGER PRIMARY KEY AUTOINCREMENT, "
        + SUBJECT + " TEXT NOT NULL, " + DESCRIPTION + " TEXT);";
    DatabaseHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_TABLE);
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
        onCreate(db);
    }
}

ステップ5：MainActivityの実装

src/MainActivity.java に以下のコードを追加します。起動時にデータベースから全レコードを取得し、SimpleCursorAdapterを使ってListViewにバインドします。また、リスト項目をタップすると編集画面へ遷移する処理も実装しています。

import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.SimpleCursorAdapter;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
    DataBaseManager dataBaseManager;
    ListView listView;
    SimpleCursorAdapter adapter;
    final String[] from = new String[]{DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESCRIPTION};
    final int[] to = new int[]{R.id.id, R.id.title, R.id.desc};
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        Cursor cursor = dataBaseManager.fetch();
        listView = findViewById(R.id.listView);
        listView.setEmptyView(findViewById(R.id.textView));
        adapter = new SimpleCursorAdapter(this, R.layout.activity_view_record, cursor, from, to, 0);
        adapter.notifyDataSetChanged();
        listView.setAdapter(adapter);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long viewId) {
                TextView idTextView = view.findViewById(R.id.id);
                TextView titleTextView = view.findViewById(R.id.title);
                TextView descTextView = view.findViewById(R.id.desc);
                String id = idTextView.getText().toString();
                String title = titleTextView.getText().toString();
                String desc = descTextView.getText().toString();
                Intent modifyIntent = new Intent(getApplicationContext(), ModifyPlayerActivity.class);
                modifyIntent.putExtra("title", title);
                modifyIntent.putExtra("desc", desc);
                modifyIntent.putExtra("id", id);
                startActivity(modifyIntent);
            }
        });
    }
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        int id = item.getItemId();
        if (id == R.id.addRecord) {
            Intent addPlayer = new Intent(this, AddPlayerActivity.class);
            startActivity(addPlayer);
        }
        return super.onOptionsItemSelected(item);
    }
}

ステップ6：追加・編集用アクティビティの作成

次に、レコードの追加と編集を行う2つのアクティビティ（AddPlayerActivity と ModifyPlayerActivity）を作成します。

AddPlayerActivity.java

新規レコードをデータベースに挿入する画面です。名前と国を入力するEditTextと、保存ボタンを備えています。

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import androidx.appcompat.app.AppCompatActivity;
public class AddPlayerActivity extends AppCompatActivity implements
View.OnClickListener {
    Button btnAdd;
    private EditText editSubject;
    private EditText editDescription;
    private DataBaseManager dataBaseManager;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle("Add Record");
        setContentView(R.layout.activity_addplayer);
        editSubject = findViewById(R.id.editTextSubject);
        editDescription = findViewById(R.id.editTextDescription);
        btnAdd = findViewById(R.id.add_record);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        btnAdd.setOnClickListener(this);
    }
    @Override
    public void onClick(View v) {
        if (v.getId() == R.id.add_record) {
            final String name = editSubject.getText().toString();
            final String desc = editDescription.getText().toString();
            dataBaseManager.insert(name, desc);
            Intent main = new Intent(AddPlayerActivity.this,
            MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
            startActivity(main);
        }
    }
}

activity_addplayer.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp">
    <EditText
        android:id="@+id/editTextSubject"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="Enter Name" >
        <requestFocus />
    </EditText>
    <EditText
        android:id="@+id/editTextDescription"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Enter Country"
        android:inputType="textMultiLine">
    </EditText>
    <Button
        android:id="@+id/add_record"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="Add Record" />
</LinearLayout>

ModifyPlayerActivity.java

既存レコードの編集画面です。タップされたレコードのIDを受け取り、更新ボタンで内容を書き換え、削除ボタンでレコードを削除できます。

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
public class ModifyPlayerActivity extends AppCompatActivity implements
View.OnClickListener {
    EditText editTextSub;
    Button updateBtn, deleteBtn;
    EditText editTextDesc;
    private long _id;
    DataBaseManager dataBaseManager;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle("Modify Record");
        setContentView(R.layout.activity_modify_player);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        editTextSub = findViewById(R.id.editTextSub);
        editTextDesc = findViewById(R.id.editTextDesc);
        updateBtn = findViewById(R.id.btnUpdate);
        deleteBtn = findViewById(R.id.btnDelete);
        Intent intent = getIntent();
        String id = intent.getStringExtra("id");
        String name = intent.getStringExtra("title");
        String desc = intent.getStringExtra("desc");
        _id = Long.parseLong(id);
        editTextSub.setText(name);
        editTextDesc.setText(desc);
        updateBtn.setOnClickListener(this);
        deleteBtn.setOnClickListener(this);
    }
    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btnUpdate:
            String title = editTextSub.getText().toString();
            String desc = editTextDesc.getText().toString();
            dataBaseManager.update(_id, title, desc);
            this.returnHome();
            break;
            case R.id.btnDelete:
            dataBaseManager.delete(_id);
            this.returnHome();
            break;
        }
    }
    public void returnHome() {
        Intent home_intent = new Intent(getApplicationContext(),
        MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
        startActivity(home_intent);
    }
}

activity_modify_player.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="10dp" >
    <EditText
        android:id="@+id/editTextSub"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="10dp"
        android:ems="10"
        android:hint="Enter Name" />
    <EditText
        android:id="@+id/editTextDesc"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Enter Country">
    </EditText>
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:weightSum="2"
        android:gravity="center_horizontal"
        android:orientation="horizontal">
    <Button
        android:id="@+id/btnUpdate"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Update" />
    <Button
        android:id="@+id/btnDelete"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Delete" />
    </LinearLayout>
</LinearLayout>

ステップ7：リスト項目用レイアウトの作成

ListViewの各行を表示するためのレイアウトリソースファイル（activity_view_record.xml）を新規作成し、以下のコードを追加します。ID・タイトル・説明文の3つのTextViewで構成されています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp">
    <TextView
        android:id="@+id/id"
        android:layout_width="25dp"
        android:layout_height="wrap_content"
        android:layout_alignParentStart="true"
        android:layout_alignParentTop="true"
        android:layout_marginEnd="6dp"
        android:padding="3dp"
        android:visibility="visible" />
    <TextView
        android:id="@+id/title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginStart="10dp"
        android:layout_toEndOf="@id/id"
        android:maxLines="1"
        android:padding="3dp"
        android:textSize="17sp"
        android:textStyle="bold" />
    <TextView
        android:id="@+id/desc"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/title"
        android:layout_marginStart="10dp"
        android:layout_toEndOf="@id/id"
        android:ellipsize="end"
        android:maxLines="2"
        android:padding="3dp"
        android:visibility="visible" />
</RelativeLayout>

ステップ8：AndroidManifest.xmlへの登録

最後に、作成したすべてのアクティビティをAndroidManifest.xmlに登録します。これを忘れるとアプリがクラッシュするので注意してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.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=".ModifyPlayerActivity"></activity>
            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        <activity android:name=".AddPlayerActivity" />
    </application>
</manifest>

アプリの実行と動作確認

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

AndroidアプリでSQLiteデータベースを使う方法を徹底解説【CRUD実装の手順】

AndroidアプリでSQLiteデータベースを使う方法を徹底解説【CRUD実装の手順】

まとめ

本記事では、AndroidアプリでSQLiteデータベースを扱うための基本構成として、SQLiteOpenHelperを継承したヘルパークラス、CRUD操作を担当するマネージャークラス、そしてそれらを利用する複数のアクティビティを実装しました。このサンプルをベースにすれば、オフラインで動作するデータ管理機能を持つアプリを簡単に構築できます。ぜひ自分のプロジェクトに応用してみてください。

  1. AndroidのSQLiteでSUM()関数を使って合計値を取得する方法【サンプルコード付き】

    SQLiteデータベースとは具体的な実装例に入る前に、AndroidにおけるSQLiteデータベースの基礎知識をおさらいしておきましょう。SQLiteはオープンソースのSQLデータベースエンジンで、デバイス内のテキストファイル形式でデータを保存します。Androidには標準でSQLiteの実装が組み込まれており、追加のライブラリなしですぐに利用できます。SQLiteはリレーショナルデータベースの主要な機能を一通りサポートしており、JDBCやODBCのような接続ドライバーを用意する必要がない点も大きな特徴です。アプリ内から直接アクセスできる手軽さが、Android開発で広く使われる理由です。本記

  2. 【Android】データベースとRecyclerViewを連携させる方法を実装例つきで解説

    この記事では、AndroidアプリでRecyclerViewとデータベース（SQLite）を連携させて使用する方法を、実際のサンプルコードとともに解説します。連絡先の登録・表示・編集・削除ができるシンプルなアプリを題材に、実装手順をステップごとに見ていきましょう。ステップ1：プロジェクトの作成と依存関係の追加まず、Android Studioで新しいプロジェクトを作成します。メニューから「File → New Project」を選択し、必要事項を入力してプロジェクトを作成してください。続いて、build.gradle（Module: app）に以下の依存関係を追加します。implementat