[027] 微信公众帐号开发教程第3篇-开发模式启用及接口配置

编辑模式与开发模式

微信公众帐号申请成功后，要想接收处理用户的请求，就必须要在“高级功能”里进行配置，点击“高级功能”，将看到如下界面：

从上图中可以看到，高级功能包含两种模式：编辑模式和开发模式，并且这两种模式是互斥关系，即两种模式不能同时开启。那两种模式有什么区别呢？作为开发人员到底要开启哪一种呢？

编辑模式：主要针对非编程人员及信息发布类公众帐号使用。开启该模式后，可以方便地通过界面配置“自定义菜单”和“自动回复的消息”。

开发模式：主要针对具备开发能力的人使用。开启该模式后，能够使用微信公众平台开放的接口，通过编程方式实现自定义菜单的创建、用户消息的接收/处理/响应。这种模式更加灵活，建议有开发能力的公司或个人都采用该模式。

启用开发模式（上）

微信公众帐号注册完成后，默认开启的是编辑模式。那么该如何开启开发模式呢？操作步骤如下：

1）点击进入编辑模式，将右上角的编辑模式开关由“开启”切换到“关闭”，如下图所示：

2）点击高级功能进入到开发模式，将右上角的开发模式开关由“关闭”切换到“开启”，但在切换时会遇到如下提示：

提示需要我们先成为开发者，才能开启开发模式。那就先点击下图所示的“成为开发者”按钮：

如果提示资料不全，那就先补齐资料再回来继续操作。需要补全的资料有公众帐号头像、描述和运营地区。

待资料补全后，再次点击“成为开发者”，这时将看到接口配置信息界面，如下图所示：

这里需要填写URL和Token两个值。URL指的是能够接收处理微信服务器发送的GET/POST请求的地址，并且是已经存在的，现在就能够在浏览器访问到的地址，这就要求我们先把公众帐号后台处理程序开发好（至少应该完成了对GET请求的处理）并部署在公网服务器上。Token后面会详细说明。

也就是说要完成接口配置，只需要先完成微信服务器的GET请求处理就可以？是的。那这是为什么呢？因为这是微信公众平台接口中定义的。具体请参考API文档-消息接口-消息接口指南中的网址接入部分。点此进入。

上面写的很清楚，其实你只要能理解上面在说什么就OK了，至于怎么编写相关代码，我已经帮你完成了，请继续往下看。

创建公众帐号后台接口程序

创建一个Java Web工程，并新建一个能够处理请求的Servlet，命名任意，我在这里将其命名为org.liufeng.course.servlet.CoreServlet，代码如下：

