鸿蒙OS开发文档 鸿蒙OS RdbOpenCallback

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 3

RdbOpenCallback

java.lang.Object
|---ohos.data.rdb.RdbOpenCallback

public abstract class RdbOpenCallback
extends Object

管理数据库的创建、升级和降级。

您可以创建一个子类来实现#onCreate、#onUpgrade 或#onOpen 方法。 如果数据库已经存在,则将其打开; 如果不存在数据库,将创建一个数据库。 在数据库升级过程中,也会调用该类的方法。

构造函数摘要

构造函数描述
RdbOpenCallback()

方法总结

修饰符和类型方法描述
voidonCorruption(File databaseFile)在打开数据库时发生损坏异常时调用。
abstract voidonCreate(RdbStore store)在创建与 RDB 存储关联的数据库时调用。
voidonDowngrade(RdbStore store, int currentVersion, int targetVersion)当与此 RdbStore 关联的数据库需要降级时调用。
voidonOpen(RdbStore store)在打开与 RDB 存储关联的数据库时调用。
abstract voidonUpgrade(RdbStore store, int currentVersion, int targetVersion)当与 RDB 存储关联的数据库需要升级时调用。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

RdbOpenCallback

public RdbOpenCallback()

方法详情

onCreate

public abstract void onCreate(RdbStore store)

在创建与 RDB 存储关联的数据库时调用。

该方法创建一个数据库并将初始化的表数据插入到数据库中。

参数:

参数名称参数描述
store指示 RdbStore 对象。

onUpgrade

public abstract void onUpgrade(RdbStore store, int currentVersion, int targetVersion)

当与 RDB 存储关联的数据库需要升级时调用。

此方法在事务中执行。 如果抛出异常,所有更改将自动回滚。

参数:

参数名称参数描述
store指示 RdbStore 对象。
currentVersion指示当前数据库版本。
targetVersion指示目标数据库版本。

onDowngrade

public void onDowngrade(RdbStore store, int currentVersion, int targetVersion)

当与此 RdbStore 关联的数据库需要降级时调用。

此方法在事务中执行。 如果抛出异常,所有更改将自动回滚。

参数:

参数名称参数描述
store指示 RdbStore 对象。
currentVersion指示当前数据库版本。
targetVersion指示目标数据库版本。

onOpen

public void onOpen(RdbStore store)

在打开与 RDB 存储关联的数据库时调用。

参数:

参数名称参数描述
store指示 RdbStore 对象。

onCorruption

public void onCorruption(File databaseFile)

在打开数据库时发生损坏异常时调用。

参数:

参数名称参数描述
databaseFile表示检测到损坏的数据库的文件。