Android上SQLite的基本应用（一）

最新推荐文章于 2025-04-05 19:24:31 发布

原创最新推荐文章于 2025-04-05 19:24:31 发布 · 727 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#android #数据库 #sqlite

android 同时被 2 个专栏收录

68 篇文章

订阅专栏

SQLite

15 篇文章

订阅专栏

本文详细介绍如何在Android应用中使用SQLite数据库，包括创建数据库、更新数据库版本及基本的数据库操作流程。通过自定义辅助类简化数据库操作，并介绍了业务逻辑处理类的设计。

SQLiteOpenHelper

Android 底层已经通过一个SQLiteOpenHelper的抽象类将数据库的创建，以及修改，更新等都放在了里面。

要使用它必须实现它的OnCreate(SQLiteDatabase db)，onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 方法。

onCreate：当数据库第一次被建立的时候被执行，例如创建表,初始化数据等。
onUpgrade：当数据库需要被更新的时候执行，例如删除久表，创建新表。

自定义辅助类

我们要在Android中使用SQLite，自然要一个数据库辅助类来创建或打开数据库，这个辅助类继承自SQLiteOpenHelper类。除了必须重写SQLiteOpenHelper的两个抽象方法外，我们还要创建辅助类的构造方法。

/*
 * SqliteOpenHelper
 * 1.提供了onCreate(), onUpGrade()等创建数据库更新数据库的函数
 * 2.提供了获取数据库对象的函数
 */
public class MySqliteHelper extends SQLiteOpenHelper {

    /**
     * 构造函数
     * @param context 上下文对象
     * @param name 表示创建数据库的名称
     * @param factory 游标工厂
     * @param version 表示创建数据库的版本
     */
    public MySqliteHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
        super(context, name, factory, version);
    }

    /**
     * 当数据库创建时回调的函数
     * @param db 数据库对象
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        Log.i("TAG", "-------onCreate--------");
    }

    /**
     * 当数据库版本更新时回调的函数
     * @param db 数据库对象
     * @param oldVersion 数据库旧版本
     * @param newVersion 数据库新版本
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        Log.i("TAG", "-------onUpGrade-------");
    }

    /**
     * 当数据库打开时回调的函数
     * @param db 数据库对象
     */
    @Override
    public void onOpen(SQLiteDatabase db) {
        super.onOpen(db);
        Log.i("TAG", "-------onOpen-------");
    }
}

onOpen 方法并不是必须重写的方法，是打开数据库会回调的函数，我们用 log 日志来监控数据库的状况。

看到MySqliteHelper类的构造方法可以知道，我们要传入这几个参数比较麻烦，如果每次实例化都需要传入，不利于修改阅读，所以我们通常会创建一个常量类来保存数据库名，版本号这些常量。像如果以后版本号更新了，我们可以很简单的修改。

常量类

在这里我们先创建这几个常量。

public class Constant {
    public static final String DATABASE_NAME = "info.db"; //数据库名称
    public static final int DATABASE_VERSION = 1; //数据库版本
    public static final String TABLE_NAME = "person"; //表名
}

既然这几个参数我们都已经确定好了，那就可以修改我们的构造函数啦。

    public MySqliteHelper(Context context) {
        super(context, Constant.DATABASE_NAME, null, Constant.DATABASE_VERSION);
    }

现在只需要传入上下文即可，CursorFactory 为 null，数据库名称和版本号引用常量就可以啦。

业务逻辑处理类

我们的 MySqliteHelper 实现了数据库的建立和打开，相当于是一个持久化数据的存储，而 MainActivity 是整个页面数据的展示，我们为了降低耦合度（两者之间的密切关系程度，也可以理解为互相依赖的程度），通常建立一个 DbManager 类，来实现数据库的逻辑处理。

/**
 * 主要是对数据库操作的工具类
 */
public class DbManager {

    public enum Something {
        INSTANCE;
        private MySqliteHelper helper;

        public MySqliteHelper getInstance(Context context) {
            if (helper == null) {
                helper = new MySqliteHelper(context);
            }
            return helper;
        }
    }
}

因为是对数据库的操作，所以我们这里用单例模式，这里我用了枚举的方法。对单例模式不了解的朋友，可以看看我的另一篇博客Java–单例模式。

布局文件

现在我们已经初步搭建好了数据库，可以测试数据库是否可以被创建。这里我是用 Button 的点击事件来操作，下面就是 xml 文件，只是很简单的布局，也是这个博客对数据库操作的主要内容。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin">

    <LinearLayout
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:layout_weight="1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="创建数据库"
            android:onClick="createDb"
            android:background="#ff3" />

        <Button
            android:layout_marginLeft="10dp"
            android:layout_marginRight="10dp"
            android:id="@+id/btn_insert"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="插入数据"
            android:onClick="click"
            android:background="#ff3"
            android:layout_weight="1" />

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_delete"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="删除数据"
            android:onClick="click"
            android:background="#ff3" />

    </LinearLayout>

    <LinearLayout
        android:layout_marginTop="60dp"
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_update"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="修改数据"
            android:onClick="click"
            android:background="#ff3" />

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_deleteApi"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="删除数据api"
            android:onClick="onClick"
            android:background="#ff3"
            android:layout_marginLeft="10dp"
            android:layout_marginRight="10dp"/>

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_query"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="sql语句查询"
            android:onClick="click"
            android:background="#ff3" />

    </LinearLayout>

    <LinearLayout
        android:layout_marginTop="120dp"
        android:orientation="horizontal"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_insertApi"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="插入数据api"
            android:onClick="onClick"
            android:background="#ff3" />

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_queryApi"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="API查询"
            android:onClick="onClick"
            android:background="#ff3"
            android:layout_marginRight="10dp"
            android:layout_marginLeft="10dp"/>

        <Button
            android:layout_weight="1"
            android:id="@+id/btn_updateApi"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="修改数据api"
            android:onClick="onClick"
            android:background="#ff3" />

    </LinearLayout>
</RelativeLayout>

我们得到的就是这样的页面，现在先让我们创建数据库。

创建数据库

public class MainActivity extends AppCompatActivity {

    private MySqliteHelper helper;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        helper = DbManager.Something.INSTANCE.getInstance(this);
    }

    /*
    点击按钮创建数据库
     */
    public void createDb(View view) {
       SQLiteDatabase db = helper.getWritableDatabase();
    }
}