2014-11-06 10:48:20 +08:00

2.4 KiB

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-apiweixin-mp-server两个工程

    • 加入支付模块