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

AndroidのSQLiteでREAL型(実数データ)を扱う方法【サンプルコード付きで解説】

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

本題に入る前に、AndroidにおけるSQLiteデータベースの基本をおさらいしておきましょう。SQLiteは、デバイス上のテキストファイルにデータを保存するオープンソースのSQLデータベースです。Androidには標準でSQLiteの実装が組み込まれており、リレーショナルデータベースの主要な機能をすべて利用できます。

大きな特徴は、JDBCやODBCのような接続設定が一切不要という点です。SQLiteOpenHelperクラスを継承するだけで、誰でも簡単にローカルデータベースを操作できます。

この記事では、「AndroidのSQLiteでREAL型(実数データ型)を使用する方法」を、実際に動作するサンプルアプリのコードを交えながら詳しく解説します。

今回作成するサンプルアプリの概要

今回作成するのは、名前(TEXT型)と給与(REAL型=実数)を入力してSQLiteに保存し、ListViewに一覧表示するシンプルなCRUDアプリです。以下の4つの操作に対応しています。

  • Save: 入力したデータをデータベースに挿入
  • Update: 既存データを更新
  • DeleteALL: 全レコードを削除
  • Refresh: 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" />
        <Button
            android:id="@+id/udate"
            android:text="Update"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />
        <Button
            android:id="@+id/Delete"
            android:text="DeleteALL"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />
    </LinearLayout>
    <ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
    </ListView>
</LinearLayout>

このレイアウトでは、名前用と給与用のEditTextを2つ配置しています。特に重要なのが給与入力欄に指定したandroid:inputType="numberDecimal"です。これにより、ユーザーは小数点付きの数値を入力できるようになり、REAL型のデータと相性の良いUIになります。

ステップ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;
    ArrayAdapter arrayAdapter;
    private ListView listView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        final DatabaseHelper helper = new DatabaseHelper(this);
        final ArrayList array_list = helper.getAllContacts();
        name = findViewById(R.id.name);
        salary = findViewById(R.id.salary);
        listView = findViewById(R.id.listView);
        arrayAdapter = new ArrayAdapter(MainActivity.this, android.R.layout.simple_list_item_1, array_list);
        listView.setAdapter(arrayAdapter);
        findViewById(R.id.Delete).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (helper.delete()) {
                    Toast.makeText(MainActivity.this, "Deleted", Toast.LENGTH_LONG).show();
                } else {
                    Toast.makeText(MainActivity.this, "NOT Deleted", Toast.LENGTH_LONG).show();
                }
            }
        });
        findViewById(R.id.udate).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (!name.getText().toString().isEmpty() && !salary.getText().toString().isEmpty()) {
                    if (helper.update(name.getText().toString(), salary.getText().toString())) {
                        Toast.makeText(MainActivity.this, "Updated", Toast.LENGTH_LONG).show();
                    } else {
                        Toast.makeText(MainActivity.this, "NOT Updated",
                        Toast.LENGTH_LONG).show();
                    }
                } else {
                    name.setError("Enter NAME");
                    salary.setError("Enter Salary");
                }
            }
        });

        findViewById(R.id.refresh).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                array_list.clear();
                array_list.addAll(helper.getAllContacts());
                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クラスのインスタンスを生成し、各ボタンにクリックリスナーを設定しています。入力欄が空の場合にはsetError()でエラーメッセージを表示するなど、入力チェックも行っています。

ステップ4:DatabaseHelper.java の実装

