極光推送>>java SDK服務端集成後臺項目(使用詳解)

PS:若是你是第一次用推送,那就直接按照個人步驟來,再去看官方文檔,這樣,更容易能理解操做流程.還有——-請耐心看

極光文檔(java SDK)請參考

[ 極光文檔 ]

---

步驟一:

• 首先,你必須在 [極光官網] 上註冊一個帳號
• 其次,註冊完後登陸,選擇極光開發者服務 
  

• 進去以後,建立一個應用,已有應用可跳過 
  

• 建立完成 
  

• 進入應用,看到AppKey和MasterSecret,這兩個參數在sdk集成的時候會用到 
  

---

項目中的操做

• 我是直接用的maven庫,畢竟這個年頭手動到jar包的項目估計沒幾個了,若是你是手動導入jar,那麼,請去官網下載jar包-o-

Maven方式導入極光推送的依賴jar包

• PS:將下面所有jar複製到你項目的pom.xml裏面(我項目以前原本就有log4j,就沒有寫到下面,導入的時候注意下,能夠參考官網的jar包)

<dependency> <groupId>cn.jpush.api</groupId> <artifactId>jpush-client</artifactId> <version>3.2.17</version> </dependency> <dependency> <groupId>cn.jpush.api</groupId> <artifactId>jiguang-common</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>io.netty</groupId> <artifactId>netty-all</artifactId> <version>4.1.6.Final</version> <scope>compile</scope> </dependency> <dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.3</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.7</version> </dependency>

 

---

記住,如下代碼,若是你是單純的複製粘貼,那麼你確定會報錯,有博主本身項目的參數,因此,請複製粘貼後看一下參數(提示什麼的)

jar包導入完成

而後在項目中建立一個包和一個類,(類放到包下)取名隨便取,畢竟開心最重要 ꉂ ೭(˵¯̴͒ꇴ¯̴͒˵)౨」

好吧推薦取名 :

com.weiwend.jdpush //包名 
jdpush //類名

• 接下來是jdpush類的操做 
  其實,極光已經給咱們集成好了,只需調用推送方法便可

  如今在jdpush類中,先進行android的推送(第一個方法)

• 在jdpush類中,建立一個方法 : jpushAndroid 
  別忘了!!!!!! app_key和masterSecret 是必須的

//極光推送>>Android //Map<String, String> parm是我本身傳過來的參數,同窗們能夠自定義參數 public static void jpushAndroid(Map<String, String> parm) { // 設置好帳號的app_key和masterSecret String appKey = "**************"; String masterSecret = "************"; //建立JPushClient JPushClient jpushClient = new JPushClient(masterSecret, appKey); //推送的關鍵,構造一個payload PushPayload payload = PushPayload.newBuilder() .setPlatform(Platform.android())//指定android平臺的用戶 .setAudience(Audience.all())//你項目中的全部用戶 .setNotification(Notification.android(parm.get("msg"), "這是title", parm)) //發送內容,這裏不要盲目複製粘貼,這裏是我從controller層中拿過來的參數) .setOptions(Options.newBuilder().setApnsProduction(false).build()) //這裏是指定開發環境,不用設置也不要緊 .setMessage(Message.content(parm.get("msg")))//自定義信息 .build(); try { PushResult pu = jpushClient.sendPush(payload); } catch (APIConnectionException e) { e.printStackTrace(); } catch (APIRequestException e) { e.printStackTrace(); } }

而後又在jdpush類中,再進行ios的推送(第二個方法)

• 在jdpush類中,建立一個方法 : jpushIOS 
  又別忘了!!!!!! app_key和masterSecret 是必須的

