1、需要开通api接收消息功能
参考企业微信地址:
概述 - 接口文档 - 企业微信开发者中心
2、实现回调地址调用逻辑
(由于此处调用地址和后续应用推送消息的地址一致,代码便整合在一起)
3、代码实现后,点击第一步中的保存按钮,则会开通成功!成功图如下所示:
4、实现企业微信回调接口
String sToken = "";自建应用中的开通api接口消息详情里的sToken
String sCorpID = ""; //企业微信后台的企业微信id
String sEncodingAESKey = ""; 自建应用的开通api接口消息详情里的sEncodingAESKey
/**
* @param params 可以接收到请求地址中所有拼接的参数
* @param xmlData 获取到企业微信响应的xml数据
* @param request 获取请求类型,因为在自建应用中添加接收api时用的是get请求,接收企业微信收到的消息时用的是post请求,当前处理只做消息接收,未添加消息安全性校验
* @return
* @throws Exception
*/
@RequestMapping("/qw/test")
private String test(@RequestParam MultiValueMap<String, String> params, @RequestBody String xmlData, HttpServletRequest request) throws Exception {
String method = request.getMethod();
WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
if (method.equals("GET")) {
try {
//解密消息并将明文返回给企业微信,即可以开通api接收消息
String sEchoStr = wxcpt.VerifyURL(params.toSingleValueMap().get("msg_signature"), params.toSingleValueMap().get("timestamp"),
params.toSingleValueMap().get("nonce"), params.toSingleValueMap().get("echostr"));
return sEchoStr;
} catch (Exception e) {
//验证URL失败,错误原因请查看异常
e.printStackTrace();
}
} else {
//对接收到的消息进行校验
String sMsg = wxcpt.DecryptMsg(params.toSingleValueMap().get("msg_signature"), params.toSingleValueMap().get("timestamp"),
params.toSingleValueMap().get("nonce"), xmlData);
//将接口中的xmlData 转换为对象
XmlMapper xmlMapper = new XmlMapper();
QwDecryptVo decryptVo = xmlMapper.readValue(sMsg, QwDecryptVo.class);
System.out.println("发送人-->" + decryptVo.getFromUserName() + ";内容--->" + decryptVo.getContent());
//可添加相应业务处理,然后给用户发确认消息
String sRespData = "<xml><ToUserName><![CDATA["+decryptVo.getFromUserName()+"]]></ToUserName><FromUserName><![CDATA["+ decryptVo.getToUserName() +"]]></FromUserName><CreateTime>"+new DateTime().getTime() +"</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[已收到该条消息]]></Content><MsgId>"+System.currentTimeMillis()+"</MsgId><AgentID>"+decryptVo.getAgentID()+"</AgentID></xml>";
return wxcpt.EncryptMsg(sRespData, "", System.currentTimeMillis()+"");
}
return null;
}
sToken 和 sEncodingAESKey 在点击查看消息后所展示的:
5、下载上一步加解密的util包到本地项目
下载地址:加解密库下载与返回码 - 接口文档 - 企业微信开发者中心
6、解决下载的类AesException报错
使用NotePad++ 打开 AesException 类文件,并转码为 utf-8 编码格式保存即可解决
7、xml 转实体所需pom依赖
<dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-xml</artifactId>
</dependency>
8、xml对应的实体对象
@JacksonXmlRootElement(localName = "xml")
@Data
public class QwDecryptVo {
@JacksonXmlProperty(localName = "ToUserName")
private String toUserName;
@JacksonXmlProperty(localName = "FromUserName")
private String fromUserName;
@JacksonXmlProperty(localName = "CreateTime")
private String createTime;
@JacksonXmlProperty(localName = "MsgType")
private String msgType;
@JacksonXmlProperty(localName = "Content")
private String content;
@JacksonXmlProperty(localName = "MsgId")
private String msgId;
@JacksonXmlProperty(localName = "AgentID")
private String agentID;
}
9、解决java.security.InvalidKeyException: Illegal key size报错
参考企业微信接口回调异常java.security.InvalidKeyException: Illegal key size 的解决方法(已解决)_java21 java.security.invalidkeyexception: illegal -CSDN博客
至此,已成功实现接收企业微信自建应用消息!!!