微信公众号开发

一、前言

　　有了前期准备之后，现在可以开始微信公众号的开发了。 　　本博文主要包含以下内容：

如何接入微信公众平台

关键步骤及易错点分析

二、接入微信公众平台

　　登录进入微信公众平台，进入”开发”部分，点击进入”基本配置”，点击“修改配置”按钮，如下：

配置：

　　依次填写服务器地址（URL）、Token和EncodingAESKey，其中URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。

注意事项：

1.URL为后台服务器的URL，且只能是80或者443端口； 2.Token值必须要和下面代码中的Token值相同。 2.2 验证消息是否来自微信服务器

2.1 验证原理

　　开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带参数如下表所示： 参数 概述 signature 微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 timestamp 时间戳 nonce 随机数 echostr 随机字符串

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

1）将token、timestamp、nonce三个参数进行字典序排序 2）将三个参数字符串拼接成一个字符串进行sha1加密 3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

2.2 验证代码

1.获取参数代码

package cn.edu.sdut.controller; import java.io.IOException; import java.io.PrintWriter; import java.util.Date; import java.util.Map; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import cn.edu.sdut.msg.TextMessage; import cn.edu.sdut.service.CheckUtil; import cn.edu.sdut.service.MessageUtil; public class WeChatServletController extends HttpServlet { /** * 与微信服务器交互，进行验证 */ private static final long serialVersionUID = 1L; protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.getParameter("signature");//该signature来自微信服务器 String timestamp = req.getParameter("timestamp"); String nonce = req.getParameter("nonce"); String echostr = req.getParameter("echostr"); // 调用逻辑验证 PrintWriter out = resp.getWriter(); if (CheckUtil.checkSignature(signature, timestamp, nonce)) { //返回微信服务器 out.println(echostr); } out.close(); out = null; } }

2.算法验证代码

package cn.edu.sdut.service; import java.io.UnsupportedEncodingException; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.util.Arrays; /** * 值的逻辑检验 */ public class CheckUtil { private static final String token = "cnsoftbei3"; public static boolean checkSignature(String signature, String timestamp, String nonce) { // System.out.println("打印signature" + signature.toString()); System.out.println("打印timestamp" + timestamp.toString()); System.out.println("打印nonce" + nonce.toString()); String[] arr = new String[] { token, timestamp, nonce }; // 将三个字符串进行排序a Arrays.sort(arr); // 生成字符串 StringBuffer content = new StringBuffer(); for (int i = 0; i < arr.length; i++) { content.append(arr[i]); } // shaq1加密 String temp = getSha1(content.toString()); return temp.equals(signature); } public static String getSha1(String str) { if (null == str || 0 == str.length()) { return null; } char[] hexDigits = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' }; try { MessageDigest mdTemp = MessageDigest.getInstance("SHA1"); mdTemp.update(str.getBytes("UTF-8")); byte[] md = mdTemp.digest(); int j = md.length; char[] buf = new char[j * 2]; int k = 0; for (int i = 0; i < j; i++) { byte byte0 = md[i]; buf[k++] = hexDigits[byte0 >>> 4 & 0xf]; buf[k++] = hexDigits[byte0 & 0xf]; } return new String(buf); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } return str; } }

2.3 配置文件(重要)

　　配置文件要注意验证代码的路径。

<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> <display-name>Wechat</display-name> <servlet> <servlet-name>WeChatServlet</servlet-name> <servlet-class>cn.edu.sdut.controller.WeChatServletController</servlet-class> </servlet> <servlet-mapping> <servlet-name>WeChatServlet</servlet-name> <url-pattern>/wechat.do</url-pattern> </servlet-mapping> <!-- JSF的核心控制器 FacesServlet --> <servlet> <servlet-name>FacesServlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <!-- Faces Servlet Mapping --> <servlet-mapping> <servlet-name>FacesServlet</servlet-name> <url-pattern>*.jsf</url-pattern> </servlet-mapping> <context-param> <param-name>javax.faces.DEFAULT_SUFFIX</param-name> <param-value>.xhtml</param-value> </context-param> <welcome-file-list> <welcome-file>index.xhtml</welcome-file> </welcome-file-list> </web-app>

2.4 依据接口文档实现业务逻辑

　　最后点击”提交按钮”，若提交成功则表明验证通过。

三、关键步骤及易错点分析

1.URL为后台服务器的URL，且只能是80或者443端口； 2.Token值必须要和下面代码中的Token值相同； 3.WeChatServlet的路径一定要正确。

四、参考资料

　　微信公众号官方文档是最好的参考资料： 　　https://mp.weixin.qq.com/wiki