weixin-java-tools/README.md
2014-10-15 10:14:00 +08:00

45 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

weixin-java-tools
===========
微信java开发工具集本项目主要分为两大块微信消息路由器、微信Java API
特性列表:
1. 不基于Servlet、和其他MVC框架仅作为工具使用提供更多的灵活性
2. 详尽的单元测试代码可以拿来当example用
3. 详尽的javadoc
4. access token过期自动刷新的功能
5. 微信服务端繁忙自动重试的功能
6. 提供微信错误信息的异常处理机制
详细文档请看 [wiki](https://github.com/chanjarster/weixin-java-tools/wiki)
# Quickstart
在你的maven项目中添加
```xml
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-tools</artifactId>
<version>1.0.0</version>
</dependency>
```
## Hello World
```java
WxConfigStorage config = new WxInMemoryConfigStorage();
config.setAppId(...); // 设置微信公众号的appid
config.setSecret(...); // 设置微信公众号的app secret
config.setToken(...); // 设置微信公众号的token
WxServiceImpl wxService = new WxServiceImpl();
wxService.setWxConfigStorage(config);
// 用户的openid在下面地址获得
// https://mp.weixin.qq.com/debug/cgi-bin/apiinfo?t=index&type=用户管理&form=获取关注者列表接口%20/user/get
String openid = ...;
WxCustomMessage message = WxCustomMessage.TEXT().toUser(openid).content("Hello World").build();
wxService.customMessageSend(message);
```