一、前言

1. 微信公眾號(hào)開發(fā) (1) 微信接入認(rèn)證成為開發(fā)者
2. 微信公眾號(hào)開發(fā) (2) 消息處理
3. 微信公眾號(hào)開發(fā) (3) 菜單處理

本文將實(shí)現(xiàn)

1. 網(wǎng)頁(yè)授權(quán)
2. 獲取用戶基本信息

網(wǎng)頁(yè)授權(quán)流程

1. 填寫網(wǎng)頁(yè)授權(quán)回調(diào)域名
2. 引導(dǎo)用戶進(jìn)入授權(quán)頁(yè)面同意授權(quán)，獲取code
3. 通過(guò)code 換 取網(wǎng)頁(yè)授權(quán)access_token 和 openid （注：與基礎(chǔ)支持中的access_token不同）
4. 刷新網(wǎng)頁(yè)授權(quán)access_token，避免過(guò)期（可選擇性操作）
5. 通過(guò)網(wǎng)頁(yè)授權(quán)access_token和openid獲取用戶基本信息（支持UnionID機(jī)制）

二、填寫網(wǎng)頁(yè)授權(quán)回調(diào)域名

測(cè)試號(hào)在如下地址中，體驗(yàn)接口權(quán)限表 -> 網(wǎng)頁(yè)帳號(hào) -> 修改
http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index

在這里插入圖片描述

在這里插入圖片描述

三、授權(quán)相關(guān)接口

溫馨小提示：接口相關(guān)參數(shù)說(shuō)明可直接查看微信官方文檔 https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html

1、用戶授權(quán)頁(yè)面

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

2、通過(guò)code換取網(wǎng)頁(yè)授權(quán)access_token和openid

【GET請(qǐng)求】https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

3、刷新access_token（如果需要）

【GET請(qǐng)求】https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

4、獲取用戶信息(需scope為 snsapi_userinfo)

【GET請(qǐng)求】https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

5、檢驗(yàn)授權(quán)憑證（access_token）是否有效

【GET請(qǐng)求】https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID

注：下面部分只貼出了重要代碼部分，完整案例可參考文末提供的源碼

四、引導(dǎo)用戶進(jìn)入授權(quán)頁(yè)面同意授權(quán) -> 獲取code

方式①：通過(guò)創(chuàng)建鏈接式菜單(view)

在這里插入圖片描述

在這里插入圖片描述

方式②：直接發(fā)送授權(quán)url消息，用戶點(diǎn)擊進(jìn)入授權(quán)

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx62d91f5c16d6e8e0&redirect_uri=http://m9adhq.natappfree.cc/api/weixin/basic/getOpenId&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

在這里插入圖片描述

授權(quán)相關(guān)的幾個(gè)api接口如下：

在這里插入圖片描述

五、通過(guò)code換取網(wǎng)頁(yè)授權(quán)access_token和openid（與基礎(chǔ)支持中的access_token不同）

用戶同意授權(quán)后，頁(yè)面將跳轉(zhuǎn)至 redirect_uri/?code=CODE&state=STATE

code說(shuō)明 ： code作為換取access_token的票據(jù)，每次用戶授權(quán)帶上的code將不一樣，code只能使用一次，5分鐘未被使用自動(dòng)過(guò)期。

注：小編這里拿到access_token和openid之后將頁(yè)面重定向到了獲取用戶信息的接口，然后返回json用戶信息數(shù)據(jù)~

public void getOpenId(HttpServletRequest request, HttpServletResponse response) {
    String code = request.getParameter("code");
    String state = request.getParameter("state");

    log.debug("======================================= \n code值：" + code);

    String responseContent = restTemplate.getForObject(Constants.AUTH_GET_ACCESS_TOKEN_AND_OPENID
            .replace("APPID", Constants.APP_ID)
            .replace("SECRET", Constants.APP_SECRET)
            .replace("CODE", code), String.class);
    JSONObject result = JSON.parseObject(responseContent);
    String accessToken = result.getString("access_token");
    String openid = result.getString("openid");
    String refreshToken = result.getString("refresh_token");

    log.debug("======================================= \n access_token值：" + accessToken + "\n  openid值：" + openid);

    String redirectUrl = "http://m9adhq.natappfree.cc/api/weixin/basic/getUserInfo?openid=" + openid + "&access_token=" + accessToken;
    try {
        // 授權(quán)之后重定向到指定URL（這里是跳轉(zhuǎn)到獲取用戶基本信息接口）
        response.sendRedirect(redirectUrl);
    } catch (IOException e) {
        e.printStackTrace();
    }
}

六、獲取微信用戶基本信息

public WeixinUserInfoVO getUserInfo(String openId, String accessToken) {
    WeixinUserInfoVO weixinUserInfoVO = null;
    String responseContent = restTemplate.getForObject(Constants.AUTH_GET_USER_INFO
            .replace("ACCESS_TOKEN", accessToken)
            .replace("OPENID", openId), String.class);
    weixinUserInfoVO = JSON.parseObject(responseContent, WeixinUserInfoVO.class);
    return weixinUserInfoVO;
}

