안드로이드 앱에서 SQLite 데이터베이스 사용하는 방법 – 단계별 완벽 가이드

안드로이드 애플리케이션에서 SQLite 데이터베이스를 활용하면 별도의 서버 없이도 디바이스 내부에 데이터를 저장하고 관리할 수 있습니다. 이 튜토리얼에서는 축구 선수 명단을 저장하는 간단한 예제 앱을 만들어 보며, 데이터의 삽입·조회·수정·삭제(CRUD) 기능을 단계별로 구현하는 방법을 알아봅니다.

1단계: 새 프로젝트 생성하기

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

2단계: 메인 레이아웃 작성하기 (activity_main.xml)

res/layout/activity_main.xml에 아래 코드를 추가합니다. 이 레이아웃에는 DB 데이터를 목록으로 보여주는 ListView와, 저장된 데이터가 없을 때 화면 중앙에 표시할 TextView가 포함되어 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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"
    android:padding="8dp"
    tools:context=".MainActivity">
    <ListView
       android:id="@+id/listView"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:dividerHeight="1dp"
       android:padding="10dp" >
    </ListView>
    <TextView
       android:id="@+id/textView"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_centerInParent="true"
       android:text="" />
</RelativeLayout>

3단계: DataBaseManager 클래스 만들기

새 Java 클래스(DataBaseManager)를 생성하고 다음 코드를 추가합니다. 이 클래스는 데이터베이스를 열고 닫는 기능과 함께 레코드 삽입(insert), 조회(fetch), 수정(update), 삭제(delete) 메서드를 제공합니다.

import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;
public class DataBaseManager {
private DatabaseHelper databaseHelper;
private Context context;
private SQLiteDatabase database;
DataBaseManager(Context c) {
    context = c;
    }
    DataBaseManager open() throws SQLException {
        databaseHelper = new DatabaseHelper(context);
        database = databaseHelper.getWritableDatabase();
        return this;
    }
    public void close() {
        databaseHelper.close();
    }
    void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESCRIPTION, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }
    Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESCRIPTION };
        Cursor cursor = database.query(DatabaseHelper.TABLE_NAME, columns, null, null, null, null, null);
    if (cursor != null) {
        cursor.moveToFirst();
    }
    return cursor;
}
public int update(long _id, String name, String desc) {
    ContentValues contentValues = new ContentValues();
    contentValues.put(DatabaseHelper.SUBJECT, name);
    contentValues.put(DatabaseHelper.DESCRIPTION, desc);
    return database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
}
public void delete(long _id) {
    database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
}

4단계: DatabaseHelper 클래스 만들기

새 Java 클래스(DatabaseHelper)를 생성하고 다음 코드를 추가합니다. 이 클래스는 SQLiteOpenHelper를 상속받아 데이터베이스 생성과 버전 관리를 담당합니다.

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
class DatabaseHelper extends SQLiteOpenHelper {
    static final String TABLE_NAME = "FOOTBALLPLAYERS";
    static final String _ID = "_id";
    static final String SUBJECT = "subject";
    static final String DESCRIPTION = "description";
    private static final String DB_NAME = "PLAYER_COUNTRIES.DB";
    private static final int DB_VERSION = 1;
    private static final String CREATE_TABLE = "create table " + TABLE_NAME + "("
        + _ID + " INTEGER PRIMARY KEY AUTOINCREMENT, "
        + SUBJECT + " TEXT NOT NULL, " + DESCRIPTION + " TEXT);";
    DatabaseHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_TABLE);
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NAME);
        onCreate(db);
    }
}

5단계: MainActivity 작성하기

src/MainActivity.java에 다음 코드를 추가합니다. MainActivity는 DB에서 데이터를 조회해 ListView에 표시하고, 목록 항목을 클릭하면 해당 레코드를 수정할 수 있는 화면으로 이동합니다. 또한 옵션 메뉴를 통해 새 레코드를 추가할 수 있습니다.

import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.SimpleCursorAdapter;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
    DataBaseManager dataBaseManager;
    ListView listView;
    SimpleCursorAdapter adapter;
    final String[] from = new String[]{DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESCRIPTION};
    final int[] to = new int[]{R.id.id, R.id.title, R.id.desc};
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        Cursor cursor = dataBaseManager.fetch();
        listView = findViewById(R.id.listView);
        listView.setEmptyView(findViewById(R.id.textView));
        adapter = new SimpleCursorAdapter(this, R.layout.activity_view_record, cursor, from, to, 0);
        adapter.notifyDataSetChanged();
        listView.setAdapter(adapter);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long viewId) {
                TextView idTextView = view.findViewById(R.id.id);
                TextView titleTextView = view.findViewById(R.id.title);
                TextView descTextView = view.findViewById(R.id.desc);
                String id = idTextView.getText().toString();
                String title = titleTextView.getText().toString();
                String desc = descTextView.getText().toString();
                Intent modifyIntent = new Intent(getApplicationContext(), ModifyPlayerActivity.class);
                modifyIntent.putExtra("title", title);
                modifyIntent.putExtra("desc", desc);
                modifyIntent.putExtra("id", id);
                startActivity(modifyIntent);
            }
        });
    }
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }
    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        int id = item.getItemId();
        if (id == R.id.addRecord) {
            Intent addPlayer = new Intent(this, AddPlayerActivity.class);
            startActivity(addPlayer);
        }
        return super.onOptionsItemSelected(item);
    }
}

6단계: 추가·수정용 액티비티 만들기

두 개의 액티비티(AddPlayerActivity, ModifyPlayerActivity)를 생성하고 각각 다음 코드를 추가합니다.

