oxFaceAndroid

6.8 KiB

Raw Blame History

订单核销结果页面重构说明

问题分析

原始问题

在执行次卡核销（order_type=1）时出现错误：

Expected BEGIN_OBJECT but was STRING at line 1 column 345 path $.data.result.info

根本原因

服务端对于不同订单类型返回的 info 字段数据结构不一致：

次卡核销 (order_type=1): info 字段为字符串类型
```
"info": "平时"
```

年月卡核销 (order_type=3): info 字段为对象类型

"info": {
  "card_no": "2509085314",
  "rest_number": 5,
  "status": 1,
  "verify_desc": "人脸验证...",
  "verify_time": "2025-09-10 11:26:36",
  "verify_type": 2
}

原有代码没有根据 order_type 正确处理这种数据结构差异。

解决方案

1. 修复 PadApiService.VerifyOrderResult 数据模型

核心问题修复：将 VerifyOrderResult 类中的 info 字段从固定的 VerifyOrderInfo 对象类型改为灵活的 JsonElement 类型。

// 修复前（有问题的代码）
@SerializedName("info")
private VerifyOrderInfo info;  // 只能处理对象类型

// 修复后（正确的代码）
@SerializedName("info")
private com.google.gson.JsonElement info;  // 支持字符串和对象类型

添加辅助方法：

// 获取字符串类型的info（次卡核销）
public String getInfoAsString() {
    if (info != null && info.isJsonPrimitive()) {
        return info.getAsString();
    }
    return "";
}

// 获取对象类型的info（年月卡核销）
public JsonObject getInfoAsJsonObject() {
    if (info != null && info.isJsonObject()) {
        return info.getAsJsonObject();
    }
    return null;
}

2. 重构 OrderVerificationResultActivity

1.1 数据结构优化

// 原始字段
private TextView tvTitle, tvOrderNo, tvVerificationCode, tvOrderType, tvCardNo, tvStatus, tvMessage, tvProject;
private String orderNo, verificationCode, orderType, cardNo, status, message, project;

// 重构后字段
private TextView tvTitle, tvStatus, tvMessage;
private ScrollView scrollContent;
private LinearLayout layoutContent;
private int orderType; // 改为int类型
private JsonElement orderInfo; // 支持多种数据类型
private PadApiService.VerifyOrderResult verifyResult; // 完整核销结果

1.2 布局文件重构

<!-- 原始静态布局 -->
<LinearLayout android:id="@+id/ll_order_info">
  <!-- 固定的订单号、验证码、订单类型等字段 -->
</LinearLayout>

<!-- 重构后动态布局 -->
<ScrollView android:id="@+id/scroll_content">
  <LinearLayout android:id="@+id/layout_content" />
</ScrollView>

1.3 动态内容生成

根据订单类型动态生成不同的显示内容：

private void buildOrderTypeSpecificContent() {
    switch (orderType) {
        case 0: // 场次核销
            buildSiteContent();
            break;
        case 1: // 人次核销
            buildPeopleContent();
            break;
        case 3: // 年月卡
            buildCardContent();
            break;
        case 5: // 课程
            buildCourseContent();
            break;
    }
}

2. 根据 uni 端逻辑实现不同订单类型展示

2.1 场次核销 (order_type=0)

显示场次信息列表：

场馆名称
开始时间

2.2 人次核销 (order_type=1)

显示人次相关信息：

验证码
订单编号
有效时间
预订信息（info 字符串）

2.3 年月卡 (order_type=3)

显示年月卡信息：

验证码
名称（项目）
卡号（NO.xxx）
核销方式
核销时间

2.4 课程 (order_type=5)

显示课程信息：

上课时间
上课教练
上课地点
课程名称
订单编号
签到方式
签到时间

3. 数据传递优化

3.1 传递完整核销结果

// 在 OrderSelectionActivity 中
if (data != null) {
    intent.putExtra("verify_result", new Gson().toJson(data));
}

3.2 解析完整数据结构

// 在 OrderVerificationResultActivity 中
String verifyResultJson = intent.getStringExtra("verify_result");
if (verifyResultJson != null) {
    verifyResult = gson.fromJson(verifyResultJson, PadApiService.VerifyOrderResponse.class).getResult();
    orderInfo = JsonParser.parseString(gson.toJson(verifyResult.getInfo()));
}

4. 兼容性处理

4.1 JsonElement 处理

private String getJsonString(JsonObject jsonObject, String key, String defaultValue) {
    if (jsonObject.has(key) && !jsonObject.get(key).isJsonNull()) {
        return jsonObject.get(key).getAsString();
    }
    return defaultValue;
}

4.2 不同数据类型检查

// 字符串类型处理
if (orderInfo != null && orderInfo.isJsonPrimitive()) {
    String bookingInfo = orderInfo.getAsString();
}

// 对象类型处理
if (orderInfo != null && orderInfo.isJsonObject()) {
    JsonObject cardInfo = orderInfo.getAsJsonObject();
}

优势分析

1. 数据结构兼容性

✅ 支持 info 字段的字符串和对象两种类型
✅ 根据 order_type 智能选择处理方式
✅ 避免 JSON 解析异常

2. 界面显示灵活性

✅ 动态生成内容，支持不同订单类型
✅ 滚动视图支持长内容显示
✅ 统一的界面风格和交互

3. 代码可维护性

✅ 模块化的内容构建方法
✅ 清晰的数据传递流程
✅ 完善的错误处理机制

4. 用户体验

✅ 针对不同订单类型优化信息展示
✅ 保持与 uni 端一致的信息结构
✅ 友好的错误提示和状态显示

测试验证

创建了完整的单元测试来验证：

次卡核销数据解析
年月卡核销数据解析
订单类型名称转换
验证码格式化
使用时长格式化

使用说明

1. 次卡核销场景

系统会自动检测 order_type=1，将 info 字段作为字符串处理，显示预订信息。

2. 年月卡核销场景

系统会自动检测 order_type=3，将 info 字段作为对象处理，提取卡号、核销方式等详细信息。

3. 其他订单类型

支持场次（order_type=0）和课程（order_type=5）核销，根据相应的数据结构显示内容。

注意事项

数据完整性: 确保从上级页面传递完整的 verify_result 数据
错误处理: 当数据解析失败时，会降级显示基本订单信息
向后兼容: 保持与现有调用方式的兼容性
性能优化: 使用动态布局生成，避免冗余的视图创建

通过这次重构，彻底解决了不同订单类型核销时的数据结构不兼容问题，提升了用户体验和系统稳定性。

6.8 KiB Raw Blame History