WeixinJavaTools

WxJava（原weixin-java-tools）微信Java开发工具包（SDK）

---

支持包括微信支付、开放平台、公众号（包括订阅号和服务号）、企业微信/企业号、小程序等微信功能的后端开发。

---

重要信息

1. 2018-12-23 项目更名为WxJava，并发布 【3.3.0正式版】！
2. 新手重要提示：本项目仅是一个SDK开发工具包，未提供Web实现，建议使用maven或gradle引用本项目即可使用本SDK提供的各种功能，详情可参考 【Demo项目】 或本项目中的部分单元测试代码；另外微信开发新手请务必阅读【开发文档 Wiki 首页】的常见问题部分，可以少走很多弯路，节省不少时间。

---

技术交流方式

1. QQ群：（注意：目前为付费群，刚入群会有5分钟禁言，稍等片刻即可正常发言） 或 ，推荐点击按钮入群，当然如果无法成功操作，请自行搜索群号343954419进行添加；由于群容量有限，为了维持运营千人QQ群的所需支付的QQ年费会员费用，故开启付费入群模式，申请者只需支付少量金额即可加入，这样也可以保证只有真实交流需求的人进入，避免闲杂做广告人员的乱入；当然如果确实因为各种原因无法付费入群的，请联系群主说明原因即可入群；
2. 微信群： 请关注公众号后点击相关菜单入群；
3. 钉钉企业群：请点击链接申请加入 或者 用手机钉钉APP扫码 申请加入。
4. 新手提问前，请先阅读【提问的智慧】，并确保已查阅过 【开发文档Wiki】；
5. 寻求帮助时需贴代码或大长串异常信息的，请利用http://paste.ubuntu.com
6. 另外，想要得到更多开发交流讨论方式，请扫描以下二维码，关注微信公众号【WxJava】，或者加入企业微信，当然也可以在微信中搜索 weixin-java-tools或 WxJava 关注公众号，公众号会及时通知SDK相关更新信息，并不定期分享微信Java开发相关技术知识。

---

其他说明

1. 本项目Fork自chanjarster/weixin-java-tools，但由于原项目已停止维护，故单独维护和发布，且发布到maven上的groupId也会不同，详细信息见下文。
2. 开源中国本项目的首页，欢迎大家积极留言评分 🙂
3. SDK详细开发文档请查阅 【开发文档Wiki】，部分文档可能未能及时更新，如有发现，可以及时上报或者自行修改。
4. 阅读源码的同学请注意，本SDK为简化代码编译时加入了lombok支持，如果不了解lombok的话，请先学习下相关知识，比如可以阅读此文章；
5. 如有新功能需求，发现BUG，或者由于微信官方接口调整导致的代码问题，可以直接在【Issues】页提出issue，便于讨论追踪问题；
6. 如果想贡献代码，请阅读【代码贡献指南】；
7. 如果本SDK对您有所帮助，欢迎对我们的努力进行肯定，可以扫描【支付宝付款码】或者【微信支付二维码】进行打赏，或者直接前往【托管于码云的项目首页】，在评论区上方可以找到“捐助”按钮。非常感谢各位打赏和捐助的同学！
8. 各个模块的Javadoc可以在线查看：weixin-java-miniapp、weixin-java-pay、weixin-java-mp、weixin-java-common、weixin-java-cp、weixin-java-open
9. 本SDK要求的最低JDK版本是1.7，还在使用JDK6的用户请参考【此项目】 ，而其他更早的JDK版本则需要自己改造实现。
10. 本SDK项目在以下代码托管网站同步更新:
11. 码云：https://gitee.com/binary/weixin-java-tools
12. GitHub：https://github.com/wechat-group/WxJava

---

SDK使用方式

注意：最新版本（包括测试版）为 ，以下为最新正式版。

<dependency>
  <groupId>com.github.binarywang</groupId>
  <artifactId>（不同模块参考下文）</artifactId>
  <version>3.2.0</version>
