使用JAVA开发微信公众平台——环境搭建与开发接入

首先推荐一个后来看到不错的教学：点击打开链接

一、 初始微信公众平台

微信公众平台，即我们平时所说的“公众号”，曾用名“官方平台”、“媒体平台”，但最终命名为“公众平台”。从微信的命名我可以发现，公众平台不只是官方、媒体使用的平台，而是对所有公众都开放的统一平台。

微信公众平台地址：https://mp.weixin.qq.com/

微信公众平台公分4大板块：订阅号、服务号、小程序、企业号。

 

简单的对比一下前三者的区别：

1、 订阅号和服务号均为传统意义的“公众号”，具有消息群发能力，详细区别可在官方平台查看：http://kf.qq.com/faq/140806zARbmm140826M36RJF.html 我们将注重于服务能力开发，而在服务方面，两者开发模式完全相同，只不过服务号可以使用更多的服务接口，而订阅号则是“阉割版”的服务号。因此，后续课程我们将使用服务号为案例进行操作。

2、 微信小程序，原本为“微信应用号”，即一个根植在微信生态系统内的APP。因苹果和谷歌的限制，“应用号”未上线便已夭折，取而代之的是适度阉割功能的“微信小程序”，而其堪比原生APP的操作体验，也使得小程序成为时下大火的开发方向。

二、 开发账号准备

1、 账号注册

进入微信公众平台https://mp.weixin.qq.com ，点击右上角立即注册，选择“服务号”或“订阅号”注册（服务号仅限机构用户注册，个人用户只能选择订阅号）

注册时需填写一系列信息，根据提示填写即可，此处不做赘述。

2、 测试账号申请

如果暂时不想注册账号，或者无法注册服务号，可选择官方提供的测试账号申请。申请地址：http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 点击后扫描二维码，即可获得一个测试账号，拥有服务号全部权限。

 

三、 开发环境准备

1、 外网映射工具

微信公众平台在访问后台时，必须提供能够正确访问的外网地址，微信平台对后台URL的要求有两点：

① 必须能够用公网访问    ② 必须使用80端口

要实现以上两点，我们可以选择购买外网服务器，例如：阿里云、百度云、腾讯云…都是不错的选择。如果没有服务器，可以选择用外网映射工具，将我们的内网链接映射为公网，比较不错的映射软件有：花生壳、ngrok、nat123等…

这几款软件都可以百度很容易搜索到并下载，下面简单讲解一下用法：

(1): Ngrock：

进入dos环境，切换到ngrock所在盘符，输入ngrock 8080 回车：

 

回车后等待一会，即可得到公网链接，下图所示阴影区域给出的链接，即可直接访问本机127.0.0.1:8080下的链接内容，分别是http协议和https协议对应的地址：

 

(2):花生壳、nat123，均可安装软件后，在软件中操作，详情可查看百度经验：http://jingyan.baidu.com/article/363872ec361d3f6e4ba16ff9.html 此处不做赘述  收费

(3):unny-Ngrok:

本来一开始看博客有人推荐了Ngrok，试了以后发现他服务器在国外，映射的网址访问慢的不行。

下面是Sunny-Ngrok的官网： 免费

https://www.ngrok.cc/

1、首先在本站注册成为会员

2、开通隧道

在上图中表单信息解释：

    隧道名称：可以随便填写，只是为了使用者在往后之后这个隧道是干嘛的

    前置域名：服务器免费赠送的域名，请不要带上后缀，如果要sunny.ngrok.cc 只需要填写 sunny 即可 ，千万不要填写成sunny.ngrok.cc否则域名会是sunny.ngrok.cc.ngrok.cc

    本地端口：可以为同一个局域网内任意一台机器进行映射，只需要填对ip和端口就行，例如：192.168.1.1:80

    http验证用户名：非必填项，在需要的时候填写，否则可以不填

    http验证密码：非必填项，在需要的时候填写，否则可以不填

3、下载客户端

    

    根据自己的操作系统需求下载相对于版本

写到这里忘了说了，之后我们会用到Tomcat，不会配置的同学可以参考下面这篇漏文：

