安卓SQLite数据库示例教程

1 年 ago
清, 扬
9 minutes

欢迎来到Android SQLite示例教程。Android SQLite是存储Android应用程序数据的首选方式。对于许多应用程序来说，无论是直接使用还是通过第三方封装，SQLite都是应用程序的支柱。下面是我们今天将使用Android SQLite数据库创建的最终应用程序。

安卓 SQLite

Android SQLite是一个非常轻量级的数据库，它是Android操作系统的一部分。Android SQLite将清晰的SQL界面与占用内存极小和良好的速度结合起来。对于Android平台，SQLite已经“深度融入”到Android运行时环境中，因此每个Android应用都可以创建自己的SQLite数据库。Android SQLite本地API不是JDBC，因为JDBC可能对于内存有限的智能手机来说过于繁重。一旦成功创建一个数据库，它将位于data/data//databases/路径下，通过Android Device Monitor可以访问。SQLite是一个典型的关系型数据库，包含表（由行和列组成）、索引等。我们可以根据需要创建自己的表来存储数据。这个结构被称为模式（schema）。

安卓 SQLite SQLiteOpenHelper

Android具有可处理更改数据库模式的功能，这主要依赖于使用SQLiteOpenHelper类。SQLiteOpenHelper被设计用于消除两个非常常见的问题。

    1. 当应用程序首次运行时 – 此时我们还没有数据库。因此我们需要创建表格、索引、初始数据等等。

 

    当应用程序升级到较新的架构时 – 我们的数据库仍会保留老版本应用程序的旧架构。我们将有选项来修改数据库架构以满足应用程序的其他需求。

SQLiteOpenHelper封装了这些逻辑，根据我们的规范创建和升级数据库。为此，我们需要创建一个自定义的SQLiteOpenHelper子类，至少实现以下三个方法。

    1. 构造函数：该构造函数接受上下文（例如一个Activity），数据库名称，可选的游标工厂（稍后将讨论此内容），以及表示数据库模式版本的整数（通常从1开始递增）。

 

    1. public DatabaseHelper(Context context) {

 

    1. super(context, DB_NAME, null, DB_VERSION);

 

    1. }

onCreate(SQLiteDatabase db)：当没有数据库且应用程序需要一个时调用此函数。它传递给我们一个指向新创建的数据库的SQLiteDatabase对象，我们可以使用它来填充表格和初始数据。

onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)：当我们需要的模式版本与数据库的模式版本不匹配时调用此函数。它传递给我们一个SQLiteDatabase对象和旧版本号和新版本号。因此，我们可以找出将数据库从旧模式转换为新模式的最佳方法。

我们定义了一个DBManager类来执行所有数据库的增、删、改、查操作。

Android SQLite数据库连接的打开和关闭

在执行任何数据库操作之前，如在表中插入、更新、删除记录，首先要通过调用getWritableDatabase()方法来打开数据库连接，如下所示：

public DBManager open() throws SQLException {
        dbHelper = new DatabaseHelper(context);
        database = dbHelper.getWritableDatabase();
        return this;
    }

DbHelper 是 SQLiteOpenHelper 的子类的一个实例。为了关闭数据库连接，会调用下面的方法。

 public void close() {
        dbHelper.close();
    }

将新记录插入Android SQLite数据库表中。

以下代码片段展示了如何在Android SQLite数据库中插入一条新记录。

public void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESC, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }

Content Values在给定的初始大小下创建一个空值集合。当我们开始编码部分时，我们将讨论其他实例值。

在Android SQLite数据库表中更新记录

下面的代码片段展示了如何更新单条记录。

public int update(long _id, String name, String desc) {
        ContentValues contentValues = new ContentValues();
        contentValues.put(DatabaseHelper.SUBJECT, name);
        contentValues.put(DatabaseHelper.DESC, desc);
        int i = database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
        return i;
    }

Android SQLite – 删除记录