AddPlayerActivity.java

새 선수 정보를 입력받아 데이터베이스에 삽입하는 화면입니다.

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import androidx.appcompat.app.AppCompatActivity;
public class AddPlayerActivity extends AppCompatActivity implements
View.OnClickListener {
    Button btnAdd;
    private EditText editSubject;
    private EditText editDescription;
    private DataBaseManager dataBaseManager;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle("Add Record");
        setContentView(R.layout.activity_addplayer);
        editSubject = findViewById(R.id.editTextSubject);
        editDescription = findViewById(R.id.editTextDescription);
        btnAdd = findViewById(R.id.add_record);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        btnAdd.setOnClickListener(this);
    }
    @Override
    public void onClick(View v) {
        if (v.getId() == R.id.add_record) {
            final String name = editSubject.getText().toString();
            final String desc = editDescription.getText().toString();
            dataBaseManager.insert(name, desc);
            Intent main = new Intent(AddPlayerActivity.this,
            MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
            startActivity(main);
        }
    }
}

activity_addplayer.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp">
    <EditText
       android:id="@+id/editTextSubject"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:ems="10"
       android:hint="Enter Name" >
       <requestFocus />
    </EditText>
    <EditText
       android:id="@+id/editTextDescription"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:hint="Enter Country"
       android:inputType="textMultiLine">
    </EditText>
    <Button
       android:id="@+id/add_record"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_gravity="center"
       android:text="Add Record" />
</LinearLayout>

ModifyPlayerActivity.java

선택한 레코드의 내용을 수정하거나 삭제할 수 있는 화면입니다.

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
public class ModifyPlayerActivity extends AppCompatActivity implements
View.OnClickListener {
    EditText editTextSub;
    Button updateBtn, deleteBtn;
    EditText editTextDesc;
    private long _id;
    DataBaseManager dataBaseManager;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle("Modify Record");
        setContentView(R.layout.activity_modify_player);
        dataBaseManager = new DataBaseManager(this);
        dataBaseManager.open();
        editTextSub = findViewById(R.id.editTextSub);
        editTextDesc = findViewById(R.id.editTextDesc);
        updateBtn = findViewById(R.id.btnUpdate);
        deleteBtn = findViewById(R.id.btnDelete);
        Intent intent = getIntent();
        String id = intent.getStringExtra("id");
        String name = intent.getStringExtra("title");
        String desc = intent.getStringExtra("desc");
        _id = Long.parseLong(id);
        editTextSub.setText(name);
        editTextDesc.setText(desc);
        updateBtn.setOnClickListener(this);
        deleteBtn.setOnClickListener(this);
    }
    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btnUpdate:
            String title = editTextSub.getText().toString();
            String desc = editTextDesc.getText().toString();
            dataBaseManager.update(_id, title, desc);
            this.returnHome();
            break;
            case R.id.btnDelete:
            dataBaseManager.delete(_id);
            this.returnHome();
            break;
        }
    }
    public void returnHome() {
        Intent home_intent = new Intent(getApplicationContext(),
        MainActivity.class).setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
        startActivity(home_intent);
    }
}

activity_modify_player.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="10dp" >
    <EditText
       android:id="@+id/editTextSub"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:layout_marginBottom="10dp"
       android:ems="10"
       android:hint="Enter Name" />
    <EditText
       android:id="@+id/editTextDesc"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:hint="Enter Country">
    </EditText>
    <LinearLayout
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:weightSum="2"
       android:gravity="center_horizontal"
       android:orientation="horizontal">
    <Button
       android:id="@+id/btnUpdate"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_weight="1"
       android:text="Update" />
    <Button
       android:id="@+id/btnDelete"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_weight="1"
       android:text="Delete" />
    </LinearLayout>
</LinearLayout>

7단계: 리스트 항목 레이아웃 만들기 (activity_view_record.xml)

새 레이아웃 리소스 파일(activity_view_record.xml)을 생성하고 다음 코드를 추가합니다. 이 레이아웃은 ListView의 각 항목에 ID, 이름, 국가 정보를 표시합니다.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp">
    <TextView
       android:id="@+id/id"
       android:layout_width="25dp"
       android:layout_height="wrap_content"
       android:layout_alignParentStart="true"
       android:layout_alignParentTop="true"
       android:layout_marginEnd="6dp"
       android:padding="3dp"
       android:visibility="visible" />
    <TextView
       android:id="@+id/title"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:layout_marginStart="10dp"
       android:layout_toEndOf="@id/id"
       android:maxLines="1"
       android:padding="3dp"
       android:textSize="17sp"
       android:textStyle="bold" />
    <TextView
       android:id="@+id/desc"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:layout_below="@id/title"
       android:layout_marginStart="10dp"
       android:layout_toEndOf="@id/id"
       android:ellipsize="end"
       android:maxLines="2"
       android:padding="3dp"
       android:visibility="visible" />
</RelativeLayout>

8단계: AndroidManifest.xml 설정하기

androidManifest.xml에 다음 코드를 추가하여 모든 액티비티를 등록합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">
    <application
       android:allowBackup="true"
       android:icon="@mipmap/ic_launcher"
       android:label="@string/app_name"
       android:roundIcon="@mipmap/ic_launcher_round"
       android:supportsRtl="true"
       android:theme="@style/AppTheme">
       <activity android:name=".ModifyPlayerActivity"></activity>
          <activity android:name=".MainActivity">
             <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
          </activity>
       <activity android:name=".AddPlayerActivity" />
    </application>
</manifest>

앱 실행 및 결과 확인

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