Android 上 SQLite 的最佳实践是什么？

Question

在 Android 应用程序中对 SQLite 数据库执行查询时，哪些被认为是最佳实践？

从 AsyncTask 的 doInBackground 运行插入、删除和选择查询是否安全？ 还是应该使用 UI 线程？ 我认为数据库查询可能是“繁重的”，不应使用 UI 线程，因为它会锁定应用程序 - 导致应用程序无响应(ANR)。

如果我有多个 AsyncTask，它们应该共享一个连接还是每个都打开一个连接？

是否有针对这些场景的最佳实践？

Answer 1

从多个线程插入、更新、删除和读取通常都可以，但 Brad 的回答不正确。 您必须小心创建和使用连接的方式。 在某些情况下，即使您的数据库没有损坏，您的更新调用也会失败。

基本答案。

SqliteOpenHelper 对象保持一个数据库连接。 它似乎为您提供了读写连接，但实际上并没有。 调用只读，无论如何您都会获得写入数据库连接。

因此，一个助手实例，一个数据库连接。 即使您从多个线程使用它，一次一个连接。 SqliteDatabase 对象使用java 锁来保持访问序列化。 因此，如果 100 个线程有一个 db 实例，则对实际磁盘数据库的调用将被序列化。

所以，一个助手，一个数据库连接，在java代码中序列化。 一个线程，1000个线程，如果你使用它们之间共享的一个辅助实例，那么你所有的数据库访问代码都是串行的。 生活很好（ish）。

如果您尝试同时从实际的不同连接写入数据库，则会失败。 它不会等到第一个完成再写。 它根本不会写入您的更改。 更糟糕的是，如果您没有在 SQLiteDatabase 上调用正确版本的插入/更新，则不会出现异常。 您只会在 LogCat 中收到一条消息，就这样。

那么，多线程？ 使用一名助手。 时期。 如果您知道只有一个线程正在写入，您可以使用多个连接，并且您的读取速度会更快，但买家要小心。 我没有测试那么多。

这是一篇包含更多细节和示例应用程序的博客文章。

• Android Sqlite 锁定（更新链接 6/18/2012）
• Android-Database-Locking-Collision-Example by touchlab on GitHub

Gray 和我实际上正在基于他的 Ormlite 开发一个 ORM 工具，该工具在本机与 Android 数据库实现一起工作，并遵循我在博客文章中描述的安全创建/调用结构。 那应该很快就出来了。 看一看。

---

与此同时，有一篇后续博客文章：

• 单个 SQLite 连接

还要通过前面提到的锁定示例的2point0来检查分叉：

• Android-Database-Locking-Collision-Example by 2point0 on GitHub

Answer 2

并发数据库访问

我博客上的同一篇文章（我更喜欢格式化）

我写了一篇小文章，描述了如何安全地访问您的 android 数据库线程。

---

假设您有自己的SQLiteOpenHelper 。

public class DatabaseHelper extends SQLiteOpenHelper { ... }

现在您想在单独的线程中将数据写入数据库。

 // Thread 1
 Context context = getApplicationContext();
 DatabaseHelper helper = new DatabaseHelper(context);
 SQLiteDatabase database = helper.getWritableDatabase();
 database.insert(…);
 database.close();

 // Thread 2
 Context context = getApplicationContext();
 DatabaseHelper helper = new DatabaseHelper(context);
 SQLiteDatabase database = helper.getWritableDatabase();
 database.insert(…);
 database.close();

您将在 logcat 中收到以下消息，并且不会写入您的一项更改。

android.database.sqlite.SQLiteDatabaseLockedException: database is locked (code 5)

发生这种情况是因为每次创建新的SQLiteOpenHelper对象时，您实际上都是在建立新的数据库连接。 如果您尝试同时从实际的不同连接写入数据库，则会失败。 （来自上面的回答）

要在多个线程中使用数据库，我们需要确保使用一个数据库连接。

让我们制作单例类数据库管理器，它将保存并返回单个SQLiteOpenHelper对象。

public class DatabaseManager {

    private static DatabaseManager instance;
    private static SQLiteOpenHelper mDatabaseHelper;

    public static synchronized void initializeInstance(SQLiteOpenHelper helper) {
        if (instance == null) {
            instance = new DatabaseManager();
            mDatabaseHelper = helper;
        }
    }

