一、开发前知识
1、微信开放平台与微信公众平台的区别
1.1 微信公众平台:
① 地址:https://mp.weixin.qq.com/cgi-bin/loginpage?t=wxm2-login&lang=zh_CN
② 微信公众平台面向的是普通的用户,比如自媒体和媒体,企业官方微信公众账号运营人员使用,当然你所在的团队或者公司有实力去开发一些内容,也可以调用公众平台里面的接口,比如自定义菜单,自动回复,查询功能。
1.2 微信开放平台:
① 地址:https://open.weixin.qq.com/
微信开放平台:面向的是开发者和第三方独立软件开发商。开放平台的文档似乎包含了微信开放平台文档里面的接口。
2、微信公众平台目前只支持80端口,且项目上传到服务器上面不容易debug啊?
解决方法:ngrok 工具,可以根据本地项目映射成外网可以访问的地址、端口,默认映射为80端口。
官网: https://dashboard.ngrok.com
存在问题: 每次重启,域名会变化,都需要项目中、微信公众平台配置,付费可以固定域名。。。
使用方法: ① 注册后获得一个授权码,下载 ngrok
② 》CMD 进入 ngrok 目录
》ngrok authtoken 授权码
》ngrok http 8080
③看到这个页面,ngrok就为你分配了临时访问通道成功了^^
二、配置
(每个微信号可以申请成为开发者测试账号进行微信功能开发的。)
1、在公众平台中进行配置:
地址: http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
①:配置“接口配置信息” (Token 在项目中我是配置为"handsomeKing",没错,我就是King ^^)
url 改为自己映射的域名
② 配置“功能服务” 的 “网页帐号”。注意,是域名
好了,可以愉快的coding 了!!!
三、可以开发啦
1、上面的 “接口配置信息” 配置得 wechat/ownerCheck 方法是验证 这个url 为我自己的,handsomeKing 就是这个方法中的一个参数。微信这个小朋友会用Get方法带上4个参数给我服务器: signature(签名)、timestamp(时间戳)、nonce(随机数)、echostr(随机字符串),再加上咱们项目中自己配置的 token ,通过检验signature对请求进行校验,若校验成功则原样返回echostr,表示接入成功,否则接入失败:(talk is cheap, show me the code *&)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
/**
* 微信消息接收和token验证
* @param model
* @param request
* @param response
* @throws IOException
*/
@RequestMapping
(
"/ownerCheck"
)
public
void
ownerCheck(Model model, HttpServletRequest request,HttpServletResponse response)
throws
IOException {
System.out.println(
111
);
boolean
isGet = request.getMethod().toLowerCase().equals(
"get"
);
PrintWriter print;
if
(isGet) {
// 微信加密签名
String signature = request.getParameter(
"signature"
);
// 时间戳
String timestamp = request.getParameter(
"timestamp"
);
// 随机数
String nonce = request.getParameter(
"nonce"
);
// 随机字符串
String echostr = request.getParameter(
"echostr"
);
// 通过检验signature对请求进行校验,若校验成功则原样返回echostr,表示接入成功,否则接入失败
if
(signature !=
null
&& CheckoutUtil.checkSignature(signature, timestamp, nonce)) {
try
{
print = response.getWriter();
print.write(echostr);
print.flush();
}
catch
(IOException e) {
e.printStackTrace();
}
}
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
import
java.security.MessageDigest;
import
java.security.NoSuchAlgorithmException;
public
class
CheckoutUtil {
// 与接口配置信息中的Token要一致
private
static
String token =
"handsomeKing"
;
/**
* 验证签名
*
* @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);
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;
}
public
static
void
sort(String a[]) {
for
(
int
i =
0
; i < a.length -
1
; i++) {
for
(
int
j = i +
1
; j < a.length; j++) {
if
(a[j].compareTo(a[i]) <
0
) {
String temp = a[i];
a[i] = a[j];
a[j] = temp;
}
}
}
}
}
|
2、用户用户同意授权,获取微信服务器传过来的俩参数: code、state。其中:
APPID: 微信开发者测试账号
REDIRECT_URI: 同意授权后跳转的 URL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
/**
* 第一步:用户同意授权,获取code(引导关注者打开如下页面:)
* 获取 code、state
*/
public
static
String getStartURLToGetCode() {
String takenUrl =
"https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect"
;
takenUrl= takenUrl.replace(
"APPID"
, Param.APPID);
takenUrl= takenUrl.replace(
"REDIRECT_URI"
, URL.encode(Param.REDIRECT_URI));
//FIXME : snsapi_userinfo
takenUrl= takenUrl.replace(
"SCOPE"
,
"snsapi_userinfo"
);
System.out.println(takenUrl);
return
takenUrl;
}
|
3、获取微信用户的 access_token、openid
APPID:微信开发者测试账号
secret:微信开发者测试账号密码
code::上一步的 code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
/**
* 获取access_token、openid
* 第二步:通过code获取access_token
* @param code url = "https://api.weixin.qq.com/sns/oauth2/access_token
* ?appid=APPID
* &secret=SECRET
* &code=CODE
* &grant_type=authorization_code"
* */
public
static
OAuthInfo getAccess_token(String code){
String authUrl =
"https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code "
;
authUrl= authUrl.replace(
"APPID"
, Param.APPID);
authUrl = authUrl.replace(
"SECRET"
, Param.SECRET);
authUrl = authUrl.replace(
"CODE"
, code);
String jsonString = HTTPRequestUtil.sendPost(authUrl,
""
);
System.out.println(
"jsonString: "
+ jsonString);
OAuthInfo auth =
null
;
try
{
auth = (OAuthInfo) JacksonUtil.parseJSONToObject(OAuthInfo.
class
, jsonString);
}
catch
(Exception e) {
e.printStackTrace();
}
return
auth;
}
|
4、在数据库中查询 openid
我是定义了一个对象 OauthInfo,包括 openid(用户的标识)属性。。。
查询时库中存在就直接登录啦,不存在就先去登录页,将登录账号同 openid 绑定。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
/**
* 微信引导页进入的方法
* @return
*/
@RequestMapping
(
"/loginByWeiXin"
)
public
String loginByWeiXin(HttpServletRequest request, Map<String, Object> map) {
// 微信接口自带 2 个参数
String code = request.getParameter(
"code"
);
String state = request.getParameter(
"state"
);
System.out.println(
"code = "
+ code +
", state = "
+ state);
if
(code !=
null
&& !
""
.equals(code)) {
// 授权成功, 微信获取用户openID
OAuthInfo authInfo = WeiXinUtil.getAccess_token(code);
String openid = authInfo.getOpenid();
String access_token = authInfo.getAccess_token();
if
(access_token ==
null
) {
// Code 使用过 异常
System.out.println(
"Code 使用过 异常....."
);
return
"redirect:"
+ WeiXinUtil.getStartURLToGetCode();
}
// 数据库中查询微信号是否绑定平台账号
SysUser sysUser = weiXinService.getUserByWeiXinID(openid);
if
(sysUser ==
null
) {
String randomStr = StringUtil.getRandomString(
50
);
request.getSession().setAttribute(openid, randomStr);
// 尚未绑定账号
System.out.println(
"尚未绑定账号....."
);
return
"redirect:/index.jsp?openid="
+ openid +
"&state="
+ randomStr;
}
userController.doSomeLoginWorkToHomePage(sysUser.getMcid(), map);
// 登录成功
return
"homePage"
;
}
// 未授权
return
"redirect:"
+ WeiXinUtil.getStartURLToGetCode();
}
|
四、踩过的坑
1、access_token 与普通 access_token。这尼玛是啥关系?
答:access_token: 登录授权会得到一个 access_token, 这个是用于标识登录用户(没有使用次数限制),绑定流程中用的都是 登录 access_token。
普通 access_token: 调用其它微信应用接口时需要带上的 access_token,普通 access_token时效为 2H, 每个应用每天调用次数<= 2000次。(实际开发时必须加以处理。。我采用的是 quartz 调度^^)
2、uuid、openid。我该绑定uuid?不不不,openid?不不,到底绑哪个?
答:uuid:微信号绑定后才有的标识,对于任何应用该微信账号的 uuid 均相同。同一个微信账号不同的应用 uuid 相同。
openid:微信号对于每个应用均有一个不变的 openid,同一个微信账号不同的应用 openid 不同。