feat: add system_push apis

Author: caojiajun

src/main/java/com/netease/nim/server/sdk/im/v2/YunxinV2ApiServices.java

@@ -27,6 +27,8 @@
 import com.netease.nim.server.sdk.im.v2.signal.SignalV2Service;
 import com.netease.nim.server.sdk.im.v2.system_notification.CustomNotificationV2Service;
 import com.netease.nim.server.sdk.im.v2.system_notification.ICustomNotificationV2Service;
+import com.netease.nim.server.sdk.im.v2.system_push.ISystemPushV2Service;
+import com.netease.nim.server.sdk.im.v2.system_push.SystemPushV2Service;
 import com.netease.nim.server.sdk.im.v2.friend.FriendV2Service;
 import com.netease.nim.server.sdk.im.v2.friend.IFriendV2Service;
 import com.netease.nim.server.sdk.im.v2.message.IMessageV2Service;
@@ -66,6 +68,7 @@ public class YunxinV2ApiServices {
     private final IBlockV2Service blockService;
     private final IBroadcastV2Service broadcastService;
     private final ICustomNotificationV2Service customNotificationService;
+    private final ISystemPushV2Service systemPushService;
     private final ISubscriptionV2Service subscriptionService;
     private final IAiSerivce aiService;
     private final IToolV2Service toolService;
@@ -89,6 +92,7 @@ public YunxinV2ApiServices(YunxinApiHttpClient yunxinApiHttpClient) {
         this.blockService = new BlockV2Service(yunxinApiHttpClient);
         this.broadcastService = new BroadcastV2Service(yunxinApiHttpClient);
         this.customNotificationService = new CustomNotificationV2Service(yunxinApiHttpClient);
+        this.systemPushService = new SystemPushV2Service(yunxinApiHttpClient);
         this.subscriptionService = new SubscriptionV2Service(yunxinApiHttpClient);
                 this.aiService = new AiService(yunxinApiHttpClient);
         this.toolService = new ToolV2Service(yunxinApiHttpClient);
@@ -163,6 +167,10 @@ public ICustomNotificationV2Service getCustomNotificationService() {
         return customNotificationService;
     }
 
+    public ISystemPushV2Service getSystemPushService() {
+        return systemPushService;
+    }
+    
     public ISubscriptionV2Service getSubscriptionService() {
         return subscriptionService;
     }

src/main/java/com/netease/nim/server/sdk/im/v2/account/request/UpdateAccountRequestV2.java

@@ -168,8 +168,6 @@ public static class UserInformation {
         @JSONField(name = "extension")
         private String extension;
 
-        @JSONField(name = "email_validation_mode")
-        private Integer emailValidationMode;
 
         public String getName() {
             return name;
@@ -235,12 +233,5 @@ public void setExtension(String extension) {
             this.extension = extension;
         }
 
-        public Integer getEmailValidationMode() {
-            return emailValidationMode;
-        }
-
-        public void setEmailValidationMode(Integer emailValidationMode) {
-            this.emailValidationMode = emailValidationMode;
-        }
     }
 }

src/main/java/com/netease/nim/server/sdk/im/v2/system_notification/CustomNotificationV2Service.java

@@ -31,7 +31,6 @@ public CustomNotificationV2Service(YunxinApiHttpClient yunxinApiHttpClient) {
     @Override
     public Result<SendCustomNotificationResponseV2> sendCustomNotification(SendCustomNotificationRequestV2 request) throws YunxinSdkException {
 
-        // Convert to JSON string using JSONField annotations
         String jsonRequestBody = JSON.toJSONString(request);
 
         YunxinApiResponse apiResponse = yunxinApiHttpClient.executeV2Api(
@@ -48,7 +47,6 @@ public Result<SendCustomNotificationResponseV2> sendCustomNotification(SendCusto
     @Override
     public Result<SendBatchCustomNotificationResponseV2> sendBatchCustomNotification(SendBatchCustomNotificationRequestV2 request) throws YunxinSdkException {
 
-        // Convert to JSON string using JSONField annotations
         String jsonRequestBody = JSON.toJSONString(request);
 
         YunxinApiResponse apiResponse = yunxinApiHttpClient.executeV2Api(
@@ -61,4 +59,4 @@ public Result<SendBatchCustomNotificationResponseV2> sendBatchCustomNotification
 
         return ResultUtils.convert(apiResponse, SendBatchCustomNotificationResponseV2.class);
     }
-} 
+}

src/main/java/com/netease/nim/server/sdk/im/v2/system_notification/CustomNotificationV2UrlContext.java

@@ -14,4 +14,4 @@ public class CustomNotificationV2UrlContext {
      * URL for sending batch custom notifications
      */
     public static final String BATCH_CUSTOM_NOTIFICATION = "/im/v2/custom_notification/batch";
-} 
+}

src/main/java/com/netease/nim/server/sdk/im/v2/system_notification/ICustomNotificationV2Service.java

@@ -17,4 +17,4 @@ Result<SendCustomNotificationResponseV2> sendCustomNotification(
 
     Result<SendBatchCustomNotificationResponseV2> sendBatchCustomNotification(
             SendBatchCustomNotificationRequestV2 request) throws YunxinSdkException;
-} 
+}

src/main/java/com/netease/nim/server/sdk/im/v2/system_push/ISystemPushV2Service.java

@@ -0,0 +1,22 @@
+package com.netease.nim.server.sdk.im.v2.system_push;
+
+import com.netease.nim.server.sdk.core.Result;
+import com.netease.nim.server.sdk.core.exception.YunxinSdkException;
+import com.netease.nim.server.sdk.im.v2.system_push.request.*;
+import com.netease.nim.server.sdk.im.v2.system_push.response.*;
+
+/**
+ * Interface for system push services
+ */
+public interface ISystemPushV2Service {
+    
+    Result<SendPushNotificationResponseV2> sendPushNotification(
+            SendPushNotificationRequestV2 request) throws YunxinSdkException;
+    
+    Result<GetPushNotificationResponseV2> getPushNotification(
+            GetPushNotificationRequestV2 request) throws YunxinSdkException;
+    
+    Result<ListPushNotificationsResponseV2> listPushNotifications(
+            ListPushNotificationsRequestV2 request) throws YunxinSdkException;
+}
+

src/main/java/com/netease/nim/server/sdk/im/v2/system_push/SystemPushV2Service.java

@@ -0,0 +1,90 @@
+package com.netease.nim.server.sdk.im.v2.system_push;
+
+import com.alibaba.fastjson2.JSON;
+import com.netease.nim.server.sdk.core.Result;
+import com.netease.nim.server.sdk.core.YunxinApiHttpClient;
+import com.netease.nim.server.sdk.core.YunxinApiResponse;
+import com.netease.nim.server.sdk.core.exception.YunxinSdkException;
+import com.netease.nim.server.sdk.core.http.HttpMethod;
+import com.netease.nim.server.sdk.im.v2.system_push.request.*;
+import com.netease.nim.server.sdk.im.v2.system_push.response.*;
+import com.netease.nim.server.sdk.im.v2.util.ResultUtils;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Implementation of the system push service
+ */
+public class SystemPushV2Service implements ISystemPushV2Service {
+
+    private final YunxinApiHttpClient yunxinApiHttpClient;
+
+    /**
+     * Constructor
+     *
+     * @param yunxinApiHttpClient HTTP client for API calls
+     */
+    public SystemPushV2Service(YunxinApiHttpClient yunxinApiHttpClient) {
+        this.yunxinApiHttpClient = yunxinApiHttpClient;
+    }
+    
+    @Override
+    public Result<SendPushNotificationResponseV2> sendPushNotification(SendPushNotificationRequestV2 request) throws YunxinSdkException {
+        
+        String jsonRequestBody = JSON.toJSONString(request);
+        
+        YunxinApiResponse apiResponse = yunxinApiHttpClient.executeV2Api(
+            HttpMethod.POST,
+            SystemPushV2UrlContext.PUSH_NOTIFICATION,
+            SystemPushV2UrlContext.PUSH_NOTIFICATION,
+            null,
+            jsonRequestBody
+        );
+        
+        return ResultUtils.convert(apiResponse, SendPushNotificationResponseV2.class);
+    }
+    
+    @Override
+    public Result<GetPushNotificationResponseV2> getPushNotification(GetPushNotificationRequestV2 request) throws YunxinSdkException {
+        
+        String url = SystemPushV2UrlContext.GET_PUSH_NOTIFICATION.replace(
+                "{push_id}", String.valueOf(request.getPushId()));
+        
+        YunxinApiResponse apiResponse = yunxinApiHttpClient.executeV2Api(
+            HttpMethod.GET,
+            SystemPushV2UrlContext.GET_PUSH_NOTIFICATION,
+            url,
+            null,
+            null
+        );
+        
+        return ResultUtils.convert(apiResponse, GetPushNotificationResponseV2.class);
+    }
+    
+    @Override
+    public Result<ListPushNotificationsResponseV2> listPushNotifications(ListPushNotificationsRequestV2 request) throws YunxinSdkException {
+        
+        Map<String, String> queryParams = new HashMap<>();
+        if (request.getPageToken() != null) {
+            queryParams.put("page_token", request.getPageToken());
+        }
+        if (request.getLimit() != null) {
+            queryParams.put("limit", String.valueOf(request.getLimit()));
+        }
+        if (request.getType() != null) {
+            queryParams.put("type", String.valueOf(request.getType()));
+        }
+        
+        YunxinApiResponse apiResponse = yunxinApiHttpClient.executeV2Api(
+            HttpMethod.GET,
+            SystemPushV2UrlContext.PUSH_NOTIFICATION,
+            SystemPushV2UrlContext.PUSH_NOTIFICATION,
+            queryParams,
+            null
+        );
+        
+        return ResultUtils.convert(apiResponse, ListPushNotificationsResponseV2.class);
+    }
+}
+

src/main/java/com/netease/nim/server/sdk/im/v2/system_push/SystemPushV2UrlContext.java

@@ -0,0 +1,19 @@
+package com.netease.nim.server.sdk.im.v2.system_push;
+
+/**
+ * URL context for system push API V2
+ */
+public class SystemPushV2UrlContext {
+
+    /**
+     * URL for sending push notifications to all users
+     */
+    public static final String PUSH_NOTIFICATION = "/im/v2/push_notification";
+    
+    /**
+     * URL template for getting a single push notification
+     * {push_id} should be replaced with the push notification ID
+     */
+    public static final String GET_PUSH_NOTIFICATION = "/im/v2/push_notification/{push_id}";
+}
+

src/main/java/com/netease/nim/server/sdk/im/v2/system_push/request/GetPushNotificationRequestV2.java

@@ -0,0 +1,27 @@
+package com.netease.nim.server.sdk.im.v2.system_push.request;
+
+/**
+ * Request for getting a single push notification
+ * 
+ * API: GET https://open.yunxinapi.com/im/v2/push_notification/:push_id
+ */
+public class GetPushNotificationRequestV2 {
+    
+    private Long pushId;
+    
+    public GetPushNotificationRequestV2() {
+    }
+    
+    public GetPushNotificationRequestV2(Long pushId) {
+        this.pushId = pushId;
+    }
+    
+    public Long getPushId() {
+        return pushId;
+    }
+    
+    public void setPushId(Long pushId) {
+        this.pushId = pushId;
+    }
+}
+

src/main/java/com/netease/nim/server/sdk/im/v2/system_push/request/ListPushNotificationsRequestV2.java

@@ -0,0 +1,43 @@
+package com.netease.nim.server.sdk.im.v2.system_push.request;
+
+/**
+ * Request for listing push notifications with pagination
+ * 
+ * API: GET https://open.yunxinapi.com/im/v2/push_notification
+ */
+public class ListPushNotificationsRequestV2 {
+    
+    private String pageToken;
+    
+    private Integer limit;
+    
+    private Integer type;
+    
+    public ListPushNotificationsRequestV2() {
+    }
+    
+    public String getPageToken() {
+        return pageToken;
+    }
+    
+    public void setPageToken(String pageToken) {
+        this.pageToken = pageToken;
+    }
+    
+    public Integer getLimit() {
+        return limit;
+    }
+    
+    public void setLimit(Integer limit) {
+        this.limit = limit;
+    }
+    
+    public Integer getType() {
+        return type;
+    }
+    
+    public void setType(Integer type) {
+        this.type = type;
+    }
+}
+