    public static synchronized DatabaseManager getInstance() {
        if (instance == null) {
            throw new IllegalStateException(DatabaseManager.class.getSimpleName() +
                    " is not initialized, call initialize(..) method first.");
        }

        return instance;
    }

    public SQLiteDatabase getDatabase() {
        return new mDatabaseHelper.getWritableDatabase();
    }

}

在单独的线程中将数据写入数据库的更新代码如下所示。

 // In your application class
 DatabaseManager.initializeInstance(new MySQLiteOpenHelper());
 // Thread 1
 DatabaseManager manager = DatabaseManager.getInstance();
 SQLiteDatabase database = manager.getDatabase()
 database.insert(…);
 database.close();

 // Thread 2
 DatabaseManager manager = DatabaseManager.getInstance();
 SQLiteDatabase database = manager.getDatabase()
 database.insert(…);
 database.close();

这会给你带来另一个崩溃。

java.lang.IllegalStateException: attempt to re-open an already-closed object: SQLiteDatabase

由于我们只使用一个数据库连接，方法getDatabase（）用于线程1和线程返回SQLiteDatabase对象的同一个实例。 发生了什么， Thread1可能会关闭数据库，而Thread2仍在使用它。 这就是我们有IllegalStateException崩溃的原因。

我们需要确保没有人在使用数据库，然后才关闭它。 stackoveflow 上的一些人建议永远不要关闭您的SQLiteDatabase 。 这将导致以下 logcat 消息。

Leak found
Caused by: java.lang.IllegalStateException: SQLiteDatabase created and never closed

工作样本

public class DatabaseManager {

    private int mOpenCounter;

    private static DatabaseManager instance;
    private static SQLiteOpenHelper mDatabaseHelper;
    private SQLiteDatabase mDatabase;

    public static synchronized void initializeInstance(SQLiteOpenHelper helper) {
        if (instance == null) {
            instance = new DatabaseManager();
            mDatabaseHelper = helper;
        }
    }

    public static synchronized DatabaseManager getInstance() {
        if (instance == null) {
            throw new IllegalStateException(DatabaseManager.class.getSimpleName() +
                    " is not initialized, call initializeInstance(..) method first.");
        }

        return instance;
    }

    public synchronized SQLiteDatabase openDatabase() {
        mOpenCounter++;
        if(mOpenCounter == 1) {
            // Opening new database
            mDatabase = mDatabaseHelper.getWritableDatabase();
        }
        return mDatabase;
    }

    public synchronized void closeDatabase() {
        mOpenCounter--;
        if(mOpenCounter == 0) {
            // Closing database
            mDatabase.close();

        }
    }

}

使用方法如下。

SQLiteDatabase database = DatabaseManager.getInstance().openDatabase();
database.insert(...);
// database.close(); Don't close it directly!
DatabaseManager.getInstance().closeDatabase(); // correct way

每次需要数据库时，都应该调用DatabaseManager类的openDatabase()方法。 在这个方法中，我们有一个计数器，它指示数据库打开了多少次。 如果等于1，则表示需要创建新的数据库连接，如果不是，则表示已经创建了数据库连接。

closeDatabase()方法中也会发生同样的情况。 每次我们调用这个方法时，计数器都会减少，每当它变为零时，我们就关闭数据库连接。

---

现在您应该能够使用您的数据库并确保它是线程安全的。

Answer 3

• 使用Thread或AsyncTask进行长时间运行的操作（50 毫秒以上）。 测试您的应用程序以查看它的位置。 大多数操作（可能）不需要线程，因为大多数操作（可能）只涉及几行。 使用线程进行批量操作。
• 在线程之间为磁盘上的每个 DB 共享一个SQLiteDatabase实例，并实现一个计数系统来跟踪打开的连接。

是否有针对这些场景的最佳实践？

在所有类之间共享一个静态字段。 我曾经为那个和其他需要共享的东西保留一个单身人士。 还应该使用计数方案（通常使用 AtomicInteger）来确保您永远不会提前关闭数据库或让它保持打开状态。

我的解决方案：

我写的旧版本可以在https://github.com/Taeluf/dev/tree/main/archived/databasemanager获得，并且没有维护。 如果你想了解我的解决方案，请查看代码并阅读我的笔记。 我的笔记通常很有帮助。