package org.liufeng.course.servlet;import java.io.IOException;
import java.io.PrintWriter;import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;import org.liufeng.course.util.SignUtil;/*** 核心请求处理类* * @author liufeng* @date 2013-05-18*/
public class CoreServlet extends HttpServlet {private static final long serialVersionUID = 4440739483644821986L;/*** 确认请求来自微信服务器*/public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {// 微信加密签名String signature = request.getParameter("signature");// 时间戳String timestamp = request.getParameter("timestamp");// 随机数String nonce = request.getParameter("nonce");// 随机字符串String echostr = request.getParameter("echostr");PrintWriter out = response.getWriter();// 通过检验signature对请求进行校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败if (SignUtil.checkSignature(signature, timestamp, nonce)) {out.print(echostr);}out.close();out = null;}/*** 处理微信服务器发来的消息*/public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {// TODO 消息的接收、处理、响应}}

可以看到，代码中只完成了doGet方法，它的作用正是确认请求是否来自于微信服务器；而doPost方法不是我们这次要讲的内容，并且完成接口配置也不需要管doPost方法，就先空在那里。

在doGet方法中调用了org.liufeng.course.util.SignUtil.checkSignature方法，SignUtil.java的实现如下：

package org.liufeng.course.util;import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;/*** 请求校验工具类* * @author liufeng* @date 2013-05-18*/
public class SignUtil {// 与接口配置信息中的Token要一致private static String token = "weixinCourse";/*** 验证签名* * @param signature* @param timestamp* @param nonce* @return*/public static boolean checkSignature(String signature, String timestamp, String nonce) {String[] arr = new String[] { token, timestamp, nonce };// 将token、timestamp、nonce三个参数进行字典序排序Arrays.sort(arr);StringBuilder content = new StringBuilder();for (int i = 0; i < arr.length; i++) {content.append(arr[i]);}MessageDigest md = null;String tmpStr = null;try {md = MessageDigest.getInstance("SHA-1");// 将三个参数字符串拼接成一个字符串进行sha1加密byte[] digest = md.digest(content.toString().getBytes());tmpStr = byteToStr(digest);} catch (NoSuchAlgorithmException e) {e.printStackTrace();}content = null;// 将sha1加密后的字符串可与signature对比，标识该请求来源于微信return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;}/*** 将字节数组转换为十六进制字符串* * @param byteArray* @return*/private static String byteToStr(byte[] byteArray) {String strDigest = "";for (int i = 0; i < byteArray.length; i++) {strDigest += byteToHexStr(byteArray[i]);}return strDigest;}/*** 将字节转换为十六进制字符串* * @param mByte* @return*/private static String byteToHexStr(byte mByte) {char[] Digit = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };char[] tempArr = new char[2];tempArr[0] = Digit[(mByte >>> 4) & 0X0F];tempArr[1] = Digit[mByte & 0X0F];String s = new String(tempArr);return s;}
}

这里唯一需要注意的就是SignUtil类中的成员变量token，这里赋予什么值，在接口配置信息中的Token就要填写什么值，两边保持一致即可，没有其他要求，建议用项目名称、公司名称缩写等，我在这里用的是项目名称weixinCourse。

最后再来看一下web.xml中，CoreServlet是怎么配置的，web.xml中的配置代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"><servlet><servlet-name>coreServlet</servlet-name><servlet-class>org.liufeng.course.servlet.CoreServlet</servlet-class></servlet><!-- url-pattern中配置的/coreServlet用于指定该Servlet的访问路径 --><servlet-mapping><servlet-name>coreServlet</servlet-name><url-pattern>/coreServlet</url-pattern></servlet-mapping><welcome-file-list><welcome-file>index.jsp</welcome-file></welcome-file-list>
</web-app>

到这里，所有编码都完成了，就是这么简单。接下来就是将工程发布到公网服务器上，如果没有公网服务器环境，可以去了解下BAE、SAE或阿里云。发布到服务器上后，我们在浏览器里访问CoreServlet，如果看到如下界面就表示我们的代码没有问题：

啊，代码都报空指针异常了还说证明没问题？那当然了，因为直接在地址栏访问coreServlet，就相当于提交的是GET请求，而我们什么参数都没有传，在验证的时候当然会报空指针异常。

接下来，把coreServlet的访问路径拷贝下来，再回到微信公众平台的接入配置信息界面，将coreServlet的访问路径粘贴到URL中，并将SignUtil类中指定的token值weixinCourse填入到Token中，填写后的结果如下图所示：

我在写这篇教程的时候是使用的BAE环境，如果想学习微信公众帐号开发又没有公网服务器环境的，建议可以试试，注册使用都很方便，如果有问题我们还可以交流。

接着点击“提交”，如果程序写的没问题，并且URL、Token都填写正确，可以在页面最上方看到“提交成功”的提示，并会再次跳转到开发模式设置界面，而且能够看到“你已成为开发者”的提示，如下图所示：

启用开发模式（下）

这个时候就已经成为开发者了，百般周折啊，哈哈，到这里还没有完哦，还有最后一步工作就是将开发模式开启。将右上角的开发模式开关由“关闭”切换到“开启”，如下图所示：

到这里，接口配置、开发模式的开启就都完成了，本章节的内容也就讲到这里。接下来要章节要讲的就是如何接收、处理、响应由微信服务器转发的用户发送给公众帐号的消息，也就是完成CoreServlet中doPost方法的编写。

如果觉得文章对你有所帮助，请留言支持或关注微信公众帐号xiaoqrobot支持柳峰哦！

[027] 微信公众帐号开发教程第3篇-开发模式启用及接口配置相关推荐

微信公众帐号开发教程第1篇-引言（转）
接触微信公众帐号已经有两个多月的时间了,在这期间,除了陆续完好个人公众帐号xiaoqrobot以外,还带领团队为公司开发了两个企业应用:一个是普通类型的公众帐号,还有一个是会议类型的公众帐号.经过这3 ...
微信公众帐号开发教程第6篇-消息及消息处理工具的封装
本篇内容主要讲解如何将微信公众平台定义的消息及消息相关的操作封装成工具类,方面后期的使用官方文档接下来要做的就是将消息请求.回复中定义的消息进行封装,建立与之对应的Java类(Java是一门面向 ...
[041] 微信公众帐号开发教程第17篇-应用实例之智能翻译
内容概要本篇文章为大家演示怎样在微信公众帐号上实现"智能翻译",本例中翻译功能是通过调用"百度翻译API"实现的.智能翻译是指用户随意输入想要翻译的内容(单词 ...
微信公众帐号开发教程第16篇-应用实例之历史上的今天
内容概要本篇文章主要讲解如何在微信公众帐号上实现"历史上的今天"功能.这个例子本身并不复杂,但希望通过对它的学习,读者能够对正则表达式有一个新的认识,能够学会运用现有的网络资源丰 ...
微信公众帐号开发教程第13篇-图文消息全攻略
引言及内容概要已经有几位读者抱怨"柳峰只用到文本消息作为示例,从来不提图文消息,都不知道图文消息该如何使用",好吧,我错了,原本以为把基础API封装完.框架搭建好,再给出一个文本 ...
微信公众帐号开发教程第12篇-符号表情的发送（下）
引言及文章概要第11篇文章给出了Unified版本的符号表情(emoji表情)代码表,并且介绍了如何在微信公众帐号开发模式下发送emoji表情,还在文章结尾出,卖了个关子:"小q机器人中使 ...
微信公众帐号开发教程第11篇-符号表情的发送（上）
题外话(可以略过) 相信这篇文章已经让大家等的太久了,不是我故弄玄虚.吊大家胃口,而是写一篇文章真的需要花太多的时间.也许一篇文章,你们花3-5分钟就看完了.就学会掌握了,而我却要花2-3个小时的时间 ...
[11] 微信公众帐号开发教程第11篇-符号表情的发送（上）
题外话(可以略过) 相信这篇文章已经让大家等的太久了,不是我故弄玄虚.吊大家胃口,而是写一篇文章真的需要花太多的时间.也许一篇文章,你们花3-5分钟就看完了.就学会掌握了,而我却要花2-3个小时的时间 ...
[036] 微信公众帐号开发教程第12篇-符号表情的发送（下）
引言及文章概要第11篇文章给出了Unified版本的符号表情(emoji表情)代码表,并且介绍了如何在微信公众帐号开发模式下发送emoji表情,还在文章结尾出,卖了个关子:"小q机器人中使 ...

[027] 微信公众帐号开发教程第3篇-开发模式启用及接口配置

[027] 微信公众帐号开发教程第3篇-开发模式启用及接口配置相关推荐

最新文章

热门文章