2 changed files with 310 additions and 0 deletions
-
210Fix9_OrderSelectionActivity门禁状态检查实现说明.md
-
100app/src/main/java/com/ouxuan/oxface/orderOX/OrderSelectionActivity.java
@ -0,0 +1,210 @@ |
|||
# Fix 9 - OrderSelectionActivity门禁状态检查实现说明 |
|||
|
|||
## 问题描述 |
|||
当处于OrderSelectionActivity页面进行订单选择核销时，如果检测到需要弹出门禁不可用弹窗（checkShow==true），此时需要立即关闭掉OrderSelectionActivity。 |
|||
|
|||
## 解决方案 |
|||
|
|||
### 🎯 核心实现逻辑 |
|||
1. **门禁状态检查集成**：在OrderSelectionActivity中集成门禁不可用弹窗的检查功能 |
|||
2. **关键点拦截**：在所有订单核销入口点添加门禁状态检查 |
|||
3. **立即关闭机制**：当检测到门禁不可用时立即关闭Activity |
|||
|
|||
### 🔧 技术实现 |
|||
|
|||
#### 1. 添加必要的导入和变量 |
|||
```java |
|||
// 新增导入 |
|||
import com.ouxuan.oxface.abgate.GateUnavailableDialog; // 门禁不可用弹窗 |
|||
import com.ouxuan.oxface.utils.VenueSceneUtils; // 场景工具类 |
|||
import com.blankj.utilcode.util.NetworkUtils; // 网络工具类 |
|||
|
|||
// 新增成员变量 |
|||
private GateUnavailableDialog gateUnavailableDialog; |
|||
``` |
|||
|
|||
#### 2. 初始化门禁状态检查 |
|||
```java |
|||
private void initGateStatusCheck() { |
|||
try { |
|||
// 初始化门禁不可用弹窗实例（仅用于检查，不显示） |
|||
gateUnavailableDialog = new GateUnavailableDialog(this); |
|||
LogManager.logInfo(TAG, "门禁状态检查初始化完成"); |
|||
} catch (Exception e) { |
|||
LogManager.logError(TAG, "门禁状态检查初始化失败", e); |
|||
} |
|||
} |
|||
``` |
|||
|
|||
#### 3. 核心检查方法 |
|||
```java |
|||
private boolean checkGateStatusAndCloseIfNeeded() { |
|||
try { |
|||
// 检查网络是否可用 |
|||
boolean isNetworkAvailable = isNetworkAvailable(); |
|||
|
|||
// 检查是否需要显示门禁不可用弹窗 |
|||
if (gateUnavailableDialog != null) { |
|||
boolean shouldShow = gateUnavailableDialog.checkShow(this, isNetworkAvailable); |
|||
|
|||
if (shouldShow) { |
|||
LogManager.logWarning(TAG, "Fix 9 - 检测到需要弹出门禁不可用弹窗，立即关闭订单选择页面"); |
|||
|
|||
// 停止倒计时 |
|||
stopCountdown(); |
|||
|
|||
// 设置结果为取消并关闭Activity |
|||
setResult(RESULT_CANCELED); |
|||
finish(); |
|||
|
|||
return true; // 表示已关闭Activity |
|||
} |
|||
} |
|||
|
|||
return false; // 门禁状态正常，不需要关闭Activity |
|||
|
|||
} catch (Exception e) { |
|||
LogManager.logError(TAG, "检查门禁状态失败", e); |
|||
return false; // 异常情况下不关闭Activity |
|||
} |
|||
} |
|||
``` |
|||
|
|||
#### 4. 在关键点添加检查 |
|||
|
|||
**确认按钮点击时：** |
|||
```java |
|||
btnConfirm.setOnClickListener(v -> { |
|||
// Fix 9: 在执行核销前检查门禁状态 |
|||
if (checkGateStatusAndCloseIfNeeded()) { |
|||
return; // 门禁不可用，已关闭Activity |
|||
} |
|||
|
|||
// 正常执行核销逻辑 |
|||
OrderVerificationData.OrderItem selectedOrder = adapter.getSelectedOrder(); |
|||
if (selectedOrder != null) { |
|||
performOrderVerification(selectedOrder); |
|||
} else { |
|||
showToast("请选择要核销的订单"); |
|||
} |
|||
}); |
|||
``` |
|||
|
|||
**直接核销按钮点击时：** |
|||
```java |
|||
@Override |
|||
public void onVerifyClick(OrderVerificationData.OrderItem order, int position) { |
|||
// Fix 9: 在直接核销前检查门禁状态 |
|||
if (checkGateStatusAndCloseIfNeeded()) { |
|||
return; // 门禁不可用，已关闭Activity |
|||
} |
|||
|
|||
// 直接核销选中的订单 |
|||
performOrderVerification(order); |
|||
} |
|||
``` |
|||
|
|||
**订单核销方法开始时：** |
|||
```java |
|||
private void performOrderVerification(OrderVerificationData.OrderItem order) { |
|||
LogManager.logInfo(TAG, "执行订单核销: " + order.getOrder_no()); |
|||
|
|||
// Fix 9: 在订单核销前检查门禁状态，如果需要弹出门禁不可用弹窗，立即关闭Activity |
|||
if (checkGateStatusAndCloseIfNeeded()) { |
|||
LogManager.logInfo(TAG, "检测到门禁不可用，立即关闭订单选择页面"); |
|||
return; // 立即返回，不继续执行核销 |
|||
} |
|||
|
|||
// 继续执行原有的核销逻辑... |
|||
} |
|||
``` |
|||
|
|||
#### 5. 网络状态检查支持 |
|||
```java |
|||
private boolean isNetworkAvailable() { |
|||
try { |
|||
// 使用NetworkUtils检查网络连接状态 |
|||
if (!NetworkUtils.isConnected()) { |
|||
LogManager.logWarning(TAG, "网络未连接"); |
|||
return false; |
|||
} |
|||
|
|||
LogManager.logDebug(TAG, "网络状态正常"); |
|||
return true; |
|||
|
|||
} catch (Exception e) { |
|||
LogManager.logError(TAG, "检查网络状态失败", e); |
|||
return false; |
|||
} |
|||
} |
|||
``` |
|||
|
|||
#### 6. 资源释放 |
|||
```java |
|||
@Override |
|||
protected void onDestroy() { |
|||
super.onDestroy(); |
|||
stopCountdown(); |
|||
|
|||
// 释放门禁弹窗资源 |
|||
if (gateUnavailableDialog != null) { |
|||
gateUnavailableDialog.release(); |
|||
gateUnavailableDialog = null; |
|||
} |
|||
|
|||
// ... 其他资源释放逻辑 |
|||
} |
|||
``` |
|||
|
|||
### 🚀 实现特点 |
|||
|
|||
#### 1. 多层拦截机制 |
|||
- **确认按钮拦截**：防止用户点击确认按钮时触发核销 |
|||
- **直接核销拦截**：防止用户直接点击订单的核销按钮 |
|||
- **核销方法拦截**：在最终执行核销前再次检查 |
|||
|
|||
#### 2. 门禁状态检查逻辑 |
|||
- 使用`GateUnavailableDialog.checkShow()`方法检查是否需要显示门禁不可用弹窗 |
|||
- 考虑网络状态和设备场景（进场/离场） |
|||
- 遵循现有的门禁检查规范 |
|||
|
|||
#### 3. 优雅关闭机制 |
|||
- 停止倒计时避免资源浪费 |
|||
- 设置正确的Activity结果（RESULT_CANCELED） |
|||
- 释放门禁弹窗相关资源 |
|||
|
|||
#### 4. 异常处理 |
|||
- 所有关键方法都有异常捕获 |
|||
- 异常情况下不影响正常流程（默认不关闭Activity） |
|||
- 详细的日志记录便于调试 |
|||
|
|||
### ✅ 验证结果 |
|||
|
|||
1. **编译验证**：✅ 无编译错误 |
|||
2. **逻辑验证**：✅ 在所有订单核销入口都添加了门禁状态检查 |
|||
3. **资源管理**：✅ 正确释放相关资源 |
|||
4. **异常处理**：✅ 完整的异常处理机制 |
|||
|
|||
### 📝 使用场景 |
|||
|
|||
当用户在订单选择页面尝试核销订单时： |
|||
|
|||
1. **门禁正常**：正常执行订单核销流程 |
|||
2. **门禁异常**： |
|||
- 立即关闭OrderSelectionActivity |
|||
- 返回到主页面 |
|||
- 主页面会显示相应的门禁不可用弹窗 |
|||
- 用户可以看到具体的门禁状态信息 |
|||
|
|||
### 🔧 配置要求 |
|||
|
|||
无需额外配置，Fix 9 会自动： |
|||
- 根据当前设备场景（进场/离场）判断 |
|||
- 根据网络状态进行检查 |
|||
- 遵循现有的门禁检查业务规则 |
|||
|
|||
## 总结 |
|||
|
|||
Fix 9 成功实现了在OrderSelectionActivity中的门禁状态检查功能。当检测到需要弹出门禁不可用弹窗时，会立即关闭订单选择页面，确保用户能够及时了解门禁状态，提升了系统的用户体验和安全性。 |
|||
|
|||
该实现遵循了现有的门禁检查规范，并保持了与现有系统的良好兼容性。 |
|||
Write
Preview
Loading…
Cancel
Save
Reference in new issue