最近做了个极光推送的功能，一下是我对这个功能的一点理解；
首先要先介入极光的包，通过maven加载包：jiguang-common，gson，log4j，slf4j，导入的方法官网上都有，直接去极光API文档上复制就行；导入完成之后在Service层添加推送方法
public Integer sendPush(String operatorId, String taskId) { ... }
首先要先添加两个重要的对象ClientConfig，JPushClient；ClientConfig是客户端配置的一些参数和极光推送需要访问的一些url；JPushClient就是极光推送的核心类。
ClientConfig clientConfig = ClientConfig.getInstance();
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY, null, clientConfig);
ClientConfig.getInstance(); 获取对象的实例；
MASTER_SECRET，APP_KEY，这两个字段是注册极光推送账号的时候分配给你的，复制上去即可；
接下来是获取regId和cid；regId是当客户端接入了极光的代码之后，会自动生成一个编码，需要服务端这边记录下来，我自己建了一张表，通过客户的手机号码和regId建立管理关系，依次来推送。注：极光推送的时候，极光推送的服务端是不认手机号码的，他们是根据regId来进行推送，所以regId至关重要；由于我有多个推送方法，而regId和cid是都需要获取的，所以我把他提出来写；
MapresultMap = regIdAndCid(operatorId);
public MapregIdAndCid(String operatorId) {
String result = "0";
ClientConfig clientConfig = ClientConfig.getInstance();
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY, null, clientConfig);Mapmap = new HashMap();
PbRegist pbRegist = new PbRegist();
pbRegist.setUserId(operatorId);
PbRegist regist = pbRegistDao.load(pbRegist);
String regId = "";
if (null != regist) {
regId = regist.getRegId();
} else {
_logger.info("regId未生成");
map.put("result", "2");
return map;
}
//获取cid
CIDResult result_cidList = null;
String cid = "";
try {
result_cidList = jpushClient.getCidList(1, "push");
//切割cid
String a = result_cidList.toString();
cid = a.substring(13,a.length()-3);
} catch (APIConnectionException | APIRequestException e1) {
_logger.info("cid获取错误");
e1.printStackTrace();
map.put("result", "1");
return map;
}
map.put("regId", regId);
map.put("cid", cid);
map.put("result", result);
return map;
}
operatorId是手机号码，通过手机号码查询到表里面的regId；cid是通过jpushClient.getCidList方法获得。其中result的编码：0-成功，1-cid获取失败，2-该用户未登录没有regId；
在都获取完成之后，需要构建一个push的对象：PushPayload payload = buildPushObject_to_do_task(regId,cid);
//创建一个推送-待办任务的推送
public static PushPayload buildPushObject_to_do_task(String regId, String cid) {
return PushPayload.newBuilder()
.setPlatform(Platform.all())
.setAudience(Audience.registrationId(regId))
.setNotification(Notification.alert(ALERT))
.setCid(cid)
.setOptions(Options.newBuilder()
//提交生产的时候需要切换
//.setApnsProduction(true)
.setApnsProduction(false)
.setTimeToLive(864000)
.build())
.build();
}
推送对象需要的元素是：Platform.all()推送的平台，可以设置仅推ios，仅推and，和全平台都推；Audience.registrationId(regId)这个就是客户端登录的时候，极光后台分配给你的编码，需要你自己保存的；.setNotification(Notification.alert(ALERT))，推送通知的内容，ALERT可以在类的顶部自己定义一段话；.setCid(cid) 通过 jpushClient.getCidList(...);方法获取；Options选项Production：环境，true生产环境；false开发、测试环境；TimeToLive保留多少天，默认1天，最多10天，86400*10 = 10天；
推送对象完成后，进入最后一步，推送：
PushResult result = jpushClient.sendPush(payload); 要用try - catch
//推送
try {
PushResult result = jpushClient.sendPush(payload);
_logger.info("Got result - " + result);
return 0;
} catch (APIConnectionException e) {
_logger.error("Connection error. Should retry later. ", e);
return 1;
} catch (APIRequestException e) {
_logger.error("Error response from JPush server. Should review and fix it. ", e);
_logger.info("HTTP Status: " + e.getStatus());
_logger.info("Error Code: " + e.getErrorCode());
_logger.info("Error Message: " + e.getErrorMessage());
return 1;
}
备注：0-推送成功；1-推送失败；
以下为整个类的完整代码：
//极光推送 收到待办任务 1-推送失败，0-推送成功,2-该用户未登录，没有生成regid没有regId@Override
public Integer sendPush(String operatorId, String taskId) {
ClientConfig clientConfig = ClientConfig.getInstance();JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY, null, clientConfig);MapresultMap = regIdAndCid(operatorId);
String resultFlag = resultMap.get("result")+"";
if("1".equals(resultFlag)){
return 1;
}
if("2".equals(resultFlag)){
return 2;
}
String regId = resultMap.get("regId")+"";
String cid = resultMap.get("cid")+"";
//构建一个push对象
PushPayload payload = buildPushObject_to_do_task(regId,cid);
_logger.info("payload - " + payload);
//推送
try {
PushResult result = jpushClient.sendPush(payload);
_logger.info("Got result - " + result);
return 0;
} catch (APIConnectionException e) {
_logger.error("Connection error. Should retry later. ", e);
return 1;
} catch (APIRequestException e) {
_logger.error("Error response from JPush server. Should review and fix it. ", e);
_logger.info("HTTP Status: " + e.getStatus());
_logger.info("Error Code: " + e.getErrorCode());
_logger.info("Error Message: " + e.getErrorMessage());
return 1;
}
}
//创建一个推送-待办任务的推送
public static PushPayload buildPushObject_to_do_task(String regId, String cid) {
return PushPayload.newBuilder()
.setPlatform(Platform.all())
.setAudience(Audience.registrationId(regId))
.setNotification(Notification.alert(ALERT))
.setCid(cid)
.setOptions(Options.newBuilder()
//提交生产的时候需要切换
//.setApnsProduction(true)
.setApnsProduction(false)
. setTimeToLive(864000)
.build())
.build();
}
//获取regId和cid方法
public MapregIdAndCid(String operatorId) {
String result = "0";
ClientConfig clientConfig = ClientConfig.getInstance();
JPushClient jpushClient = new JPushClient(MASTER_SECRET, APP_KEY, null, clientConfig);
Mapmap = new HashMap();
PbRegist pbRegist = new PbRegist();
pbRegist.setUserId(operatorId);
PbRegist regist = pbRegistDao.load(pbRegist);
String regId = "";
if (null != regist) {
regId = regist.getRegId();
} else {
_logger.info("regId未生成");
map.put("result", "2");
return map;
}
//获取cid
CIDResult result_cidList = null;
String cid = "";
try {
result_cidList = jpushClient.getCidList(1, "push");
//切割cid
String a = result_cidList.toString();
cid = a.substring(13,a.length()-3);
} catch (APIConnectionException | APIRequestException e1) {
_logger.info("cid获取错误");
e1.printStackTrace();
map.put("result", "1");
return map;
}
map.put("regId", regId);
map.put("cid", cid);
map.put("result", result);
return map;
}
第一次用极光推送，还有很多瑕疵，希望大家多多指点 ~
推送成功后的json：
Got result - {"msg_id":1141315895,"sendno":1718225847,"statusCode":0}
payload 推送对象的json：
payload -
{"platform":"all",
"audience":{"registration_id":["13065ffa4e0c9ea0662"]},
"notification":{"alert":"您有一条交办任务于3小时后截止，记得去完成哦！",
"android":{"alert":"您有一条交办任务于3小时后截止，记得去完成哦！",
"extras":{"taskId":"JB00013420171114011"},
"title":"任务到期推送"},"ios":{"alert":"您有一条交办任务于3小时后截止，记得去完成哦！",
"extras":{"taskId":"JB00013420171114011"},"badge":"+1","sound":""}},
"options":{"sendno":1718225847,"time_to_live":864000,"apns_production":false},
"cid":"8c393f1fcc57e465e84019d5-d9f7fbc8-7cab-4447-aab4-350ab55c67ac"}
