AndroidのSQLiteでSUM()関数を使って合計値を取得する方法【サンプルコード付き】

SQLiteデータベースとは

具体的な実装例に入る前に、AndroidにおけるSQLiteデータベースの基礎知識をおさらいしておきましょう。SQLiteはオープンソースのSQLデータベースエンジンで、デバイス内のテキストファイル形式でデータを保存します。Androidには標準でSQLiteの実装が組み込まれており、追加のライブラリなしですぐに利用できます。

SQLiteはリレーショナルデータベースの主要な機能を一通りサポートしており、JDBCやODBCのような接続ドライバーを用意する必要がない点も大きな特徴です。アプリ内から直接アクセスできる手軽さが、Android開発で広く使われる理由です。

本記事では、SQLiteのSUM()集計関数を使って数値カラム（給与）の合計値を取得する方法を、実際に動くサンプルアプリとともに解説します。

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

今回作成するのは、名前と給与を入力してSQLiteに保存し、「Refresh」ボタンを押すとSUM()関数で計算した給与の合計額をListViewに表示するシンプルなアプリです。保存・更新・全件削除といった基本的なCRUD操作もあわせて実装します。

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

このレイアウトでは、名前用と給与用の2つのEditTextを配置しています。給与の入力欄には inputType="numberDecimal" を指定することで、数値のみ入力できるように制限している点がポイントです。「Save」「Refresh」「Update」「DeleteALL」の4つのボタンと、結果を表示するListViewも定義しています。

ユーザーが「Save」ボタンをタップすると入力したデータがSQLiteデータベースに保存され、「Refresh」ボタンをタップするとSUM()で算出した給与の合計が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.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クラスのメソッドを呼び出す構成になっています。処理結果はToastで画面に通知され、「Refresh」ボタンを押すたびにリストが再読み込みされて最新の合計額が表示されます。

ステップ4：DatabaseHelper.java の実装（SUM()の核心部分）

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 = "salaryDatabase5";
    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 money,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 (SUM(salary)) AS fullname from "+CONTACTS_TABLE_NAME, null );
        res.moveToFirst();
        while(res.isAfterLast() == false){
            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;
    }
}

SUM()を使っている重要な箇所

合計値の計算を行っているのは、getAllCotacts()メソッド内の次のSQL文です。

select (SUM(salary)) AS fullname from SalaryDetails

ここではSUM(salary)によってsalaryカラムの全レコードの合計値を算出し、AS fullnameでエイリアス（別名）を付けています。エイリアスを付けておくことで、CursorのgetColumnIndex("fullname")を使って結果の値を確実に取り出せます。rawQuery()の戻り値であるCursorをmoveToFirst()～isAfterLast()でループ処理しながらArrayListに詰めていくのが、Androidでクエリ結果を扱う定番のパターンです。

また、テーブル作成時にはid・name・salary・datetimeの各カラムを持つ「SalaryDetails」テーブルを定義しています。onUpgrade()では既存テーブルをDROPして再作成することで、スキーマ変更にも対応できるようにしています。

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

それではアプリを実行してみましょう。実機のAndroidスマートフォンをPCに接続している前提で説明します。Android Studioでアクティビティファイルを開き、ツールバーのRunアイコンをクリックしてください。デバイス選択ダイアログで自分のスマートフォンを選択すると、端末のデフォルト画面にアプリが起動します。

上記の実行結果のように、名前と給与を複数件保存した状態で「Refresh」ボタンをタップすると、保存されている全レコードの給与の合計値がListViewに表示されます。このように、SQLiteのSUM()関数を使えば、集計処理をSQL側で完結させることができ、アプリ側で数値を足し合わせるコードを書く必要がありません。売上管理や家計簿アプリなど、合計値を表示したい場面でぜひ活用してみてください。