我们只需要按照以下方式传递要删除的记录的ID即可。

public void delete(long _id) {
        database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
    }

安卓SQLite游标

游标表示查询的整个结果集。一旦查询被获取，将会调用cursor.moveToFirst()。调用moveToFirst()会做两件事情：

  • It allows us to test whether the query returned an empty set (by testing the return value)
  • It moves the cursor to the first result (when the set is not empty)

以下代码用于获取所有的记录。

 public Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESC };
        Cursor cursor = database.query(DatabaseHelper.TABLE_NAME, columns, null, null, null, null, null);
        if (cursor != null) {
            cursor.moveToFirst();
        }
        return cursor;
    }

另一种使用光标的方式是将其包装在CursorAdapter中。就像ArrayAdapter适配数组一样，CursorAdapter适配Cursor对象，将其数据提供给像ListView这样的AdapterView。让我们跳转到使用SQLite存储一些有意义数据的项目中。

Android SQLite例子项目的架构

在这个应用中，我们希望创建一个记录国家名称和其相应货币的ListView形式的列表。我们涵盖了上述讨论的所有功能。

安卓SQLite项目代码

这个应用程序由5个类组成。我们首先定义DatabaseHelper，它是SQLiteOpenHelper的子类，代码如下：DatabaseHelper.java

package com.Olivia.sqlite;

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

public class DatabaseHelper extends SQLiteOpenHelper {

    // Table Name
    public static final String TABLE_NAME = "COUNTRIES";

    // Table columns
    public static final String _ID = "_id";
    public static final String SUBJECT = "subject";
    public static final String DESC = "description";

    // Database Information
    static final String DB_NAME = "JOURNALDEV_COUNTRIES.DB";

    // database version
    static final int DB_VERSION = 1;

    // Creating table query
    private static final String CREATE_TABLE = "create table " + TABLE_NAME + "(" + _ID
            + " INTEGER PRIMARY KEY AUTOINCREMENT, " + SUBJECT + " TEXT NOT NULL, " + DESC + " TEXT);";

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

如上所述，除了构造函数之外，我们已经重写了onCreate()和onUpgrade()方法。我们为数据库和表分别指定了名称为JOURNALDEV_COUNTRIES.DB和COUNTRIES。每当插入新行时，索引列会自动增加。国家和货币的列名分别是“subject”和“description”。DBManager类是初始化DatabaseHelper并定义CRUD操作的地方。以下是这个类的代码：DBManager.java。

package com.Olivia.sqlite;


import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;

public class DBManager {

    private DatabaseHelper dbHelper;

    private Context context;

    private SQLiteDatabase database;

    public DBManager(Context c) {
        context = c;
    }

    public DBManager open() throws SQLException {
        dbHelper = new DatabaseHelper(context);
        database = dbHelper.getWritableDatabase();
        return this;
    }

    public void close() {
        dbHelper.close();
    }

    public void insert(String name, String desc) {
        ContentValues contentValue = new ContentValues();
        contentValue.put(DatabaseHelper.SUBJECT, name);
        contentValue.put(DatabaseHelper.DESC, desc);
        database.insert(DatabaseHelper.TABLE_NAME, null, contentValue);
    }

    public Cursor fetch() {
        String[] columns = new String[] { DatabaseHelper._ID, DatabaseHelper.SUBJECT, DatabaseHelper.DESC };
        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.DESC, desc);
        int i = database.update(DatabaseHelper.TABLE_NAME, contentValues, DatabaseHelper._ID + " = " + _id, null);
        return i;
    }

    public void delete(long _id) {
        database.delete(DatabaseHelper.TABLE_NAME, DatabaseHelper._ID + "=" + _id, null);
    }

}

当应用程序启动时，CountryListActivity.java类是被启动的活动。下面是为其定义的布局：fragment_emp_list.xml。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" >

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:dividerHeight="1dp"
        android:padding="10dp" >
    </ListView>

    <TextView
        android:id="@+id/empty"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="@string/empty_list_text" />

