AndroidのSQLiteデータベースの例のチュートリアル

2年 ago
夏樹, 風
9 minutes

アンドロイドSQLiteの例チュートリアルへようこそ。アンドロイドアプリケーションのデータを保存するために、SQLiteが一番利用される方法です。多くのアプリケーションでは、SQLiteが直接使用されるか、あるいはいくつかのサードパーティのラッパーを通じて利用されています。以下は、本日作成する最終的なアプリケーションです。

アンドロイドのSQLite

AndroidのSQLiteは、非常に軽量なデータベースであり、Android OSに付属しています。AndroidのSQLiteは、シンプルなSQLインターフェースと非常に小さなメモリ使用量、まずまずの速度を組み合わせています。Androidにおいて、SQLiteはAndroidランタイムに組み込まれており、そのため、すべてのAndroidアプリケーションは独自のSQLiteデータベースを作成することができます。AndroidのSQLiteネイティブAPIはJDBCではなく、メモリ制限のあるスマートフォンにはオーバーヘッドが大きいためです。データベースが正常に作成されると、Android Device Monitorからアクセスできるdata/data//databases/に配置されます。SQLiteは、テーブル（行と列からなる）やインデックスなどを含む典型的な関係データベースです。必要に応じて、独自のテーブルを作成してデータを保持することができます。この構造はスキーマと呼ばれます。

アンドロイドのSQLite、SQLiteOpenHelperがあります。

Androidは、データベーススキーマの変更を処理するために利用できる機能を備えており、これは主にSQLiteOpenHelperクラスを使用することに依存しています。SQLiteOpenHelperは、非常に一般的な2つの問題を解決するために設計されています。

    1. アプリケーションが初めて実行される時点ではまだデータベースはありません。そのため、テーブル、インデックス、初期データなどを作成する必要があります。

 

    アプリケーションが新しいスキーマにアップグレードされる場合、データベースはまだ古いスキーマのままです。アプリの残りの部分に合わせるためにデータベーススキーマを変更する選択肢があります。

SQLiteOpenHelperは、私たちの仕様に基づいてデータベースを作成およびアップグレードするためのこれらのロジックをカプセル化します。そのために、少なくとも以下の3つのメソッドを実装したSQLiteOpenHelperのカスタムサブクラスを作成する必要があります。

    1. コンストラクター：このコンストラクターは、コンテキスト（たとえば、アクティビティ）、データベースの名前、オプションのカーソルファクトリ（後で説明します）、および使用しているデータベーススキーマのバージョンを表す整数（通常は1から始まり、後で増分されます）を受け取ります。

 

    1. public DatabaseHelper(Context context) {

 

    1. super(context, DB_NAME, null, DB_VERSION);

 

    1. }

onCreate(SQLiteDatabase db)：データベースが存在せず、アプリが新規に作成する必要がある場合に呼び出されます。新しく作成されたデータベースを指すSQLiteDatabaseオブジェクトが渡されるため、テーブルや初期データを追加することができます。

onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)：必要なスキーマのバージョンがデータベースのスキーマのバージョンと一致しない場合に呼び出されます。SQLiteDatabaseオブジェクトと古いバージョン番号、新しいバージョン番号が渡されるため、古いスキーマから新しいスキーマにデータベースを変換する最適な方法を見つけることができます。

私たちは、すべてのデータベースのCRUD（作成、読み取り、更新、削除）操作を実行するためのDBManagerクラスを定義します。

AndroidのSQLiteデータベース接続のオープンとクローズ

以下のように示されているように、テーブル内のレコードの挿入、更新、削除などのデータベース操作を行う前に、最初にgetWritableDatabase()メソッドを呼び出してデータベース接続を開いてください。

public DBManager open() throws SQLException {
        dbHelper = new DatabaseHelper(context);
        database = dbHelper.getWritableDatabase();
        return this;
    }

DbHelperはSQLiteOpenHelperのサブクラスのインスタンスです。データベース接続を閉じるためには、次のメソッドが呼び出されます。

 public void close() {
        dbHelper.close();
    }

AndroidのSQLiteデータベーステーブルに新しいレコードを挿入する

以下のコードスニペットは、AndroidのSQLiteデータベースに新しいレコードを挿入する方法を示しています。

