javaPNS 基礎篇

javaPNS 基礎篇
最簡單的javapns推送爲：


 import javapns.Push;     
 public class PushTest {
       public static void main(String[] args) {    
                Push.alert("Hello World!", "keystore.p12", "keystore_password", false, "Your token");
       }
 }
 Push類除了alert方法外，還有
    alert (message, keystore, password, production, devices): push a simple alert message
    badge (badge, keystore, password, production, devices): push a badge number
    sound (sound, keystore, password, production, devices): push a sound name
    combined (message, badge, sound, keystore, password, production, devices): push a alert+badge+sound notification
    contentAvailable (keystore, password, production, devices): notify Apple's Newsstand application
    test (keystore, password, production, devices): push useful debug information
這幾種簡易方法可以調用。而如果你要自定義payload的話，可以使用下面的幾種方法
    payload (payload, keystore, password, production, devices): push a single payload to devices
    payload (payload, keystore, password, production, numberOfThreads, devices): use the built-in multithreaded transmission engine to push a single payload to lots of devices using n threads
    payloads (keystore, password, production, payloadDevicePairs): push payloads to paired devices
    payloads (keystore, password, production, numberOfThreads, payloadDevicePairs): use the built-in multithreaded transmission engine to push payloads to paired devices


下面說明一下push常用方法的幾個參數：
    1 Object keystore:即keystore.p12文件，關於java pns需要的p12文件的製作請自行百度吧
    此object可以是多種子類：
       java.io.File指向p12文件
       java.lang.String 給出p12文件的路徑
       java.io.InputStream
       byte[]  p12的二進制流
       java.security.KeyStore:已經裝載的keystore文件
    2 String password ：建立p12文件時指定的密碼
    3 boolean production：使用sandbox服務器還是production服務器。ture爲production服務器，false爲sandbox服務器
    開發狀態服務器地址 gateway.sandbox.push.apple.com 2195
    產品狀態服務器地址 gateway.push.apple.com         2195


    Development和Production兩個版本對應的apns device token是不同的，前者是develop的mobileprovision下獲取的。後者是production的mobileprovision獲取的。
    Development和Production兩個版本可以共用一個App ID（不推薦。共用時每次調試前都要刪除設備上的app，重新打包生成。而且公用appid會經常抓狂，早上行，下午就不行了。所以不推薦），但是不能共用一個mobileprovision，所以要單獨生成Distribution的證書供production版本使用。
    注：Distribution的版本是無法在設備上debug調試的！
    Development和Production兩個版本的code sign是不同的，前者是iPhone Developer，後者是iPhone Distribution。注意不能搞錯。


    無論是Development Push SSLCertificate還是Production Push SSL Certificate 都有過期時間的。Development Push SSL Certificate有效期大概四個月左右，而ProductionPush SSL Certificate的有效期是一年。需要注意在過期之前生成新的證書，以免影響使用。
    4 Object devices:設備token列表。Apple強烈建議一次連接APNS發送多條通知而不是每建立一次連接發送一條通知。我們可以傳入以下類型的參數
     java.lang.String[]
     java.util.List<String>
     java.lang.String  //只傳入了一個token
     javapns.devices.Device[]
     java.util.List<Device>
     javapns.devices.Device //只傳入了一個Device
     
    5 Object payloadDevicePairs  一個payloads和tokens名值對的列表，可以傳入下面的參數:
        javapns.notification.PayloadPerDevice[]: an array of PayloadPerDevice objects
        java.util.List<PayloadPerDevice>: a list of PayloadPerDevice objects
        javapns.notification.PayloadPerDevice: a single PayloadPerDevice object
     
當向APNS發送通知後，APNS會返回發送的結果，結果可能會很複雜，幸好javaPNS都爲我們做了處理 ， Push類的大多數方法會返回一系列的PushedNotification對象，該對象封裝了APNS返回的信息，如是否成功，失敗原因等
關於具體的返回信息以及對於返回信息的處理，請看 《 javaPNS處理APNS返回結果》一文