วิธีใช้ UNIQUE Constraint ใน Android SQLite

บทนำ: SQLite ใน Android

SQLite เป็นฐานข้อมูล SQL แบบโอเพนซอร์ส ที่จัดเก็บข้อมูลในไฟล์ข้อความบนอุปกรณ์ Android มีการรองรับ SQLite ในตัว รองรับคุณสมบัติของ Relational Database ทั้งหมด

ตัวอย่าง: การใช้ UNIQUE Constraint ป้องกันข้อมูลซ้ำ

ขั้นตอนที่ 1: สร้างโปรเจกต์ใหม่ใน Android Studio

ไปที่ File → New Project แล้วกรอกข้อมูลที่จำเป็น

ขั้นตอนที่ 2: ออกแบบ Layout เรียบง่าย (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" />

    <Button
        android:id="@+id/save"
        android:text="Save"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

ขั้นตอนที่ 3: เขียนโค้ด MainActivity.java

package com.example.andy.myapplication;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    Button save;
    EditText name, salary;

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

        final DatabaseHelper helper = new DatabaseHelper(this);
        name = findViewById(R.id.name);
        salary = findViewById(R.id.salary);

        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");
                }
            }
        });
    }
}

ขั้นตอนที่ 4: สร้าง DatabaseHelper.java - กำหนด UNIQUE Constraint

package com.example.andy.myapplication;

import android.content.ContentValues;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

class DatabaseHelper extends SQLiteOpenHelper {
    public static final String DATABASE_NAME = "MyDBName";
    public static final String CONTACTS_TABLE_NAME = "SalaryDetails";

    public DatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, 1);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        // สร้างตารางพร้อม UNIQUE Constraint
        db.execSQL("create table " + CONTACTS_TABLE_NAME + 
            "(id integer primary key NOT NULL UNIQUE, " +
            "name text NOT NULL UNIQUE, " +
            "salary text NOT NULL)");
    }

    @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);
        
        // insert() จะคืนค่า -1 ถ้า UNIQUE constraint violated
        long result = db.insert(CONTACTS_TABLE_NAME, null, contentValues);
        return result != -1;
    }
}

คำอธิบาย UNIQUE Constraint

UNIQUE - รับประกันว่าค่าในคอลัมน์ (หรือชุดคอลัมน์) ไม่ซ้ำกัน
id INTEGER PRIMARY KEY NOT NULL UNIQUE - PRIMARY KEY เป็น UNIQUE แล้ว โดยอัตโนมัติ
name TEXT NOT NULL UNIQUE - name ต้องไม่ซ้ำ และไม่เป็น NULL
พยายาม INSERT ค่าซ้ำ → SQLite จะโยน SQLiteConstraintException (UNIQUE constraint failed)

รูปแบบ UNIQUE Constraint ต่างๆ

-- คอลัมน์เดียว
CREATE TABLE users (email TEXT UNIQUE);

-- หลายคอลัมน์ (Composite Unique)
CREATE TABLE enrollments (
    student_id INTEGER,
    course_id INTEGER,
    UNIQUE(student_id, course_id)  -- นักเรียนเรียนคอร์สเดียวกันไม่ได้ซ้ำ
);

-- ชื่อ Constraint (เพื่อจัดการง่ายขึ้น)
CREATE TABLE products (
    sku TEXT,
    CONSTRAINT unique_sku UNIQUE (sku)
);

การจัดการ Error ใน Android

public boolean insert(String name, String salary) {
    SQLiteDatabase db = this.getWritableDatabase();
    ContentValues values = new ContentValues();
    values.put("name", name);
    values.put("salary", salary);
    
    try {
        long rowId = db.insertOrThrow(CONTACTS_TABLE_NAME, null, values);
        return rowId != -1;
    } catch (SQLiteConstraintException e) {
        // UNIQUE constraint violated
        Log.e("DB", "Duplicate entry: " + e.getMessage());
        return false;
    }
}

INSERT OR REPLACE / IGNORE

SQLite รองรับ Conflict Resolution:

INSERT OR IGNORE - ข้ามถ้าซ้ำ (ไม่ Error, ไม่ Insert)
INSERT OR REPLACE - ลบแถวเก่า Insert ใหม่ (เหมือน REPLACE INTO)
ในโค้ดตัวอย่างใช้ db.replace() ซึ่งทำงานแบบ REPLACE

การทดสอบ

รันแอป ป้อนชื่อ "John" เงินเดือน "50000" กด Save → Inserted
ป้อนชื่อ "John" อีกครั้ง (ซ้ำ) กด Save → NOT Inserted (เพราะ UNIQUE)
ตรวจสอบใน Database Inspector จะมีแค่ 1 แถวชื่อ John