http://blog.csdn.net/geanwen/article/details/78410595

4、启动映射服务

    window系统下:

方法一：

1、打开命令提示符

2、通过命令提示符窗口进入下载好的软件目录

3、启动隧道

命令解释：

    sunny.exe 下载的软件内网映射隧道工具

    clientid  通过隧道id启动，后面跟上隧道id，如果有多个隧道要一起启动那么使用英文逗号隔开第三个红色剪头所指的地方就是为了启动多个隧道

方法二：

    通过下载的软件包里面的bat小工具启动，双击bat文件输入隧道id回车启动即可。

    

    这里启动了两个隧道，使用了英文逗号隔开了。

    其中：http://aool.ngrok.cc就是你本地路径映射后的结果。

5、访问服务

    然后通过启动成功界面上的链接访问网站如果显示是内网搭建的web服务里面的内容就说明成功了

    如果没有启动web服务将会看到下图提示

注意：tomcat默认的端口号为：8080

    修改eclipse中tomcat端口的办法：

        1：找到tomcat位置：打开eclipse，选择window->Preferences->Server->Runtime Environments选择你的tomcat然后点Edit，就会出现它的路径了。
2：打开Tomcat下，conf文件夹中的，server.xml文件
        3：将port由8080修改为80

注意：正常情况下，这时重启tomcat服务器端口号就修改成功了。但是，如果你用的开发工具是Eclipse，这是你在Eclipse中重启tomcat服务器的话，会发现服务器用的依然是8080端口。这时需要你在Eclipse中将正在使用的服务器删掉，在重新装载一次。

                            

4、重新启动Tomcat

四、 微信公众平台数据交互原理

搭建好公网访问地址后，我们自己开发的后台代码就可以放到公网地址了，那么用户是怎么样访问到我们的代码呢？

下面我们来看一下微信公众平台的数据交互原理：

 

 

从上图可以看到，微信公众平台实际只是起到一个桥梁作用，实际处理业务、提供服务的代码，依然是放在我们自己的服务器或者公网映射上面。

那么，我们就可以在我们自己的电脑（服务器）上面编写后台代码，并通过映射工具提供公网能够访问的URL，然后将此URL绑定到微信后台即可。

五、 开发模式接入

下面将进入实际开发过程，我们可以参考官方提供的开发文档：https://mp.weixin.qq.com/wiki 

1、 填写服务器配置

进入微信公众平台，点击左侧【开发——基本配置】，选择【服务器配置】。即可进入配置页面：

 

其中：

URL：即我们上述所说的后台服务器公网访问地址

Token：开发者自定的验证口令

EncodingAESKey：随机字符串，如果消息加解密方式采用安全模式才需验证

 

2、 验证消息是否有效

当我们点击提交时，微信服务器将会发送一个Get请求，到我们上述地址，同时传递四个参数：

 

我们通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：

下面，我们实现代码操作。

六、 开发接入后台代码

代码也是我看文章找的：

[java]  view plain  copy

