Problem

微信支付v3 API经常会返回新的字段，但这些字段可能还没有在WxJava的Result类中定义。例如，微信支付批次详情接口返回的card_id字段在FavorStocksGetResult类中就没有定义。当官方API更新时，开发者无法访问这些新增字段，只能等待框架更新。

Solution

添加了原始JSON内容保存功能，允许开发者访问API返回的任何字段，即使这些字段未在Result类中定义。

核心实现

1. 新增BaseWxPayV3Result基类

   • 提供rawJsonString字段保存原始API响应
   • 提供安全的getter/setter方法
   • 遵循v2结果类中xmlString的设计模式

2. 更新Result类继承结构

   • FavorStocksGetResult - 查询批次详情
   • FavorStocksCreateResult - 创建代金券批次
   • FavorCouponsGetResult - 查询代金券详情

3. 修改服务实现

   • 在GSON.fromJson()后调用setRawJsonString()保存原始内容
   • 保持现有API完全不变

使用示例

// 正常使用已定义的字段
FavorStocksGetResult result = marketingFavorService.getFavorStocksV3(stockId, mchId);
String stockName = result.getStockName();

// 访问未定义的card_id字段
String rawJson = result.getRawJsonString();
if (rawJson != null) {
    JsonElement jsonElement = JsonParser.parseString(rawJson);
    if (jsonElement.getAsJsonObject().has("card_id")) {
        String cardId = jsonElement.getAsJsonObject().get("card_id").getAsString();
        // 使用card_id...
    }
}

特性

• 向后兼容: 现有代码无需任何修改
• 零性能影响: 只在需要时访问原始JSON
• 安全设计: 包含完整的错误处理和null安全检查
• 易于扩展: 其他v3结果类可以轻松采用相同模式

测试覆盖

• 基本功能测试：JSON保存和访问
• 继承关系验证
• 空值安全测试
• 实际使用场景模拟
• 特定字段访问测试（如card_id）

Fixes #3565.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.