public void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESC, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }

Content Valuesは与えられた初期サイズを使用して空の値のセットを作成します。コーディングの部分に入る際に、他のインスタンスの値についても説明します。

AndroidのSQLiteデータベーステーブルのレコードをアップデートします。

以下のコードは、単一のレコードを更新する方法を示しています。

public int update(long _id, String name, String desc) {
        ContentValues contentValues = new ContentValues();
        contentValues.put(DatabaseHelper.SUBJECT, name);
        contentValues.put(DatabaseHelper.DESC, desc);
        int i = database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
        return i;
    }

Android SQLite – レコードの削除

以下に示すように、削除するレコードのIDを渡すだけで十分です。

public void delete(long _id) {
        database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
    }

アンドロイドのSQLiteのカーソル

カーソルはクエリの結果セット全体を表します。クエリが取得されると、cursor.moveToFirst()が呼び出されます。moveToFirst()の呼び出しによって、2つのことが行われます。

  • It allows us to test whether the query returned an empty set (by testing the return value)
  • It moves the cursor to the first result (when the set is not empty)

以下のコードは、すべてのレコードを取得するために使用されます。

 public Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESC };
        Cursor cursor = database.query(DatabaseHelper.TABLE_NAME, columns, null, null, null, null, null);
        if (cursor != null) {
            cursor.moveToFirst();
        }
        return cursor;
    }

カーソルを使用する別の方法は、カーソルアダプターでカーソルをラップすることです。ArrayAdapterが配列を適応するのと同様に、CursorAdapterはカーソルオブジェクトを適応し、そのデータをListViewのようなAdapterViewに利用できるようにします。SQLiteを使用して意味のあるデータを格納するプロジェクトに移行しましょう。

Android SQLiteのサンプルプロジェクトの構造

このアプリケーションでは、国名とそれに対応する通貨をListView形式で保存するレコードを作成したいと考えています。上記で説明したすべての機能をカバーしています。

AndroidのSQLiteプロジェクトのコード

アプリケーションは5つのクラスで構成されています。まず、DatabaseHelperという名前のクラスを定義します。これはSQLiteOpenHelperのサブクラスです。DatabaseHelper.javaの内容は以下の通りです。

package com.scdev.sqlite;

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

public class DatabaseHelper extends SQLiteOpenHelper {

    // Table Name
    public static final String TABLE_NAME = "COUNTRIES";

    // Table columns
    public static final String _ID = "_id";
    public static final String SUBJECT = "subject";
    public static final String DESC = "description";

    // Database Information
    static final String DB_NAME = "JOURNALDEV_COUNTRIES.DB";

    // database version
    static final int DB_VERSION = 1;

    // Creating table query
    private static final String CREATE_TABLE = "create table " + TABLE_NAME + "(" + _ID
            + " INTEGER PRIMARY KEY AUTOINCREMENT, " + SUBJECT + " TEXT NOT NULL, " + DESC + " TEXT);";

    public 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);
    }
}

上述のとおり、コンストラクタ以外にもonCreate()メソッドとonUpgrade()メソッドをオーバーライドしています。データベースとテーブルの名前はそれぞれJOURNALDEV_COUNTRIES.DBとCOUNTRIESです。新しい行が挿入されるたびに、インデックス列は自動的に増分されます。国名と通貨の列名はそれぞれ「subject」と「description」です。DBManagerクラスではDatabaseHelperが初期化され、CRUD操作が定義されています。以下にこのクラスのコードを示します：DBManager.java

package com.scdev.sqlite;


import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;

public class DBManager {

    private DatabaseHelper dbHelper;

    private Context context;

    private SQLiteDatabase database;

    public DBManager(Context c) {
        context = c;
    }

    public DBManager open() throws SQLException {
        dbHelper = new DatabaseHelper(context);
        database = dbHelper.getWritableDatabase();
        return this;
    }

    public void close() {
        dbHelper.close();
    }

    public void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESC, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }

    public Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESC };
        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.DESC, desc);
        int i = database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
        return i;
    }

    public void delete(long _id) {
        database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
    }

}