//極光推送>>ios
   //Map<String, String> parm是我本身傳過來的參數,同窗們能夠自定義參數
   public static  void jpushIOS(Map<String, String> parm) {
       // 設置好帳號的app_key和masterSecret是必須的
       String appKey = "*********************"; String masterSecret = "**********************"; //建立JPushClient JPushClient jpushClient = new JPushClient(masterSecret, appKey); PushPayload payload = PushPayload.newBuilder() .setPlatform(Platform.ios())//ios平臺的用戶 .setAudience(Audience.all())//全部用戶 .setNotification(Notification.newBuilder() .addPlatformNotification(IosNotification.newBuilder() .setAlert(parm.get("msg")) .setBadge(+1) .setSound("happy") .addExtras(parm) .build()) .build()) .setOptions(Options.newBuilder().setApnsProduction(false).build()) .setMessage(Message.newBuilder().setMsgContent(parm.get("msg")).addExtras(parm).build())//自定義信息 .build(); try { PushResult pu = jpushClient.sendPush(payload); } catch (APIConnectionException e) { e.printStackTrace(); } catch (APIRequestException e) { e.printStackTrace(); } }

PS:

• 以上只是列出了2種推送的方法,(通常設置安卓和ios就夠了)還有更多(去看看官網)好比推送winPhone平臺,安卓andIos,所有平臺,等等等等,自定義去組合,反正你寫的方法能夠調用
• 極光已經集成好了衆多方法,同窗們都是能夠點出來的,好比,想設置環境指定爲開發,那麼就在方法裏設置:

.setOptions(Options.newBuilder().setApnsProduction(false).build())

• 若是你還想再設置其餘推送的系統參數,那麼,能夠去參考,裏面有參數講解 
  

  [ 極光文檔Push API v3 ]

我用的是SSM框架,因此我在controller裏面調用我寫的推送方法,其餘框架調用推送方法也同樣

調用簡直不要太簡單

controller:

//這是個人添加文章的接口方法 //如今我要添加一篇文章後,進行推送 public Map<String, Object> addArticle() throws Exception { Map<String, Object> result = new HashMap<String, Object>(); .... //省略文章添加的步驟 //從前端頁面傳個參數過來判斷是否推送 if((infoMap.get("is_push").toString()).trim().equals("1")){ //設置推送參數 //這裏同窗們就能夠自定義推送參數了 Map<String, String> parm =new HashMap<String, String>(); //這是個人文章id parm.put("id",(""+id).trim()); //文章標題 parm.put("Atitle",(String) infoMap.get("Atitle") ); //設置提示信息,內容是文章標題 parm.put("msg",(String) infoMap.get("Atitle") ); //調用ios的 Jdpush.jpushIOS(parm); //而後調用安卓的 Jdpush.jpushAndroid(parm); } return result; }

這樣就推送完了….

---

童鞋們可能出現的的錯誤

• 推送後報錯了

Your request params is invalid. Please check them according to error message. 
Error response from JPush server. Should review and fix it. 
//而後狀態碼是 
INFO 2017-07-14 11:08:04,208 com.weiwend.jdpush.Jdpush.http-bio-8080-exec-7 HTTP Status: 400 
INFO 2017-07-14 11:08:04,208 com.weiwend.jdpush.Jdpush.http-bio-8080-exec-7 Error Code: 1011 
INFO 2017-07-14 11:08:04,208 com.weiwend.jdpush.Jdpush.http-bio-8080-exec-7 Error Message: cannot find user by this audience 
INFO 2017-07-14 11:08:04,208 com.weiwend.jdpush.Jdpush.http-bio-8080-exec-7 Msg ID: 4241206476

• 這種的話不要慌,去看看你的極光開發者服務>>點進去你的應用>>點擊推送>>選擇是web|Api下拉框 
  

應該會看到一條紅色的推送記錄

好比:

——這就是發送失敗了,爲何呢?提示是:

就是說,你當前項目中

沒有用戶!!!

沒有用戶!!!

沒有用戶???

這就很尷尬了 
若是你的項目中有用戶, 
可是,是你的參數(setAudience)設置錯了,也會也會報錯.

---

po一條視頻教程(內容比較簡單,試着去理解):

[ 極客學院>>極光推送javaSDK集成使用 ]

還有要注意的是app_key和masterSecret 是必須的

好惹,講完惹,

最重要的是自學哦

複製粘貼需謹慎

(〜￣▽￣)〜