Android에서 SQLite를 활용해 데이터를 저장하는 방법 완벽 가이드

Android SQLite 데이터베이스란?

예제를 시작하기 전에 Android에서의 SQLite 데이터베이스가 무엇인지 먼저 알아보겠습니다. SQLite는 오픈소스 SQL 데이터베이스로, 기기 내 텍스트 파일 형태로 데이터를 저장합니다. Android에는 SQLite 데이터베이스 구현이 기본으로 내장되어 있어 별도의 설치 없이 바로 사용할 수 있습니다.

SQLite는 관계형 데이터베이스의 모든 핵심 기능을 지원하며, JDBC나 ODBC처럼 별도의 연결(Connection)을 설정할 필요 없이 간편하게 데이터베이스에 접근할 수 있다는 것이 가장 큰 장점입니다.

이번 예제에서는 사용자가 입력한 이름과 급여 정보를 SQLite 데이터베이스에 저장하는 방법을 단계별로 살펴보겠습니다.

1단계: 새 프로젝트 생성

Android Studio에서 File → New Project를 선택하고, 필요한 모든 세부 정보를 입력하여 새 프로젝트를 생성합니다.

2단계: 레이아웃 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" />
    <Button
        android:id = "@+id/save"
        android:text = "Save"
        android:layout_width = "wrap_content"
        android:layout_height = "wrap_content" />
</LinearLayout>

위 코드에서는 이름(name)과 급여(salary)를 입력받는 EditText 두 개와 저장(Save) 버튼을 배치했습니다. 사용자가 저장 버튼을 클릭하면 입력된 데이터가 SQLite 데이터베이스에 저장됩니다.

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

위 코드에서는 저장 버튼에 클릭 리스너를 등록했습니다. 이름과 급여 필드가 모두 채워져 있으면 DatabaseHelper의 insert() 메서드를 호출해 데이터를 저장하고, 성공 여부에 따라 Toast 메시지로 결과를 알려줍니다. 필드가 비어 있으면 에러 메시지를 표시합니다.

4단계: DatabaseHelper.java 작성

src/DatabaseHelper.java 파일에 아래 코드를 추가합니다. 이 클래스가 실제 SQLite 데이터베이스 생성과 데이터 삽입을 담당합니다.

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) {
        db.execSQL(
            "create table "+ CONTACTS_TABLE_NAME +"(id integer primary key, name text,salary text)"
        );
    }
    @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.insert(CONTACTS_TABLE_NAME, null, contentValues);
        return true;
    }
}

DatabaseHelper 클래스는 SQLiteOpenHelper를 상속받습니다. onCreate()에서는 id, name, salary 컬럼을 가진 테이블을 생성하고, onUpgrade()에서는 기존 테이블을 삭제한 후 새로 생성합니다. insert() 메서드는 ContentValues 객체에 데이터를 담아 테이블에 삽입하는 역할을 수행합니다.

애플리케이션 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 Android 모바일 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 열고 툴바의 Run(실행) 아이콘을 클릭하세요. 실행 옵션 목록에서 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.

화면에 이름과 급여 값을 입력한 후 저장 버튼을 클릭합니다.

데이터가 정상적으로 저장되었는지 확인하려면 Android Studio에서 아래와 같이 데이터베이스 내용을 조회해 보면 됩니다.

마무리

이처럼 Android에서는 SQLiteOpenHelper 클래스를 상속받아 손쉽게 로컬 데이터베이스를 구축하고 데이터를 저장할 수 있습니다. 별도의 서버 연결 없이 기기 내부에 데이터를 영구적으로 보관해야 하는 앱을 개발할 때 SQLite는 매우 유용한 선택입니다.