アプリケーションが起動するときに開始されるアクティビティであるCountryListActivity.javaクラスです。以下にはそれに対して定義されたレイアウトがあります：fragment_emp_list.xml。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" >

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:dividerHeight="1dp"
        android:padding="10dp" >
    </ListView>

    <TextView
        android:id="@+id/empty"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="@string/empty_list_text" />

</RelativeLayout>

最初に、データベースに保存されているレコードが含まれるListViewコンポーネントが定義されます。最初はListViewは空なので、同じ内容を表示するためにTextViewが使用されます。CountryListActivity.java

package com.scdev.sqlite;

import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.support.v4.widget.SimpleCursorAdapter;
import android.support.v7.app.ActionBarActivity;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.TextView;

public class CountryListActivity extends ActionBarActivity {

    private DBManager dbManager;

    private ListView listView;

    private SimpleCursorAdapter adapter;

    final String[] from = new String[] { DatabaseHelper._ID,
            DatabaseHelper.SUBJECT, DatabaseHelper.DESC };

    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.fragment_emp_list);

        dbManager = new DBManager(this);
        dbManager.open();
        Cursor cursor = dbManager.fetch();

        listView = (ListView) findViewById(R.id.list_view);
        listView.setEmptyView(findViewById(R.id.empty));

        adapter = new SimpleCursorAdapter(this, R.layout.activity_view_record, cursor, from, to, 0);
        adapter.notifyDataSetChanged();

        listView.setAdapter(adapter);

        // OnCLickListiner For List Items
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long viewId) {
                TextView idTextView = (TextView) view.findViewById(R.id.id);
                TextView titleTextView = (TextView) view.findViewById(R.id.title);
                TextView descTextView = (TextView) view.findViewById(R.id.desc);

                String id = idTextView.getText().toString();
                String title = titleTextView.getText().toString();
                String desc = descTextView.getText().toString();

                Intent modify_intent = new Intent(getApplicationContext(), ModifyCountryActivity.class);
                modify_intent.putExtra("title", title);
                modify_intent.putExtra("desc", desc);
                modify_intent.putExtra("id", id);

                startActivity(modify_intent);
            }
        });
    }

    @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.add_record) {

            Intent add_mem = new Intent(this, AddCountryActivity.class);
            startActivity(add_mem);

        }
        return super.onOptionsItemSelected(item);
    }

}

この活動では、DBManagerオブジェクトがCRUD操作を実行するために呼び出されます。SimpleCursorAdapterは、クエリ結果がカーソルオブジェクトで返される要素をリストに追加するために定義されます。リストアイテムをクリックすると、ModifyCountryActivityクラスを開くための意図が行われます。メニューには、ActionBarから新しいレコードを追加するためのアイテムが含まれています。ここでも、AddCountryActivityクラスを開くための意図が行われます。以下にmenu.xmlコードを示します。

<menu xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    tools:context="com.example.sqlitesample.MainActivity" >

    <item
        android:id="@+id/add_record"
        android:icon="@android:drawable/ic_menu_add"
        android:orderInCategory="100"
        android:title="@string/add_record"
        app:showAsAction="always"/>

</menu>

以下に、AddCountryActivity.javaファイルのXMLレイアウトとコードが定義されています：activity_add_record.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="20dp" >

    <EditText
        android:id="@+id/subject_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_title" >

        <requestFocus />
    </EditText>

    <EditText
        android:id="@+id/description_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_desc"
        android:inputType="textMultiLine"
        android:minLines="5" >
    </EditText>

    <Button
        android:id="@+id/add_record"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="@string/add_record" />

</LinearLayout>

国と通貨の入力を受け付ける2つのEditTextコンポーネントと、値をデータベースに追加しListViewで表示するためのボタンが定義されている。AddCountryActivity.java

package com.scdev.sqlite;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;

public class AddCountryActivity extends Activity implements OnClickListener {

    private Button addTodoBtn;
    private EditText subjectEditText;
    private EditText descEditText;

    private DBManager dbManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setTitle("Add Record");

        setContentView(R.layout.activity_add_record);

        subjectEditText = (EditText) findViewById(R.id.subject_edittext);
        descEditText = (EditText) findViewById(R.id.description_edittext);

        addTodoBtn = (Button) findViewById(R.id.add_record);

