README.md

微信Java客户端

Mojo-Weixin HTTP 接口 的 Java 客户端

接口列表汇总

本项目使用 http-api-invoker 框架实现，提供以下方法:

接口类	方法	功能
ClientApi		对 Mojo-Weixin 进程的操作
ClientApi	getClientInfo	获取进程运行信息
ClientApi	stopClient	终止客户端运行
ClientApi	startClient	启动一个客户端
ClientApi	getQrcode	获取登录二维码文件
FriendApi		微信好友相关的操作
FriendApi	searchFriend	搜索好友对象
FriendApi	getFriendInfo	获取好友信息
FriendApi	getAvatar	获取用户头像
FriendApi	setMarkname	修改好友或群成员备注名称
FriendApi	stick	设置或取消群组、好友置顶
FriendApi	makeFriend	向指定的群成员发送好友请求
FriendApi	acceptFriendRequest	接受好友验证申请
GroupApi		用于微信群相关的操作
GroupApi	searchGroup	搜索群组对象
GroupApi	getGroupInfo	获取群组数据
GroupApi	getGroupBasicInfo	获取群组基本数据
GroupApi	getAvatar	获取群组头像
GroupApi	createCroup	创建群组
GroupApi	inviteFriend	邀请好友入群
GroupApi	kickGroupMember	移除群组成员
GroupApi	setGroupDisplayname	设置群组的显示名称
MediaApi		媒体相关操作
MediaApi	uploadMedia	上传媒体文件，获取media_id
MessageApi		消息相关操作
MessageApi	revokeMessage	撤回消息
MessageApi	sendFriendMessage	发送好友消息
MessageApi	sendGroupMessage	发送群消息
MessageApi	consult	发送消息给好友并等待好友回答

具体方法参数含义及使用说明，请查看具体类的代码注释或查看 接口文档

使用

一、引入 maven 依赖

<dependency>
    <groupId>com.github.dadiyang</groupId>
    <artifactId>wechat-client</artifactId>
    <version>1.0.1</version>
</dependency>

二、设置微信服务地址

通过系统参数设置 Mojo-Weixin 的服务地址

System.setProperty("wechat.host", "http://localhost:3000");

三、获取Api对象

Spring项目

在Spring的项目中，只需要在ComponentScan中添加 com.github.dadiyang.wechat.spring 即可使用@AutoWired获取api接口的实现类，即

@ComponentScan(basePackages = {"com.github.dadiyang.wechat.spring"})
public class Application {

}

然后就可以在需要使用的地方使用 @Autowired 注解了:

@Autowired
private ClientApi clientApi;
@Autowired
private FriendApi friendApi;
@Autowired
private GroupApi groupApi;
@Autowired
private MediaApi mediaApi;
@Autowired
private MessageApi messageApi;
@Autowired
private UserApi userApi;

普通项目

非 Spring 项目需要自己调用工厂方法获取:

HttpApiProxyFactory factory = new HttpApiProxyFactory();
FriendApi friendApi = factory.getProxy(FriendApi.class);
GroupApi groupApi = factory.getProxy(GroupApi.class);