最近在开发微信企业号，刚接触时云里雾里的，在摸索过程中终于清晰了一点。
刚开始我以为订阅号、服务号、企业号的接口差不多，就一直用订阅号的教程来入门，后来才发现差的挺多的。
首先，微信企业号不像订阅号和服务号，就一个主页面。企业号的开发其实是对应用的开发。
先附上微信企业号开发官方文档：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）关注取关事件数据格式：
到这里，可以试着向应用发送消息了，或者尝试重新关注，看看是否有回复消息。
因为我目前这个企业号功能不多，所以只写了文字格式的回复，有需要的话可以自行去官方文档那对应消息格式进行改动~