1. package servlet;  
2.   
3. import bean.TextMessage;  
4. import util.CheckUtil;  
5. import util.MessageUtils;  
6.   
7. import javax.servlet.ServletException;  
8. import javax.servlet.http.HttpServlet;  
9. import javax.servlet.http.HttpServletRequest;  
10. import javax.servlet.http.HttpServletResponse;  
11. import java.io.IOException;  
12. import java.io.PrintWriter;  
13. import java.util.Date;  
14. import java.util.Map;  
15.   
16. public class WechatServlet extends HttpServlet{  
17.   
18.     /** 
19.      * 接收微信服务器发送的4个参数并返回echostr 
20.      */  
21.     public void doGet(HttpServletRequest request, HttpServletResponse response)  
22.             throws ServletException, IOException {  
23.   
24.         // 接收微信服务器以Get请求发送的4个参数  
25.         String signature = request.getParameter("signature");  
26.         String timestamp = request.getParameter("timestamp");  
27.         String nonce = request.getParameter("nonce");  
28.         String echostr = request.getParameter("echostr");  
29.   
30.         PrintWriter out = response.getWriter();  
31.         if (CheckUtil.checkSignature(signature, timestamp, nonce)) {  
32.             out.print(echostr);        // 校验通过，原样返回echostr参数内容  
33.         }  
34.     }  
35.   
36.     /** 
37.      * 接收并处理微信客户端发送的请求 
38.      */  
39.     public void doPost(HttpServletRequest request, HttpServletResponse response)  
40.             throws ServletException, IOException {  
41.   
42.         request.setCharacterEncoding("UTF-8");  
43.         response.setCharacterEncoding("UTF-8");  
44.         response.setContentType("text/xml;charset=utf-8");  
45.         PrintWriter out = response.getWriter();  
46.         Map<String, String> map = MessageUtils.xmlToMap(request);  
47.         String toUserName = map.get("ToUserName");  
48.         String fromUserName = map.get("FromUserName");  
49.         String msgType = map.get("MsgType");  
50.         String content = map.get("Content");  
51.   
52.         String message = null;  
53.         if ("text".equals(msgType)) {                // 对文本消息进行处理  
54.             TextMessage text = new TextMessage();  
55.             text.setFromUserName(toUserName);         // 发送和回复是反向的  
56.             text.setTouserName(fromUserName);  
57.             text.setMsgType("text");  
58.             text.setCreateTime(String.valueOf(new Date().getTime()));  
59.             text.setContent("你发送的消息是：" + content);  
60.             message = MessageUtils.textMessageToXML(text);  
61.             System.out.println(message);  
62.         }  
63.         out.print(message);                            // 将回应发送给微信服务器  
64.     }  
65. }  

里面的工具类CheckUtils：

[java]  view plain  copy

1. package util;  
2.   
3. import java.security.MessageDigest;  
4. import java.util.Arrays;  
5.   
6. public class CheckUtil {  
7.   
8.     private static final String token = "geanwen";  
9.   
10.     public static boolean checkSignature(String signature, String timestamps, String nonce){  
11.   
12.         String[] arr = new String[]{token, timestamps, nonce};  
13.   
14.         // 排序  
15.         Arrays.sort(arr);  
16.   
17.         // 生成字符串  
18.         StringBuilder content = new StringBuilder();  
19.         for (int i = 0; i < arr.length; i++) {  
20.             content.append(arr[i]);  
21.         }  
22.   
23.         // sha1加密  
24.         String temp = encode(content.toString());  
25.   
26.         return temp.equals(signature); // 与微信传递过来的签名进行比较  
27.     }  
28.   
29.   
30.     private static final char[] HEX_DIGITS = {'0', '1', '2', '3', '4', '5',  
31.             '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};  
32.   
33.     /** 
34.      * Takes the raw bytes from the digest and formats them correct. 
35.      * 
36.      * @param bytes the raw bytes from the digest. 
37.      * @return the formatted bytes. 
38.      */  
39.     private static String getFormattedText(byte[] bytes) {  
40.         int len = bytes.length;  
41.         StringBuilder buf = new StringBuilder(len * 2);  
42.         // 把密文转换成十六进制的字符串形式  
43.         for (int j = 0; j < len; j++) {  
44.             buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);  
45.             buf.append(HEX_DIGITS[bytes[j] & 0x0f]);  
46.         }  
47.         return buf.toString();  
48.     }  
49.   
50.     public static String encode(String str) {  
51.         if (str == null) {  
52.             return null;  
53.         }  
54.         try {  
55.             MessageDigest messageDigest = MessageDigest.getInstance("SHA1");  
56.             messageDigest.update(str.getBytes());  
57.             return getFormattedText(messageDigest.digest());  
58.         } catch (Exception e) {  
59.             throw new RuntimeException(e);  
60.         }  
61.     }  
62.   
63. }  

MessageUtils：

[java]  view plain  copy