</RelativeLayout>

在这里定义了一个ListView组件来包含存储在数据库中的记录。最初，ListView是空的，因此使用TextView来显示相同的内容。CountryListActivity.java

package com.Olivia.sqlite;

import android.content.Intent;
import android.database.Cursor;
import android.os.Bundle;
import android.support.v4.widget.SimpleCursorAdapter;
import android.support.v7.app.ActionBarActivity;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.TextView;

public class CountryListActivity extends ActionBarActivity {

    private DBManager dbManager;

    private ListView listView;

    private SimpleCursorAdapter adapter;

    final String[] from = new String[] { DatabaseHelper._ID,
            DatabaseHelper.SUBJECT, DatabaseHelper.DESC };

    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.fragment_emp_list);

        dbManager = new DBManager(this);
        dbManager.open();
        Cursor cursor = dbManager.fetch();

        listView = (ListView) findViewById(R.id.list_view);
        listView.setEmptyView(findViewById(R.id.empty));

        adapter = new SimpleCursorAdapter(this, R.layout.activity_view_record, cursor, from, to, 0);
        adapter.notifyDataSetChanged();

        listView.setAdapter(adapter);

        // OnCLickListiner For List Items
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long viewId) {
                TextView idTextView = (TextView) view.findViewById(R.id.id);
                TextView titleTextView = (TextView) view.findViewById(R.id.title);
                TextView descTextView = (TextView) view.findViewById(R.id.desc);

                String id = idTextView.getText().toString();
                String title = titleTextView.getText().toString();
                String desc = descTextView.getText().toString();

                Intent modify_intent = new Intent(getApplicationContext(), ModifyCountryActivity.class);
                modify_intent.putExtra("title", title);
                modify_intent.putExtra("desc", desc);
                modify_intent.putExtra("id", id);

                startActivity(modify_intent);
            }
        });
    }

    @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.add_record) {

            Intent add_mem = new Intent(this, AddCountryActivity.class);
            startActivity(add_mem);

        }
        return super.onOptionsItemSelected(item);
    }

}

在这个活动中，调用DBManager对象来执行CRUD操作。定义了一个SimpleCursorAdapter来将查询结果中返回的Cursor对象中的元素添加到列表中。在列表项点击时，执行一个意图来打开ModifyCountryActivity类。菜单中包含一个从ActionBar中添加新记录的项目。在这里，再次执行一个意图来打开AddCountryActivity类。以下是menu.xml的代码。

<menu xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    tools:context="com.example.sqlitesample.MainActivity" >

    <item
        android:id="@+id/add_record"
        android:icon="@android:drawable/ic_menu_add"
        android:orderInCategory="100"
        android:title="@string/add_record"
        app:showAsAction="always"/>

</menu>

以下是AddCountryActivity.java文件的xml布局和代码：activity_add_record.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="20dp" >

    <EditText
        android:id="@+id/subject_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_title" >

        <requestFocus />
    </EditText>

    <EditText
        android:id="@+id/description_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_desc"
        android:inputType="textMultiLine"
        android:minLines="5" >
    </EditText>

    <Button
        android:id="@+id/add_record"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="@string/add_record" />

</LinearLayout>

定义了两个EditText组件，用于输入国家和货币，以及一个按钮，将这些值添加到数据库并在ListView中显示。AddCountryActivity.java

package com.Olivia.sqlite;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;

public class AddCountryActivity extends Activity implements OnClickListener {

    private Button addTodoBtn;
    private EditText subjectEditText;
    private EditText descEditText;

    private DBManager dbManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setTitle("Add Record");

        setContentView(R.layout.activity_add_record);

        subjectEditText = (EditText) findViewById(R.id.subject_edittext);
        descEditText = (EditText) findViewById(R.id.description_edittext);

