Merge pull request #184 from Wechat-Group/develop

合并Develop，准备发布2.6.0版本

Author: binarywang

build.gradle

@@ -2,7 +2,7 @@ allprojects  {
   apply plugin: 'maven'
 
   group = 'com.github.binarywang'
-  version = '2.5.0'
+  version = '2.6.0'
 }
 
 subprojects {
@@ -27,7 +27,6 @@ subprojects {
     compile group: 'commons-codec', name: 'commons-codec', version:'1.10'
     compile group: 'commons-io', name: 'commons-io', version:'2.5'
     compile group: 'org.apache.commons', name: 'commons-lang3', version:'3.4'
-    compile group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version:'2.8.0'
     compile group: 'redis.clients', name: 'jedis', version:'2.9.0'
     testCompile group: 'ch.qos.logback', name: 'logback-classic', version:'1.1.2'
   }

CONTRIBUTION.md renamed to contribution.md

@@ -5,7 +5,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.github.binarywang</groupId>
   <artifactId>weixin-java-parent</artifactId>
-  <version>2.5.0</version>
+  <version>2.6.0</version>
   <packaging>pom</packaging>
   <name>WeiXin Java Tools - Parent</name>
   <description>微信公众号、企业号上级POM</description>
@@ -86,7 +86,8 @@
     <module>weixin-java-common</module>
     <module>weixin-java-cp</module>
     <module>weixin-java-mp</module>
-    <module>weixin-java-osgi</module>
+    <module>weixin-java-pay</module>
+    <!--module>weixin-java-osgi</module-->
   </modules>
 
   <properties>
@@ -105,6 +106,7 @@
     <commons-io.version>2.5</commons-io.version>
     <commons-codec.version>1.10</commons-codec.version>
     <jetty.version>9.3.0.RC0</jetty.version>
+    <jedis.version>2.9.0</jedis.version>
   </properties>
 
   <dependencies>
@@ -113,6 +115,11 @@
       <artifactId>slf4j-api</artifactId>
       <version>${slf4j.version}</version>
     </dependency>
+    <dependency>
+      <groupId>com.thoughtworks.xstream</groupId>
+      <artifactId>xstream</artifactId>
+      <version>1.4.9</version>
+    </dependency>
     <dependency>
       <groupId>ch.qos.logback</groupId>
       <artifactId>logback-classic</artifactId>
@@ -152,17 +159,12 @@
     <dependency>
       <groupId>com.google.guava</groupId>
       <artifactId>guava</artifactId>
+      <version>${guava.version}</version>
     </dependency>
   </dependencies>
 
   <dependencyManagement>
     <dependencies>
-      <dependency>
-        <groupId>junit</groupId>
-        <artifactId>junit</artifactId>
-        <version>4.11</version>
-        <scope>test</scope>
-      </dependency>
       <dependency>
         <groupId>com.google.inject</groupId>
         <artifactId>guice</artifactId>
@@ -194,9 +196,9 @@
         <scope>test</scope>
       </dependency>
       <dependency>
-        <groupId>com.google.guava</groupId>
-        <artifactId>guava</artifactId>
-        <version>${guava.version}</version>
+        <groupId>redis.clients</groupId>
+        <artifactId>jedis</artifactId>
+        <version>${jedis.version}</version>
       </dependency>
     </dependencies>
   </dependencyManagement>

pom.xml

@@ -6,14 +6,15 @@
 ### 注意事项：
 1. 声明： ***本项目Fork自chanjarster/weixin-java-tools，但由于原项目已停止维护，故单独维护和发布，且发布到maven上的groupId也会不同，详细信息见下文。***
 1. **新手请注意，本项目仅是一个开发工具包（即SDK），未提供Web实现，建议使用maven或gradle引用本项目即可使用本SDK提供的各种功能，详情可参考下文中提到的Demo项目或本项目中的部分单元测试代码；如果没有贡献代码的意愿，不建议下载项目的源码自行编译，因为如果想看源码使用maven也是可以下载源码的**；
-1. 最新更新：**2017-2-12 发布[【2.5.0正式版】](https://github.com/Wechat-Group/weixin-java-tools/releases)**！
+1. 最新更新：**2017-4-13 发布[【2.6.0正式版】](https://github.com/Wechat-Group/weixin-java-tools/releases)**！
 1. 开源中国网站的本项目介绍的首页链接地址：https://www.oschina.net/p/weixin-java-tools-new
 1. 自2.0.0版本以来，公众号的接口调整比较大，主要是为了解决主接口类过于庞大不方便管理的问题，将接口实现代码按模块进行拆分。
+1. 自2.6.0版本开始，微信支付相关功能抽出独立为一个模块，详细使用方式请参考相关demo；
 1. SDK详细开发文档请查阅 [【Wiki】](https://github.com/wechat-group/weixin-java-tools/wiki)，部分文档可能未能及时更新，如有发现，可以及时上报或者自行修改。***另外微信开发新手请务必阅读wiki首页的常见问题部分，可以少走很多弯路，节省不少时间。***
 1. 各个模块的Javadoc可以在线查看（有可能是最新的测试版本的，请注意观察版本号）：[weixin-java-pay](https://binarywang.github.io/weixin-java-pay-javadoc/)、[weixin-java-mp](https://binarywang.github.io/weixin-java-mp-javadoc/)、[weixin-java-common](https://binarywang.github.io/weixin-java-common-javadoc/)、[weixin-java-cp](https://binarywang.github.io/weixin-java-cp-javadoc/)
 1. 本SDK要求的最低JDK版本是7，还在使用JDK6的用户请参考[【此项目】]( https://github.com/binarywang/weixin-java-tools-for-jdk6) ，而其他更早的JDK版本则需要自己改造实现。
 1. 如有新功能需求，发现BUG，或者由于微信官方接口调整导致的代码问题，可以直接在[【Issues】](https://github.com/Wechat-Group/weixin-java-tools/issues)页提出issue，便于讨论追踪问题；
-1. 如果想贡献代码，请阅读[【代码贡献指南】](CONTRIBUTION.md)；
+1. 如果想贡献代码，请阅读[【代码贡献指南】](contribution.md)；
 1. 捐助渠道已开通，如有意向请前往托管于码云的项目首页（具体地址见下文）的页面评论区上方，可以找到“捐助”按钮，非常感谢各位捐助的同学！
 
 ---------------------------------
@@ -58,12 +59,12 @@ maven：
 <dependency>
   <groupId>com.github.binarywang</groupId>
   <artifactId>weixin-java-pay</artifactId>
-  <version>2.5.7.BETA</version>
+  <version>2.6.0</version>
 </dependency>
 ```
 gradle：
 ```groovy
-compile 'com.github.binarywang:weixin-java-pay:2.5.7.BETA'
+compile 'com.github.binarywang:weixin-java-pay:2.6.0'
 ```
 
 * 公众号（订阅号及服务号）：
@@ -73,12 +74,12 @@ maven：
 <dependency>
   <groupId>com.github.binarywang</groupId>
   <artifactId>weixin-java-mp</artifactId>
-  <version>2.5.0</version>
+  <version>2.6.0</version>
 </dependency>
 ```
 gradle：
 ```groovy
-compile 'com.github.binarywang:weixin-java-mp:2.5.0'
+compile 'com.github.binarywang:weixin-java-mp:2.6.0'
 ```
 
 * 企业号：
@@ -88,10 +89,10 @@ maven：
 <dependency>
   <groupId>com.github.binarywang</groupId>
   <artifactId>weixin-java-cp</artifactId>
-  <version>2.5.0</version>
+  <version>2.6.0</version>
 </dependency>
 ```
 gradle：
 ```groovy
-compile 'com.github.binarywang:weixin-java-cp:2.5.0'
+compile 'com.github.binarywang:weixin-java-cp:2.6.0'
 ```

readme.md

@@ -6,24 +6,14 @@
   <parent>
     <groupId>com.github.binarywang</groupId>
     <artifactId>weixin-java-parent</artifactId>
-    <version>2.5.0</version>
+    <version>2.6.0</version>
   </parent>
 
   <artifactId>weixin-java-common</artifactId>
   <name>WeiXin Java Tools - Common</name>
   <description>微信公众号、企业号Java SDK Common</description>
 
   <dependencies>
-    <dependency>
-      <groupId>com.thoughtworks.xstream</groupId>
-      <artifactId>xstream</artifactId>
-      <version>1.4.7</version>
-    </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <scope>test</scope>
-    </dependency>
     <dependency>
       <groupId>org.testng</groupId>
       <artifactId>testng</artifactId>

weixin-java-common/pom.xml

@@ -55,15 +55,15 @@ public class WxConsts {
   ///////////////////////
   public static final String MASS_ST_SUCCESS = "send success";
   public static final String MASS_ST_FAIL = "send fail";
-  public static final String MASS_ST_涉嫌广告 = "err(10001)";
-  public static final String MASS_ST_涉嫌政治 = "err(20001)";
-  public static final String MASS_ST_涉嫌社会 = "err(20004)";
-  public static final String MASS_ST_涉嫌色情 = "err(20002)";
-  public static final String MASS_ST_涉嫌违法犯罪 = "err(20006)";
-  public static final String MASS_ST_涉嫌欺诈 = "err(20008)";
-  public static final String MASS_ST_涉嫌版权 = "err(20013)";
-  public static final String MASS_ST_涉嫌互推_互相宣传 = "err(22000)";
-  public static final String MASS_ST_涉嫌其他 = "err(21000)";
+  public static final String MASS_ST_10001 = "err(10001)";
+  public static final String MASS_ST_20001 = "err(20001)";
+  public static final String MASS_ST_20004 = "err(20004)";
+  public static final String MASS_ST_20002 = "err(20002)";
+  public static final String MASS_ST_20006 = "err(20006)";
+  public static final String MASS_ST_20008 = "err(20008)";
+  public static final String MASS_ST_20013 = "err(20013)";
+  public static final String MASS_ST_22000 = "err(22000)";
+  public static final String MASS_ST_21000 = "err(21000)";
 
   /**
    * 群发反馈消息代码所对应的文字描述
@@ -101,6 +101,7 @@ public class WxConsts {
   public static final String EVT_KF_CLOSE_SESSION = "kf_close_session"; // 客服关闭会话
   public static final String EVT_KF_SWITCH_SESSION = "kf_switch_session"; // 客服转接会话
   public static final String EVT_POI_CHECK_NOTIFY = "poi_check_notify"; //门店审核事件推送
+  public static final String EVN_SUBMIT_MEMBERCARD_USER_INFO = "submit_membercard_user_info"; //接收会员信息事件推送
   //以下为微信认证事件
   /**
    * 资质认证成功
@@ -135,26 +136,23 @@ public class WxConsts {
   public static final String MEDIA_VIDEO = "video";
   public static final String MEDIA_THUMB = "thumb";
   public static final String MEDIA_FILE = "file";
+
+
   ///////////////////////
-  // 文件类型
+  // 自定义菜单的按钮类型
   ///////////////////////
-  public static final String FILE_JPG = "jpeg";
-  public static final String FILE_MP3 = "mp3";
-  public static final String FILE_AMR = "amr";
-  public static final String FILE_MP4 = "mp4";
   /**
    * 点击推事件
    */
   public static final String BUTTON_CLICK = "click";
-
-
-  ///////////////////////
-  // 自定义菜单的按钮类型
-  ///////////////////////
   /**
    * 跳转URL
    */
   public static final String BUTTON_VIEW = "view";
+  /**
+   * 跳转到小程序
+   */
+  public static final String BUTTON_MINIPROGRAM = "miniprogram";
   /**
    * 扫码推事件
    */
@@ -187,6 +185,7 @@ public class WxConsts {
    * 跳转图文消息URL
    */
   public static final String BUTTON_VIEW_LIMITED = "view_limited";
+  
   /**
    * 不弹出授权页面，直接跳转，只能获取用户openid
    */
@@ -216,14 +215,14 @@ public class WxConsts {
   static {
     MASS_ST_2_DESC.put(MASS_ST_SUCCESS, "发送成功");
     MASS_ST_2_DESC.put(MASS_ST_FAIL, "发送失败");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌广告, "涉嫌广告");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌政治, "涉嫌政治");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌社会, "涉嫌社会");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌色情, "涉嫌色情");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌违法犯罪, "涉嫌违法犯罪");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌欺诈, "涉嫌欺诈");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌版权, "涉嫌版权");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌互推_互相宣传, "涉嫌互推_互相宣传");
-    MASS_ST_2_DESC.put(MASS_ST_涉嫌其他, "涉嫌其他");
+    MASS_ST_2_DESC.put(MASS_ST_10001, "涉嫌广告");
+    MASS_ST_2_DESC.put(MASS_ST_20001, "涉嫌政治");
+    MASS_ST_2_DESC.put(MASS_ST_20004, "涉嫌社会");
+    MASS_ST_2_DESC.put(MASS_ST_20002, "涉嫌色情");
+    MASS_ST_2_DESC.put(MASS_ST_20006, "涉嫌违法犯罪");
+    MASS_ST_2_DESC.put(MASS_ST_20008, "涉嫌欺诈");
+    MASS_ST_2_DESC.put(MASS_ST_20013, "涉嫌版权");
+    MASS_ST_2_DESC.put(MASS_ST_22000, "涉嫌互推_互相宣传");
+    MASS_ST_2_DESC.put(MASS_ST_21000, "涉嫌其他");
   }
 }

weixin-java-common/src/main/java/me/chanjar/weixin/common/api/WxConsts.java

@@ -1,5 +1,6 @@
 package me.chanjar.weixin.common.bean.menu;
 
+import com.google.gson.annotations.SerializedName;
 import me.chanjar.weixin.common.util.ToStringUtils;
 
 import java.io.Serializable;
@@ -9,12 +10,65 @@
 public class WxMenuButton implements Serializable {
   private static final long serialVersionUID = -1070939403109776555L;
 
+  /**
+   * <pre>
+   * 菜单的响应动作类型：
+   * view表示网页类型，
+   * click表示点击类型，
+   * miniprogram表示小程序类型
+   * </pre>
+   */
   private String type;
+
+  /**
+   * 菜单标题，不超过16个字节，子菜单不超过60个字节
+   */
   private String name;
+
+  /**
+   * <pre>
+   * 菜单KEY值，用于消息接口推送，不超过128字节
+   * click等点击类型必须
+   * </pre>
+   */
   private String key;
+
+  /**
+   * <pre>
+   * 网页链接，用户点击菜单可打开链接，不超过1024字节。type为miniprogram时，不支持小程序的老版本客户端将打开本url。
+   * view、miniprogram类型必须
+   * </pre>
+   */
   private String url;
+
+  /**
+   * <pre>
+   * 调用新增永久素材接口返回的合法media_id
+   * media_id类型和view_limited类型必须
+   * </pre>
+   */
+  @SerializedName("media_id")
   private String mediaId;
 
+  /**
+   * <pre>
+   * 小程序的appid
+   * miniprogram类型必须
+   * </pre>
+   */
+  @SerializedName("appid")
+  private String appId;
+
+  /**
+   * <pre>
+   * 小程序的页面路径
+   * miniprogram类型必须
+   * </pre>
+   */
+  @SerializedName("pagepath")
+  private String pagePath;
+
+  @SerializedName("sub_button")
   private List<WxMenuButton> subButtons = new ArrayList<>();
 
   @Override
@@ -69,4 +123,20 @@ public String getMediaId() {
   public void setMediaId(String mediaId) {
     this.mediaId = mediaId;
   }
+
+  public String getAppId() {
+    return appId;
+  }
+
+  public void setAppId(String appId) {
+    this.appId = appId;
+  }
+
+  public String getPagePath() {
+    return pagePath;
+  }
+
+  public void setPagePath(String pagePath) {
+    this.pagePath = pagePath;
+  }
 }