</dependency>

• 各模块的artifactId：
  • 微信小程序：weixin-java-miniapp
    
  • 微信支付：weixin-java-pay
  • 微信开放平台：weixin-java-open
    
  • 公众号（包括订阅号和服务号）：weixin-java-mp
    
  • 企业号/企业微信：weixin-java-cp

---

版本说明

1. 本项目定为大约每两个月发布一次正式版，版本号格式为X.X.0（如2.1.0，2.2.0等），遇到重大问题需修复会及时提交新版本，欢迎大家随时提交Pull Request；
2. BUG修复和新特性一般会先发布成小版本作为临时测试版本（如3.1.8.B，即尾号不为0，并添加B，以区别于正式版）；
3. 目前最新版本号为 ，也可以通过访问链接 【微信支付】 、【微信小程序】 、【公众号】 、【企业微信】、【开放平台】 分别查看所有最新的版本。

---

使用案例

1. 开源项目：https://github.com/workcheng/weiya
2. 开源项目：https://github.com/jmdhappy/xxpay-master
3. 微信点餐系统开源项目：http://www.sqmax.top/springboot-project/
4. 小程序：喵星人贴吧助手(扫码关注)
5. 小程序：树懒揽书+
6. 小程序：广廉快线，鹏城巴士等
7. 小程序：360考试宝典
8. 平台：小猪餐餐
9. 平台：餐饮系统
10. 公众号：中国电信上海网厅（sh_189）
11. 公众号：E答平台
12. 公众号：全民约跑健身便利店
13. 公众号：洽洽食品、洽洽合伙人
14. 公众号和小程序：民医台（可自行搜索）
15. 洽洽企业号
16. 高善人力资源
17. 其他更多案例请【访问这里】，持续更新中。

---

贡献者列表

特别感谢以下参与贡献的所有同学！

1. chanjarster (Daniel Qian)
2. binarywang (Binary Wang)
3. mgcnrx11
4. 007gzs
5. aimilin6688 (Jonk)
6. kakotor
7. kareanyi (MillerLin)
8. rememberber (周波)
9. tianmu
10. charmingoh (Charming)
11. ukid
12. forfuns (爱因斯唐)
13. zxkane (Meng Xin Zhu)
14. crskyp (我是木予)
15. yuanqixun (yuanqixun)
16. gaigeshen (gaigeshen)
17. dylanleung (dylanleung)
18. huansinho
19. codepiano (codepiano)
20. stvliu (Steven Liu)
21. ajffdnt
22. fxdfxq (fxdfxq)
23. unlimitedsola (Sola)
24. DDLeEHi
25. Hyseen
26. nickwongwong (Nick Wong)
27. jink2005 (Jink2005)
28. withinthefog (withinthefog)
29. iwareserictsai (Eric.Tsai)
30. lwxian
31. xusheng1987 (flying)
32. ZhaoxiongTan (xiong)
33. SimonDolph (Simon Dolph)
34. axeon
35. TonyLuo (Tony)
36. dwandw (dwandw)
37. alanchenup (alanchen)
38. zexpp5 (Lance7in)
39. xiaohulu (huluwa)
40. aalx (devina)
41. rtsbtx (强哥)
42. dracupid (Jingchen Zhao)
43. lijunkun1988
44. lly835
45. mog0202 (蘑菇0202)
46. bobbyguo (bobby_guo)
47. huotaihe (白马度和)
48. dxwts (xuewu)
49. aliangsoft (阿亮软件)
50. Mkluas (Mklaus)
51. CodeIdeal (康阳)
52. leeis (IOMan)
53. lichenliang666 (李晨亮)
54. 627535195
55. ztmark (Mark)
56. gtyang
57. scott-z (scott)
58. borisbao (Boris)
59. qsjia (QSJia)
60. webcreazy (webcreazy)
61. cwivan (鱼丸Cwivan)
62. howardliu-cn (看山)