【Androidプログラミング】SQLiteCursorでNULL値をスマートに扱う方法とは？

2024-06-19

AndroidにおけるSQLiteCursorとNULL値の取り扱い

NULL値は、カラムに値が格納されていないことを示す特殊な値です。NULL値は、さまざまな理由で発生する可能性があります。たとえば、データがまだ入力されていない場合、またはデータが削除された場合、カラムはNULL値になります。

SQLiteCursorがNULL値に遭遇した場合、その値はどのように扱われるのでしょうか？

カラムデータ型による挙動の違い

数値型（int、float、doubleなど）：NULL値の場合、0として扱われます。
文字列型（String）：NULL値の場合、空文字列（""）として扱われます。
ブール型（boolean）：NULL値の場合、falseとして扱われます。
BLOB型：NULL値の場合、バイト配列（byte[]）として扱われますが、その長さは0になります。

カラムデータの取得方法

SQLiteCursorからカラムデータを取得するには、**getColumnIndex()メソッドとgetXXX()**メソッドを使用します。

int columnIndex = cursor.getColumnIndex("columnName");

if (columnIndex != -1) {
    // カラムが存在する
    switch (cursor.getType(columnIndex)) {
        case Cursor.FIELD_TYPE_INTEGER:
            int value = cursor.getInt(columnIndex);
            break;
        case Cursor.FIELD_TYPE_STRING:
            String value = cursor.getString(columnIndex);
            break;
        case Cursor.FIELD_TYPE_FLOAT:
            float value = cursor.getFloat(columnIndex);
            break;
        case Cursor.FIELD_TYPE_BLOB:
            byte[] value = cursor.getBlob(columnIndex);
            break;
        default:
            // その他のデータ型
            break;
    }
} else {
    // カラムが存在しない
}

NULL値のチェック

カラム値がNULLかどうかを確認するには、**isNull()**メソッドを使用します。

int columnIndex = cursor.getColumnIndex("columnName");

if (columnIndex != -1) {
    if (cursor.isNull(columnIndex)) {
        // カラム値はNULL
    } else {
        // カラム値はNULLではない
    }
} else {
    // カラムが存在しない
}

まとめ

SQLiteCursorは、NULL値を0、空文字列、false、または長さ0のバイト配列として扱います。

補足

NULL値は、データがないことを明確に示すことができるため、データベース設計において重要な役割を果たします。
NULL値の扱いに注意しないと、予期しない結果になる可能性があるため、プログラムコードで適切に処理する必要があります。

サンプルコード：SQLiteCursorでNULL値を扱う

MainActivity.java

package com.example.androidsqlite;

import android.content.ContentValues;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

    private static final String DATABASE_NAME = "test.db";
    private static final String TABLE_NAME = "users";
    private static final String COLUMN_ID = "id";
    private static final String COLUMN_NAME = "name";
    private static final String COLUMN_AGE = "age";

    private SQLiteDatabase db;

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

        // データベースを開く
        db = openOrCreateDatabase(DATABASE_NAME, MODE_PRIVATE, null);

        // テーブルを作成する（存在しない場合のみ）
        db.execSQL("CREATE TABLE IF NOT EXISTS " + TABLE_NAME + " (" +
                COLUMN_ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +
                COLUMN_NAME + " TEXT, " +
                COLUMN_AGE + " INTEGER)");

        // データを挿入する
        ContentValues values = new ContentValues();
        values.put(COLUMN_NAME, "Alice");
        values.put(COLUMN_AGE, 20);
        db.insert(TABLE_NAME, null, values);

        values.clear();
        values.put(COLUMN_NAME, "Bob");
        values.put(COLUMN_AGE, 30);
        db.insert(TABLE_NAME, null, values);

        // データを取得する
        Cursor cursor = db.rawQuery("SELECT * FROM " + TABLE_NAME, null);

        // カーソルを移動する
        while (cursor.moveToNext()) {
            int id = cursor.getInt(cursor.getColumnIndex(COLUMN_ID));
            String name = cursor.getString(cursor.getColumnIndex(COLUMN_NAME));
            int age = cursor.getInt(cursor.getColumnIndex(COLUMN_AGE));

            // NULL値のチェック
            if (cursor.isNull(cursor.getColumnIndex(COLUMN_AGE))) {
                age = 0; // 例：NULL値を0として扱う
            }

            // 取得したデータを表示する
            TextView textView = findViewById(R.id.textView);
            textView.append("ID: " + id + ", Name: " + name + ", Age: " + age + "\n");
        }

        // カーソルを閉じる
        cursor.close();
    }
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="16sp" />

</LinearLayout>

このコードを実行すると、データベースから以下の出力が表示されます。

ID: 1, Name: Alice, Age: 20
ID: 2, Name: Bob, Age: 30

説明

MainActivity.java
- DATABASE_NAME、TABLE_NAME、COLUMN_ID、COLUMN_NAME、COLUMN_AGEなどの定数は、データベースとテーブルのスキーマを定義するために使用されます。

SQLiteCursorでNULL値を扱うその他の方法

三項演算子を使用する

int columnIndex = cursor.getColumnIndex("columnName");

if (columnIndex != -1) {
    int value = cursor.isNull(columnIndex) ? 0 : cursor.getInt(columnIndex);
    // ...
}

デフォルト値を設定する

int columnIndex = cursor.getColumnIndex("columnName");

if (columnIndex != -1) {
    int value = cursor.getInt(columnIndex, 0); // デフォルト値を0に設定
    // ...
}

try-catchブロックを使用する

int columnIndex = cursor.getColumnIndex("columnName");

if (columnIndex != -1) {
    try {
        int value = cursor.getInt(columnIndex);
        // ...
    } catch (NullPointerException e) {
        int value = 0; // 例外が発生したら0を代入
    }
}

カスタム型を使用する

class User {
    private int id;
    private String name;
    private Integer age; // Integer型を使用することで、NULL値を許容する

    // ...

    public User(int id, String name, Integer age) {
        this.id = id;
        this.name = name;
        this.age = age;
    }

    // ...
}

// ...

Cursor cursor = db.rawQuery("SELECT * FROM " + TABLE_NAME, null);

while (cursor.moveToNext()) {
    int id = cursor.getInt(cursor.getColumnIndex(COLUMN_ID));
    String name = cursor.getString(cursor.getColumnIndex(COLUMN_NAME));
    Integer age = cursor.isNull(cursor.getColumnIndex(COLUMN_AGE)) ? null : cursor.getInt(COLUMN_AGE);

    User user = new User(id, name, age);

    // ...
}