編輯模式與開發模式
微信公衆帳號申請成功後,要想接收處理用戶的請求,就必須要在“高級功能”裏進行配置,點擊“高級功能”,將看到如下界面:
從上圖中可以看到,高級功能包含兩種模式:編輯模式和開發模式,並且這兩種模式是互斥關係,即兩種模式不能同時開啓。那兩種模式有什麼區別呢?作爲開發人員到底要開啓哪一種呢?
編輯模式:主要針對非編程人員及信息發佈類公衆帳號使用。開啓該模式後,可以方便地通過界面配置“自定義菜單”和“自動回覆的消息”。
開發模式:主要針對具備開發能力的人使用。開啓該模式後,能夠使用微信公衆平臺開放的接口,通過編程方式實現自定義菜單的創建、用戶消息的接收/處理/響應。這種模式更加靈活,建議有開發能力的公司或個人都採用該模式。
啓用開發模式(上)
微信公衆帳號註冊完成後,默認開啓的是編輯模式。那麼該如何開啓開發模式呢?操作步驟如下:
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方法中調用了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;
- }
- }
最後再來看一下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>
啊,代碼都報空指針異常了還說證明沒問題?那當然了,因爲直接在地址欄訪問coreServlet,就相當於提交的是GET請求,而我們什麼參數都沒有傳,在驗證的時候當然會報空指針異常。
接下來,把coreServlet的訪問路徑拷貝下來,再回到微信公衆平臺的接入配置信息界面,將coreServlet的訪問路徑粘貼到URL中,並將SignUtil類中指定的token值weixinCourse填入到Token中,填寫後的結果如下圖所示:
我在寫這篇教程的時候是使用的BAE環境,如果想學習微信公衆帳號開發又沒有公網服務器環境的,建議可以試試,註冊使用都很方便,如果有問題我們還可以交流。
接着點擊“提交”,如果程序寫的沒問題,並且URL、Token都填寫正確,可以在頁面最上方看到“提交成功”的提示,並會再次跳轉到開發模式設置界面,而且能夠看到“你已成爲開發者”的提示,如下圖所示:
啓用開發模式(下)
這個時候就已經成爲開發者了,百般周折啊,哈哈,到這裏還沒有完哦,還有最後一步工作就是將開發模式開啓。將右上角的開發模式開關由“關閉”切換到“開啓”,如下圖所示:
到這裏,接口配置、開發模式的開啓就都完成了,本章節的內容也就講到這裏。接下來要章節要講的就是如何接收、處理、響應由微信服務器轉發的用戶發送給公衆帳號的消息,也就是完成CoreServlet中doPost方法的編寫。
如果覺得文章對你有所幫助,請留言支持或關注原作者微信公衆帳號xiaoqrobot支持柳峯哦!