new README

This commit is contained in:
Daniel Qian 2014-10-22 13:03:19 +08:00
parent a8f5d07ff3
commit f76f0e6773
3 changed files with 34 additions and 103 deletions

34
README.md Normal file
View File

@ -0,0 +1,34 @@
weixin-java-cp
===========
微信公众号、企业号Java SDK。
从``1.0.3``开始本项目拆分成3个部分
1. weixin-java-common公共lib
2. weixin-java-cp企业号SDK
3. weixin-java-mp公众号订阅号、服务号SDK
详细文档请看 [wiki](https://github.com/chanjarster/weixin-java-tools/wiki)
# Quick Start
如果要开发公众号订阅号、服务号应用在你的maven项目中添加
```xml
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-mp</artifactId>
<version>1.0.3</version>
</dependency>
```
如果要开发企业号应用在你的maven项目中添加
```xml
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-cp</artifactId>
<version>1.0.3</version>
</dependency>
```

View File

@ -1,46 +0,0 @@
weixin-java-cp
===========
微信企业号Java SDK开发工具集本项目主要分为两大块微信消息路由器、微信Java API
详细文档请看 [wiki](https://github.com/chanjarster/weixin-java-tools/wiki)
# Quickstart
在你的maven项目中添加
```xml
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-cp-tools</artifactId>
<version>1.0.3</version>
</dependency>
```
如果要使用``*-SNAPSHOT``版,则需要在你的``pom.xml``中添加这段:
```xml
<repositories>
<repository>
<snapshots />
<id>sonatype snapshots</id>
<url>https://oss.sonatype.org/content/repositories/snapshots/</url>
</repository>
</repositories>
```
## Hello World
```java
WxCpInMemoryConfigStorage config = new WxCpInMemoryConfigStorage();
config.getCorpId(...); // 设置微信企业号的appid
config.getCorpSecret(...); // 设置微信企业号的app corpSecret
config.setAgentId(...); // 设置微信企业号应用ID
config.setToken(...); // 设置微信企业号应用的token
config.setAesKey(...); // 设置微信企业号应用的EncodingAESKey
WxCpServiceImpl wxCpService = new WxCpServiceImpl();
wxCpService.setWxCpConfigStorage(config);
String userId = ...;
WxCpMessage message = WxCpMessage.TEXT().agentId(...).toUser(userId).content("Hello World").build();
wxService.messageSend(message);
```

View File

@ -1,57 +0,0 @@
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.2</version>
</dependency>
```
如果要使用``*-SNAPSHOT``版,则需要在你的``pom.xml``中添加这段:
```xml
<repositories>
<repository>
<snapshots />
<id>sonatype snapshots</id>
<url>https://oss.sonatype.org/content/repositories/snapshots/</url>
</repository>
</repositories>
```
## Hello World
```java
WxInMemoryConfigStorage config = new WxInMemoryConfigStorage();
config.setAppId(...); // 设置微信公众号的appid
config.setSecret(...); // 设置微信公众号的app secret
config.setToken(...); // 设置微信公众号的token
config.setAesKey(...); // 设置微信公众号的EncodingAESKey
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);
```