feat: 统一异常处理并封装响应头限流信息

- 所有公共API方法添加 throws ApiErrorException
- 创建 BaseResult 基类和 RateLimit 类封装限流信息
- 优化 codec 类代码风格，提取常量和方法
- 删除 AdminApi 相关代码
- 更新文档和测试示例

Author: zhanq

README.md

@@ -95,13 +95,40 @@ cn.jiguang.sdk.exception.ApiErrorException
 ```java
 try {
     PushSendResult result = pushApi.send(param);
-    log.info("result:{}", result);
+    log.info("send success:{}", result);
+    log.info("send rateLimit:{}", result.getRateLimit());
 } catch (ApiErrorException e) {
-    int httpStatus = e.getStats();
-    int errorCode = e.getApiError().getError().getCode();
-    String errorMessage = e.getApiError().getError().getMessage();
-    log.error("httpStatus:{}，errorCode:{}，errorMessage:{}", httpStatus, errorCode, errorMessage);
-    e.printStackTrace();
+    log.error("send error:{}", e.getApiError());
+    log.error("send rateLimit:{}", e.getRateLimit());
+}
+```
+
+错误信息字段说明：
+```java
+int httpStatus = e.getStats();                              // HTTP状态码
+int errorCode = e.getApiError().getError().getCode();       // 错误码
+String errorMessage = e.getApiError().getError().getMessage(); // 错误信息
+RateLimit rateLimit = e.getRateLimit();                     // 限流信息
+```
+
+### 响应头信息
+所有成功响应的Result对象都包含限流信息，可通过 `getRateLimit()` 方法获取：
+
+```java
+PushSendResult result = pushApi.send(param);
+log.info("rateLimit:{}", result.getRateLimit());
+
+// 获取具体字段
+RateLimit rateLimit = result.getRateLimit();
+Integer limit = rateLimit.getLimit();           // 单位时间内最大请求次数
+Integer remaining = rateLimit.getRemaining();   // 单位时间内剩余请求次数  
+Integer reset = rateLimit.getReset();           // 限流重置时间(秒)
+```
+
+异常中也包含限流信息：
+```java
+catch (ApiErrorException e) {
+    log.error("rateLimit:{}", e.getRateLimit());
 }
 ```
 

example-for-spring/src/test/java/cn/jiguang/app/api/PushApiTest.java

@@ -119,13 +119,11 @@ public void send() {
         // 发送
         try {
             PushSendResult result = pushApi.send(param);
-            log.info("result:{}", result);
+            log.info("send success:{}", result);
+            log.info("send rateLimit:{}", result.getRateLimit());
         } catch (ApiErrorException e) {
-            int httpStatus = e.getStats();
-            int errorCode = e.getApiError().getError().getCode();
-            String errorMessage = e.getApiError().getError().getMessage();
-            log.error("httpStatus:{}，errorCode:{}，errorMessage:{}", httpStatus, errorCode, errorMessage);
-            e.printStackTrace();
+            log.error("send error:{}", e.getApiError());
+            log.error("send rateLimit:{}", e.getRateLimit());
         }
     }
 

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/device/AliasGetResult.java

@@ -1,15 +1,18 @@
 package cn.jiguang.sdk.bean.device;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import cn.jiguang.sdk.enums.platform.Platform;
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 import java.time.LocalDate;
 import java.util.List;
 
 @Data
-public class AliasGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class AliasGetResult extends BaseResult {
 
     @JsonProperty("data")
     private List<Data> data;

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/device/DeviceGetResult.java

@@ -1,15 +1,18 @@
 package cn.jiguang.sdk.bean.device;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 import java.util.List;
 
 @Data
+@EqualsAndHashCode(callSuper = true)
 @JsonIgnoreProperties(ignoreUnknown = true)
-public class DeviceGetResult {
+public class DeviceGetResult extends BaseResult {
 
     @JsonProperty("tags")
     @JsonInclude(JsonInclude.Include.NON_NULL)

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/device/DeviceStatusGetResult.java

@@ -1,10 +1,12 @@
 package cn.jiguang.sdk.bean.device;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonAnySetter;
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 import lombok.extern.slf4j.Slf4j;
 
 import java.time.LocalDateTime;
@@ -13,7 +15,8 @@
 
 @Slf4j
 @Data
-public class DeviceStatusGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class DeviceStatusGetResult extends BaseResult {
 
     @JsonInclude(JsonInclude.Include.NON_NULL)
     private Map<String, DeviceStatus> results = new HashMap<>();

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/device/TagGetResult.java

@@ -1,10 +1,13 @@
 package cn.jiguang.sdk.bean.device;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 @Data
-public class TagGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class TagGetResult extends BaseResult {
 
     @JsonProperty("result")
     private Boolean result;

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/device/TagsGetResult.java

@@ -1,12 +1,15 @@
 package cn.jiguang.sdk.bean.device;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 import java.util.List;
 
 @Data
-public class TagsGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class TagsGetResult extends BaseResult {
 
     @JsonProperty("tags")
     private List<String> tags;

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/file/FileGetResult.java

@@ -1,13 +1,16 @@
 package cn.jiguang.sdk.bean.file;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 import java.time.LocalDateTime;
 
 @Data
-public class FileGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class FileGetResult extends BaseResult {
 
     @JsonProperty("type")
     private String type;

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/file/FileUploadResult.java

@@ -1,10 +1,13 @@
 package cn.jiguang.sdk.bean.file;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 @Data
-public class FileUploadResult {
+@EqualsAndHashCode(callSuper = true)
+public class FileUploadResult extends BaseResult {
 
     @JsonProperty("file_id")
     private String fileId;

jiguang-sdk/src/main/java/cn/jiguang/sdk/bean/file/FilesGetResult.java

@@ -1,12 +1,15 @@
 package cn.jiguang.sdk.bean.file;
 
+import cn.jiguang.sdk.bean.BaseResult;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
 
 import java.util.List;
 
 @Data
-public class FilesGetResult {
+@EqualsAndHashCode(callSuper = true)
+public class FilesGetResult extends BaseResult {
 
     @JsonProperty("total_count")
     private Integer totalCount;