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返回结果》一文