feat: add BaseResult and RateLimit classes for response header handling

Author: zhanq

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/BaseResult.java

@@ -0,0 +1,64 @@
+package cn.jiguang.sdk.bean;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import lombok.Data;
+
+import java.util.Collection;
+import java.util.Map;
+
+/**
+ * 所有Result的基类，包含HTTP响应头信息
+ */
+@Data
+public class BaseResult {
+
+    /**
+     * 限流信息
+     */
+    @JsonIgnore
+    private RateLimit rateLimit;
+
+    /**
+     * 从响应头中提取并设置相关字段
+     */
+    public void setResponseHeaders(Map<String, Collection<String>> headers) {
+        if (headers == null) {
+            return;
+        }
+
+        // 提取限流信息
+        RateLimit rateLimit = new RateLimit();
+        rateLimit.setLimit(extractIntHeader(headers, "x-rate-limit-limit"));
+        rateLimit.setRemaining(extractIntHeader(headers, "x-rate-limit-remaining"));
+        rateLimit.setReset(extractIntHeader(headers, "x-rate-limit-reset"));
+        this.rateLimit = rateLimit;
+    }
+
+    /**
+     * 提取字符串类型的响应头
+     */
+    private String extractStringHeader(Map<String, Collection<String>> headers, String headerName) {
+        Collection<String> values = headers.get(headerName);
+        if (values != null && !values.isEmpty()) {
+            return values.iterator().next();
+        }
+        return null;
+    }
+
+    /**
+     * 提取整数类型的响应头
+     */
+    private Integer extractIntHeader(Map<String, Collection<String>> headers, String headerName) {
+        String value = extractStringHeader(headers, headerName);
+        if (value != null) {
+            try {
+                return Integer.parseInt(value);
+            } catch (NumberFormatException e) {
+                return null;
+            }
+        }
+        return null;
+    }
+
+}
+

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/RateLimit.java

@@ -0,0 +1,31 @@
+package cn.jiguang.sdk.bean;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * 限流信息
+ */
+@Data
+public class RateLimit implements Serializable {
+
+    /**
+     * 当前 AppKey 一个时间窗口内可调用次数
+     * 响应头: x-rate-limit-limit
+     */
+    private Integer limit;
+
+    /**
+     * 当前时间窗口剩余的可用次数
+     * 响应头: x-rate-limit-remaining
+     */
+    private Integer remaining;
+
+    /**
+     * 距离时间窗口重置剩余的秒数
+     * 响应头: x-rate-limit-reset
+     */
+    private Integer reset;
+}
+