Add more example code in README.md;

Add shortcut methods for Platform.

Author: Javen

README.md

@@ -5,6 +5,8 @@
 
 对应的 REST API 文档：<http://docs.jpush.cn/display/dev/REST+API>
 
+API Javadoc：[API Docs](http://jpush.github.io/jpush-api-java-client/apidocs/)
+
 ## 安装
 
 ### maven 方式（3.0.0 版本 maven 库里还没有，请直接用 jar 的方式）
@@ -22,8 +24,9 @@
 请到 [Release页面](https://github.com/jpush/jpush-api-java-client/releases)下载相应版本的发布包。
 
 ### 依赖包
-* gson
-* slf4j
+* slf4j/log4j (Log)
+* gson (Google)
+* guava (Google)
 
 > 其中 slf4j 可以与 logback, log4j, commons-logging 等日志框架一起工作，可根据你的需要配置使用。
 
@@ -80,14 +83,14 @@ maven package
 ```
 
 ## 使用样例
-下边是简单直接的使用样例。
-详细地了解请参考：[API Docs](http://jpush.github.io/jpush-api-java-client/apidocs/)。
 
 ### 推送样例
 
+> 以下片断来自项目代码里的文件：cn.jpush.api.examples.PushExample
+
 ```
         JPushClient jpushClient = new JPushClient(masterSecret, appKey);
-        PushPayload payload = PushPayload.alertAll("Hi, JPush!");
+        PushPayload payload = buildPushObject_all_all_alert();
         LOG.info("Paylaod JSON - " + payload.toString());
 
         PushResult result = jpushClient.sendPush(payload);
@@ -103,8 +106,79 @@ maven package
 
 ```
 
+进行推送的关键在于构建一个 PushPayload 对象。对下示例一般的构建对象的用法。
+
+* 快捷地构建推送对象：所有平台，所有设备，内容为 ALERT 的通知。
+```
+	public static PushPayload buildPushObject_all_all_alert() {
+	    return PushPayload.alertAll(ALERT);
+	}
+```
+
+* 构建推送对象：所有平台，推送目标是别名为 "alias1"，通知内容为 ALERT。
+```
+    public static PushPayload buildPushObject_all_alias_alert() {
+        return PushPayload.newBuilder()
+                .setPlatform(Platform.all())
+                .setAudience(Audience.alias("alias1"))
+                .setNotification(Notification.alert(ALERT))
+                .build();
+    }
+```
+
+* 构建推送对象：平台是 Android，目标是 tag 为 "tag1" 的设备，内容是 Android 通知 ALERT，并且标题为 TITLE。
+```
+    public static PushPayload buildPushObject_android_tag_alertWithTitle() {
+        return PushPayload.newBuilder()
+                .setPlatform(Platform.android())
+                .setAudience(Audience.tag("tag1"))
+                .setNotification(Notification.newBuilder()
+                        .addPlatformNotification(AndroidNotification.newBuilder()
+                                .setAlert(ALERT)
+                                .setTitle(TITLE)
+                                .build())
+                        .build())
+                .build();
+    }
+```
+
+* 构建推送对象：平台是 iOS，推送目标是 "tag1", "tag_all" 的并集，推送内容同时包括通知与消息 - 通知信息是 ALERT，并且附加字段 from = "JPush"；消息内容是 MSG_CONTENT。通知是 APNs 推送通道的，消息是 JPush 应用内消息通道的。
+```
+    public static PushPayload buildPushObject_ios_tagAnd_alertWithExtras() {
+        return PushPayload.newBuilder()
+                .setPlatform(Platform.ios())
+                .setAudience(Audience.tag_and("tag1", "tag_all"))
+                .setNotification(Notification.newBuilder()
+                        .addPlatformNotification(IosNotification.newBuilder()
+                                .setAlert(ALERT)
+                                .addExtra("from", "JPush")
+                                .build())
+                        .build())
+                 .build();
+    }
+```
+
+* 构建推送对象：平台是 Andorid 与 iOS，推送目标是 （"tag1" 与 "tag2" 的交集）并（"alias1" 与 "alias2" 的交集），推送内容是 - 内容为 MSG_CONTENT 的消息，并且附加字段 from = JPush。
+```
+    public static PushPayload buildPushObject_ios_audienceMore_message() {
+        return PushPayload.newBuilder()
+                .setPlatform(Platform.android_ios())
+                .setAudience(Audience.newBuilder()
+                        .addAudienceTarget(AudienceTarget.tag("tag1", "tag2"))
+                        .addAudienceTarget(AudienceTarget.alias("alias1", "alias2"))
+                        .build())
+                .setMessage(Message.newBuilder()
+                        .setMsgContent(MSG_CONTENT)
+                        .addExtra("from", "JPush")
+                        .build())
+                .build();
+    }
+```
+
 ### 统计获取样例
 
+> 以下片断来自项目代码里的文件：cn.jpush.api.examples.ReportsExample
+
 ```
 JPushClient jpushClient = new JPushClient(masterSecret, appKey);
 ReceivedsResult receivedsResult = jpushClient.getReportReceiveds("1708010723,1774452771");

src/cn/jpush/api/examples/PushExample.java

@@ -86,12 +86,13 @@ public static PushPayload buildPushObject_ios_tagAnd_alertWithExtras() {
                                 .addExtra("news_id", 333)
                                 .build())
                         .build())
+                 .setMessage(Message.content(MSG_CONTENT))
                  .build();
     }
 
     public static PushPayload buildPushObject_ios_audienceMore_message() {
         return PushPayload.newBuilder()
-                .setPlatform(Platform.ios())
+                .setPlatform(Platform.android_ios())
                 .setAudience(Audience.newBuilder()
                         .addAudienceTarget(AudienceTarget.tag("tag1", "tag2"))
                         .addAudienceTarget(AudienceTarget.alias("alias1", "alias2"))

src/cn/jpush/api/push/model/Platform.java

@@ -39,6 +39,27 @@ public static Platform winphone() {
         return newBuilder().addDeviceType(DeviceType.WinPhone).build();
     }
 
+    public static Platform android_ios() {
+        return newBuilder()
+                .addDeviceType(DeviceType.Android)
+                .addDeviceType(DeviceType.IOS)
+                .build();
+    }
+    
+    public static Platform android_winphone() {
+        return newBuilder()
+                .addDeviceType(DeviceType.Android)
+                .addDeviceType(DeviceType.WinPhone)
+                .build();
+    }
+    
+    public static Platform ios_winphone() {
+        return newBuilder()
+                .addDeviceType(DeviceType.IOS)
+                .addDeviceType(DeviceType.WinPhone)
+                .build();
+    }
+    
     public boolean isAll() {
         return all;
     }