// BoxDBManager.ets import Box from '../bean/Box'; import relationalStore from '@ohos.data.relationalStore'; import common from '@ohos.app.ability.common'; import emitter from '@ohos.events.emitter'; import { Record } from '../bean/Record'; import { BusinessError } from '@ohos.base'; import { Logger } from './Logger'; import { uartUtils } from './UartUtils'; import { Member } from '../bean/Member'; // 定义锁信息接口 interface LockInfo { lockBoard: number; lockNumber: number; } interface SizeLockMap { size: string; start: number; } interface SizeLockMigrationMap { sizeChar: string; fullSize: string; start: number; } interface MemberInfo { id: number; name: string; phone: string; password: string; } const TAG = "UartUtils"; class BoxDBManager { private static instance: BoxDBManager; private rdbStore: relationalStore.RdbStore | null = null; private readonly DB_NAME = 'BoxDB.db'; private readonly TABLE_NAME = 'BOX'; public readonly DATA_CHANGED_EVENT_ID = 1001; private readonly DB_CONFIG: relationalStore.StoreConfig = { name: this.DB_NAME, securityLevel: relationalStore.SecurityLevel.S1 }; private readonly CREATE_TABLE_SQL = ` CREATE TABLE IF NOT EXISTS ${this.TABLE_NAME} ( ID INTEGER PRIMARY KEY AUTOINCREMENT, PHONE TEXT DEFAULT '', PASSWORD TEXT DEFAULT '', BOX_ID TEXT UNIQUE, SIZE TEXT, STATUS INTEGER DEFAULT 0, ENABLED INTEGER DEFAULT 1, LOCK_BOARD INTEGER DEFAULT 1, LOCK_NUMBER INTEGER DEFAULT 1 )`; private readonly CREATE_LOG_TABLE_SQL = ` CREATE TABLE IF NOT EXISTS BOX_OPERATION_LOG ( ID INTEGER PRIMARY KEY AUTOINCREMENT, BOX_ID INTEGER DEFAULT 0, OPERATION_TIME TEXT NOT NULL, OPERATOR TEXT NOT NULL, ACTION_TYPE TEXT NOT NULL, ACCESS_METHOD TEXT NOT NULL )`; private readonly CREATE_MEMBER_TABLE_SQL = ` CREATE TABLE IF NOT EXISTS MEMBER ( ID INTEGER PRIMARY KEY AUTOINCREMENT, MEMBER_ID TEXT NOT NULL, NAME TEXT NOT NULL, PASSWORD TEXT NOT NULL )`; private constructor() {} public static getInstance(): BoxDBManager { if (!BoxDBManager.instance) { BoxDBManager.instance = new BoxDBManager(); } return BoxDBManager.instance; } // 初始化数据库(使用Promise) async initDatabase(context: common.Context): Promise<boolean> { try { this.rdbStore = await relationalStore.getRdbStore(context, this.DB_CONFIG); await this.rdbStore.executeSql(this.CREATE_TABLE_SQL); await this.rdbStore.executeSql(this.CREATE_LOG_TABLE_SQL); await this.rdbStore.executeSql(this.CREATE_MEMBER_TABLE_SQL); await this.initDefaultBoxes(); console.info('Database initialized successfully'); return true; } catch (err) { console.error(`Database init failed: ${JSON.stringify(err)}`); return false; } } // 新增:添加会员(使用 Member 类) async addMember(member: Member): Promise<boolean> { if (!this.rdbStore){return false} try { const valueBucket: relationalStore.ValuesBucket = { 'MEMBER_ID': member.id, // 会员编号(字符串) 'NAME': member.name, // 姓名 'PASSWORD': member.password // 密码(已拼接好的完整密码) }; // 插入会员表 await this.rdbStore.insert('MEMBER', valueBucket); console.info(`会员 ${member.name} 添加成功`); return true; } catch (err) { console.error(`添加会员失败: ${JSON.stringify(err)}`); return false; } } // 验证会员(通过密码) async verifyMember(password: string): Promise<boolean> { if (!this.rdbStore) return false; try { // 使用RegExp构造函数替代正则表达式字面量 const passwordRegex = new RegExp('^\\d{8}$'); if (!passwordRegex.test(password)) { console.error("密码格式错误,必须是8位数字"); return false; } const predicates = new relationalStore.RdbPredicates('MEMBER'); predicates.equalTo('PASSWORD', password); const columns = ['ID']; const resultSet = await this.rdbStore.query(predicates, columns); const isMember = resultSet.rowCount > 0; resultSet.close(); return isMember; } catch (err) { console.error(`验证会员失败: ${JSON.stringify(err)}`); return false; } } // 删除会员 async deleteMember(memberId: string): Promise<boolean> { if (!this.rdbStore) return false; try { const predicates = new relationalStore.RdbPredicates('MEMBER'); predicates.equalTo('MEMBER_ID', memberId); const rowsDeleted = await this.rdbStore.delete(predicates); console.info(`删除会员成功,ID: ${memberId},删除行数: ${rowsDeleted}`); this.notifyDataChanged(); // 通知数据变化 return rowsDeleted > 0; } catch (err) { console.error(`删除会员失败: ${JSON.stringify(err)}`); return false; } } // 获取所有会员(用于后台管理页面展示) async getAllMembers(): Promise<Member[]> { if (!this.rdbStore) return []; try { const predicates = new relationalStore.RdbPredicates('MEMBER'); const columns = ['MEMBER_ID', 'NAME', 'PASSWORD']; const resultSet = await this.rdbStore.query(predicates, columns); const members: Member[] = []; while (resultSet.goToNextRow()) { members.push(new Member( resultSet.getLong(resultSet.getColumnIndex('MEMBER_ID')).toString(), resultSet.getString(resultSet.getColumnIndex('NAME')), resultSet.getString(resultSet.getColumnIndex('PASSWORD')) // 返回存储的密码 )); } resultSet.close(); return members; } catch (err) { console.error(`查询会员列表失败: ${JSON.stringify(err)}`); return []; } } // 在BoxDBManager类中添加以下方法 // 更新会员信息(支持ID修改) async updateMember(oldId: string, newMember: Member): Promise<boolean> { if (!this.rdbStore) return false; try { // 检查新ID是否已存在(如果修改了ID) if (oldId !== newMember.id) { // 直接查询新ID是否已存在 const checkPredicates = new relationalStore.RdbPredicates('MEMBER'); checkPredicates.equalTo('MEMBER_ID', newMember.id); const resultSet = await this.rdbStore.query(checkPredicates, ['MEMBER_ID']); const exists = resultSet.rowCount > 0; resultSet.close(); if (exists) { console.error(`更新失败:会员编号 ${newMember.id} 已存在`); return false; } } // 构建更新条件 const predicates = new relationalStore.RdbPredicates('MEMBER'); predicates.equalTo('MEMBER_ID', oldId); // 构建更新内容 const valueBucket: relationalStore.ValuesBucket = { 'MEMBER_ID': newMember.id, 'NAME': newMember.name, 'PASSWORD': newMember.password }; // 执行更新 const rowsUpdated = await this.rdbStore.update(valueBucket, predicates); if (rowsUpdated === 0) { console.error(`未找到会员编号 ${oldId} 的记录`); return false; } console.info(`更新会员成功,从ID: ${oldId} 更新为 ${newMember.id}`); this.notifyDataChanged(); // 通知数据变化 return true; } catch (err) { console.error(`更新会员失败: ${JSON.stringify(err)}`); return false; } } // 初始化默认箱子 private async initDefaultBoxes(): Promise<void> { const count = await this.getBoxCount(); if (count > 0) return; const sizeLockMapping:SizeLockMap[] = [ { size: "特大", start: 1 }, { size: "大", start: 4 }, { size: "中", start: 7 }, { size: "小", start: 10 } ]; const boxes: relationalStore.ValuesBucket[] = []; for (const mapping of sizeLockMapping) { for (let i = 1; i <= 3; i++) { boxes.push({ 'BOX_ID': `${mapping.size.charAt(0)}${i}`, 'SIZE': mapping.size, 'STATUS': 0, 'ENABLED': 1, 'LOCK_BOARD': 1, 'LOCK_NUMBER': mapping.start + (i - 1) // 计算正确的锁号 }); } } await this.rdbStore?.batchInsert(this.TABLE_NAME, boxes); console.info(`${boxes.length} default boxes initialized`); } async migrateLockNumbers(): Promise<void> { if (!this.rdbStore) return; try { // 获取所有箱子 const allBoxes = await this.getAllBoxes(); // 使用类型安全的映射定义 const sizeLockMapping:SizeLockMigrationMap[] = [ { sizeChar: "特", fullSize: "特大", start: 1 }, { sizeChar: "大", fullSize: "大", start: 4 }, { sizeChar: "中", fullSize: "中", start: 7 }, { sizeChar: "小", fullSize: "小", start: 10 } ]; for (const box of allBoxes) { // 提取尺寸和序号 const regex = new RegExp("^(\\D+)(\\d+)$"); const match = regex.exec(box.boxId); if (!match) continue; const sizeChar = match[1]; const index = parseInt(match[2]); // 查找匹配的尺寸映射 const mapping = sizeLockMapping.find(m => m.sizeChar === sizeChar); if (!mapping) continue; // 计算新锁号 const newLockNumber = mapping.start + (index - 1); // 更新数据库 const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', box.id); const valueBucket: relationalStore.ValuesBucket = { 'LOCK_NUMBER': newLockNumber }; await this.rdbStore.update(valueBucket, predicates); } console.info("Lock numbers migrated successfully"); } catch (err) { console.error("Lock number migration failed:", err); } } // 获取箱子数量 private async getBoxCount(): Promise<number> { if (!this.rdbStore) return 0; const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); const result = await this.rdbStore.query(predicates, ['count(*) as count']); if (result.rowCount > 0 && result.goToFirstRow()) { return result.getLong(result.getColumnIndex('count')); } return 0; } // 获取所有箱子 async getAllBoxes(): Promise<Box[]> { if (!this.rdbStore) return []; try { const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); const columns = ['ID', 'PHONE', 'PASSWORD', 'BOX_ID', 'SIZE', 'STATUS', 'ENABLED', 'LOCK_BOARD', 'LOCK_NUMBER']; // 直接使用await获取结果集 const resultSet = await this.rdbStore.query(predicates, columns); const boxes: Box[] = []; if (resultSet.rowCount > 0) { while (resultSet.goToNextRow()) { const box = new Box( resultSet.getString(resultSet.getColumnIndex('BOX_ID')), resultSet.getString(resultSet.getColumnIndex('SIZE')), resultSet.getLong(resultSet.getColumnIndex('STATUS')), resultSet.getLong(resultSet.getColumnIndex('ENABLED')) === 1, resultSet.getLong(resultSet.getColumnIndex('LOCK_BOARD')), resultSet.getLong(resultSet.getColumnIndex('LOCK_NUMBER')) ); box.id = resultSet.getLong(resultSet.getColumnIndex('ID')); box.phone = resultSet.getString(resultSet.getColumnIndex('PHONE')); box.password = resultSet.getString(resultSet.getColumnIndex('PASSWORD')); boxes.push(box); } } resultSet.close(); return boxes; } catch (err) { console.error(`Query failed: ${JSON.stringify(err)}`); return []; } } // 更新箱子状态 async updateBoxStatus(id: number, status: number): Promise<boolean> { if (!this.rdbStore) return false; const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', id); const valueBucket: relationalStore.ValuesBucket = { 'STATUS': status }; await this.rdbStore.update(valueBucket, predicates); this.notifyDataChanged(); return true; } // 占用箱子 async occupyBox(boxId: string, phone: string, password: string): Promise<boolean> { if (!this.rdbStore) return false; const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('BOX_ID', boxId); predicates.equalTo('STATUS', 0); const valueBucket: relationalStore.ValuesBucket = { 'PHONE': phone, 'PASSWORD': password, 'STATUS': 1 }; await this.rdbStore.update(valueBucket, predicates); this.notifyDataChanged(); return true; } // 释放箱子 async releaseBox(phoneSuffix: string, password: string): Promise<string[]> { if (!this.rdbStore) return []; // 查询匹配的箱子 const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.endsWith('PHONE', phoneSuffix); predicates.equalTo('PASSWORD', password); predicates.equalTo('STATUS', 1); predicates.equalTo('ENABLED', 1); const result = await this.rdbStore.query(predicates, ['ID', 'BOX_ID']); const boxIds: string[] = []; while (result.goToNextRow()) { boxIds.push(result.getString(result.getColumnIndex('BOX_ID'))); } result.close(); if (boxIds.length === 0) return []; // 更新匹配的箱子 const updatePredicates = new relationalStore.RdbPredicates(this.TABLE_NAME); updatePredicates.endsWith('PHONE', phoneSuffix); updatePredicates.equalTo('PASSWORD', password); updatePredicates.equalTo('STATUS', 1); updatePredicates.equalTo('ENABLED', 1); const valueBucket: relationalStore.ValuesBucket = { 'PHONE': '', 'PASSWORD': '', 'STATUS': 0 }; await this.rdbStore.update(valueBucket, updatePredicates); this.notifyDataChanged(); return boxIds; } // 更新箱子信息 public async updateBoxInfo( id: number, boxId: string, size: string, status: number, // 新增状态参数 enabled: boolean, lockBoard: number, lockNumber: number ): Promise<boolean> { if (!this.rdbStore) return false; try { const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', id); const valueBucket: relationalStore.ValuesBucket = { 'BOX_ID': boxId, 'SIZE': size, 'STATUS': status, // 保存状态值 'ENABLED': enabled ? 1 : 0, 'LOCK_BOARD': lockBoard, 'LOCK_NUMBER': lockNumber }; const changedRows = await this.rdbStore.update(valueBucket, predicates); console.info(`Updated ${changedRows} rows for box ID: ${id}, new status: ${status}`); this.notifyDataChanged(); return changedRows > 0; } catch (err) { console.error(`Update box info failed: ${JSON.stringify(err)}`); return false; } } // 删除箱子 public async deleteBox(id: number): Promise<number> { if (!this.rdbStore) return 0; try { const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', id); const rows = await this.rdbStore.delete(predicates); this.notifyDataChanged(); return rows; } catch (err) { console.error(`Delete box failed: ${JSON.stringify(err)}`); return 0; } } // 添加新箱子 public async addBox(box: Box): Promise<number> { if (!this.rdbStore) return -1; try { const valueBucket: relationalStore.ValuesBucket = { 'BOX_ID': box.boxId, 'SIZE': box.size, 'ENABLED': box.enabled ? 1 : 0, 'LOCK_BOARD': box.lockBoard, 'LOCK_NUMBER': box.lockNumber }; const id = await this.rdbStore.insert(this.TABLE_NAME, valueBucket); this.notifyDataChanged(); return id; } catch (err) { console.error(`Add box failed: ${JSON.stringify(err)}`); return -1; } } // 清空箱子的手机号和密码 public async clearBoxCredentials(id: number): Promise<boolean> { if (!this.rdbStore) return false; try { const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', id); const valueBucket: relationalStore.ValuesBucket = { 'PHONE': '', 'PASSWORD': '' }; await this.rdbStore.update(valueBucket, predicates); return true; } catch (err) { console.error(`Clear credentials failed: ${JSON.stringify(err)}`); return false; } } // 通知数据变化 private notifyDataChanged() { try { console.info("Emitting DATA_CHANGED event"); emitter.emit({ eventId: this.DATA_CHANGED_EVENT_ID }, { data: { action: "DATA_CHANGED" } }); } catch (err) { console.error(`Emit event failed: ${err.message}`); } } addOperationLog(record:Record, callback: (success: boolean) => void) { const rdbStore = this.rdbStore; if (!rdbStore) { console.error('RdbStore is not initialized'); callback(false); return; } const valueBucket: relationalStore.ValuesBucket = { 'BOX_ID': record.Box_ID, 'OPERATION_TIME': record.Operation_Time, // 当前时间戳 'OPERATOR': record.Operator, 'ACTION_TYPE': record.Action_Type, 'ACCESS_METHOD': record.Access_Method }; rdbStore.insert('BOX_OPERATION_LOG', valueBucket, (err: BusinessError) => { if (err) { console.error(`Insert log failed. Code:${err.code}, message:${err.message}`); callback(false); return; } callback(true); }); } getLogsByTime(time: string, callback: (logs: Record[]) => void) { const rdbStore = this.rdbStore; if (!rdbStore) { console.error('RdbStore is not initialized'); callback([]); return; } const predicates = new relationalStore.RdbPredicates('BOX_OPERATION_LOG'); // 只查询Record类需要的字段 const columns = ['BOX_ID', 'OPERATION_TIME', 'OPERATOR', 'ACTION_TYPE', 'ACCESS_METHOD']; // 构建时间查询条件 if (time.length === 10) { // YYYY-MM-DD 格式 predicates.greaterThanOrEqualTo('OPERATION_TIME', `${time}T00:00:00Z`); predicates.lessThan('OPERATION_TIME', `${time}T23:59:59.999Z`); } else if (time.length === 7) { // YYYY-MM 格式 predicates.like('OPERATION_TIME', `${time}-%`); } else { console.error('Invalid time format. Use YYYY-MM or YYYY-MM-DD'); callback([]); return; } rdbStore.query(predicates, columns, (err: BusinessError, resultSet: relationalStore.ResultSet) => { if (err) { console.error(`Query failed. Code:${err.code}, message:${err.message}`); callback([]); return; } const logs: Record[] = []; if (resultSet.rowCount > 0) { while (resultSet.goToNextRow()) { logs.push(new Record( resultSet.getLong(resultSet.getColumnIndex('BOX_ID')), resultSet.getString(resultSet.getColumnIndex('OPERATION_TIME')), resultSet.getString(resultSet.getColumnIndex('OPERATOR')), resultSet.getString(resultSet.getColumnIndex('ACTION_TYPE')), resultSet.getString(resultSet.getColumnIndex('ACCESS_METHOD')) )); } } resultSet.close(); callback(logs); }); } // 新增方法:根据箱子ID获取锁板编号和锁编号 public async getLockInfoById(id: number): Promise<LockInfo | null> { if (!this.rdbStore) return null; try { const predicates = new relationalStore.RdbPredicates(this.TABLE_NAME); predicates.equalTo('ID', id); const columns = ['LOCK_BOARD', 'LOCK_NUMBER']; const resultSet = await this.rdbStore.query(predicates, columns); if (resultSet.rowCount > 0 && resultSet.goToFirstRow()) { return { lockBoard: resultSet.getLong(resultSet.getColumnIndex('LOCK_BOARD')), lockNumber: resultSet.getLong(resultSet.getColumnIndex('LOCK_NUMBER')) }; } return null; } catch (err) { console.error(`Get lock info failed: ${JSON.stringify(err)}`); return null; } } // 新增方法:根据箱子ID直接开锁 public async openLockById(id: number): Promise<boolean> { try { // 获取锁信息 const lockInfo = await this.getLockInfoById(id); if (!lockInfo) { Logger.e(TAG, `No lock info found for box ID: ${id}`); return false; } // 检查锁编号是否在有效范围内 (1-12) if (lockInfo.lockNumber < 1 || lockInfo.lockNumber > 12) { Logger.e(TAG, `Invalid lock number ${lockInfo.lockNumber} for box ID: ${id}`); return false; } // 开锁 uartUtils.openSpecificLock(lockInfo.lockNumber); return true; } catch (error) { Logger.e(TAG, `Failed to open lock for box ID ${id}: ${error.message}`); return false; } } } export default BoxDBManager.getInstance(); 根据box类将上面的代码修改一下 deveco studio4.1版本API11// Box.ets export default class Box { id: number = 0; phone: string = ''; password: string = ''; boxId: string = ''; size: string = ''; status: number = 0; // 0: 空闲, 1: 占用, 2: 打开 enabled: boolean = true; // 新增:能用状态 lockBoard: number = 1; // 新增:锁板 lockNumber: number = 1; // 新增:锁号 constructor( boxId: string, size: string, status: number, enabled: boolean = true, lockBoard: number = 1, lockNumber: number = 1 ) { this.boxId = boxId; this.size = size; this.status = status; this.enabled = enabled; this.lockBoard = lockBoard; this.lockNumber = lockNumber; } }
时间: 2025-07-21 12:52:55 AIGC 浏览: 39
<think>我们正在讨论HarmonyOS应用开发,特别是关于BoxDBManager数据库操作,需要根据Box类结构调整来适配Deveco Studio 4.1 API 11版本。Box类现在包含以下字段:status, enabled, lockBoard, lockNumber。我们需要处理数据库模式迁移(schema migration)。
在HarmonyOS中,数据库模式迁移通常涉及以下步骤:
1. 在数据库帮助类中定义当前数据库版本。
2. 在onUpgrade方法中处理版本升级时的迁移逻辑。
3. 根据新版本的需求修改表结构(例如添加新列、删除列、修改列类型等)。
根据引用[3],我们有一个DataORM库的目录结构,它提供了数据库操作的封装。我们可能使用这个库或者类似的ORM框架来管理数据库。
假设我们之前有一个Box类,现在新增了字段:status, enabled, lockBoard, lockNumber。我们需要在数据库表中添加这些字段。
步骤:
1. 确定当前数据库版本和新的版本号。假设之前版本是1,现在升级到2。
2. 在数据库帮助类中,更新版本号,并实现onUpgrade方法。
3. 在onUpgrade方法中,执行ALTER TABLE语句来添加新列。
但是,需要注意的是,HarmonyOS的关系型数据库(使用关系型数据库(RDB))在修改表结构时,不支持直接删除列或修改列类型(需要创建新表并迁移数据)。但添加列是支持的。
因此,我们可以这样写迁移代码:
```java
public class BoxDBHelper extends OrmObjectContext {
private static final int DATABASE_VERSION = 2; // 更新版本号
public BoxDBHelper(Context context) {
super(context, "BoxDB", DATABASE_VERSION, "box.db");
}
@Override
public void onCreate(DatabaseHelper helper) {
// 初次创建数据库
helper.createTable(Box.class);
}
@Override
public void onUpgrade(DatabaseHelper helper, int oldVersion, int newVersion) {
if (oldVersion < 2) {
// 从版本1升级到版本2:添加新列
helper.addColumn(Box.class, "status");
helper.addColumn(Box.class, "enabled");
helper.addColumn(Box.class, "lockBoard");
helper.addColumn(Box.class, "lockNumber");
}
// 如果有后续版本,可以继续写else if (oldVersion < 3) {...}
}
}
```
注意:以上代码使用了DataORM库(引用[3])的API。在DataORM库中,`DatabaseHelper`提供了`addColumn`方法来添加列。
但是,我们需要注意,如果用户已经安装了旧版本的应用,升级时就会触发onUpgrade。如果是新安装的用户,则直接执行onCreate,此时表结构已经是最新的。
另外,根据引用[3]的目录结构,我们可能是在使用这个DataORM库。因此,我们需要确保Box类已经正确注解。
Box类的示例:
```java
@Entity
public class Box {
@PrimaryKey
private int id;
// 其他原有字段...
// 新增字段
private String status;
private boolean enabled;
private String lockBoard;
private int lockNumber;
// getters and setters...
}
```
在DataORM库中,`@Entity`注解表示这是一个数据库表对应的实体,`@PrimaryKey`表示主键。
如果我们没有使用DataORM库,而是直接使用HarmonyOS的RDB API,那么我们需要在onUpgrade中执行SQL语句:
```java
@Override
public void onUpgrade(RdbStore store, int oldVersion, int newVersion) {
if (oldVersion < 2) {
// 执行SQL语句添加列
store.executeSql("ALTER TABLE box ADD COLUMN status TEXT");
store.executeSql("ALTER TABLE box ADD COLUMN enabled INTEGER"); // 注意:SQLite没有布尔类型,用0和1表示
store.executeSql("ALTER TABLE box ADD COLUMN lockBoard TEXT");
store.executeSql("ALTER TABLE box ADD COLUMN lockNumber INTEGER");
}
}
```
注意:在RDB中,布尔类型需要存储为整数(0表示false,1表示true)。
根据你的项目实际情况选择使用DataORM还是直接使用RDB API。
另外,在Deveco Studio 4.1 API 11中,HarmonyOS的API可能有所变化,请确保使用正确的API。
最后,记得在应用启动时初始化数据库,并传入新的版本号。这样当检测到版本升级时,就会自动执行迁移。
总结:
1. 更新数据库版本号。
2. 在数据库帮助类中实现onUpgrade方法,添加新列。
3. 确保实体类(Box)包含新增字段。
4. 测试迁移过程(新安装和升级安装)。
相关问题:
1. 在HarmonyOS中,如何安全地进行数据库模式迁移?
2. 除了添加列,数据库模式迁移还支持哪些操作?
3. 如何测试数据库迁移逻辑?</think>### BoxDBManager 数据库模式迁移指南
根据您的需求,我将指导您如何为 Box 类实现数据库模式迁移,适配 Deveco Studio 4.1 API 11 版本。Box 类新增了 `status`、`enabled`、`lockBoard`、`lockNumber` 字段,需要处理数据库迁移。
#### 1. **定义 Box 实体类**
```java
@Entity
public class Box {
@PrimaryKey(autoGenerate = true)
private long id;
private String name;
private int status; // 新增字段
private boolean enabled; // 新增字段
private String lockBoard; // 新增字段
private int lockNumber; // 新增字段
// Getters & Setters
// ...
}
```
#### 2. **数据库管理器实现**
```java
public class BoxDBManager {
private static final int DATABASE_VERSION = 2; // 版本升级
private final BoxDatabase database;
public BoxDBManager(Context context) {
// 使用自动迁移(API 11+)
BoxDatabase.MigrationStrategy migration = new AutoMigration.Builder()
.addColumn(Box.class, "status", Integer.class)
.addColumn(Box.class, "enabled", Boolean.class)
.addColumn(Box.class, "lockBoard", String.class)
.addColumn(Box.class, "lockNumber", Integer.class)
.build();
database = DatabaseBuilder
.of(context, BoxDatabase.class)
.addMigrations(migration) // 注册迁移策略
.build();
}
@Database(entities = {Box.class}, version = DATABASE_VERSION)
public abstract static class BoxDatabase extends OrmDatabase {
public abstract BoxDao boxDao();
}
@Dao
public interface BoxDao {
@Insert
void insert(Box box);
@Query("SELECT * FROM Box")
List<Box> getAll();
}
}
```
#### 3. **手动迁移(复杂场景)**
如果需要数据转换,实现 `Migration` 接口:
```java
public class BoxMigration implements Migration {
@Override
public void migrate(@NonNull SupportSQLiteDatabase database) {
// 添加新列
database.execSQL("ALTER TABLE Box ADD COLUMN status INTEGER DEFAULT 0");
database.execSQL("ALTER TABLE Box ADD COLUMN enabled INTEGER DEFAULT 1"); // SQLite用0/1表示boolean
database.execSQL("ALTER TABLE Box ADD COLUMN lockBoard TEXT");
database.execSQL("ALTER TABLE Box ADD COLUMN lockNumber INTEGER DEFAULT 0");
// 数据迁移示例:将旧数据迁移到新字段
database.execSQL("UPDATE Box SET status = 1 WHERE enabled = 1");
}
}
// 注册迁移
BoxDatabase database = DatabaseBuilder
.of(context, BoxDatabase.class)
.addMigrations(new BoxMigration()) // 手动迁移
.build();
```
#### 4. **迁移注意事项**
1. **版本管理**:
- 每次模式变更递增 `DATABASE_VERSION`
- 旧版本设备升级时自动触发 `migrate()`
2. **字段兼容性**:
- SQLite 无原生布尔类型,使用 `INTEGER`(0=false, 1=true)
- 新增字段需设置默认值(如 `DEFAULT 0`)
3. **数据一致性**:
- 迁移前备份数据(引用[4])
- 使用事务确保原子性:
```java
database.beginTransaction();
try {
// 迁移操作
database.setTransactionSuccessful();
} finally {
database.endTransaction();
}
```
#### 5. **验证迁移结果**
```java
// 查询验证
List<Box> boxes = boxDao.getAll();
for (Box box : boxes) {
// 检查新字段是否有效
Log.i("Migration", "Box ID:" + box.getId()
+ " Status:" + box.getStatus()
+ " LockBoard:" + box.getLockBoard());
}
```
### 关键修改点
1. 实体类添加新字段:`status`、`enabled`、`lockBoard`、`lockNumber`
2. 数据库版本号升级(从1→2)
3. 选择自动迁移(简单字段添加)或手动迁移(复杂转换)
4. 使用 `@Column` 注解定义字段约束(如默认值)
> **提示**:HarmonyOS 的分布式数据库迁移需在所有设备同步执行,确保多端数据一致性(引用[1])。如果遇到迁移失败,系统会通过 `IAbilityContinuation.onStartContinuation()` 回调通知(引用[4])。
---
### 相关问题
1. 如何在 HarmonyOS 中处理分布式数据库的跨设备模式迁移?
2. 数据库迁移失败时有哪些回滚机制?
3. 如何为现有字段添加唯一性约束(UNIQUE)?
4. 在 API 11 中如何实现数据库加密迁移?
5. 如何测试数据库迁移逻辑的可靠性?
阅读全文
相关推荐



















