Android 本地数据存储：SQLite 增删改查实战

这里需要注意，实际开发中如果修改了表结构，需要增加 version 并在 onUpgrade 中处理数据迁移或重建。

UI 布局设计

界面主要包含输入框用于填写用户信息，以及查询条件输入框，底部放置操作按钮。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="10dp"
    tools:context=".MainActivity">

    <!-- 编号输入 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:text="编号" />

        <EditText
            android:id="@+id/code"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:ems="10"
            android:inputType="number"
            android:hint="输入编号"
            android:text="" />
    </LinearLayout>

    <!-- 姓名输入 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:text="姓名" />

        <EditText
            android:id="@+id/name"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:ems="10"
            android:hint="输入姓名"
            android:inputType="text"
            android:text="" />

    </LinearLayout>

    <!-- 年龄输入 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:text="年龄" />

        <EditText
            android:id="@+id/age"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:ems="10"
            android:hint="输入年龄"
            android:inputType="number"
            android:text="" />
    </LinearLayout>

    <!-- 查询条件 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:text="编号" />

        <EditText
            android:id="@+id/findCode"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:ems="10"
            android:hint="输入查找编号"
            android:inputType="number"
            android:text="" />
    </LinearLayout>

    <!-- 操作按钮组 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <Button
            android:id="@+id/add"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:onClick="addHandle"
            android:text="新增" />

        <Button
            android:id="@+id/delete"
            android:layout_marginStart="10dp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:onClick="deleteHandle"
            android:text="删除" />

        <Button
            android:id="@+id/update"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:layout_marginHorizontal="10dp"
            android:onClick="updateHandle"
            android:text="修改" />

        <Button
            android:id="@+id/query"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:onClick="findHandle"
            android:text="查询" />

    </LinearLayout>

    <!-- 结果显示区域 -->
    <TextView
        android:id="@+id/showBlock"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:hint="显示查询信息"
        android:text="" />
</LinearLayout>

业务逻辑实现

在 MainActivity 中，我们获取数据库实例并绑定事件。这里重点展示如何使用参数化 SQL 语句来防止注入风险，以及如何遍历结果集。

public class MainActivity extends AppCompatActivity {
    EditText code, name, age;
    EditText findCode;
    Button add, update, query, delete;
    TextView showBlock;
    SQLiteDatabase sqLiteDatabase;

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

    private void initView() {
        MyDataBase myDataBase = new MyDataBase(this);
        // 初始化控件
        code = findViewById(R.id.code);
        name = findViewById(R.id.name);
        age = findViewById(R.id.age);
        findCode = findViewById(R.id.findCode);

        add = findViewById(R.id.add);
        update = findViewById(R.id.update);
        query = findViewById(R.id.query);
        delete = findViewById(R.id.delete);
        showBlock = findViewById(R.id.showBlock);

        // 获取可写数据库对象
        sqLiteDatabase = myDataBase.getWritableDatabase();
    }

    // 新增数据
    public void addHandle(View view) {
        if (code.getText().toString().trim().isEmpty()) {
            Toast.makeText(this, "请输入编号", Toast.LENGTH_SHORT).show();
            return;
        }
        try {
            int codeVal = Integer.parseInt(code.getText().toString().trim());
            String nameVal = name.getText().toString().trim();
            int ageVal = Integer.parseInt(age.getText().toString().trim());

            // 使用占位符 ? 传递参数，避免 SQL 注入
            String sql = "insert into user(code, name, age) values(?,?,?)";
            sqLiteDatabase.execSQL(sql, new Object[]{codeVal, nameVal, ageVal});
            Toast.makeText(this, "新增成功", Toast.LENGTH_SHORT).show();
        } catch (NumberFormatException e) {
            Toast.makeText(this, "格式错误", Toast.LENGTH_SHORT).show();
        }
    }

    // 删除数据
    public void deleteHandle(View view) {
        if (findCode.getText().toString().trim().isEmpty()) {
            Toast.makeText(this, "请输入要删除的编号", Toast.LENGTH_SHORT).show();
            return;
        }
        try {
            int codeVal = Integer.parseInt(findCode.getText().toString().trim());
            String sql = "delete from user where code=?";
            sqLiteDatabase.execSQL(sql, new Object[]{codeVal});
            Toast.makeText(this, "删除成功", Toast.LENGTH_SHORT).show();
        } catch (NumberFormatException e) {
            Toast.makeText(this, "格式错误", Toast.LENGTH_SHORT).show();
        }
    }

    // 修改数据
    public void updateHandle(View view) {
        if (findCode.getText().toString().trim().isEmpty()) {
            Toast.makeText(this, "请输入要修改的编号", Toast.LENGTH_SHORT).show();
            return;
        }
        try {
            int codeVal = Integer.parseInt(findCode.getText().toString().trim());
            String nameVal = name.getText().toString().trim();
            int ageVal = Integer.parseInt(age.getText().toString().trim());

            String sql = "update user set name=?, age=? where code=?";
            sqLiteDatabase.execSQL(sql, new Object[]{nameVal, ageVal, codeVal});
            Toast.makeText(this, "修改成功", Toast.LENGTH_SHORT).show();
            // 修改后自动刷新查询结果
            findHandle(view);
        } catch (NumberFormatException e) {
            Toast.makeText(this, "格式错误", Toast.LENGTH_SHORT).show();
        }
    }

    // 查询数据
    public void findHandle(View view) {
        showBlock.setText("");
        String codeStr = findCode.getText().toString().trim();

        if (codeStr.isEmpty()) {
            Toast.makeText(this, "请输入查询编号", Toast.LENGTH_SHORT).show();
            return;
        }

        String sql = "select * from user where code=?";
        Cursor cursor = sqLiteDatabase.rawQuery(sql, new String[]{codeStr});

        boolean hasData = false;
        while (cursor.moveToNext()) {
            // 注意：在实际项目中建议使用 getColumnIndexOrThrow 并检查列是否存在
            @SuppressLint("Range") String nameVal = cursor.getString(cursor.getColumnIndex("name"));
            @SuppressLint("Range") int ageVal = cursor.getInt(cursor.getColumnIndex("age"));
            
            showBlock.append("编号：" + codeStr + "\t姓名：" + nameVal + "\t年龄：" + ageVal + "\n");
            hasData = true;
        }
        cursor.close(); // 记得关闭游标释放资源

        if (!hasData) {
            showBlock.setText("暂无查询数据");
        }
    }
}

运行示意

开发建议

1. 线程安全：上述代码在主线程执行数据库操作。对于耗时查询，建议在子线程中进行，避免 ANR。
2. 资源管理：务必在操作完成后关闭 Cursor，防止内存泄漏。
3. 异常处理：增加了 try-catch 块来处理数字转换异常，提升用户体验。
4. 安全性：始终使用参数化查询（?），不要直接拼接字符串构建 SQL。