java后端整合极光消息推送

目录

1、简介

2、极光Demo

2.1、进入极光官网——应用管理

2.2、快速集成一个Android/iOS的SDK​

2.3、java服务端代码

3、参考资料

---

1、简介

简单来说，就是android系统没有内置的推送程序，如果要想实现消息推送到APP只有通过客户端与服务器长连接的方式来保证消息推送的通畅性。因此可以借助第三方平台，如极光推送，专门负责推送消息。这样APP就不需要与服务器长连接了，可以减少服务器负荷。

有关极光推送详细原理可参考：从极光推送的实现原理概括iOS和Andriod推送原理

2、极光Demo

2.1、进入极光官网——应用管理  

https://www.jiguang.cn/portal/#/dev/overview/appCardList

创建一个极光应用

2.2、快速集成一个Android/iOS的SDK

如果只是做极光推送后端的话，可以直接下载官方集成好的sdk

2.3、java服务端代码

消息模板类

package com.myaurora.entity;

import com.fasterxml.jackson.annotation.JsonProperty;
import com.google.gson.JsonObject;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.Map;

/**
 * @author: Atlantide
 * @time: 2021/8/6 9:52
 * @description: 极光推送消息类型
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class NotificationBO {
    private String title;
    private String alert;

}

枚举类 

package com.myaurora.enums;

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Getter
@AllArgsConstructor
@NoArgsConstructor
// 枚举类，用于指定推送平台，推送模式
public enum PushEnum {
    IOS(1, "ios"),
    Android(2, "android"),
    RegistrationId(3, "registrationId"),
    Alias(4, "alias"),
    All(5, "all");

    private int code;
    private String content;
}

工具类 

package com.myaurora.util;

import cn.jiguang.common.resp.APIConnectionException;
import cn.jiguang.common.resp.APIRequestException;
import cn.jpush.api.JPushClient;
import cn.jpush.api.push.PushResult;
import cn.jpush.api.push.model.Options;
import cn.jpush.api.push.model.Platform;
import cn.jpush.api.push.model.PushPayload;
import cn.jpush.api.push.model.audience.Audience;
import cn.jpush.api.push.model.notification.AndroidNotification;
import cn.jpush.api.push.model.notification.IosNotification;
import com.myaurora.entity.NotificationBO;
import com.myaurora.enums.PushEnum;
import org.springframework.beans.factory.annotation.Value;

/**
 * @author: Atlantide
 * @time: 2021/8/6 10:04
 * @description: 极光推送工具类
 */

public class JpushUtils {

    private static JPushClient jPushClient = new JPushClient("极光应用的masterSecret", "极光应用的appKey");

    /**
     * @author: Atlantide
     * @creat: 2021-08-05 15:23
     * @desc: 批量推送
     * notificationBO: 消息
     * alias: 别名
     * registrationIds: 注册Id
     * platForm: android/ios
     * pattern: 根据alias/registrationIds推送 / 全局推送（推所有用户）
     **/
    public static int jiguangSend_batch(NotificationBO notificationBO, String[] alias, String[] registrationIds, String platForm, String pattern) {
        int result = 0;
        try {
            PushPayload pushPayload = JpushUtils.pushBatch(notificationBO, alias, registrationIds, platForm, pattern);

            System.out.println(pushPayload);
            PushResult pushResult = jPushClient.sendPush(pushPayload);
            System.out.println(pushResult);
            if (pushResult.getResponseCode() == 200) {
                result = 1;
            }
        } catch (APIConnectionException e) {
            e.printStackTrace();

        } catch (APIRequestException e) {
            e.printStackTrace();
        }
        return result;
    }

    /**
     * @author: Atlantide
     * @creat: 2021-08-05 15:17
     * @desc: 指定平台批量推送
     * notificationBO: 消息
     * alias: 别名
     * registrationIds: 注册Id
     * platForm: android/ios
     * pattern: 根据alias/registrationIds推送 / 全局推送（推所有用户）
     **/
    private static PushPayload pushBatch(NotificationBO notificationBO, String[] alias, String[] registrationIds, String platForm, String pattern) {
        // 创建一个IosAlert对象，可指定APNs的alert、title等字段
        return PushPayload.newBuilder()
                // 指定要推送的平台
                .setPlatform(platForm.equals(PushEnum.Android.getContent()) ? Platform.android()
                        : platForm.equals(PushEnum.IOS.getContent()) ? Platform.ios() : Platform.all())
                // 指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration
                .setAudience(pattern.equals(PushEnum.Alias.getContent()) ? Audience.alias(alias) :
                        pattern.equals(PushEnum.RegistrationId.getContent()) ? Audience.registrationId(registrationIds) :
                                Audience.all())
                // jpush的通知
                .setNotification(cn.jpush.api.push.model.notification.Notification.newBuilder()
                        // 指定当前推送的通知
                        .addPlatformNotification(platForm.equals(PushEnum.Android.getContent()) ? AndroidNotification.newBuilder().
                                setAlert(notificationBO.getAlert())
                                .setTitle(notificationBO.getTitle())
                                .build() :
                                IosNotification.newBuilder().setThreadId(notificationBO.getTitle()).setAlert(notificationBO.getAlert()).build())
                        .build())
                .setOptions(Options.newBuilder()
                        // 此字段的值是用来指定本推送要推送的apns环境，false表示开发，true表示生产；对android和自定义消息无意义
                        .setApnsProduction(false)
                        // 此字段是给开发者自己给推送编号，方便推送者分辨推送记录
                        .setSendno(1)
                        // 此字段的值是用来指定本推送的离线保存时长，如果不传此字段则默认保存一天，最多指定保留十天；
                        .setTimeToLive(86400)
                        .build())
                .build();
    }

}

在pom.xml中增加极光推送的依赖

 <!-- 极光推送 -->
        <dependency>
            <groupId>cn.jpush.api</groupId>
            <artifactId>jpush-client</artifactId>
            <version>3.4.3</version>
        </dependency>

        <dependency>
            <groupId>cn.jpush.api</groupId>
            <artifactId>jiguang-common</artifactId>
            <version>1.1.7</version>
        </dependency>

启动类

package com.myaurora;

import com.myaurora.entity.NotificationBO;
import com.myaurora.util.JpushUtils;

/**
 * @author: Atlantide
 * @time: 2021/8/6 10:51
 * @description:
 */

public class Run {
    public static void main(String[] args) {
        String[] alias = {"别名"};
        String[] registrationIds = {"Registration ID"};
        NotificationBO notificationBO = new NotificationBO();
        notificationBO.setTitle("标题");
        notificationBO.setAlert("内容");
        //推送平台为android，推送方式为使用别名推送
        JpushUtils.jiguangSend_batch(notificationBO, alias, registrationIds, "android", "alias");
    }
}

打开”极光Demo“，启动java程序，消息推送成功。

3、参考资料

• https://blog.csdn.net/liufangbaishi2014/article/details/52015921
• https://docs.jiguang.cn//jpush/server/push/rest_api_v3_push/#notification