🎨 #3659 【微信支付】新增BaseWxPayV3Result基类，提供rawJsonString字段保存原始API响应

weixin-java-pay/src/test/java/com/github/binarywang/wxpay/bean/marketing/FavorStocksGetResultTest.java

@@ -0,0 +1,164 @@
+package com.github.binarywang.wxpay.bean.marketing;
+
+import com.github.binarywang.wxpay.bean.result.BaseWxPayV3Result;
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonParser;
+import org.testng.annotations.Test;
+
+import static org.testng.Assert.*;
+
+/**
+ * 测试FavorStocksGetResult的原始JSON保存功能
+ *
+ * @author Binary Wang
+ */
+public class FavorStocksGetResultTest {
+
+  private static final Gson GSON = new GsonBuilder().create();
+
+  @Test
+  public void testRawJsonPreservation() {
+    // 模拟微信API返回的JSON（包含未在Result类中定义的字段）
+    String mockJson = "{\n" +
+      "  \"stock_id\": \"9836588\",\n" +
+      "  \"stock_creator_mchid\": \"1230000109\",\n" +
+      "  \"stock_name\": \"微信支付代金券\",\n" +
+      "  \"status\": \"running\",\n" +
+      "  \"create_time\": \"2021-01-01T00:00:00.000+08:00\",\n" +
+      "  \"description\": \"微信支付营销\",\n" +
+      "  \"card_id\": \"pFS7Fjg9kqcMOBtl3bFn\",\n" +
+      "  \"extra_field\": \"这是一个新增字段\"\n" +
+      "}";
+
+    // 模拟服务调用：反序列化JSON
+    FavorStocksGetResult result = GSON.fromJson(mockJson, FavorStocksGetResult.class);
+    
+    // 模拟服务调用：设置原始JSON
+    result.setRawJsonString(mockJson);
+
+    // 验证基本字段正常解析
+    assertEquals(result.getStockId(), "9836588");
+    assertEquals(result.getStockCreatorMchId(), "1230000109");
+    assertEquals(result.getStockName(), "微信支付代金券");
+    assertEquals(result.getStatus(), "running");
+
+    // 验证原始JSON被保存
+    assertNotNull(result.getRawJsonString());
+    assertEquals(result.getRawJsonString(), mockJson);
+
+    // 验证可以从原始JSON中获取未定义的字段
+    assertTrue(result.getRawJsonString().contains("\"card_id\": \"pFS7Fjg9kqcMOBtl3bFn\""));
+    assertTrue(result.getRawJsonString().contains("\"extra_field\": \"这是一个新增字段\""));
+  }
+
+  @Test
+  public void testBaseV3ResultInheritance() {
+    FavorStocksGetResult result = new FavorStocksGetResult();
+    
+    // 验证继承关系
+    assertTrue(result instanceof BaseWxPayV3Result);
+    
+    // 验证基类方法可用
+    result.setRawJsonString("test json");
+    assertEquals(result.getRawJsonString(), "test json");
+  }
+
+  @Test
+  public void testNullRawJson() {
+    FavorStocksGetResult result = new FavorStocksGetResult();
+    
+    // 验证初始状态下rawJsonString为null
+    assertNull(result.getRawJsonString());
+    
+    // 验证设置null不会出错
+    result.setRawJsonString(null);
+    assertNull(result.getRawJsonString());
+  }
+
+  @Test
+  public void testRealWorldUsagePattern() {
+    // 实际使用场景的示例
+    String realApiResponse = "{\n" +
+      "  \"stock_id\": \"9836588\",\n" +
+      "  \"stock_creator_mchid\": \"1230000109\",\n" +
+      "  \"stock_name\": \"微信支付代金券\",\n" +
+      "  \"status\": \"running\",\n" +
+      "  \"create_time\": \"2021-01-01T00:00:00.000+08:00\",\n" +
+      "  \"description\": \"微信支付营销\",\n" +
+      "  \"card_id\": \"pFS7Fjg9kqcMOBtl3bFn\",\n" +
+      "  \"future_field_1\": \"未来可能新增的字段1\",\n" +
+      "  \"future_field_2\": \"未来可能新增的字段2\"\n" +
+      "}";
+
+    FavorStocksGetResult result = GSON.fromJson(realApiResponse, FavorStocksGetResult.class);
+    result.setRawJsonString(realApiResponse);
+
+    // 1. 正常使用已定义的字段
+    assertEquals(result.getStockId(), "9836588");
+    assertEquals(result.getStockName(), "微信支付代金券");
+
+    // 2. 安全地获取可能存在的新字段
+    String cardId = getStringFieldSafely(result, "card_id");
+    assertEquals(cardId, "pFS7Fjg9kqcMOBtl3bFn");
+
+    // 3. 获取未来可能新增的字段
+    String futureField1 = getStringFieldSafely(result, "future_field_1");
+    assertEquals(futureField1, "未来可能新增的字段1");
+
+    String nonExistentField = getStringFieldSafely(result, "non_existent");
+    assertNull(nonExistentField);
+  }
+
+  @Test
+  public void testCardIdExtractionExample() {
+    // 测试具体的card_id字段提取（这是issue中提到的用例）
+    String apiResponseWithCardId = "{\n" +
+      "  \"stock_id\": \"9836588\",\n" +
+      "  \"stock_creator_mchid\": \"1230000109\",\n" +
+      "  \"stock_name\": \"微信支付代金券\",\n" +
+      "  \"status\": \"running\",\n" +
+      "  \"card_id\": \"pFS7Fjg9kqcMOBtl3bFn\"\n" +
+      "}";
+
+    FavorStocksGetResult result = GSON.fromJson(apiResponseWithCardId, FavorStocksGetResult.class);
+    result.setRawJsonString(apiResponseWithCardId);
+
+    // 验证可以获取card_id字段
+    JsonElement jsonElement = JsonParser.parseString(result.getRawJsonString());
+    assertTrue(jsonElement.getAsJsonObject().has("card_id"));
+    String cardId = jsonElement.getAsJsonObject().get("card_id").getAsString();
+    assertEquals(cardId, "pFS7Fjg9kqcMOBtl3bFn");
+
+    // 展示实际用法
+    String extractedCardId = extractCardId(result);
+    assertEquals(extractedCardId, "pFS7Fjg9kqcMOBtl3bFn");
+  }
+
+  /**
+   * 提取card_id的示例方法
+   */
+  private String extractCardId(FavorStocksGetResult result) {
+    return getStringFieldSafely(result, "card_id");
+  }
+
+  /**
+   * 安全地从结果中获取字符串字段的工具方法
+   */
+  private String getStringFieldSafely(BaseWxPayV3Result result, String fieldName) {
+    String rawJson = result.getRawJsonString();
+    if (rawJson == null) return null;
+    
+    try {
+      JsonElement jsonElement = JsonParser.parseString(rawJson);
+      if (jsonElement.getAsJsonObject().has(fieldName)) {
+        JsonElement fieldElement = jsonElement.getAsJsonObject().get(fieldName);
+        return fieldElement.isJsonNull() ? null : fieldElement.getAsString();
+      }
+    } catch (Exception e) {
+      // 解析失败时返回null
+    }
+    return null;
+  }
+}