微信公眾號平台開發(一)如何與微信后台對接
BAT一直以來是許多程序猿的奮斗目標,但如果有幸能夠進入其中學習卻連自家的平台API都沒辦法調用,那就有點說不過去了。因此,我這段時間一直在學習JAVA微信之間的對接開發,也從中看到了BAT的嚴謹之處。
(一)准備
最好的參考工具(官方文檔):公眾平台開發者文檔
參考博客:souvc的博客
測試接口:微信公眾號平台接口測試
jdk:1.8
IDE:IDEA
服務器:騰訊雲(對學生有較大優惠)
(二)接入流程
通過閱讀官方文檔,可以得知若要接入微信公眾號平台開發,開發者需要按照以下三步流程:
1. 填寫服務器配置
2. 驗證服務器地址的有效性
3. 依據接口文檔來實現業務邏輯
(三)驗證服務器的代碼編寫
我們的應用服務器要接受微信服務器的get請求,其中包括四個參數(signature、timestamp、nonce、echostr),開發者通過檢驗signature對請求進行校驗(下面有校驗方式)。若確認此次GET請求來自微信服務器,請原樣返回echostr參數內容,則接入生效,成為開發者成功,否則接入失敗。
注意:具體內容含義可以通過閱讀官方文檔得知!
由官方文檔,我們可知加密/校驗流程如下:
- 將token、timestamp、nonce三個參數進行字典序排序
- 將三個參數字符串拼接成一個字符串進行SHA1加密(SHA1加密在接下來的開發,有興趣的話可以去了解一下)
- 開發者獲得加密后的字符串可與signature對比,標識該請求來源於微信
ps:微信提供了一份php示例代碼,有興趣的可以了解一下
接下來,我將前兩個步驟合為一個工具類去實現。廢話不多說,我們直接上代碼。
/** * SignUtil * 驗證 signature 工具類 * Created by zggdczfr on 2016/10/21. */ public class SignUtil { //與接口配置信息中的ToKen一致 private static String token = ""; //該Token值為自己定義 public static boolean checkSignature(String signature, String timestamp,String nonce){ // 1. 將token、timestamp、nonce三個參數進行字典序排序 String[] arr = new String[] { token, timestamp, nonce }; Arrays.sort(arr); // 2. 將三個參數字符串拼接成一個字符串進行sha1加密 StringBuilder content = new StringBuilder(); for(int i=0; i<arr.length; i++){ content.append(arr[i]); } MessageDigest messageDigest = null; String tmpStr = null; try { // 將三個參數字符串拼接成一個字符串進行sha1加密 messageDigest = MessageDigest.getInstance("SHA-1"); byte[] digest = messageDigest.digest(content.toString().getBytes()); tmpStr = byteToStr(digest); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } content = null; // 3. 將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; } }
接下來是實現第三步,這里需要注意的一點是:微信提過get方法來驗證身份,通過post方法來實現信息的傳遞,也就是說以后的業務邏輯實現都將通過這里配置的鏈接來對接。
/** * Created by zggdczfr on 2016/10/21. */ @Controller @RequestMapping(value = "/wechat") public class SecurityController { private static final long serialVersionUID = 4323197796926899691L; private static final Logger LOGGER = Logger.getLogger(SecurityController.class); @RequestMapping("test") public String test(){ System.out.println("test"); return "/index.jsp"; } @RequestMapping(value = "security", method = RequestMethod.GET) public void WetChatGet(HttpServletRequest request, HttpServletResponse response, @RequestParam(value = "signature", required = true) String signature, @RequestParam(value = "timestamp", required = true) String timestamp, @RequestParam(value = "nonce", required = true) String nonce, @RequestParam(value = "echostr", required = true) String echostr) throws IOException { try { // 通過檢驗signature對請求進行校驗,若校驗成功則原樣返回echostr,表示接入成功,否則接入失敗 if (SignUtil.checkSignature(signature, timestamp, nonce)) { PrintWriter out = response.getWriter(); out.print(echostr); out.close(); } } catch (Exception e){ LOGGER.log(Level.ERROR, "連接微信公眾號平台測試失敗!"); } System.out.println("連接微信公眾號平台測試成功!"); } @RequestMapping(value = "security", method = RequestMethod.POST) public void WetChatPost(HttpServletRequest request, HttpServletResponse response){ //業務邏輯處理 } }
(四)服務器驗證
接下來就是將我們的代碼打包部署到服務器上來,通過測試接口來進行對接。
測試結果:
(五)最后的不知道什么鬼
- 微信服務器驗證身份是通過固定的端口80。若沒有配置域名的服務器(虛擬機),切記在外網ip后不必接上端口號。(ps:也許是我自己的基礎不夠扎實,在這個坑里面蹲了好久…………最后居然被我試出來了。。。)
- 這里采用的是springMVC框架,關於該框架的配置網上有許多教程可以學習。或者等我什么時候有時間了,也來寫一寫我對於該框架的了解。