1. 将代码复制/粘贴到名为DatabaseManager的新文件中。 （或从github下载）
2. 像往常一样扩展DatabaseManager并实现onCreate和onUpgrade 。 您可以创建一个DatabaseManager类的多个子类，以便在磁盘上拥有不同的数据库。
3. 实例化您的子类并调用getDb()以使用SQLiteDatabase类。
4. 为您实例化的每个子类调用close()

要复制/粘贴的代码：

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

import java.util.concurrent.ConcurrentHashMap;

/** Extend this class and use it as an SQLiteOpenHelper class
 *
 * DO NOT distribute, sell, or present this code as your own. 
 * for any distributing/selling, or whatever, see the info at the link below
 *
 * Distribution, attribution, legal stuff,
 * See https://github.com/JakarCo/databasemanager
 * 
 * If you ever need help with this code, contact me at support@androidsqlitelibrary.com (or support@jakar.co )
 * 
 * Do not sell this. but use it as much as you want. There are no implied or express warranties with this code. 
 *
 * This is a simple database manager class which makes threading/synchronization super easy.
 *
 * Extend this class and use it like an SQLiteOpenHelper, but use it as follows:
 *  Instantiate this class once in each thread that uses the database. 
 *  Make sure to call {@link #close()} on every opened instance of this class
 *  If it is closed, then call {@link #open()} before using again.
 * 
 * Call {@link #getDb()} to get an instance of the underlying SQLiteDatabse class (which is synchronized)
 *
 * I also implement this system (well, it's very similar) in my <a href="http://androidslitelibrary.com">Android SQLite Libray</a> at http://androidslitelibrary.com
 * 
 *
 */
abstract public class DatabaseManager {
    
    /**See SQLiteOpenHelper documentation
    */
    abstract public void onCreate(SQLiteDatabase db);
    /**See SQLiteOpenHelper documentation
     */
    abstract public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion);
    /**Optional.
     * *
     */
    public void onOpen(SQLiteDatabase db){}
    /**Optional.
     * 
     */
    public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {}
    /**Optional
     * 
     */
    public void onConfigure(SQLiteDatabase db){}



    /** The SQLiteOpenHelper class is not actually used by your application.
     *
     */
    static private class DBSQLiteOpenHelper extends SQLiteOpenHelper {

        DatabaseManager databaseManager;
        private AtomicInteger counter = new AtomicInteger(0);

        public DBSQLiteOpenHelper(Context context, String name, int version, DatabaseManager databaseManager) {
            super(context, name, null, version);
            this.databaseManager = databaseManager;
        }

        public void addConnection(){
            counter.incrementAndGet();
        }
        public void removeConnection(){
            counter.decrementAndGet();
        }
        public int getCounter() {
            return counter.get();
        }
        @Override
        public void onCreate(SQLiteDatabase db) {
            databaseManager.onCreate(db);
        }

        @Override
        public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            databaseManager.onUpgrade(db, oldVersion, newVersion);
        }

        @Override
        public void onOpen(SQLiteDatabase db) {
            databaseManager.onOpen(db);
        }

        @Override
        public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
            databaseManager.onDowngrade(db, oldVersion, newVersion);
        }

        @Override
        public void onConfigure(SQLiteDatabase db) {
            databaseManager.onConfigure(db);
        }
    }

    private static final ConcurrentHashMap<String,DBSQLiteOpenHelper> dbMap = new ConcurrentHashMap<String, DBSQLiteOpenHelper>();

    private static final Object lockObject = new Object();


    private DBSQLiteOpenHelper sqLiteOpenHelper;
    private SQLiteDatabase db;
    private Context context;

    /** Instantiate a new DB Helper. 
     * <br> SQLiteOpenHelpers are statically cached so they (and their internally cached SQLiteDatabases) will be reused for concurrency
     *
     * @param context Any {@link android.content.Context} belonging to your package.
     * @param name The database name. This may be anything you like. Adding a file extension is not required and any file extension you would like to use is fine.
     * @param version the database version.
     */
    public DatabaseManager(Context context, String name, int version) {
        String dbPath = context.getApplicationContext().getDatabasePath(name).getAbsolutePath();
        synchronized (lockObject) {
            sqLiteOpenHelper = dbMap.get(dbPath);
            if (sqLiteOpenHelper==null) {
                sqLiteOpenHelper = new DBSQLiteOpenHelper(context, name, version, this);
                dbMap.put(dbPath,sqLiteOpenHelper);
            }
            //SQLiteOpenHelper class caches the SQLiteDatabase, so this will be the same SQLiteDatabase object every time
            db = sqLiteOpenHelper.getWritableDatabase();
        }
        this.context = context.getApplicationContext();
    }
    /**Get the writable SQLiteDatabase
     */
    public SQLiteDatabase getDb(){
        return db;
    }

    /** Check if the underlying SQLiteDatabase is open
     *
     * @return whether the DB is open or not
     */
    public boolean isOpen(){
        return (db!=null&&db.isOpen());
    }


    /** Lowers the DB counter by 1 for any {@link DatabaseManager}s referencing the same DB on disk
     *  <br />If the new counter is 0, then the database will be closed.
     *  <br /><br />This needs to be called before application exit.
     * <br />If the counter is 0, then the underlying SQLiteDatabase is <b>null</b> until another DatabaseManager is instantiated or you call {@link #open()}
     *
     * @return true if the underlying {@link android.database.sqlite.SQLiteDatabase} is closed (counter is 0), and false otherwise (counter > 0)
     */
    public boolean close(){
        sqLiteOpenHelper.removeConnection();
        if (sqLiteOpenHelper.getCounter()==0){
            synchronized (lockObject){
                if (db.inTransaction())db.endTransaction();
                if (db.isOpen())db.close();
                db = null;
            }
            return true;
        }
        return false;
    }
    /** Increments the internal db counter by one and opens the db if needed
    *
    */
    public void open(){
        sqLiteOpenHelper.addConnection();
        if (db==null||!db.isOpen()){
                synchronized (lockObject){
                    db = sqLiteOpenHelper.getWritableDatabase();
                }
        } 
    }
}

