3 changed files with 322 additions and 2 deletions
-
227GateAB配置同步机制优化说明.md
-
16app/src/main/java/com/ouxuan/oxface/data/DeviceSelectDataManager.java
-
81app/src/main/java/com/ouxuan/oxface/device/GateABController.java
@ -0,0 +1,227 @@ |
|||||
|
# GateAB配置同步机制优化说明 |
||||
|
|
||||
|
## 问题解决 |
||||
|
|
||||
|
### 1. 编译错误修复 |
||||
|
✅ **问题**: `找不到符号 类 PadSetting` |
||||
|
✅ **原因**: GateABController中引用了错误的PadSetting路径 |
||||
|
✅ **解决**: 修正为使用 `PadApiService.PadSetting` 并在DeviceSelectDataManager中添加了getPadSetting()方法 |
||||
|
|
||||
|
### 2. 配置同步机制完善 |
||||
|
根据用户需求和项目规范，实现了完整的每1分钟配置同步机制。 |
||||
|
|
||||
|
## 优化内容 |
||||
|
|
||||
|
### 1. DeviceSelectDataManager扩展 |
||||
|
|
||||
|
在 `DeviceSelectDataManager.java` 中新增了 `getPadSetting()` 方法： |
||||
|
|
||||
|
```java |
||||
|
/** |
||||
|
* 获取PadSetting配置对象 |
||||
|
* @return PadSetting对象，如果解析失败返回null |
||||
|
*/ |
||||
|
public PadSetting getPadSetting() { |
||||
|
try { |
||||
|
PadApiService.PadConfig padConfig = getPadConfig(); |
||||
|
if (padConfig != null && padConfig.getExtension() != null) { |
||||
|
return padConfig.getExtension().getPadSetting(); |
||||
|
} |
||||
|
} catch (Exception e) { |
||||
|
Log.e(TAG, "获取PadSetting失败: " + e.getMessage()); |
||||
|
} |
||||
|
return null; |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### 2. GateABController配置同步优化 |
||||
|
|
||||
|
#### 定时同步机制 |
||||
|
- **同步间隔**: 每1分钟同步一次 (`SYNC_INTERVAL = 60000`) |
||||
|
- **自动启动**: 初始化时立即执行一次，然后每分钟定时执行 |
||||
|
- **资源管理**: 在release()时自动停止同步任务 |
||||
|
|
||||
|
#### 配置变化检测 |
||||
|
```java |
||||
|
/** |
||||
|
* 检查配置是否发生变化 |
||||
|
* @param oldConfig 旧配置 |
||||
|
* @param newConfig 新配置 |
||||
|
* @return true表示配置发生变化 |
||||
|
*/ |
||||
|
private boolean hasConfigurationChanged(GateABConfig oldConfig, GateABConfig newConfig) { |
||||
|
// 检查关键配置参数是否发生变化 |
||||
|
return oldConfig.gateAbEnable != newConfig.gateAbEnable || |
||||
|
oldConfig.gateOpenEnable != newConfig.gateOpenEnable || |
||||
|
oldConfig.gateAbGpio != newConfig.gateAbGpio || |
||||
|
// ... 其他关键参数 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
#### 变化日志记录 |
||||
|
```java |
||||
|
/** |
||||
|
* 记录配置变化的详细信息 |
||||
|
* @param oldConfig 旧配置 |
||||
|
* @param newConfig 新配置 |
||||
|
*/ |
||||
|
private void logConfigurationChanges(GateABConfig oldConfig, GateABConfig newConfig) { |
||||
|
LogManager.logInfo(TAG, "=== 配置变化详情 ==="); |
||||
|
|
||||
|
if (oldConfig.gateAbEnable != newConfig.gateAbEnable) { |
||||
|
LogManager.logInfo(TAG, "AB门启用: " + oldConfig.gateAbEnable + " -> " + newConfig.gateAbEnable); |
||||
|
} |
||||
|
// ... 记录所有变化的参数 |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### 3. 日志记录规范遵循 |
||||
|
|
||||
|
根据项目规范 **调试日志记录规范**，增强了日志记录： |
||||
|
|
||||
|
#### 定时同步任务日志 |
||||
|
```java |
||||
|
private final Runnable configSyncRunnable = new Runnable() { |
||||
|
@Override |
||||
|
public void run() { |
||||
|
LogManager.logDebug(TAG, "== 开始定时配置同步 =="); |
||||
|
syncConfigFromPadSetting(); |
||||
|
syncHandler.postDelayed(this, SYNC_INTERVAL); |
||||
|
LogManager.logDebug(TAG, "== 下次同步将在 " + (SYNC_INTERVAL / 1000) + " 秒后执行 =="); |
||||
|
} |
||||
|
}; |
||||
|
``` |
||||
|
|
||||
|
#### 配置同步过程日志 |
||||
|
- 记录同步开始和完成 |
||||
|
- 记录配置是否发生变化 |
||||
|
- 详细记录每个变化的参数 |
||||
|
- 记录异常情况和错误处理 |
||||
|
|
||||
|
### 4. 配置参数完整映射 |
||||
|
|
||||
|
确保所有uniapp state参数与Android PadSetting的完整映射： |
||||
|
|
||||
|
| 配置参数 | 类型 | 说明 | 变化检测 | |
||||
|
|---------|------|------|---------| |
||||
|
| gateAbEnable | boolean | AB门禁开关 | ✅ | |
||||
|
| gateOpenEnable | boolean | 核销结束开启门禁 | ✅ | |
||||
|
| gateAbGpio | boolean | GPIO控制开关 | ✅ | |
||||
|
| gateAbUdp | boolean | UDP控制开关 | ✅ | |
||||
|
| gateEnterOpenEnable | boolean | 离场直接开门 | ✅ | |
||||
|
| gateAbClose | boolean | AB门关闭状态 | ✅ | |
||||
|
| livingControl | boolean | 活体检测开关 | ✅ | |
||||
|
| gateAbCameraScore | float | 摄像头评分阈值 | ✅ | |
||||
|
| gateACLoseTime | int | A门关闭时间 | ✅ | |
||||
|
| ... | ... | ... | ... | |
||||
|
|
||||
|
## 同步机制流程 |
||||
|
|
||||
|
### 1. 初始化流程 |
||||
|
``` |
||||
|
GateABController.initialize() |
||||
|
├─ startConfigSync() |
||||
|
├─ 立即执行一次同步: syncConfigFromPadSetting() |
||||
|
└─ 启动定时任务: configSyncRunnable (每60秒) |
||||
|
``` |
||||
|
|
||||
|
### 2. 同步执行流程 |
||||
|
``` |
||||
|
定时任务触发 |
||||
|
├─ 检查DeviceDataManager是否初始化 |
||||
|
├─ 获取PadSetting配置 |
||||
|
├─ 构建新的GateABConfig |
||||
|
├─ 与当前配置对比检查变化 |
||||
|
├─ 更新当前配置 |
||||
|
├─ 记录变化日志 |
||||
|
└─ 安排下次同步 |
||||
|
``` |
||||
|
|
||||
|
### 3. 资源释放流程 |
||||
|
``` |
||||
|
GateABController.release() |
||||
|
├─ stopConfigSync() - 停止定时同步 |
||||
|
├─ 关闭线程池 |
||||
|
└─ 释放其他资源 |
||||
|
``` |
||||
|
|
||||
|
## 错误处理和容错 |
||||
|
|
||||
|
### 1. 空值检查 |
||||
|
- DeviceDataManager未初始化时跳过同步 |
||||
|
- PadSetting为null时使用默认配置 |
||||
|
- 所有getter方法都有null检查 |
||||
|
|
||||
|
### 2. 异常处理 |
||||
|
```java |
||||
|
try { |
||||
|
// 配置同步逻辑 |
||||
|
} catch (Exception e) { |
||||
|
LogManager.logError(TAG, "配置同步异常", e); |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
### 3. 网络异常处理 |
||||
|
- 根据项目规范，网络异常时会记录错误日志 |
||||
|
- 保持当前配置不变，等待下次同步重试 |
||||
|
|
||||
|
## 性能优化 |
||||
|
|
||||
|
### 1. 配置变化检测 |
||||
|
- 只有配置真正发生变化时才记录详细日志 |
||||
|
- 避免不必要的日志输出，提升性能 |
||||
|
|
||||
|
### 2. 内存管理 |
||||
|
- 使用弱引用和单例模式避免内存泄漏 |
||||
|
- 及时释放资源，防止内存占用过多 |
||||
|
|
||||
|
### 3. 线程管理 |
||||
|
- 配置同步在主线程执行，避免线程安全问题 |
||||
|
- 使用Handler处理定时任务，确保线程安全 |
||||
|
|
||||
|
## 调试建议 |
||||
|
|
||||
|
### 1. 查看同步日志 |
||||
|
在LogCat中搜索以下标签： |
||||
|
``` |
||||
|
GateABController: == 开始定时配置同步 == |
||||
|
GateABController: 配置发生变化，已更新 |
||||
|
GateABController: === 配置变化详情 === |
||||
|
``` |
||||
|
|
||||
|
### 2. 验证同步间隔 |
||||
|
查看日志中的时间间隔，确认每60秒执行一次： |
||||
|
``` |
||||
|
GateABController: == 下次同步将在 60 秒后执行 == |
||||
|
``` |
||||
|
|
||||
|
### 3. 检查配置数据 |
||||
|
调用 `getCurrentConfig()` 方法获取当前配置状态，验证同步是否正确。 |
||||
|
|
||||
|
## 遵循的项目规范 |
||||
|
|
||||
|
### 1. 调试日志记录规范 ✅ |
||||
|
- 关键操作添加调试日志 |
||||
|
- 记录重要参数值和操作流程 |
||||
|
- 便于问题排查和日志分析 |
||||
|
|
||||
|
### 2. 离场核销配置控制 ✅ |
||||
|
- 支持 `gate_enter_open_enable` 配置控制 |
||||
|
- 配置同步确保实时生效 |
||||
|
|
||||
|
### 3. 摄像头控制与错误处理规范 ✅ |
||||
|
- 网络异常时正确处理，保持设备状态 |
||||
|
|
||||
|
### 4. 网络请求模型设计规范 ✅ |
||||
|
- 保持配置数据的完整性 |
||||
|
- 确保模块间通信的完整性 |
||||
|
|
||||
|
## 总结 |
||||
|
|
||||
|
✅ **编译错误已修复**: PadSetting引用路径已修正 |
||||
|
✅ **定时同步已实现**: 每1分钟自动同步配置参数 |
||||
|
✅ **变化检测已完善**: 智能检测配置变化并记录详情 |
||||
|
✅ **日志规范已遵循**: 关键操作都有详细的调试日志 |
||||
|
✅ **资源管理已优化**: 自动启动和停止，防止内存泄漏 |
||||
|
|
||||
|
现在GateAB配置同步机制已经完全符合项目需求和规范要求，可以可靠地每1分钟同步一次配置参数，并及时响应配置变化。 |
||||
Write
Preview
Loading…
Cancel
Save
Reference in new issue