微信开发 之 开启开发模式
.
作者 : 万境绝尘
转载请注明出处 : http://blog.csdn.net/shulianghan/article/details/20494177
.
GitHub源码位置 :
-- HTTP : https://github.com/han1202012/WeChatVerify.git
-- SSH : git@github.com:han1202012/WeChatVerify.git
CSDN下载认证程序的war包和源码 : http://download.csdn.net/detail/han1202012/6999207
微信验证war包下载 :
-- 访问地址 : ip地址:80/WeChatVerify/verifyServlet ;
-- Token : 注意Token是 "hanshuliang" ;
一. 开启开发模式解析
1. 开发者文档
首先进入编辑模式, 将编辑模式关闭, 进入开发模式 :
点击查看文档, 就可以打开微信的开发者文档 : 路线 功能 -> 高级功能 -> 开发模式 -> 查看文档 ;
开发者文档目录结构说明 :
-- 新手接入 : 包括 接入指南 典型案例介绍 开发者规范, 讲解如何接入开发者模;
-- 基础支持 : 包括 获取access_token 全局返回码说明 接口频率限制说明 上传下载多媒体文件;
-- 接收消息 : 包括 验证消息真实性 接收普通消息 接收事件推送 接收语音识别结果;
-- 发送消息 : 包括 发送被动响应消息 发送客服消息;
-- 用户管理 : 包括 分组管理接口 获取用户基本信息 获取关注者列表 获取用户地理位置 网页授权用户基本信息 网页获取用户网络状态;
-- 自定义菜单 : 包括 自定义菜单创建接口 自定义菜单查询接口 自定义菜单删除接口 自定义菜单事件推送;
-- 推广支持 : 包括 生成带参数的二维码 ;
-- 微信 JS接口 : 包括 隐藏微信中网页右上角的按钮 隐藏微信中网页底部的导航栏 网页获取用户网络状态;
-- 开发者交流互助 : 包括 开发者问答系统 接口调试工具 接口体验测试号申请;
2. 开发者校验流程解析
(1)申请消息接口
点击开发模式 "成为开发者" 按钮之后, 会弹出协议 :
之后会弹出填写 URL 和 Token :
-- URL : 用来接收微信服务器数据的接口URL;
-- Token : 任意填写, 用于生成签名;
(2) 验证URL有效性
校验流程 : 程序必须能够处理HTTP GET请求, 并对请求者身份进行校验, 确保请求来自微信服务器;
-- 获取参数 : HTTP GET 会携带四个参数 signature timestamp nonce echostr;
-- 拼装参数 : 将排序后的三个参数按照字典顺序排成字符串;
-- 加密参数 : 将排序后的字符串进行sha1加密;
-- 返回结果 : 将加密后的字符串 与 signature 参数对比, 如果相等则说明请求来自微信服务器, 原样返回参数 echostr;
二. 开发校验程序
1. 要点解析
(1) 在servlet中获取四个参数
获取方法 : 在doGet()方法中, 直接调用request的getParameter("signature")方法, 即可获取signature参数;
-- 示例 :
//获取微信服务器发送给我们的四个参数
String signature = req.getParameter("signature");
String timestamp = req.getParameter("timestamp");
String nonce = req.getParameter("nonce");
String echostr = req.getParameter("echostr");(2) 将参数按照字典顺序排序
排序方法 : 数组工具类 Arrays.sort()会自动将数组中的字符串按照字典循序排序;
-- 代码示例 :
//将token timestamp nonce 按照字典顺序排序
String[] params = new String[]{token, timestamp, nonce};
Arrays.sort(params);
//将上面三个参数排序之后拼接成字符串
StringBuffer buffer = new StringBuffer();
for(int i = 0; i < params.length; i ++){
buffer.append(params[i]);
}(3) sha1 加密
获取MessageDigest加密类 : 通过调用 MessageDigest.getInstance("SHA-1"), 即可获取sha1加密类;
-- 代码示例 :
//获取sha1加密对象
MessageDigest digest = MessageDigest.getInstance("SHA-1");
//将组合后的字符串使用sha1加密, 加密后获得一个byte数组
byte[] byteDigest = digest.digest(buffer.toString().getBytes());(4) byte数组转为字符串
byte转为char类型 :
-- 示例代码 :
/*
* 将byte转为字符串
*/
public static String byte2HexStr(byte b) {
char[] digit = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
char[] temp = new char[2];
temp[0] = digit[(b >>> 4) & 0x0F];
temp[1] = digit[b & 0x0F];
String s = new String(temp);
return s;
}byte数组转为字符串 : 需要调用上面的类;
-- 示例代码 :
/*
* 将byte数组转为字符串
*/
public static String byte2str(byte[] byteArray) {
String str = "";
for(int i = 0; i < byteArray.length; i ++){
str += byte2HexStr(byteArray[i]);
}
return str;
}(5) 向微信服务器发送信息
发送信息 : 先获取输出流, 然后校验, 如果通过校验就向微信服务器发送信息;
-- 示例代码 :
//创建一个出处流, 用于向微信服务器发送数据
PrintWriter out = resp.getWriter();
//如果校验通过, 向微信服务器发送echostr参数
if(VerifyUtils.checkSignature(signature, timestamp, nonce)){
out.print(echostr);
}
//释放资源
out.close();
out = null;.
2. 程序源码
GitHub源码位置 :
-- HTTP : https://github.com/han1202012/WeChatVerify.git
-- SSH : git@github.com:han1202012/WeChatVerify.git
CSDN下载认证程序的war包和源码 : http://download.csdn.net/detail/han1202012/6999207
微信验证war包下载 :
-- 访问地址 : ip地址:80/WeChatVerify/verifyServlet ;
-- Token : 注意Token是 "hanshuliang" ;
程序结构 :
Servlet源码 :
package shuliang.han.vertify.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 shuliang.han.vertify.VerifyUtils;
public class VerifyServlet extends HttpServlet {
private static final long serialVersionUID = 4440739483644L;
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
//获取微信服务器发送给我们的四个参数
String signature = req.getParameter("signature");
String timestamp = req.getParameter("timestamp");
String nonce = req.getParameter("nonce");
String echostr = req.getParameter("echostr");
//创建一个出处流, 用于向微信服务器发送数据
PrintWriter out = resp.getWriter();
//如果校验通过, 向微信服务器发送echostr参数
if(VerifyUtils.checkSignature(signature, timestamp, nonce)){
out.print(echostr);
}
//释放资源
out.close();
out = null;
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
//注意这里不能有任何操作, 否则不能完成验证
}
}
验证工具类源码 :
package shuliang.han.vertify;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
public class VerifyUtils {
private final static String token = "hanshuliang";
public static boolean checkSignature(String signature, String timestamp, String nonce) {
//将token timestamp nonce 按照字典顺序排序
String[] params = new String[]{token, timestamp, nonce};
Arrays.sort(params);
//将上面三个参数排序之后拼接成字符串
StringBuffer buffer = new StringBuffer();
for(int i = 0; i < params.length; i ++){
buffer.append(params[i]);
}
//str用于存储加密后的字符串
String str = null;
try {
//获取sha1加密对象
MessageDigest digest = MessageDigest.getInstance("SHA-1");
//将组合后的字符串使用sha1加密, 加密后获得一个byte数组
byte[] byteDigest = digest.digest(buffer.toString().getBytes());
//获取加密后的字符串, 将byte数组转化为字符串
str = byte2str(byteDigest);
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
/*
* 将加密后的字符串 与 signature 参数进行比较,
* 如果加密后的字符串为null直接返回false
* 如果加密后的字符串不为null, 直接返回
*/
boolean isVerified = (str != null) ? str.equals(signature.toUpperCase()) : false;
return isVerified;
}
/*
* 将byte数组转为字符串
*/
public static String byte2str(byte[] byteArray) {
String str = "";
for(int i = 0; i < byteArray.length; i ++){
str += byte2HexStr(byteArray[i]);
}
return str;
}
/*
* 将byte转为字符串
*/
public static String byte2HexStr(byte b) {
char[] digit = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
char[] temp = new char[2];
temp[0] = digit[(b >>> 4) & 0x0F];
temp[1] = digit[b & 0x0F];
String s = new String(temp);
return s;
}
}
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>verifyServlet</servlet-name>
<servlet-class>shuliang.han.vertify.servlet.VerifyServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>verifyServlet</servlet-name>
<url-pattern>/verifyServlet</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
三. 进行校验
1.部署程序
(1) 导出war包
(2) 将war包上传到服务器
(3) 配置Tomcat的server.xml文件
微信服务器只能接受80端口数据 :
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />2. 使用阿里云服务器
将上面的程序导出的war包, 放到阿里云Tomcat服务器下 : 使用 http://hanshuliang.com:8080/WeChatVerify/verifyServlet 登陆;
-- 结果 : 这是正常情况, 因为在POST中没有添加参数;
HTTP Status 500 -
type Exception report
message
description The server encountered an internal error () that prevented it from fulfilling this request.
exception
java.lang.NullPointerException java.lang.String.compareTo(String.java:1168) java.lang.String.compareTo(String.java:92) java.util.Arrays.mergeSort(Arrays.java:1144) java.util.Arrays.sort(Arrays.java:1079) shuliang.han.vertify.VerifyUtils.checkSignature(VerifyUtils.java:13) shuliang.han.vertify.servlet.VerifyServlet.doGet(VerifyServlet.java:28) javax.servlet.http.HttpServlet.service(HttpServlet.java:617) javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
note The full stack trace of the root cause is available in the Apache Tomcat/6.0.20 logs.
Apache Tomcat/6.0.20
不支持8080端口, 只支持80端口, 我的服务器上跑着ngix服务器, 独立域名博客在上面那 : 郁闷 ...
2. 开始校验
原来的Ngix服务器中80端口是独立域名博客, 现在讲独立域名博客指到 8086端口中 : 现在独立域名博客可以从 http://hanshuliang.com:8086/ 访问;
将Tomcat设置成80端口, 气死我了 ;
终于成功了 : 哭死了, 调试了好长时间啊, 终于通过了;
接口功能不全, 只有基础接口的权限 ...
GitHub源码位置 :
-- HTTP : https://github.com/han1202012/WeChatVerify.git
-- SSH : git@github.com:han1202012/WeChatVerify.git
CSDN下载认证程序的war包和源码 : http://download.csdn.net/detail/han1202012/6999207
微信验证war包下载 :
-- 访问地址 : ip地址:80/WeChatVerify/verifyServlet ;
-- Token : 注意Token是 "hanshuliang" ;
.
作者 : 万境绝尘
转载请注明出处 : http://blog.csdn.net/shulianghan/article/details/20494177
.
