weixin4j/weixin4j-qy/README.md
2014-11-26 11:33:44 +08:00

2.6 KiB

weixin4j-qy

微信企业号开发工具包

功能列表

  • weixin4j-qy-api

    • DepartApi 部门管理API

    • UserApi 成员管理API

    • TagApi 标签管理API

    • MediaApi 多媒体管理API

    • MenuApi 菜单管理API

    • NotifyApi 消息发送API

  • weixin4j-qy-server

    • netty服务器 & 消息分发

    • 回调连接AES加密、解密

项目说明

1.weixin4j-qy包含「微信企业号」的API封装以及一个半成品的netty服务实现.

2.API的成功调用依赖于正确的appid等数据,创建(或者copy项目里面的)一个名为weixin.properties的资源文件放在自己工程中的classpath下.

属性名 说明
account 微信企业号信息 json格式
token_path 使用FileTokenHolder时token保存的物理路径
media_path 调用媒体接口时保存媒体文件的物理路径

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

account={"id":"corpid","secret":"corpsecret",\
	"token":"企业号中应用在回调模式下的token",\
	"encodingAesKey":"企业号中应用在回调模式下AES加密密钥"}

token_path=/tmp/weixin/token
media_path=/tmp/weixin/media

3.在项目根目录执行mvn package命令后得到jar包,将weixin4j-qy-api-full包或者weixin4j-baseweixin4j-qy-api两个包引入到自己的工程内.

WeixinProxy weixinProxy = new WeixinProxy();
// weixinProxy = new WeixinProxy(corpid,corpsecret);
// weixinProxy = new WeixinProxy(weixinAccount);
weixinProxy.getUser(userid);

4.如需使用netty服务,则可以在相应的action中实现自己的业务处理,打包后放到正确的目录下解压weixin-qy-server-bin.zip执行sh startup.sh start便可启动服务.

@ActionAnnotation(msgType = MessageType.text)
public class TextAction extends AbstractAction<TextMessage> {

	@Override
	public ResponseMessage execute(TextMessage inMessage) {
		return new ResponseMessage(new Text("Hello World!"), inMessage);
	}
}

更新LOG

  • 2014-11-19

    • 得到weixin4j-qy-apiweixin4j-qy-server工程

    • weixin4j-qy-api: 新增部门管理接口

    • weixin4j-qy-api: 新增用户管理接口

    • weixin4j-qy-api: 新增标签管理接口

  • 2014-11-23

    • weixin4j-qy-api: 新增多媒体管理接口

    • weixin4j-qy-api: 新增发送消息接口

    • weixin4j-qy-api: 新增菜单管理接口

  • 2014-11-24

    • weixin4j-qy-server: 新增netty服务与消息分发