关于极光推送Jpush的demo

关于极光推送Jpush

　　推送是手机app必不可少的一样功能，这次由于公司项目需要研究了一下。由于推送一般写于服务端，所以对于不会Android的javaweb程序员要写出一个完整的demo是一件很头痛的事情。所以我就在这里从头到尾写一个例子以示参考。由于我也不懂Android 只是由于项目需要百度了一个demo，当中有很多不足的地方忘各位大神指正。

一、首先先简单的介绍一下什么是极光推送

①为什么需要推送：为了解决数据同步的问题，在手机平台上，常用的方法有2种。一种是定时去服务器上查询数据，也叫Polling，还有一种手机跟服务器之间维护一个 TCP 长连接，当服务器有数据时，实时推送到客户端，也就是我们说的 Push。由于做推送在移动网络下维持长连接有一定的技术难度，而且当用户量上去的时候，需要很多服务器来维持长连接，成本也是很大的。因此我们需要一个第三方的jar包来支持我们的推送服务。如果想了解更多内容可参看极光推送官方文档。

②极光推送的通俗解答：就是把需要推送的内容通过调用jpush的api的发送到极光推送的服务器上，极光推送的服务器根据我们推送过去的内容选择推送到具体的app。

二、源码

服务端代码：http://pan.baidu.com/s/1bpH55uR

安卓客户端代码：http://pan.baidu.com/s/1jIqmN7S

安卓环境为：ADT+SDK+eclipse

ADT下载：http://pan.baidu.com/s/1dFmZlZF

SDK下载：http://pan.baidu.com/s/1kU53AUr

所需JDK的环境安装就不一一叙述了。

注：代码可直接导入只需要改几个地方后面会阐述。首先教大家搭下安卓环境先保证代码能导入成功

三、操作步骤

①  安装插件

②安装sdk

此步骤完成后页面会切换到Android的开发界面，页面会多两个东西

选择你要安装的一般选择Tools里面的和Android你所需要的版本，然后带你安装，我这里已经没有选，所以示灰色的。

注：关于安装很慢或者安装失败

有两种方法：

①  使用翻墙软件  我用的蓝灯

②  使用配置镜像服务器  如图：

③然后导入安卓工程（服务端的工程就不叙述怎么导入了）

在工程列表的空白处右键--选择import--然后操作如图

然后是运行安卓程序（最好是插上数据线--打开手机的usb调试--然后程序运行的时候回下到手机上）

具体的可以百度下。

四、极光推送的使用（肯定要到官网注册一个账号）

具体使用请百度，或者参照官网，下面是主要截图

appkey和master secret 后面会用到

五、修改Android配置文件，将appkey改成你所添加的应用的appkey

六、服务端代码展示，代码均有注释就不一一解释了

只用的到这三个代码

