目录
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程序，消息推送成功。
