QQ互聯登陸(Java)

一、准備部分

1、賬戶注冊

騰訊開放平台網址: https://connect.qq.com/index.html

首先需要到開放平台注冊QQ互聯開發者身份。注冊之后創建一個網站應用，注意，需要備案成功的域名才可申請。

2、應用審核

審核通過后如下圖所示，審核通過后可以得到 appid 和 appkey，用於開發中使用。

二、實現思路

相信大家都用過QQ登陸第三方網站，但是在開發之前我們需要先了解一下QQ互聯的開發流程：

1. 生成QQ授權鏈接
2. 獲取授權碼，使用授權碼獲取用戶的openid
3. 使用openid可以查詢到用戶信息

openid作用：相當於QQ用戶的 userid，身份唯一標識。

看完這三步是不是覺得很熟悉？沒錯，跟微信一個路子，畢竟都是 OAuth協議嘛。如果還不是特別清楚的小伙伴可以去看官方文檔：騰訊開放平台文檔 —http://wiki.connect.qq.com/

為了方便開發，我們再整理一下代碼實現思路：

1. 編寫授權鏈接接口
2. 編寫授權回調接口，拿到用戶openid
   -- 獲取到授權碼；
   -- 使用授權碼獲取accessToken；
   -- 使用accessToken獲取用戶openid。
3. 使用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

我創建了一個java相關的公眾號，用來記錄自己的學習之路，感興趣的小伙伴可以關注一下微信公眾號哈：niceyoo