        dbManager = new DBManager(this);
        dbManager.open();
        addTodoBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.add_record:

                final String name = subjectEditText.getText().toString();
                final String desc = descEditText.getText().toString();

                dbManager.insert(name, desc);

                Intent main = new Intent(AddCountryActivity.this, CountryListActivity.class)
                        .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

                startActivity(main);
                break;
        }
    }

}

ここで行われるCRUD操作は、データベースに新しいレコードを追加することです。activity_modify_record.xmlファイルのxmlレイアウトとModifyCountryActivity.javaファイルのコードは以下で定義されています。

<?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/subject_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="10dp"
        android:ems="10"
        android:hint="@string/enter_title" />

    <EditText
        android:id="@+id/description_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_desc"
        android:inputType="textMultiLine"
        android:minLines="5" >
    </EditText>


    <LinearLayout
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:weightSum="2"
        android:gravity="center_horizontal"
        android:orientation="horizontal" >

        <Button
            android:id="@+id/btn_update"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="@string/btn_update" />

        <Button
            android:id="@+id/btn_delete"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="@string/btn_delete" />
    </LinearLayout>

</LinearLayout>

以前のレイアウトと似ていますが、修正および削除ボタンが追加されたものです。ModifyCountryActivity.java

package com.scdev.sqlite;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;

public class ModifyCountryActivity extends Activity implements OnClickListener {

    private EditText titleText;
    private Button updateBtn, deleteBtn;
    private EditText descText;

    private long _id;

    private DBManager dbManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setTitle("Modify Record");

        setContentView(R.layout.activity_modify_record);

        dbManager = new DBManager(this);
        dbManager.open();

        titleText = (EditText) findViewById(R.id.subject_edittext);
        descText = (EditText) findViewById(R.id.description_edittext);

        updateBtn = (Button) findViewById(R.id.btn_update);
        deleteBtn = (Button) findViewById(R.id.btn_delete);

        Intent intent = getIntent();
        String id = intent.getStringExtra("id");
        String name = intent.getStringExtra("title");
        String desc = intent.getStringExtra("desc");

        _id = Long.parseLong(id);

        titleText.setText(name);
        descText.setText(desc);

        updateBtn.setOnClickListener(this);
        deleteBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_update:
                String title = titleText.getText().toString();
                String desc = descText.getText().toString();

                dbManager.update(_id, title, desc);
                this.returnHome();
                break;

            case R.id.btn_delete:
                dbManager.delete(_id);
                this.returnHome();
                break;
        }
    }

    public void returnHome() {
        Intent home_intent = new Intent(getApplicationContext(), CountryListActivity.class)
                .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
        startActivity(home_intent);
    }
}

ここで行われるCRUD操作は、レコードの更新と削除です。以下の画像は、私たちのプロジェクトの最終出力のスクリーンショットです。最初の画像は、アプリケーションを初めて起動したときに表示される出力です。2番目の画像は、ActionBarからメニューオプションをクリックして新しいレコードを追加した結果です。3番目の画像は、3つのレコードが追加されたときの出力を示しています。4番目の画像は、リストアイテムをクリックしてレコードを修正または削除した場合の出力を示しています。最後の画像は、レコードが削除されたときの出力です。この例では、最初のレコードを削除しています。

AndroidのSQLiteデータベースファイルを開く

リリースノートの中で既に話し合ったように、データベースファイルは内部ストレージに保存されており、Android Device Monitorからアクセス可能です。下の画像で確認できます。このデータベースを表示するには、まずこのファイルをデバイスからデスクトップに取り出す必要があります。以下の画像に示されているように、右上のメニューオプションをクリックして実行します。「SQLiteBrowser」を次のリンクからダウンロードし、このファイルを開きます。以下のスニペットは、ブラウザ内のスキーマとテーブルを表示しています。テーブルを表示するには、上部の「Browse Data」タブに移動してください。以下の画像が表示されます。これでAndroid SQLiteチュートリアルは終了です。最終的なAndroid SQLiteプロジェクトは以下のリンクからダウンロードできます。

アンドロイドのSQLiteの例題プロジェクトをダウンロードする。

コメントを残す 0

Your email address will not be published. Required fields are marked *