微信企业号开发入门(回调模式)java

﹥>﹥吖頭↗ 提交于 2019-12-02 07:59:31

最近在开发微信企业号,刚接触时云里雾里的,在摸索过程中终于清晰了一点。

刚开始我以为订阅号、服务号、企业号的接口差不多,就一直用订阅号的教程来入门,后来才发现差的挺多的。

 

首先,微信企业号不像订阅号和服务号,就一个主页面。企业号的开发其实是对应用的开发。

先附上微信企业号开发官方文档:https://qydev.weixin.qq.com/wiki/index.php

 

一、企业微信管理页面配置

网址:https://work.weixin.qq.com/wework_admin/frame


1、在注册完企业号后,先创建一个应用

 

 

2、在应用管理--自建的应用中配置可信域名

需要注意的是,微信公众号的开发测试需要访问到外网的服务器,且端口只能为80。

这里推荐使用 natapp进行配置,具体使用看 :https://blog.csdn.net/qq_33922980/article/details/90244160  (自备域名的可以忽略)

启动后,填写可信域名

 

 3、配置接收消息的api(这里我已经配好了)

 Token和EncodingAESKey可以使用随机获取,url填写刚刚配置的可信域名,及准备调用的接口。

 

 

此时点击保存,会提示服务器异常,请稍后再试。

这是由于点击保存时,微信会向我们添加的url发送一个get请求,需要我们返回值。

附上官方说明:

 

 附上url检验代码:

1 @RequestMapping(method = RequestMethod.GET)
2 @ResponseBody
3 public String checkToken(@RequestParam(name = "msg_signature") String signature, String timestamp, String nonce, String echostr) throws AesException {
4     //token和encoding_aeskey就是上诉随机获取的值,corp_id是企业id,在企业微信管理页面点击: 我的企业,拉到最下方可以看到
5     WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(TOTKN, ENCODING_AESKEY, CORP_ID);
6     String sEchoStr = wxcpt.VerifyURL(signature, timestamp,nonce, echostr);
7     System.out.println("-----签名校验通过-----");
8     return sEchoStr;
9 }

 

其中,WXBizMsgCrypt是官方提供的加解密库,下载地址:https://qydev.weixin.qq.com/download/java.zip

为方便使用,我直接打成了jar包,有需要的自取。链接: https://pan.baidu.com/s/1Xtzd69T8jVL3w8Kg1jnreQ 提取码: jeeu 

 

再点击保存,就通过了。

此时后台管理的配置完成。

二、实际功能开发

1、回调模式

该url的调用有两个,一个是上述的url检验时调用,第二个是回调模式调用。不同点是回调模式是发post请求,且携带的参数不一样。

这里说明一下,第二个回调模式是说,成员发送消息或触发事件时都会调用该接口,我们根据逻辑处理后再进行反馈。

 

接收的信息使用XML数据格式、UTF8编码,并以AES方式加密

 

这里我们封装一个类,来接收回调数据。

 1 import javax.xml.bind.annotation.XmlAccessType;
 2 import javax.xml.bind.annotation.XmlAccessorType;
 3 import javax.xml.bind.annotation.XmlElement;
 4 import javax.xml.bind.annotation.XmlRootElement;
 5 
 6 @XmlRootElement(name="xml")
 7 @XmlAccessorType(XmlAccessType.FIELD)
 8 public class InMsgEntity {
 9     /**
10      * 接收的应用id,可在应用的设置页面获取
11      */
12     @XmlElement(name = "AgentID")
13     private String agentID;
14     /**
15      * 经过加密的密文
16      */
17     @XmlElement(name = "Encrypt")
18     private String encrypt;
19     /**
20      * 发送方帐号
21      */
22     @XmlElement(name="ToUserName")
23     private String toUserName;
24 
25     public String getAgentID() {
26         return agentID;
27     }
28 
29     public void setAgentID(String agentID) {
30         this.agentID = agentID;
31     }
32 
33     public String getEncrypt() {
34         return encrypt;
35     }
36 
37     public void setEncrypt(String encrypt) {
38         this.encrypt = encrypt;
39     }
40 
41     public String getToUserName() {
42         return toUserName;
43     }
44 
45     public void setToUserName(String toUserName) {
46         this.toUserName = toUserName;
47     }
48 }

 再写两个工具类,来转换格式。