1. package util;  
2.   
3. import bean.TextMessage;  
4. import com.thoughtworks.xstream.XStream;  
5. import org.dom4j.Document;  
6. import org.dom4j.DocumentException;  
7. import org.dom4j.Element;  
8. import org.dom4j.io.SAXReader;  
9.   
10. import javax.servlet.http.HttpServletRequest;  
11. import java.io.IOException;  
12. import java.io.InputStream;  
13. import java.util.HashMap;  
14. import java.util.List;  
15. import java.util.Map;  
16.   
17. public class MessageUtils {  
18.   
19.     /** 
20.      * xml转为map集合 
21.      */  
22.     public static Map<String, String> xmlToMap(HttpServletRequest request){  
23.         Map<String, String> map = new HashMap<>();  
24.         SAXReader reader = new SAXReader();  
25.   
26.         try {  
27.             // 从request中获取输入流  
28.             InputStream ins = request.getInputStream();  
29.             Document doc = reader.read(ins);  
30.   
31.             // 获取xml中的跟元素  
32.             Element root = doc.getRootElement();  
33.   
34.             // 获取跟元素所有节点放到list中  
35.             List<Element> list = root.elements();  
36.   
37.             // 遍历  
38.             for (Element e : list){  
39.                 map.put(e.getName(), e.getText());  
40.             }  
41.   
42.             ins.close();  
43.             return map;  
44.         } catch (IOException e) {  
45.             e.printStackTrace();  
46.             return null;  
47.         } catch (DocumentException e) {  
48.             e.printStackTrace();  
49.             return null;  
50.         }  
51.     }  
52.   
53.     /** 
54.      * 将文本消息对象转换成XML 
55.      */  
56.     public static String textMessageToXML(TextMessage textMessage){  
57.   
58.         XStream xstream = new XStream();              // 使用XStream将实体类的实例转换成xml格式  
59.         xstream.alias("xml", textMessage.getClass()); // 将xml的默认根节点替换成“xml”  
60.         return xstream.toXML(textMessage);  
61.   
62.     }  
63.   
64. }  

按照微信要求的实体类TextMessage：

[java]  view plain  copy

1. package bean;  
2.   
3. public class TextMessage {  
4.   
5.     private String TouserName;  
6.     private String FromUserName;  
7.     private String CreateTime;  
8.     private String MsgType;  
9.     private String Content;  
10.     private String MsgId;  
11.   
12.     public String getTouserName() {  
13.         return TouserName;  
14.     }  
15.   
16.     public void setTouserName(String touserName) {  
17.         TouserName = touserName;  
18.     }  
19.   
20.     public String getFromUserName() {  
21.         return FromUserName;  
22.     }  
23.   
24.     public void setFromUserName(String fromUserName) {  
25.         FromUserName = fromUserName;  
26.     }  
27.   
28.     public String getCreateTime() {  
29.         return CreateTime;  
30.     }  
31.   
32.     public void setCreateTime(String createTime) {  
33.         CreateTime = createTime;  
34.     }  
35.   
36.     public String getMsgType() {  
37.         return MsgType;  
38.     }  
39.   
40.     public void setMsgType(String msgType) {  
41.         MsgType = msgType;  
42.     }  
43.   
44.     public String getContent() {  
45.         return Content;  
46.     }  
47.   
48.     public void setContent(String content) {  
49.         Content = content;  
50.     }  
51.   
52.     public String getMsgId() {  
53.         return MsgId;  
54.     }  
55.   
56.     public void setMsgId(String msgId) {  
57.         MsgId = msgId;  
58.     }  
59. }  

Web.xml中添加配置Servlet：

[html]  view plain  copy

1. <servlet>  
2.         <servlet-name>wechatServlet</servlet-name>  
3.         <servlet-class>servlet.WechatServlet</servlet-class>  
4.     </servlet>  
5.       
6.     <servlet-mapping>  
7.         <servlet-name>wechatServlet</servlet-name>  
8.         <url-pattern>/wx.do</url-pattern>  
9.     </servlet-mapping>  

 最后一步：

将项目加到tomcat下 访问对应的控制器  

成功！

如有问题加我QQ：2649416836

参考地址：https://www.sunnyos.com/article-show-71.html

          https://www.cnblogs.com/jerehedu/p/6377759.html