微信消息路由器，及单元测试代码

README.md

@@ -1,7 +1,48 @@
-weixin-java
+weixin-tools
 ===========
 
-微信java开发工具集
+微信java开发工具，本项目提供了两个主要特性：微信消息路由器、微信Java API
 
-## 执行测试
-将 ''src/test/resources/test-config.sample.xml'' 改成 ''test-config.xml'' 并设置appId, secret, 一个过期的accessToken
+## 微信消息路由器
+
+你可以使用``WxMessageRouter``来对微信推送过来的消息、事件进行路由，交给特定的``WxMessageHandler``处理。
+
+使用方法：
+
+```java
+WxMessageRouter router = new WxMessageRouter();
+router
+  .rule()
+      .msgType("MSG_TYPE").event("EVENT").eventKey("EVENT_KEY").content("CONTENT")
+      .interceptor(interceptor, ...).handler(handler, ...)
+  .end()
+  .rule()
+      // 另外一个匹配规则
+  .end()
+;
+
+// 将WxXmlMessage交给消息路由器
+router.route(message);
+```
+
+说明：
+1. 配置路由规则时要按照从细到粗的原则，否则可能消息可能会被提前处理
+2. 默认情况下消息只会被处理一次，除非使用 {@link Rule#next()}
+3. 规则的结束必须用{@link Rule#end()}或者{@link Rule#next()}，否则不会生效
+
+## 微信Java API
+
+使用``WxService``可以调用微信API。目前实现了以下功能，其余功能以后陆续补充：
+
+1. 发送客服消息
+1. 创建自定义菜单
+1. 删除自定义菜单
+1. 查询自定义菜单
+1. 刷新access_token
+
+## 如何执行单元测试
+将 ``src/test/resources/test-config.sample.xml`` 改成 ``test-config.xml`` 设置appId, secret, accessToken(可选), openId
+
+```bash
+mvn clean test
+```