(1)因为要调用官方的加解密库,所以要封装成他需要格式的字符串。

 1 import com.newland.bean.InMsgEntity;
 2 public class FormatUtils {
 3     /**
 4      * 接收请求格式封装
 5      * @param msg
 6      * @return
 7      */
 8     public static String getReqData(InMsgEntity msg){
 9         return  "<xml><ToUserName><![CDATA["+msg.getToUserName()+"]]></ToUserName><Encrypt><![CDATA[" +msg.getEncrypt()+
10                 "]]></Encrypt><AgentID><![CDATA["+msg.getAgentID()+"]]></AgentID></xml>";
11     }
12 
13     /**
14      * 发送文字消息格式封装
15      * @param content
16      * @return
17      */
18     public static String getTextRespData(String content){
19         return  "<xml><MsgType><![CDATA[text]]></MsgType><Content><![CDATA["+content+"]]></Content></xml>";
20     }
21 }

(2)为方便处理xml格式的数据,写一个标签处理的工具类

 1 import org.w3c.dom.Document;
 2 import org.w3c.dom.Element;
 3 import org.xml.sax.InputSource;
 4 import org.xml.sax.SAXException;
 5 import javax.xml.parsers.DocumentBuilder;
 6 import javax.xml.parsers.DocumentBuilderFactory;
 7 import javax.xml.parsers.ParserConfigurationException;
 8 import java.io.IOException;
 9 import java.io.StringReader;
10 public class ElementUtils {
11     private Element root = null;
12     /**
13      * 根据xml格式的字符串建document
14      * @param sMsg
15      * @throws ParserConfigurationException
16      * @throws IOException
17      * @throws SAXException
18      */
19     public ElementUtils(String sMsg) throws ParserConfigurationException, IOException, SAXException {
20         DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
21         DocumentBuilder db = dbf.newDocumentBuilder();
22         StringReader sr = new StringReader(sMsg);
23         InputSource is = new InputSource(sr);
24         Document document = db.parse(is);
25         root = document.getDocumentElement();
26     }
27 
28     /**
29      * 根据tagName获取内容
30      * @param tagName
31      * @return
32      */
33     public String get(String tagName){
34         return root.getElementsByTagName(tagName).item(0).getTextContent();
35     }
36 }

最后回调模式代码:(这里没写太多,可以根据自身需要写逻辑)

 1 @RequestMapping(method = RequestMethod.POST,produces = {"application/xml;charset=UTF-8"})
 2 @ResponseBody
 3 public Object handlerMessage(@RequestBody InMsgEntity msg, @RequestParam(name = "msg_signature") String signature,
 4                              String timestamp, String nonce) throws Exception {
 5     WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(TOTKN, ENCODING_AESKEY, CORP_ID);
 6     String sReqData = FormatUtils.getReqData(msg);
 7     String sMsg = wxcpt.DecryptMsg(signature, timestamp, nonce, sReqData);
 8     ElementUtils element = new ElementUtils(sMsg);
 9     String msgType = element.get("MsgType");
10     String content = "";
11     switch (msgType){
12         /**
13          * 事件类型处理
14          */
15         case "event":content = "触发事件";break;
16         /**
17          * 文字消息处理:这里是将用户发送的消息原样返回
18          */
19         case "text": content = element.get("Content");break;
20         default:break;
21     }
22     String sRespData = FormatUtils.getTextRespData(content);
23     String sEncryptMsg = wxcpt.EncryptMsg(sRespData, timestamp, nonce);
24     return sEncryptMsg;
25 }

很奇怪的是,在企业微信官方文档里,并没有给出Encrypt解密之后的格式,要在微信公众号官方文档里看:https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_standard_messages.html

或者你也可以通过在上诉代码获得sMsg之后,打断点或输出sMsg的值来查看格式。

 

这里附上几种常用类型的数据格式。其中ToUserName、FromUserName、CreateTime、MsgType是公共标签。

(1)文字消息类型格式: 

(2)图片消息格式

 (3)关注取关事件数据格式:

 

 

到这里,可以试着向应用发送消息了,或者尝试重新关注,看看是否有回复消息。

因为我目前这个企业号功能不多,所以只写了文字格式的回复,有需要的话可以自行去官方文档那对应消息格式进行改动~

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!