Answer 4

数据库在多线程方面非常灵活。 我的应用程序同时从许多不同的线程访问他们的数据库，它做得很好。 在某些情况下，我有多个进程同时访问数据库，这也很好用。

您的异步任务 - 尽可能使用相同的连接，但如果必须，可以从不同的任务访问数据库。

Answer 5

在为此苦苦挣扎了几个小时后，我发现每次执行 db 只能使用一个 db helper 对象。 例如，

for(int x = 0; x < someMaxValue; x++)
{
    db = new DBAdapter(this);
    try
    {

        db.addRow
        (
                NamesStringArray[i].toString(), 
                StartTimeStringArray[i].toString(),
                EndTimeStringArray[i].toString()
        );

    }
    catch (Exception e)
    {
        Log.e("Add Error", e.toString());
        e.printStackTrace();
    }
    db.close();
}

如对：

db = new DBAdapter(this);
for(int x = 0; x < someMaxValue; x++)
{

    try
    {
        // ask the database manager to add a row given the two strings
        db.addRow
        (
                NamesStringArray[i].toString(), 
                StartTimeStringArray[i].toString(),
                EndTimeStringArray[i].toString()
        );

    }
    catch (Exception e)
    {
        Log.e("Add Error", e.toString());
        e.printStackTrace();
    }

}
db.close();

每次循环迭代时创建一个新的 DBAdapter 是我通过辅助类将字符串放入数据库的唯一方法。

Answer 6

Dmytro 的回答适用于我的情况。 我认为最好将该函数声明为同步的。 至少对于我的情况，否则它会调用空指针异常，例如 getWritableDatabase 尚未在一个线程中返回，而 openDatabse 在另一个线程中同时调用。

public synchronized SQLiteDatabase openDatabase() {
    if(mOpenCounter.incrementAndGet() == 1) {
        // Opening new database
        mDatabase = mDatabaseHelper.getWritableDatabase();
    }
    return mDatabase;
}

Answer 7

您可以尝试应用在 Google I/O 2017 上宣布的新架构方法。

它还包括名为Room 的新 ORM 库

它包含三个主要组件：@Entity、@Dao 和@Database

用户.java

@Entity
public class User {
  @PrimaryKey
  private int uid;

  @ColumnInfo(name = "first_name")
  private String firstName;

  @ColumnInfo(name = "last_name")
  private String lastName;

  // Getters and setters are ignored for brevity,
  // but they're required for Room to work.
}

用户道

@Dao
public interface UserDao {
  @Query("SELECT * FROM user")
  List<User> getAll();

  @Query("SELECT * FROM user WHERE uid IN (:userIds)")
  List<User> loadAllByIds(int[] userIds);

  @Query("SELECT * FROM user WHERE first_name LIKE :first AND "
       + "last_name LIKE :last LIMIT 1")
  User findByName(String first, String last);

