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