最後に、src/DatabaseHelper.javaに以下のコードを追加します。ここが今回の主題であるREAL型の扱いに関わる最重要部分です。

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 = "salaryDatabase9";
    public static final String CONTACTS_TABLE_NAME = "SalaryDetails";
    public DatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, 2);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        try {
            db.execSQL(
                "create table " + CONTACTS_TABLE_NAME + "(id INTEGER PRIMARY KEY, name text,salary real,datetime default current_timestamp)"
            );
        } 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.replace(CONTACTS_TABLE_NAME, null, contentValues);
        return true;
    }

    public ArrayList<String> getAllContacts() {
        SQLiteDatabase db = this.getReadableDatabase();
        ArrayList<String> array_list = new ArrayList<String>();
        Cursor res = db.rawQuery("select (id ||' : '||trim(name) || ' : ' || salary || ' : '|| datetime) as fullname from " + CONTACTS_TABLE_NAME, null);
        res.moveToFirst();
        while (res.isAfterLast() == false) {
            if ((res != null) && (res.getCount() > 0))
                array_list.add(res.getString(res.getColumnIndex("fullname")));
                res.moveToNext();
        }
        return array_list;
    }

    public boolean update(String s, String s1) {
        SQLiteDatabase db = this.getWritableDatabase();
        db.execSQL("UPDATE " + CONTACTS_TABLE_NAME + " SET name = " + "'" + s + "', " + "salary = " + "'" + s1 + "'");
        return true;
    }

    public boolean delete() {
        SQLiteDatabase db = this.getWritableDatabase();
        db.execSQL("DELETE from " + CONTACTS_TABLE_NAME);
        return true;
    }
}

注目すべきはonCreate()内のCREATE TABLE文にある「salary real」というカラム定義です。このように「real」を指定することで、salaryカラムはREAL型(8バイトのIEEE浮動小数点数)として扱われ、小数点以下を含む値を正確に保存できます。さらに「datetime default current_timestamp」を指定することで、レコードの登録日時も自動的に記録される仕組みになっています。

アプリを実行して動作を確認しよう

それでは実際にアプリを動かしてみましょう。実機のAndroidスマートフォンをPCにUSB接続している状態を想定します。Android Studioでプロジェクト内の任意のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイス選択ダイアログで接続した端末を選ぶと、スマートフォンの画面にアプリの初期画面が表示されます。

AndroidのSQLiteでREAL型(実数データ)を扱う方法【サンプルコード付きで解説】

上記の実行結果を見ると、名前がテキスト(TEXT型)として、給与が実数(REAL型)として正しく保存されていることが確認できます。

まとめ

SQLiteではINTEGER、TEXT、REAL、BLOBなどのデータ型(ストレージクラス)が利用可能です。金額や体重、測定値のように小数を扱いたい場合は、テーブル作成時にカラムの型を「real」と定義するだけでREAL型として保存できます。あわせてEditText側にもinputType="numberDecimal"を指定しておけば、ユーザーが自然に小数を入力できるためおすすめです。

なお、サンプルコードのandroid.support.v7ライブラリは現在非推奨となっているため、新しいプロジェクトで試す場合はAndroidX(androidx.appcompat.app.AppCompatActivity)への置き換えを行ってください。また、UPDATE文を文字列連結で構築している箇所はSQLインジェクションのリスクがあるため、実務ではContentValuesやプレースホルダ(?)を使った安全な書き方に置き換えることを推奨します。

  1. 【Android】SQLiteのtotal_changes()関数で変更されたレコード数を取得する方法

    AndroidにおけるSQLiteデータベースとは具体的な実装例に入る前に、まずAndroidにおけるSQLiteデータベースについて簡単に説明します。SQLiteはオープンソースのSQLデータベースで、デバイス上のテキストファイルにデータを保存します。Androidには標準でSQLiteデータベースの実装が組み込まれており、リレーショナルデータベースの機能をすべてサポートしています。また、このデータベースにアクセスする際、JDBCやODBCのような接続確立は一切不要です。アプリ内から直接利用できる点が大きな特徴となっています。本記事では、SQLiteのtotal_changes()関数を使用

  2. Android SQLiteでunlikely()関数を使用する方法をわかりやすく解説

    AndroidにおけるSQLiteデータベースとは 実装例に入る前に、まずAndroidにおけるSQLiteデータベースの基本を押さえておきましょう。SQLiteはオープンソースのSQLデータベースエンジンで、デバイス上のテキストファイルとしてデータを保存するのが特徴です。 Androidには標準でSQLiteデータベースの実装が組み込まれており、リレーショナルデータベースが持つすべての機能をサポートしています。また、JDBCやODBCのような接続設定を行う必要がなく、そのまま手軽にデータベースへアクセスできる点も大きなメリットです。 本記事では、Android SQLiteでunlikely