Android SQLiteのquote()関数の使い方をステップごとに解説

AndroidにおけるSQLiteとは

具体的な例に入る前に、AndroidにおけるSQLiteデータベースについて簡単に確認しておきましょう。SQLiteは、デバイス上のテキストファイルにデータを保存するオープンソースのSQLデータベースです。Androidには標準でSQLiteデータベースの実装が組み込まれており、リレーショナルデータベースの機能をすべてサポートしています。

また、このデータベースにアクセスする際、JDBCやODBCなどのような接続を確立する必要はありません。これがAndroidアプリ開発でSQLiteが広く使われる理由の一つです。

本記事では、AndroidのSQLiteでquote()関数を使用する方法を、実際のサンプルコードとともに段階的に解説します。quote()関数を使うと、テキスト値をシングルクォート（'）で囲んだ形式で取得できるため、SQL文の生成やデバッグの際に便利です。

ステップ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>

このレイアウトでは、「名前（name）」と「給与（salary）」の2つのEditTextを配置しています。ユーザーが「Save」ボタンをタップすると、入力したデータがSQLiteデータベースに保存されます。「Refresh」ボタンを押すと、ListViewに保存済みのデータ一覧が表示されます。

ステップ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 readdInstanceState) {
      super.onCreate(readdInstanceState);
      setContentView(R.layout.activity_main);
      final DatabaseHelper helper = new DatabaseHelper(this);
      final ArrayList array_list = helper.getAllCotacts();
      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.getAllCotacts());
            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クラスを通じてデータベース操作を行っています。入力欄が空の場合にはエラーを表示するバリデーションも実装されています。

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

次に、src/DatabaseHelper.javaに以下のコードを追加します。quote()関数を使用しているのは、getAllCotacts()メソッド内のrawQueryです。

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.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
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 float,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 getAllCotacts() {
      SQLiteDatabase db = this.getReadableDatabase();
      ArrayList<String> array_list = new ArrayList<String>();
      Cursor res = db.rawQuery("select quote(name) 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;
   }
}

ポイントとなるのは次の行です。SELECT文の中でquote(name)を呼び出し、結果を「fullname」という別名で受け取っています。

Cursor res = db.rawQuery("select quote(name) as fullname from " + CONTACTS_TABLE_NAME, null);

アプリを実行してみよう

それではアプリを実行してみましょう。実際のAndroidスマートフォンをパソコンに接続しているものとします。Android Studioからアプリを起動するには、プロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された選択肢から自分のモバイルデバイスを選択すると、接続された端末にアプリの初期画面が表示されます。

実行結果の確認

上記の実行結果を見ると、名前として「sairam」を保存しています。SQLiteのquote()関数を使って名前を変換することで、結果として「'sairam'」のようにシングルクォートで囲まれた形式で文字列が返されていることが確認できます。

このように、quote()関数を活用すれば、データベース内のテキスト値を引用符付きの安全な形式で取得できます。SQL文を動的に組み立てる場面や、データの整合性を確認したい場合にぜひ活用してみてください。