其中WeixinUserInfoVO基本信息類

@Data
@ApiModel(description = "微信用戶基本信息")
public class WeixinUserInfoVO {

    @ApiModelProperty(value = "用戶的唯一標(biāo)識(shí)")
    private String openid;

    @ApiModelProperty(value = "用戶昵稱")
    private String nickname;

    @ApiModelProperty(value = "用戶的性別，值為1時(shí)是男性，值為2時(shí)是女性，值為0時(shí)是未知")
    private Integer sex;

    @ApiModelProperty(value = "用戶個(gè)人資料填寫的省份")
    private String province;

    @ApiModelProperty(value = "普通用戶個(gè)人資料填寫的城市")
    private String city;

    @ApiModelProperty(value = "國(guó)家，如中國(guó)為CN")
    private String country;

    @ApiModelProperty(value = "用戶頭像，最后一個(gè)數(shù)值代表正方形頭像大?。ㄓ?、46、64、96、132數(shù)值可選，0代表640*640正方形頭像），用戶沒有頭像時(shí)該項(xiàng)為空。若用戶更換頭像，原有頭像URL將失效。")
    private String headimgurl;

    @ApiModelProperty(value = "用戶特權(quán)信息，json 數(shù)組，如微信沃卡用戶為（chinaunicom）")
    private String privilege;

    @ApiModelProperty(value = "只有在用戶將公眾號(hào)綁定到微信開放平臺(tái)帳號(hào)后，才會(huì)出現(xiàn)該字段。")
    private String unionid;

    @ApiModelProperty(value = "返回國(guó)家地區(qū)語(yǔ)言版本，zh_CN 簡(jiǎn)體，zh_TW 繁體，en 英語(yǔ)")
    private String language;

}

響應(yīng)數(shù)據(jù)如下：

在這里插入圖片描述

這里獲取到用戶信息之后，也就可以寫頁(yè)面，然后進(jìn)行自己的業(yè)務(wù)交互了... (openid：微信用戶的唯一標(biāo)識(shí))

七、刷新access_token（如果需要）

由于access_token擁有較短的有效期，當(dāng)access_token超時(shí)后，可以使用refresh_token進(jìn)行刷新，refresh_token有效期為30天，當(dāng)refresh_token失效之后，需要用戶重新授權(quán)。

public String refreshAccessToken(String appId, String refreshToken) {
    String responseResult = restTemplate.getForObject(Constants.AUTH_REFRESH_ACCESS_TOKEN
            .replace("APPID", appId)
            .replace("REFRESH_TOKEN", refreshToken), String.class);
    JSONObject jsonObject = JSON.parseObject(responseResult);
    return jsonObject.getString("access_token");
}

八、檢驗(yàn)授權(quán)憑證（access_token）是否有效

public WeixinResponseResult checkAccessToken(String openId, String accessToken) {
     String responseResult = restTemplate.getForObject(Constants.AUTH_CHECK_ACCESS_TOKEN
             .replace("ACCESS_TOKEN", accessToken)
             .replace("OPENID", openId), String.class);
     WeixinResponseResult weixinResponseResult = JSON.parseObject(responseResult, WeixinResponseResult.class);
     if (weixinResponseResult.getErrcode() != 0) {
         log.error("授權(quán)憑證無(wú)效：" + responseResult);
         throw new MyException(weixinResponseResult.getErrcode(), weixinResponseResult.getErrmsg());
     }
     return weixinResponseResult;
 }

九、總結(jié)

1. 微信公眾號(hào)開發(fā)網(wǎng)上有很多教程，但針對(duì)于每一個(gè)開發(fā)者的環(huán)境以及語(yǔ)言不同而有所差異，建議認(rèn)真看微信提供的官方文檔去學(xué)習(xí)，大致也就是查看文檔 封裝數(shù)據(jù) 調(diào)微信api接口 業(yè)務(wù)處理
2. 關(guān)于微信公眾號(hào)開發(fā)小編也已經(jīng)寫了幾篇了，大家在學(xué)習(xí)完微信官方提供的原始api之后，GitHub以及Gitee等上面有很多大神已經(jīng)封裝好了優(yōu)秀的開源sdk，這時(shí)候我們有了一定的微信開發(fā)基礎(chǔ)就可以去閱讀參考學(xué)習(xí)
3. 小編建議大家在學(xué)習(xí)遇到問(wèn)題，查看別人如何實(shí)現(xiàn)以及解決問(wèn)題的時(shí)候，更多的是去學(xué)習(xí)思維方式處理邏輯，而不是拿到就跑，雖然寫代碼也不過(guò)就是復(fù)制黏貼運(yùn)行完無(wú)bug就萬(wàn)事大吉，但我們也要 知其然知其所以然 ！

本文案例demo源碼

https://gitee.com/zhengqingya/java-workspace