极光推送在众多的消息推送里，口碑算是很好的，项目中我负责的是这一块，就整理了这篇博客帮助记忆；
极光推送官方SDK文档：/jpush/server/sdk/java_sdk/
错误码信息：/jpush/server/push/rest_api_v3_push/#_19
工具类：
import java.util.ArrayList;import java.util.List;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import mon.resp.APIConnectionException;import mon.resp.APIRequestException;import cn.jpush.api.JPushClient;import cn.jpush.api.push.PushResult;import cn.jpush.api.push.model.Message;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 cn.jpush.api.push.model.notification.Notification;import cn.jpush.api.schedule.ScheduleResult;/*** @author Zhang* @date 11月14日* @description: 极光推送工具类*/ public class JpushClientUtil {private static Logger logger = LoggerFactory.getLogger(JpushClientUtil.class);private final static String APPKER = "************";private final static String MASTERSECRET = "**********";private static JPushClient jPushClient = new JPushClient(MASTERSECRET,APPKER);private JpushClientUtil() {throw new AssertionError("不能产生该对象");}/*public static void main(String[] args) {List<String> alias = new ArrayList<String>();alias.add("276");alias.add("231");sendToRegistrationId(alias, "测试", "测试信息", "测试信息", "");// sendToRegistrationId2(alias, "测试", "测试信息", "测试信息", "","-11-23 17:05:25");// sendToAllAndroid("测试", "测试信息", "测试信息", "");// sendToAllIos("测试", "测试信息", "测试信息", "");}*//*** 推送给设备标识参数的用户* @param alias 设备标识* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段（通常传跳转的链接）* @return 0推送失败，1推送成功*/public static int sendToRegistrationId( List<String> alias,String notification_title, String msg_title, String msg_content, String extrasparam) {JPushClient jPushClient = new JPushClient(MASTERSECRET,APPKER);int result = 0;try {PushPayload pushPayload= JpushClientUtil.buildPushObject_all_alias_alertWithTitle(alias,notification_title,msg_title,msg_content,extrasparam);PushResult pushResult=jPushClient.sendPush(pushPayload);if(pushResult.getResponseCode()==200){result=1;}logger.info("[极光推送]PushResult result is " + pushResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;}/*** 推送给设备标识参数的用户（定时）* @param alias 设备标识* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段* @param time 格式:yyyy-MM-dd HH:mm:ss* @return 0推送失败，1推送成功*/public static int sendToRegistrationId2( List<String> alias,String notification_title, String msg_title, String msg_content, String extrasparam, String time) {JPushClient jPushClient = new JPushClient(MASTERSECRET,APPKER);int result = 0;try {PushPayload pushPayload= JpushClientUtil.buildPushObject_all_alias_alertWithTitle(alias,notification_title,msg_title,msg_content,extrasparam);ScheduleResult scheduleResult=jPushClient.createSingleSchedule("点呗生活", time, pushPayload);if(scheduleResult.getResponseCode()==200){result=1;}logger.info("[极光推送]ScheduleResult result is " + scheduleResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;} /*** 发送给所有安卓用户* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段* @return 0推送失败，1推送成功*/public static int sendToAllAndroid( String notification_title, String msg_title, String msg_content, String extrasparam) {int result = 0;try {PushPayload pushPayload= JpushClientUtil.buildPushObject_android_all_alertWithTitle(notification_title,msg_title,msg_content,extrasparam);PushResult pushResult=jPushClient.sendPush(pushPayload);if(pushResult.getResponseCode()==200){result=1;}logger.info("[极光推送]PushResult result is " + pushResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;}/*** 发送给所有IOS用户* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段* @return 0推送失败，1推送成功*/public static int sendToAllIos(String notification_title, String msg_title, String msg_content, String extrasparam) {int result = 0;try {PushPayload pushPayload= JpushClientUtil.buildPushObject_ios_all_alertWithTitle(notification_title,msg_title,msg_content,extrasparam);PushResult pushResult=jPushClient.sendPush(pushPayload);if(pushResult.getResponseCode()==200){result=1;}logger.info("[极光推送]PushResult result is " + pushResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;}/*** 发送给所有用户* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段* @return 0推送失败，1推送成功*/public static int sendToAll( String notification_title, String msg_title, String msg_content, String extrasparam) {int result = 0;try {PushPayload pushPayload= JpushClientUtil.buildPushObject_android_and_ios(notification_title,msg_title,msg_content,extrasparam);PushResult pushResult=jPushClient.sendPush(pushPayload);if(pushResult.getResponseCode()==200){result=1;}logger.info("[极光推送]PushResult result is " + pushResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;}/*** 发送给所有用户(定时推送)* @param notification_title 通知内容标题* @param msg_title 消息内容标题* @param msg_content 消息内容* @param extrasparam 扩展字段* @param time 格式:yyyy-MM-dd HH:mm:ss* @return 0推送失败，1推送成功*/public static int sendToAll2( String notification_title, String msg_title, String msg_content, String extrasparam, String time) {int result = 0;try {PushPayload pushPayload= JpushClientUtil2.buildPushObject_android_and_ios(notification_title,msg_title,msg_content,extrasparam);ScheduleResult scheduleResult=jPushClient.createSingleSchedule("测试", time, pushPayload);if(scheduleResult.getResponseCode()==200){result=1;}logger.info("[极光推送]scheduleResult result is " + scheduleResult);} catch (APIConnectionException e) {logger.error("[极光推送]Connection error. Should retry later. ", e);} 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 result;}public static PushPayload buildPushObject_android_and_ios(String notification_title, String msg_title, String msg_content, String extrasparam) {return PushPayload.newBuilder().setPlatform(Platform.android_ios()).setAudience(Audience.all()).setNotification(Notification.newBuilder().setAlert(msg_content).addPlatformNotification(AndroidNotification.newBuilder().setAlert(msg_content).setTitle(notification_title)//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam).build()).addPlatformNotification(IosNotification.newBuilder()//传一个IosAlert对象，指定apns title、title、subtitle等.setAlert(msg_content)//直接传alert//此项是指定此推送的badge自动加1.incrBadge(1)//此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，// 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音.setSound("sound.caf")//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam)//此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification// .setContentAvailable(true).build()).build())//Platform指定了哪些平台就会像指定平台中符合推送条件的设备进行推送。 jpush的自定义消息，// sdk默认不做任何处理，不会有通知提示。建议看文档http://docs.jpush.io/guideline/faq/的// [通知与自定义消息有什么区别？]了解通知和自定义消息的区别.setMessage(Message.newBuilder().setMsgContent(msg_content).setTitle(msg_title).addExtra("url",extrasparam).build()).setOptions(Options.newBuilder()//此字段的值是用来指定本推送要推送的apns环境，false表示开发，true表示生产；对android和自定义消息无意义.setApnsProduction(true)//此字段是给开发者自己给推送编号，方便推送者分辨推送记录.setSendno(1)//此字段的值是用来指定本推送的离线保存时长，如果不传此字段则默认保存一天，最多指定保留十天，单位为秒.setTimeToLive(86400).build()).build();}private static PushPayload buildPushObject_all_alias_alertWithTitle(List<String> alias,String notification_title, String msg_title, String msg_content, String extrasparam) {//创建一个IosAlert对象，可指定APNs的alert、title等字段//IosAlert iosAlert = IosAlert.newBuilder().setTitleAndBody("title", "alert body").build();return PushPayload.newBuilder()//指定要推送的平台，all代表当前应用配置了的所有平台，也可以传android等具体平台.setPlatform(Platform.all())//指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id.setAudience(Audience.alias(alias))//.setAudience(Audience.registrationId(registrationId))//jpush的通知，android的由jpush直接下发，iOS的由apns服务器下发，Winphone的由mpns下发.setNotification(Notification.newBuilder()//指定当前推送的android通知.addPlatformNotification(AndroidNotification.newBuilder().setAlert(msg_content).setTitle(notification_title)//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam).build())//指定当前推送的iOS通知.addPlatformNotification(IosNotification.newBuilder()//传一个IosAlert对象，指定apns title、title、subtitle等.setAlert(msg_content)//直接传alert//此项是指定此推送的badge自动加1.incrBadge(1)//此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，// 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音.setSound("sound.caf")//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam)//此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification//取消此注释，消息推送时ios将无法在锁屏情况接收// .setContentAvailable(true).build()).build())//Platform指定了哪些平台就会像指定平台中符合推送条件的设备进行推送。 jpush的自定义消息，// sdk默认不做任何处理，不会有通知提示。建议看文档http://docs.jpush.io/guideline/faq/的// [通知与自定义消息有什么区别？]了解通知和自定义消息的区别.setMessage(Message.newBuilder().setMsgContent(msg_content).setTitle(msg_title).addExtra("url",extrasparam).build()).setOptions(Options.newBuilder()//此字段的值是用来指定本推送要推送的apns环境，false表示开发，true表示生产；对android和自定义消息无意义.setApnsProduction(true)//此字段是给开发者自己给推送编号，方便推送者分辨推送记录.setSendno(1)//此字段的值是用来指定本推送的离线保存时长，如果不传此字段则默认保存一天，最多指定保留十天；.setTimeToLive(86400).build()).build();}private static PushPayload buildPushObject_android_all_alertWithTitle(String notification_title, String msg_title, String msg_content, String extrasparam) {return PushPayload.newBuilder()//指定要推送的平台，all代表当前应用配置了的所有平台，也可以传android等具体平台.setPlatform(Platform.android())//指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id.setAudience(Audience.all())//jpush的通知，android的由jpush直接下发，iOS的由apns服务器下发，Winphone的由mpns下发.setNotification(Notification.newBuilder()//指定当前推送的android通知.addPlatformNotification(AndroidNotification.newBuilder().setAlert(msg_content).setTitle(notification_title)//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam).build()).build())//Platform指定了哪些平台就会像指定平台中符合推送条件的设备进行推送。 jpush的自定义消息，// sdk默认不做任何处理，不会有通知提示。建议看文档http://docs.jpush.io/guideline/faq/的// [通知与自定义消息有什么区别？]了解通知和自定义消息的区别.setMessage(Message.newBuilder().setMsgContent(msg_content).setTitle(msg_title).addExtra("url",extrasparam).build()).setOptions(Options.newBuilder()//此字段的值是用来指定本推送要推送的apns环境，false表示开发，true表示生产；对android和自定义消息无意义.setApnsProduction(true)//此字段是给开发者自己给推送编号，方便推送者分辨推送记录.setSendno(1)//此字段的值是用来指定本推送的离线保存时长，如果不传此字段则默认保存一天，最多指定保留十天，单位为秒.setTimeToLive(86400).build()).build();}private static PushPayload buildPushObject_ios_all_alertWithTitle( String notification_title, String msg_title, String msg_content, String extrasparam) {return PushPayload.newBuilder()//指定要推送的平台，all代表当前应用配置了的所有平台，也可以传android等具体平台.setPlatform(Platform.ios())//指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id.setAudience(Audience.all())//jpush的通知，android的由jpush直接下发，iOS的由apns服务器下发，Winphone的由mpns下发.setNotification(Notification.newBuilder()//指定当前推送的android通知.addPlatformNotification(IosNotification.newBuilder()//传一个IosAlert对象，指定apns title、title、subtitle等.setAlert(msg_content)//直接传alert//此项是指定此推送的badge自动加1.incrBadge(1)//此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，// 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音.setSound("sound.caf")//此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）.addExtra("url",extrasparam)//此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification// .setContentAvailable(true).build()).build())//Platform指定了哪些平台就会像指定平台中符合推送条件的设备进行推送。 jpush的自定义消息，// sdk默认不做任何处理，不会有通知提示。建议看文档http://docs.jpush.io/guideline/faq/的// [通知与自定义消息有什么区别？]了解通知和自定义消息的区别.setMessage(Message.newBuilder().setMsgContent(msg_content).setTitle(msg_title).addExtra("url",extrasparam).build()).setOptions(Options.newBuilder()//此字段的值是用来指定本推送要推送的apns环境，false表示开发，true表示生产；对android和自定义消息无意义.setApnsProduction(true)//此字段是给开发者自己给推送编号，方便推送者分辨推送记录.setSendno(1)//此字段的值是用来指定本推送的离线保存时长，如果不传此字段则默认保存一天，最多指定保留十天，单位为秒.setTimeToLive(86400).build()).build();}}
推送成功返回：
推送失败返回(大多的推送失败返回，都是1011找不到指定的目标用户):
