Android SQLiteでLIMIT句を使って取得件数を制限する方法

AndroidのSQLiteデータベースとは

具体的な手順に入る前に、AndroidにおけるSQLiteデータベースについて簡単におさらいしておきましょう。SQLiteはオープンソースのSQLデータベースエンジンで、デバイス上のテキストファイルとしてデータを保存します。AndroidにはSQLiteが標準で組み込まれており、リレーショナルデータベースの主要な機能をすべて利用できます。さらに、JDBCやODBCのような特別な接続設定が不要で、手軽にデータベースへアクセスできるのも大きな特徴です。

この記事では、AndroidのSQLiteでLIMIT句を使用し、クエリ結果の取得件数を制限する方法を、サンプルアプリのコードとともにステップごとに解説します。

手順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" />
   </LinearLayout>

   <ListView
      android:id="@+id/listView"
      android:layout_width="match_parent"
      android:layout_height="wrap_content">
   </ListView>
</LinearLayout>

このレイアウトでは、「名前」と「給与」を入力するためのEditTextを2つ配置しています。「Save」ボタンをタップすると入力内容がSQLiteデータベースに保存され、「Refresh」ボタンをタップするとLIMIT句を適用したカーソルの結果をもとに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;
   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);
      final ArrayAdapter arrayAdapter = new ArrayAdapter(MainActivity.this, android.R.layout.simple_list_item_1, array_list);
      listView.setAdapter(arrayAdapter);
      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経由でデータを挿入します。挿入の成否はToastで通知される仕組みです。

手順4：DatabaseHelper.java の実装

続いて、src/DatabaseHelper.java に以下のコードを追加します。

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

   @Override
   public void onCreate(SQLiteDatabase db) {
      try {
         db.execSQL(
            "create table "+ CONTACTS_TABLE_NAME +"(id INTEGER PRIMARY KEY, name text,salary text )"
         );
      } 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 * from "+CONTACTS_TABLE_NAME+" LIMIT 2", null );
      res.moveToFirst();

      while(res.isAfterLast() == false) {
         array_list.add(res.getString(res.getColumnIndex("name")));
         res.moveToNext();
      }
      return array_list;
   }

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

このコードのポイントは、getAllCotacts() メソッド内のSQL文にある 「LIMIT 2」 の部分です。SELECT文の末尾にLIMIT句を付けることで、テーブルに何件のデータが登録されていても、取得できるのは先頭の2件だけになります。この数字を変更すれば、任意の件数に制限できます。

アプリを実行して結果を確認する

それではアプリを実行してみましょう。実機のAndroidスマートフォンをパソコンに接続している状態を想定します。Android Studioでプロジェクト内のいずれかのアクティビティファイルを開き、ツールバーの実行アイコンをクリックしてください。デバイス選択画面で自分のモバイル端末を選ぶと、端末に以下のような初期画面が表示されます。

実行結果を見ると、テーブルに複数件のデータが存在する場合でも、画面には2件しか表示されていません。これはクエリに「LIMIT 2」を指定しているためです。このようにLIMIT句を活用すれば、大量のデータの中から必要な件数だけを効率よく取得でき、ページネーションや一覧表示のパフォーマンス向上にも役立ちます。