  @Insert
  void insertAll(User... users);

  @Delete
  void delete(User user);
}

应用数据库.java

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
  public abstract UserDao userDao();
}

Answer 8

我对 SQLiteDatabase API 的理解是，如果你有一个多线程应用程序，你不能承受超过 1 个指向单个数据库的 SQLiteDatabase 对象。

该对象肯定可以创建，但如果不同的线程/进程（也）开始使用不同的 SQLiteDatabase 对象（就像我们在 JDBC 连接中使用的方式），则插入/更新会失败。

这里唯一的解决方案是坚持使用 1 个 SQLiteDatabase 对象，并且每当 startTransaction() 用于超过 1 个线程时，Android 管理跨不同线程的锁定，并且一次只允许 1 个线程具有独占更新访问权限。

您也可以从数据库中“读取”并在不同的线程中使用相同的 SQLiteDatabase 对象（而另一个线程写入）并且永远不会有数据库损坏，即“读取线程”不会从数据库读取数据直到“写入线程”提交数据，尽管两者都使用相同的 SQLiteDatabase 对象。

这与连接对象在 JDBC 中的方式不同，在 JDBC 中，如果您在读写线程之间传递（使用相同的）连接对象，那么我们也可能会打印未提交的数据。

在我的企业应用程序中，我尝试使用条件检查，以便 UI 线程永远不必等待，而 BG 线程持有 SQLiteDatabase 对象（独占）。 我尝试预测 UI 操作并推迟 BG 线程运行“x”秒。 也可以维护 PriorityQueue 来管理 SQLiteDatabase Connection 对象的分发，以便 UI 线程首先获取它。

Answer 9

遇到了一些问题，我想我已经明白为什么我会出错。

我编写了一个数据库包装类，其中包括一个close() ，它调用 helper close 作为open()的镜像，它调用 getWriteableDatabase ，然后迁移到ContentProvider 。 ContentProvider的模型不使用SQLiteDatabase.close()我认为这是一个很大的线索，因为代码确实使用了getWriteableDatabase在某些情况下，我仍然在进行直接访问（主要是屏幕验证查询，所以我迁移到了 getWriteableDatabase/rawQuery 模型.

我使用了一个单例，并且在关闭文档中有一点不祥的评论

关闭任何打开的数据库对象

（我的粗体）。

所以我遇到了间歇性崩溃，我使用后台线程访问数据库并且它们与前台同时运行。

所以我认为close()强制数据库关闭，而不管任何其他线程持有引用 - 所以close()本身不是简单地撤消匹配的getWriteableDatabase而是强制关闭任何打开的请求。 大多数时候这不是问题，因为代码是单线程的，但在多线程的情况下，总是有机会打开和关闭不同步。

在其他地方阅读了解释 SqliteDatabaseHelper 代码实例计数的评论，那么您想要关闭的唯一时间是您想要进行备份副本的情况，并且您想要强制关闭所有连接并强制 Sqlite写掉任何可能徘徊的缓存内容 - 换句话说，停止所有应用程序数据库活动，关闭以防万一助手丢失，执行任何文件级活动（备份/恢复）然后重新开始。

尽管尝试以受控方式关闭听起来是个好主意，但实际情况是 Android 保留丢弃您的 VM 的权利，因此任何关闭操作都可以降低未写入缓存更新的风险，但无法保证设备压力很大，如果您正确释放了游标和对数据库的引用（不应是静态成员），那么帮助程序无论如何都会关闭数据库。

所以我认为方法是：

使用 getWriteableDatabase 从单例包装器打开。 （我使用派生的应用程序类从静态提供应用程序上下文来解决对上下文的需求）。

永远不要直接调用close。

永远不要将结果数据库存储在任何没有明显作用域的对象中，并且依赖引用计数来触发隐式 close()。

如果进行文件级处理，请停止所有数据库活动，然后调用 close 以防万一有一个失控线程，假设您编写了正确的事务，因此失控线程将失败，并且关闭的数据库至少会有正确的事务而不是可能是部分事务的文件级副本。

Answer 10

我知道响应晚了，但在 android 中执行 sqlite 查询的最佳方法是通过自定义内容提供程序。 通过这种方式，UI 与数据库类（扩展 SQLiteOpenHelper 类的类）分离。 此外，查询在后台线程（Cursor Loader）中执行。