Merge pull request binarywang#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;
+ }
 }