微信企業號開發入門（回調模式）java

最近在開發微信企業號，剛接觸時雲里霧里的，在摸索過程中終於清晰了一點。

剛開始我以為訂閱號、服務號、企業號的接口差不多，就一直用訂閱號的教程來入門，后來才發現差的挺多的。

 

首先，微信企業號不像訂閱號和服務號，就一個主頁面。企業號的開發其實是對應用的開發。

先附上微信企業號開發官方文檔：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檢驗代碼：

@RequestMapping(method = RequestMethod.GET)
@ResponseBody
public String checkToken(@RequestParam(name = "msg_signature") String signature, String timestamp, String nonce, String echostr) throws AesException {
    //token和encoding_aeskey就是上訴隨機獲取的值，corp_id是企業id，在企業微信管理頁面點擊： 我的企業，拉到最下方可以看到
    WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(TOTKN, ENCODING_AESKEY, CORP_ID);
    String sEchoStr = wxcpt.VerifyURL(signature, timestamp,nonce, echostr);
    System.out.println("-----簽名校驗通過-----");
    return sEchoStr;
}

 

其中，WXBizMsgCrypt是官方提供的加解密庫，下載地址：https://qydev.weixin.qq.com/download/java.zip

為方便使用，我直接打成了jar包，有需要的自取。鏈接: https://pan.baidu.com/s/1Xtzd69T8jVL3w8Kg1jnreQ 提取碼: jeeu 

 

再點擊保存，就通過了。

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

二、實際功能開發

1、回調模式

該url的調用有兩個，一個是上述的url檢驗時調用，第二個是回調模式調用。不同點是回調模式是發post請求，且攜帶的參數不一樣。

這里說明一下，第二個回調模式是說，成員發送消息或觸發事件時都會調用該接口，我們根據邏輯處理后再進行反饋。

 

接收的信息使用XML數據格式、UTF8編碼，並以AES方式加密。

 

這里我們封裝一個類，來接收回調數據。

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="xml")
@XmlAccessorType(XmlAccessType.FIELD)
public class InMsgEntity {
    /**
     * 接收的應用id，可在應用的設置頁面獲取
     */
    @XmlElement(name = "AgentID")
    private String agentID;
    /**
     * 經過加密的密文
     */
    @XmlElement(name = "Encrypt")
    private String encrypt;
    /**
     * 發送方帳號
     */
    @XmlElement(name="ToUserName")
    private String toUserName;

    public String getAgentID() {
        return agentID;
    }

    public void setAgentID(String agentID) {
        this.agentID = agentID;
    }

    public String getEncrypt() {
        return encrypt;
    }

    public void setEncrypt(String encrypt) {
        this.encrypt = encrypt;
    }

    public String getToUserName() {
        return toUserName;
    }

    public void setToUserName(String toUserName) {
        this.toUserName = toUserName;
    }
}

 再寫兩個工具類，來轉換格式。

（1）因為要調用官方的加解密庫，所以要封裝成他需要格式的字符串。

import com.newland.bean.InMsgEntity;
public class FormatUtils {
    /**
     * 接收請求格式封裝
     * @param msg
     * @return
     */
    public static String getReqData(InMsgEntity msg){
        return  "<xml><ToUserName><![CDATA["+msg.getToUserName()+"]]></ToUserName><Encrypt><![CDATA[" +msg.getEncrypt()+
                "]]></Encrypt><AgentID><![CDATA["+msg.getAgentID()+"]]></AgentID></xml>";
    }

    /**
     * 發送文字消息格式封裝
     * @param content
     * @return
     */
    public static String getTextRespData(String content){
        return  "<xml><MsgType><![CDATA[text]]></MsgType><Content><![CDATA["+content+"]]></Content></xml>";
    }
}

（2）為方便處理xml格式的數據，寫一個標簽處理的工具類

import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import java.io.IOException;
import java.io.StringReader;
public class ElementUtils {
    private Element root = null;
    /**
     * 根據xml格式的字符串建document
     * @param sMsg
     * @throws ParserConfigurationException
     * @throws IOException
     * @throws SAXException
     */
    public ElementUtils(String sMsg) throws ParserConfigurationException, IOException, SAXException {
        DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
        DocumentBuilder db = dbf.newDocumentBuilder();
        StringReader sr = new StringReader(sMsg);
        InputSource is = new InputSource(sr);
        Document document = db.parse(is);
        root = document.getDocumentElement();
    }

    /**
     * 根據tagName獲取內容
     * @param tagName
     * @return
     */
    public String get(String tagName){
        return root.getElementsByTagName(tagName).item(0).getTextContent();
    }
}

最后回調模式代碼：（這里沒寫太多，可以根據自身需要寫邏輯）

@RequestMapping(method = RequestMethod.POST,produces = {"application/xml;charset=UTF-8"})
@ResponseBody
public Object handlerMessage(@RequestBody InMsgEntity msg, @RequestParam(name = "msg_signature") String signature,
                             String timestamp, String nonce) throws Exception {
    WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(TOTKN, ENCODING_AESKEY, CORP_ID);
    String sReqData = FormatUtils.getReqData(msg);
    String sMsg = wxcpt.DecryptMsg(signature, timestamp, nonce, sReqData);
    ElementUtils element = new ElementUtils(sMsg);
    String msgType = element.get("MsgType");
    String content = "";
    switch (msgType){
        /**
         * 事件類型處理
         */
        case "event":content = "觸發事件";break;
        /**
         * 文字消息處理：這里是將用戶發送的消息原樣返回
         */
        case "text": content = element.get("Content");break;
        default:break;
    }
    String sRespData = FormatUtils.getTextRespData(content);
    String sEncryptMsg = wxcpt.EncryptMsg(sRespData, timestamp, nonce);
    return sEncryptMsg;
}

很奇怪的是，在企業微信官方文檔里，並沒有給出Encrypt解密之后的格式，要在微信公眾號官方文檔里看：https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Receiving_standard_messages.html

或者你也可以通過在上訴代碼獲得sMsg之后，打斷點或輸出sMsg的值來查看格式。

 

這里附上幾種常用類型的數據格式。其中ToUserName、FromUserName、CreateTime、MsgType是公共標簽。

（1）文字消息類型格式： 

（2）圖片消息格式

 （3）關注取關事件數據格式：

 

 

到這里，可以試着向應用發送消息了，或者嘗試重新關注，看看是否有回復消息。

因為我目前這個企業號功能不多，所以只寫了文字格式的回復，有需要的話可以自行去官方文檔那對應消息格式進行改動~