APPKET和MASTERSECRET 改成你在极光开发者服务添加的应用时所生产的字符串

  package com.uxun.serviceImpl;

 import com.uxun.service.JPushService;

 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.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;

 public class JPushServiceImpl implements JPushService {

     private final static String APPKET = "44262636e2afd75d9b9f7932";

     private final static String  MASTERSECRET = "ae5c0ab5f093b2aba1f8ce25";

     private static JPushClient jPushClient = new JPushClient(MASTERSECRET, APPKET);//通知默认保留24小时。

     @Override
     public int sendToRegistrationId(String registrationId, String notification_alert, String notification_title,
             String extrasparam) {
         int result = 0;
         try {
             PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithRegistrationId(registrationId,
                     notification_alert, notification_title, extrasparam);
             System.out.println(pushPayload);
             PushResult pushResult=jPushClient.sendPush(pushPayload);  //发送推送对象
             //System.out.println(pushResult);
             if(pushResult.getResponseCode() == 200) {  //状态码等于200 为成功
                 result=1;
             }
         } catch (APIConnectionException e) {
             e.printStackTrace();
         } catch (APIRequestException e) {
             e.printStackTrace();
         }

          return result;
     }

     @Override
     public int sendToAll(String notification_alert, String notification_title, String extrasparam) {
         int result = 0;
         try {
             PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithAll(notification_alert,
                     notification_title, extrasparam);
             System.out.println(pushPayload);
             PushResult pushResult=jPushClient.sendPush(pushPayload);  //发送推送对象
             //System.out.println(pushResult);
             if(pushResult.getResponseCode() == 200) {  //状态码等于200 为成功
                 result=1;
             }
         } catch (APIConnectionException e) {
             e.printStackTrace();
         } catch (APIRequestException e) {
             e.printStackTrace();
         }

          return result;
     }

     @Override
     public int sendToAllIos(String notification_alert, String notification_title, String extrasparam) {

         int result = 0;
         try {
             PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithIos(notification_alert,
                     notification_title, extrasparam);
             System.out.println(pushPayload);
             PushResult pushResult=jPushClient.sendPush(pushPayload);  //发送推送对象
             //System.out.println(pushResult);
             if(pushResult.getResponseCode() == 200) {  //状态码等于200 为成功
                 result=1;
             }
         } catch (APIConnectionException e) {
             e.printStackTrace();
         } catch (APIRequestException e) {
             e.printStackTrace();
         }

          return result;
     }

     @Override
     public int sendToAllAndroid(String notification_alert, String notification_title, String extrasparam) {

         int result = 0;
         try {
             PushPayload pushPayload= JPushServiceImpl.buildPushObjectWithAndroid(notification_alert,
                     notification_title, extrasparam);
             System.out.println(pushPayload);
             PushResult pushResult=jPushClient.sendPush(pushPayload);  //发送推送对象
             //System.out.println(pushResult);
             if(pushResult.getResponseCode() == 200) {  //状态码等于200 为成功
                 result=1;
             }
         } catch (APIConnectionException e) {
             e.printStackTrace();
         } catch (APIRequestException e) {
             e.printStackTrace();
         }

          return result;
     }

     /**
      * 建立以唯一设备标识符推送的对象
      * @param registrationId  唯一设备标识
      * @param notification_alert  通知内容
      * @param notification_title  通知标题
      * @param extrasparam  扩展字段
      * @return  返回推送对象
      */
     private static PushPayload buildPushObjectWithRegistrationId(String registrationId, String notification_alert, String notification_title,
             String extrasparam) {
         return PushPayload.newBuilder()
                 //指定要推送的平台，all代表当前应用配置了的所有平台，也可以传android等具体平台
                 .setPlatform(Platform.all())
                 //指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id
                 .setAudience(Audience.registrationId(registrationId))
                 //jpush的通知，android的由jpush直接下发，iOS的由apns服务器下发，Winphone的由mpns下发
                 .setNotification(Notification.newBuilder()
                 //指定当前推送的android通知
                 .addPlatformNotification(AndroidNotification.newBuilder()
                     .setAlert(notification_alert)   //设置通知内容（必填）
                     .setTitle(notification_title)    //设置通知标题（可选）
                     //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                     .addExtra("androidNotification extras key",extrasparam)
                     .build())

                 //指定当前推送的iOS通知
                 .addPlatformNotification(IosNotification.newBuilder()
                     //传一个IosAlert对象，指定apns title、title、subtitle等
                     .setAlert(notification_alert)
                     //直接传alert
                     //此项是指定此推送的badge（应用角标）自动加1
                     .incrBadge(1)
                     //此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，
                     // 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音
                     .setSound("sound.caf")
                     //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                     .addExtra("iosNotification extras key",extrasparam)
                     //此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification
                     //取消此注释，消息推送时ios将无法在锁屏情况接收
                     // .setContentAvailable(true)
                     .build())

                 //指定当前推送的winPhone通知
                 /*.addPlatformNotification(WinphoneNotification.newBuilder()
                       .setAlert(notification_alert)
                       //.setTitle(""))  //设置通知标题（可选）此标题将取代显示app名称的地方
                     .build())*/
                     .build())
                     .build();
     }

     /**
      * 建立推送所有用户的推送对象
      * @param notification_alert  通知内容
      * @param notification_title  通知标题
      * @param extrasparam  扩展字段
      * @return  返回推送对象
      */
     private static PushPayload buildPushObjectWithAll(String notification_alert,
             String notification_title, String extrasparam) {
         return PushPayload.newBuilder()
                 //指定要推送的平台，all代表当前应用配置了的所有平台，也可以传android等具体平台
                 .setPlatform(Platform.all())
                 //指定推送的接收对象，all代表所有人，也可以指定已经设置成功的tag或alias或该应应用客户端调用接口获取到的registration id
                 .setAudience(Audience.all())
                 //jpush的通知，android的由jpush直接下发，iOS的由apns服务器下发，Winphone的由mpns下发
                 .setNotification(Notification.newBuilder()
                 //指定当前推送的android通知
                 .addPlatformNotification(AndroidNotification.newBuilder()
                     .setAlert(notification_alert)   //设置通知内容（必填）
                     .setTitle(notification_title)    //设置通知标题（可选）
                     //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                     .addExtra("androidNotification extras key",extrasparam)
                     .build())

                 //指定当前推送的iOS通知
                 .addPlatformNotification(IosNotification.newBuilder()
                     //传一个IosAlert对象，指定apns title、title、subtitle等
                     .setAlert(notification_alert)
                     //直接传alert
                     //此项是指定此推送的badge（应用角标）自动加1
                     .incrBadge(1)
                     //此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，
                     // 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音
                     .setSound("sound.caf")
                     //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                     .addExtra("iosNotification extras key",extrasparam)
                     //此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification
                     //取消此注释，消息推送时ios将无法在锁屏情况接收
                     // .setContentAvailable(true)
                     .build())

                 //指定当前推送的winPhone通知
                 /*.addPlatformNotification(WinphoneNotification.newBuilder()
                       .setAlert(notification_alert)
                       //.setTitle(""))  //设置通知标题（可选）此标题将取代显示app名称的地方
                     .build())*/
                     .build())
                     .build();
     }

     /**
      * 建立推送所有ios用户的推送对象
      * @param notification_alert  通知内容
      * @param notification_title  通知标题
      * @param extrasparam  扩展字段
      * @return  返回推送对象
      */
     private static PushPayload buildPushObjectWithIos(String notification_alert,
             String notification_title, 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()

                 //指定当前推送的iOS通知
                 .addPlatformNotification(IosNotification.newBuilder()
                     //传一个IosAlert对象，指定apns title、title、subtitle等
                     .setAlert(notification_alert)
                     //直接传alert
                     //此项是指定此推送的badge（应用角标）自动加1
                     .incrBadge(1)
                     //此字段的值default表示系统默认声音；传sound.caf表示此推送以项目里面打包的sound.caf声音来提醒，
                     // 如果系统没有此音频则以系统默认声音提醒；此字段如果传空字符串，iOS9及以上的系统是无声音提醒，以下的系统是默认声音
                     .setSound("sound.caf")
                     //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                     .addExtra("iosNotification extras key",extrasparam)
                     //此项说明此推送是一个background推送，想了解background看：http://docs.jpush.io/client/ios_tutorials/#ios-7-background-remote-notification
                     //取消此注释，消息推送时ios将无法在锁屏情况接收
                     // .setContentAvailable(true)
                     .build())
                     .build())
                     .build();
     }

     /**
      * 建立推送所有安卓用户的推送对象
      * @param notification_alert  通知内容
      * @param notification_title  通知标题
      * @param extrasparam  扩展字段
      * @return  返回推送对象
      */
     private static PushPayload buildPushObjectWithAndroid(String notification_alert,
             String notification_title, 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(notification_alert)   //设置通知内容（必填）
                         .setTitle(notification_title)    //设置通知标题（可选）
                         //此字段为透传字段，不会显示在通知栏。用户可以通过此字段来做一些定制需求，如特定的key传要指定跳转的页面（value）
                         .addExtra("androidNotification extras key",extrasparam)
                         .build())
                         .build())
                         .build();
     }

 }

运行服务端代码后手机会受到如下通知：

其实就是服务端通过唯一识别的appkey和master secret将通知发送到极光服务器，服务器再转发至对应的app（上面app的配置文件里也配置了appkey）

具体操作就是这么多，可能不是很详细，但是操作步骤实在太多，就不一一截图了，这里只给大部分的具体方向。