        addTodoBtn = (Button) findViewById(R.id.add_record);

        dbManager = new DBManager(this);
        dbManager.open();
        addTodoBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.add_record:

                final String name = subjectEditText.getText().toString();
                final String desc = descEditText.getText().toString();

                dbManager.insert(name, desc);

                Intent main = new Intent(AddCountryActivity.this, CountryListActivity.class)
                        .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

                startActivity(main);
                break;
        }
    }

}

在这里执行的CRUD操作是向数据库中添加一条新记录。下面定义了ModifyCountryActivity.java文件的xml布局和代码：activity_modify_record.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/subject_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="10dp"
        android:ems="10"
        android:hint="@string/enter_title" />

    <EditText
        android:id="@+id/description_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10"
        android:hint="@string/enter_desc"
        android:inputType="textMultiLine"
        android:minLines="5" >
    </EditText>


    <LinearLayout
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:weightSum="2"
        android:gravity="center_horizontal"
        android:orientation="horizontal" >

        <Button
            android:id="@+id/btn_update"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="@string/btn_update" />

        <Button
            android:id="@+id/btn_delete"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="@string/btn_delete" />
    </LinearLayout>

</LinearLayout>

这与以前的布局相似，只是添加了修改和删除按钮。ModifyCountryActivity.java

package com.Olivia.sqlite;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;

public class ModifyCountryActivity extends Activity implements OnClickListener {

    private EditText titleText;
    private Button updateBtn, deleteBtn;
    private EditText descText;

    private long _id;

    private DBManager dbManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setTitle("Modify Record");

        setContentView(R.layout.activity_modify_record);

        dbManager = new DBManager(this);
        dbManager.open();

        titleText = (EditText) findViewById(R.id.subject_edittext);
        descText = (EditText) findViewById(R.id.description_edittext);

        updateBtn = (Button) findViewById(R.id.btn_update);
        deleteBtn = (Button) findViewById(R.id.btn_delete);

        Intent intent = getIntent();
        String id = intent.getStringExtra("id");
        String name = intent.getStringExtra("title");
        String desc = intent.getStringExtra("desc");

        _id = Long.parseLong(id);

        titleText.setText(name);
        descText.setText(desc);

        updateBtn.setOnClickListener(this);
        deleteBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_update:
                String title = titleText.getText().toString();
                String desc = descText.getText().toString();

                dbManager.update(_id, title, desc);
                this.returnHome();
                break;

            case R.id.btn_delete:
                dbManager.delete(_id);
                this.returnHome();
                break;
        }
    }

    public void returnHome() {
        Intent home_intent = new Intent(getApplicationContext(), CountryListActivity.class)
                .setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
        startActivity(home_intent);
    }
}

在这里执行的CRUD操作是更新和删除记录。下面的图像是我们项目的最终输出的屏幕截图。第一张图片是在首次启动应用程序时看到的输出。第二张图片是点击ActionBar中的菜单选项后的结果，如下所示。第三张图片显示添加3个记录的输出。第四张图片显示点击列表项以修改或删除记录的输出。最后一张图片是删除记录时的输出。在这个例子中，我们删除了第一条记录。

打开Android SQLite数据库文件

正如我们在本教程中所讨论的，数据库文件存储在内部存储器中，并可通过Android设备监视器访问，如下图所示。为了查看此数据库，我们需要将该文件从设备中提取到我们的桌面上。通过点击右上角的菜单选项完成此操作，如下图所示: 要打开此文件，请从以下链接下载SQLiteBrowser。以下代码片段显示了浏览器中的模式和表格。要查看表格，请转到顶部的“浏览数据”选项卡。可以看到如下图所示: 这就结束了Android SQLite教程。最终的Android SQLite项目可以从下面的链接中下载。

下载一个Android SQLite示例项目

发表回复 0

Your email address will not be published. Required fields are marked *

✖
广告
将在 10 秒后关闭
bannerAds