weixin4j-mp-api

微信公众平台开发工具包

功能列表

MediaApi 上传/下载媒体文件API
NotifyApi 客服消息API
MassApi 群发消息API
UserApi 用户管理API
GroupApi 分组管理API
MenuApi 底部菜单API
QrApi 二维码API
TmplApi 模板消息API
HelperApi 辅助API
PayApi 支付API

如何使用

1.API工程可以单独打包到其他项目中使用,需新增或拷贝weixin.properties文件到项目的classpath中

weixin.properties说明

属性名	说明
account	微信公众号信息 `json格式`
token_path	使用FileTokenHolder时token保存的物理路径
qr_path	调用二维码接口时保存二维码图片的物理路径
media_path	调用媒体接口时保存媒体文件的物理路径
bill_path	调用支付(`V3`)下载对账单接口保存excel文件的物理路径

示例(properties中换行用右斜杆)

account={"appId":"appId","appSecret":"appSecret", "token":"开放者的token 非必须","openId":"公众号的openid 非必须", "mchId":"V3.x版本下的微信商户号", "partnerId":"财付通的商户号","partnerKey":"财付通商户权限密钥Key", "paySignKey":"微信支付中调用API的密钥"}
token_path=/tmp/weixin/token
qr_path=/tmp/weixin/qr
media_path=/tmp/weixin/media
bill_path=/tmp/weixin/bill

2.实例化一个WeixinProxy对象,调用API.

WeixinProxy weixinProxy = new WeixinProxy();
// weixinProxy = new WeixinProxy(appid,appsecret);
weixinProxy.getUser(openId);

3.针对token存储有两种方案,File存储/Redis存储,当然也可自己实现TokenHolder(继承AbstractTokenHolder并重写getToken方法),默认使用文件(xml)的方式保存token,如果环境中支持redis,建议使用RedisTokenHolder.

WeixinProxy weixinProxy = new WeixinProxy(new RedisTokenHolder());
// weixinProxy = new WeixinProxy(new RedisTokenHolder(appid,appsecret));

4.mvn package.

更新LOG

2014-10-27
- 用netty构建http服务器&消息分发
2014-10-28
- 调整ActionMapping抽象化
2014-10-31
- weixin.properties切分为API调用地址和公众号appid等信息两部分
2014-11-03
- 分离为weixin-mp-api和weixin-mp-server两个工程
- 加入支付模块