在上一篇文章中讲到了关于消息接收的配置和开发方法之后,本节将介绍WX SDK关于微信公众号所有http请求接口的封装api。
在WX SDK中,目前已经实现了包括如下三种类型的接口:
- 消息发送(Message)
- 用户管理(User)
- 菜单管理(Menu)
每一种类型的接口对应着一个Invoker接口,每个Invoker接口所提供的方法和微信公众平台开放的接口文档是一一对应的,所以开发者调用时可以明确区分关于消息的方法在MessageInvoker接口,用户管理的方法在UserInvoker接口中。
WX SDK所支持的接口类型都可以通过WXContext来获取,例如:
获取消息操作接口:MessageInvoker messageInvoker = WXContext.getMessageInvoker();
获取用户接口:UserInvoker userInvoker = WXContext.getUserInvoker();
在WXContext中,已经封装了关于accessToken、jsTicket的获取和过期重新获取机制,这一切对于开发者是透明的,开发者仅需关注Invoker即可。
关于响应结果
微信针对每个Http接口定义了公共的响应码,通常Post请求以及请求错误会返回如下形式的Json:
{ "errcode":0, "errmsg":"ok" }
WX SDK中将微信公众平台列出的所有响应码都定义在了WXResponseCode类中供开发者直接使用,并针对这些api的返回值封装为Result类。