【画像付き解説】AndroidアプリでSDカード上のSQLiteデータベースを操作するサンプルコード

Android アプリで SD カード上の SQLite データベースにアクセスする方法

方法 1: SQLiteOpenHelper を使用する

1. データベース ファイルの配置

   • アプリの内部ストレージにデータベースファイルを配置する場合は、context.getDatabasePath() メソッドを使用して適切なパスを取得できます。
   • SD カードにデータベースファイルを配置する場合は、Environment.getExternalStorageDirectory() メソッドを使用して SD カードのルート ディレクトリへのパスを取得し、そのパスにデータベースファイル名を連結することでパスを作成できます。

2. SQLiteOpenHelper を継承したヘルパー クラスを作成

   • onCreate() メソッドをオーバーライドして、データベースを作成または更新する SQL ステートメントを実行します。
   • onUpgrade() メソッドをオーバーライドして、データベースのスキーマが変更された場合に必要な処理を行います。

3. アプリでヘルパー クラスを使用する

   • getReadableDatabase() メソッドを呼び出して読み取り専用データベースへのアクセスを取得します。
   • execSQL() メソッドを使用して SQL ステートメントを実行します。
   • rawQuery() メソッドを使用して SQL クエリを実行し、結果を Cursor オブジェクトとして取得します。
   • データベース操作が完了したら、close() メソッドを呼び出してデータベースを閉じます。

方法 2: Context を使用する

注意事項

• SD カード上のデータベースにアクセスする場合は、WRITE_EXTERNAL_STORAGE パーミッションが必要になります。
• データベースファイルは、他のアプリからアクセスされないように注意する必要があります。
• パフォーマンスを向上させるために、データベースキャッシュを使用することを検討してください。

上記に加えて、以下の点にも注意する必要があります。

• データベースファイルのバージョン管理：データベースのスキーマを変更する場合は、データベースのバージョンを管理する必要があります。これにより、古いバージョンのアプリで新しいバージョンのデータベースを開こうとしても問題が発生しないようにすることができます。
• エラー処理：データベース操作中にエラーが発生する可能性があります。適切なエラー処理を実装して、アプリがクラッシュしないようにする必要があります。
• セキュリティ：データベースファイルは機密情報を含む可能性があるため、適切なセキュリティ対策を講じて保護する必要があります。

これらの点を踏まえ、ご自身のアプリに合った方法を選択してください。

MainActivity.java

package com.example.androidapp;

import android.content.Context;
import android.database.Cursor;
import android.os.Bundle;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

import java.io.File;

public class MainActivity extends AppCompatActivity {

    private static final String DATABASE_NAME = "mydatabase.db";
    private static final int DATABASE_VERSION = 1;

    private DatabaseHelper dbHelper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        TextView textView = findViewById(R.id.textView);

        // データベースヘルパーを作成
        dbHelper = new DatabaseHelper(this);

        // データベースにアクセスしてデータを取得
        Cursor cursor = dbHelper.getReadableDatabase().rawQuery("SELECT * FROM mytable", null);
        if (cursor.moveToFirst()) {
            String data = cursor.getString(0);
            textView.setText(data);
        } else {
            textView.setText("データが見つかりませんでした。");
        }
        cursor.close();
    }

    private static class DatabaseHelper extends SQLiteOpenHelper {

        public DatabaseHelper(Context context) {
            super(context, DATABASE_NAME, null, DATABASE_VERSION);
        }

        @Override
        public void onCreate(SQLiteDatabase db) {
            db.execSQL("CREATE TABLE mytable (id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT)");
        }

        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            // データベースのスキーマが変更された場合の処理
        }
    }
}

DatabaseHelper.java

package com.example.androidapp;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

import java.io.File;

public class DatabaseHelper extends SQLiteOpenHelper {

    private static final String DATABASE_NAME = "mydatabase.db";
    private static final int DATABASE_VERSION = 1;

    private final Context context;

    public DatabaseHelper(Context context) {
        super(context, getDatabasePath(context).getAbsolutePath(), null, DATABASE_VERSION);
        this.context = context;
    }

    private static File getDatabasePath(Context context) {
        File dbFile = new File(context.getExternalFilesDir(null), DATABASE_NAME);
        return dbFile;
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL("CREATE TABLE mytable (id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT)");
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // データベースのスキーマが変更された場合の処理
    }
}

• MainActivity.java は、アプリのメインアクティビティです。
  • onCreate() メソッドは、データベースヘルパーを作成し、データベースにアクセスしてデータを取得します。
• DatabaseHelper.java は、データベースの作成と管理を行うヘルパー クラスです。
  • getDatabasePath() メソッドは、SD カード上のデータベースファイルのパスを取得します。

このサンプルコードは、SD カード上の SQLite データベースにアクセスする基本的な方法を示しています。 ご自身のアプリに合わせて、必要に応じてコードを修正してください。

• このサンプルコードはあくまでも参考としており、本番環境で使用する場合は、適切なエラー処理やセキュリティ対策を追加する必要があります。
• Android 10 以降では、WRITE_EXTERNAL_STORAGE パーミッションがデフォルトで許可されていないことに注意してください。 アプリでこのパーミッションを使用する場合は、ユーザーに許可を要求する必要があります。

Android アプリで SD カード上の SQLite データベースにアクセスするその他の方法

ContentProvider を使用する

• ContentProvider を使用すると、他のアプリからデータベースにアクセスできるようにすることができます。 これは、複数のアプリ間でデータを共有する必要がある場合に役立ちます。

ライブラリを使用する

• SQLite を操作するためのライブラリがいくつかあります。 これらのライブラリを使用すると、データベース操作をより簡単に記述することができます。

ネイティブ コードを使用する

• C または C++ などのネイティブ コードを使用して、SQLite に直接アクセスすることもできます。 これは、パフォーマンスが重要である場合に役立ちます。

それぞれの方法の利点と欠点

最適な方法は、アプリの要件によって異なります。 以下の点を考慮して、適切な方法を選択してください。

• アプリでデータベースをどのように使用するのか
• パフォーマンス要件
• セキュリティ要件
• 開発者のスキル

上記以外にも、SD カード上の SQLite データベースにアクセスする方法があります。 最新の情報については、Android 開発者ドキュメントを参照することをお勧めします。