一、準備部分
1、賬戶注冊
騰訊開放平台網址: https://connect.qq.com/index.html
首先需要到開放平台注冊QQ互聯開發者身份。注冊之後建立一個網站應用，注意，需要備案成功的域名才可申請。
2、應用稽核
稽核通過後如下圖所示，稽核通過後可以得到 appid 和 appkey，用于開發中使用。
二、實作思路
相信大家都用過QQ登陸第三方網站，但是在開發之前我們需要先了解一下QQ互聯的開發流程：
- 生成QQ授權連結
- 擷取授權碼，使用授權碼擷取使用者的openid
- 使用openid可以查詢到使用者資訊
openid作用：相當于QQ使用者的 userid，身份唯一辨別。
看完這三步是不是覺得很熟悉？沒錯，跟微信一個路子，畢竟都是 OAuth協定嘛。如果還不是特别清楚的小夥伴可以去看官方文檔：騰訊開放平台文檔 —http://wiki.connect.qq.com/
為了友善開發，我們再整理一下代碼實作思路：
- 編寫授權連結接口
-
編寫授權回調接口，拿到使用者openid
-- 擷取到授權碼；
-- 使用授權碼擷取accessToken；
-- 使用accessToken擷取使用者openid。
-
使用openid查詢資料庫user資訊表中是否有關聯
-- 如果使用openid能夠查詢使用者資訊，說明使用者已經綁定成功，自動實作登陸；’
-- 如果使用openid沒有查詢到使用者資訊的話，說明使用者沒有綁定賬資訊，跳轉到關聯賬号頁面；
-- 關聯成功賬号之後，将openid修改為對應的賬号資訊。
三、代碼部分
1、引入sdk
QQ互連提供了使用者開發的SDK，下載下傳連結：https://files.cnblogs.com/files/niceyoo/Sdk4J.zip
由于我們的項目大部分都是 maven 管理的，但提供的是個 jar 檔案，是以我們可以打入本地 maven 中：
mvn install:install-file -Dfile=jar包的位置(參數一) -DgroupId=groupId(參數二) -DartifactId=artifactId(參數三) -Dversion=version(參數四) -Dpackaging=jar
mvn install:install-file -Dfile="F:\Sdk4J.jar" -DgroupId=com.tengxun -DartifactId=sdk4j -Dversion=1.0 -Dpackaging=jar 複制
項目中引入依賴：
<dependency>
<groupId>com.tengxun</groupId>
<artifactId>sdk4j</artifactId>
<version>1.0</version>
</dependency> 複制
項目中引入配置檔案
app_ID = APP_ID
app_KEY = APP_KEY
redirect_URI = 回調位址
scope = get_user_info,add_topic,add_one_blog,add_album,upload_pic,list_album,add_share,check_page_fans,add_t,add_pic_t,del_t,get_repost_list,get_info,get_other_info,get_fanslist,get_idollist,add_idol,del_ido,get_tenpay_addr
baseURL = https://graph.qq.com/
getUserInfoURL = https://graph.qq.com/user/get_user_info
accessTokenURL = https://graph.qq.com/oauth2.0/token
authorizeURL = https://graph.qq.com/oauth2.0/authorize
getOpenIDURL = https://graph.qq.com/oauth2.0/me
addTopicURL = https://graph.qq.com/shuoshuo/add_topic
addBlogURL = https://graph.qq.com/blog/add_one_blog
addAlbumURL = https://graph.qq.com/photo/add_album
uploadPicURL = https://graph.qq.com/photo/upload_pic
listAlbumURL = https://graph.qq.com/photo/list_album
addShareURL = https://graph.qq.com/share/add_share
checkPageFansURL = https://graph.qq.com/user/check_page_fans
addTURL = https://graph.qq.com/t/add_t
addPicTURL = https://graph.qq.com/t/add_pic_t
delTURL = https://graph.qq.com/t/del_t
getWeiboUserInfoURL = https://graph.qq.com/user/get_info
getWeiboOtherUserInfoURL = https://graph.qq.com/user/get_other_info
getFansListURL = https://graph.qq.com/relation/get_fanslist
getIdolsListURL = https://graph.qq.com/relation/get_idollist
addIdolURL = https://graph.qq.com/relation/add_idol
delIdolURL = https://graph.qq.com/relation/del_idol
getTenpayAddrURL = https://graph.qq.com/cft_info/get_tenpay_addr
getRepostListURL = https://graph.qq.com/t/get_repost_list
version = 2.0.0.0 複制
2、生成QQ聯合登陸授權連結
https://graph.qq.com/oauth2.0/authorize?response_type=code&client_id=[YOUR_APPID]&redirect_uri=[YOUR_REDIRECT_URI]&state=[THE_STATE] 複制
接口以及參數詳細說明位址：https://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token#Step1.EF.BC.9A.E8.8E.B7.E5.8F.96AuthorizationCode
代碼實作：
/**
* 生成授權連結
*
* @param request
* @return
*/
@RequestMapping("/qqAuth")
public String qqAuth(HttpServletRequest request) {
try {
String authorizeURL = new Oauth().getAuthorizeURL(request);
log.info("authorizeURL:{}", authorizeURL);
return "redirect:" + authorizeURL;
} catch (Exception e) {
return ERROR_500_FTL;
}
} 複制
3、QQ授權回調
在上邊生成授權方法裡進行了一次重定向，重定向位址即為本方法。
private static final String MB_QQ_QQLOGIN = "member/qqlogin";
/**
* 重定向到首頁
*/
private static final String REDIRECT_INDEX = "redirect:/";
@RequestMapping("/qqLoginBack")
public String qqLoginBack(HttpServletRequest request, HttpServletResponse response, HttpSession httpSession) {
try {
AccessToken accessTokenObj = (new Oauth()).getAccessTokenByRequest(request);
if (accessTokenObj == null) {
return ERROR_500_FTL;
}
String accessToken = accessTokenObj.getAccessToken();
if (StringUtils.isEmpty(accessToken)) {
return ERROR_500_FTL;
}
/* 擷取使用者openid */
OpenID openIDObj = new OpenID(accessToken);
String openId = openIDObj.getUserOpenID();
if (StringUtils.isEmpty(openId)) {
return ERROR_500_FTL;
}
BaseResponse<JSONObject> findByOpenId = qqAuthoriFeign.findByOpenId(openId);
if (!isSuccess(findByOpenId)) {
return ERROR_500_FTL;
}
Integer resultCode = findByOpenId.getCode();
/* 如果使用openid沒有查詢到使用者資訊，則跳轉到綁定使用者資訊頁面 */
if (resultCode.equals(Constants.HTTP_RES_CODE_NOTUSER_203)) {
/* 使用openid擷取使用者資訊 */
UserInfo qzoneUserInfo = new UserInfo(accessToken, openId);
UserInfoBean userInfoBean = qzoneUserInfo.getUserInfo();
if (userInfoBean == null) {
return ERROR_500_FTL;
}
String avatarURL100 = userInfoBean.getAvatar().getAvatarURL100();
/* 傳回使用者頭像頁面展示 */
request.setAttribute("avatarURL100", avatarURL100);
httpSession.setAttribute(WebConstants.LOGIN_QQ_OPENID, openId);
return MB_QQ_QQLOGIN;
}
/* 自動實作登陸 */
JSONObject data = findByOpenId.getData();
String token = data.getString("token");
CookieUtils.setCookie(request, response, WebConstants.LOGIN_TOKEN_COOKIENAME, token);
return REDIRECT_INDEX;
} catch (Exception e) {
return ERROR_500_FTL;
}
} 複制
4、測試環節
通路生成授權連結的方法位址：
http://shop.sscai.club/qqAuth 複制
如果覺得這篇文章有丶東西，不妨訂閱一下 niceyoo 專欄。