java服務端集成極光消息推送--詳細開發步驟

1.極光推送賬號准備

　　要使用極光消息推送必須先在官方網站上注冊賬號,並添加應用.

　　產品介紹:https://docs.jiguang.cn/jpush/guideline/intro/

　　注冊開發者賬號:https://www.jiguang.cn/accounts/register

　　注冊完成后需要添加應用

　　應用配置好后有兩個重要的數據,必須獲取到,在后面發送消息的時候要使用:

　　

2.極光推送后端管理配置認識

　　要做極光推送,得先認識極光賬號的后端管理平台,應為在開發的時候很多參數和配置來自於后端管理系統

　　先宏觀認識一下消息推送流程圖:

　　

　　后端管理說明:https://docs.jiguang.cn/jpush/console/Instructions/

3.集成java服務端

3.1.添加maven依賴,使用官方提供的sdk

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

 

3.2.客戶端java代碼

代碼參考文檔:

https://docs.jiguang.cn/jpush/server/push/server_overview/

package com.qianxingniwo.client;


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.Notification;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.ArrayList;
import java.util.List;

/**
 * @Copyright (C) 四川千行你我科技有限公司
 * @Author: LI DONG PING
 * @Date: 7/3 19:11
 * @Description:
 */

public class JpushClientUtil {
    private static final Logger log = LoggerFactory.getLogger(JpushClientUtil.class);

    private final static String appKey = "應用的key(非登錄賬號)";

    private final static String masterSecret = "應用的密碼(非登錄密碼)";

    private static JPushClient jPushClient = new JPushClient(masterSecret, appKey);


    /**
     * 發送給所有安卓用戶
     *
     * @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, String cid) {
        int result = 0;
        try {
            PushPayload pushPayload = JpushClientUtil.buildPushObject_android_all_alertWithTitle(notification_title, msg_title, msg_content, extrasparam, cid);
            System.out.println("推送參數:" + pushPayload);
            PushResult pushResult = jPushClient.sendPush(pushPayload);
            System.out.println("推送結果:" + pushResult);
            if (pushResult.getResponseCode() == 200) {
                result = 1;
            }
        } catch (Exception e) {

            e.printStackTrace();
        }

        return result;
    }

    /**
     * 生產發送條件
     *
     * @param notification_title
     * @param msg_title
     * @param msg_content
     * @param extrasparam
     * @param cid
     * @return
     */
    private static PushPayload buildPushObject_android_all_alertWithTitle(String notification_title, String msg_title, String msg_content, String extrasparam, String cid) {
        log.info("構建推送參數,如推薦平台,接收對象");
        //具體參看接口文檔
        //https://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/
        List list = new ArrayList();
        // Audience.tag(list);
        //  Audience audience = Audience.alias("112201","112202");//別名推送
        // Audience audience = Audience.tag("tag1");
        //Audience audience = Audience.all();
        // Audience audience = Audience.registrationId("112201", "112202");
        Audience audience = Audience.segment("c8f2fff736");
        return PushPayload.newBuilder()
                //指定要推送的平台，all代表當前應用配置了的所有平台，也可以傳android等具體平台
                .setPlatform(Platform.android())
                //設置發送消息id
                //  .setCid(cid)
                //指定推送的接收對象，all代表所有人，也可以指定已經設置成功的tag或alias或該應應用客戶端調用接口獲取到的registration id
                .setAudience(audience)
                // .setAudience(Audience.tag(list))
                //jpush的通知，android的由jpush直接下發，iOS的由apns服務器下發，Winphone的由mpns下發
                .setNotification(Notification.newBuilder()
                        //指定當前推送的android通知
                        .addPlatformNotification(AndroidNotification.newBuilder()
                                .setAlert(notification_title)
                                .setTitle(notification_title)
                                //此字段為透傳字段，不會顯示在通知欄。用戶可以通過此字段來做一些定制需求，如特定的key傳要指定跳轉的頁面（value）
                                .addExtra("androidNotification extras key", extrasparam)
                                .build())
                        .build()
                )
                //Platform指定了哪些平台就會像指定平台中符合推送條件的設備進行推送。 jpush的自定義消息，
                // sdk默認不做任何處理，不會有通知提示。建議看文檔http://docs.jpush.io/guideline/faq/的
                // [通知與自定義消息有什么區別？]了解通知和自定義消息的區別
                .setMessage(Message.newBuilder()
                        .setMsgContent(msg_content)
                        .setTitle(msg_title)
                        .addExtra("message extras key", extrasparam)
                        .build())

                .setOptions(Options.newBuilder()
                        //此字段的值是用來指定本推送要推送的apns環境，false表示開發，true表示生產；對android和自定義消息無意義
                        .setApnsProduction(false)
                        //此字段是給開發者自己給推送編號，方便推送者分辨推送記錄
                        .setSendno(1)
                        //此字段的值是用來指定本推送的離線保存時長，如果不傳此字段則默認保存一天，最多指定保留十天，單位為秒
                        .setTimeToLive(86400)
                        .build())
                .build();
    }

    /**
     * 發送測試
     *
     * @param args
     */
    public static void main(String[] args) {
        String num = "-0405-別名";
        String notification_title = "推送測試-通知標題" + num;
        String msg_title = "推送測試-內容標題" + num;
        String msg_content = "我是內容" + num;
        String extrasparam = "我是擴展的json" + num;
        String cid = String.valueOf(System.currentTimeMillis());
        int i = JpushClientUtil.sendToAllAndroid(notification_title, msg_title, msg_content, extrasparam, cid);
        System.out.println("i=" + i);
    }
}

 

3.3.發送測試

　　執行發送后,如果發送成功,我們可以在后端管理系統中看見消息詳情

　　

3.3.注意事項

　　1.剛建立的極光賬號由於配置的原因,很多發送條件是測試不了的,一定要信息閱讀接口文檔,如下:

　　

　　2.cid並非任意編號,而是有規則的

　　

　　3.遇到問題再補充....