前期準(zhǔn)備工作
1.云服務(wù)器
2.備案的域名
3.本地調(diào)試需要修改hosts文件，將域名映射到127.0.0.1
申請(qǐng)QQ互聯(lián)，并成為開發(fā)者
申請(qǐng)QQ互聯(lián)創(chuàng)建應(yīng)用時(shí)需要備案域名，所以建議提前準(zhǔn)備備案域名。
QQ互聯(lián)：https://connect.qq.com/index.html
登錄后，點(diǎn)擊頭像，進(jìn)入認(rèn)證頁(yè)面，填寫信息，等待審核。
審核通過(guò)后創(chuàng)建應(yīng)用
應(yīng)用創(chuàng)建通過(guò)審核后，就可以使用App ID 和 APP Key
前期工作就這些了，后面可以開始寫代碼了。
項(xiàng)目結(jié)構(gòu)：
properties或者yml配置文件（這里就是簡(jiǎn)單的配置了一下，可以自行添加數(shù)據(jù)庫(kù)等配置）
server.port=80server.servlet.context-path=/ #qq互聯(lián)qq.oauth.http:QQ互聯(lián)中申請(qǐng)?zhí)顚懙木W(wǎng)站地址
在pom中添加依賴
<!--httpclient--><dependency> <groupId>org.Apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.6</version></dependency><!--阿里 JSON--><dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.47</version></dependency>
發(fā)送QQ登錄請(qǐng)求
定義全局變量獲取配置文件中的網(wǎng)站地址
@Value("${qq.oauth.http}")private String http;
定義登錄回調(diào)地址（可以用網(wǎng)站地址拼接或者直接寫）
//QQ互聯(lián)中的回調(diào)地址String backUrl = http + "/index";
登錄請(qǐng)求方法代碼
@GetMapping("/qq/login")public String qq(HttpSession session) throws UnsupportedEncodingException { //QQ互聯(lián)中的回調(diào)地址 String backUrl = http + "/index"; //用于第三方應(yīng)用防止CSRF攻擊 String uuid = UUID.randomUUID().toString().replaceAll("-",""); session.setAttribute("state",uuid); //Step1：獲取Authorization Code String url = "https://graph.qq.com/oauth2.0/authorize?response_type=code"+ "&client_id=" + QQHttpClient.APPID + "&redirect_uri=" + URLEncoder.encode(backUrl, "utf-8") + "&state=" + uuid; return "redirect:" + url;}
正確返回示例：
JSON示例:
Content-type: text/html; charset=utf-8{"ret":0,"is_lost":0,"nickname":"Peter","gender":"男","country":"中國(guó)","province":"廣東","city":"深圳","figureurl":"http://imgcache.qq.com/qzone_v4/client/userinfo_icon/1236153759.gif","is_yellow_vip":1,"is_yellow_year_vip":1,"yellow_vip_level":7,"is_yellow_high_vip": 0}
錯(cuò)誤返回示例
Content-type: text/html; charset=utf-8{"ret":1002,"msg":"請(qǐng)先登錄"}
用戶資料的接口文檔：https://wiki.open.qq.com/wiki/v3/user/get_info
請(qǐng)求成功，用戶確認(rèn)登錄后回調(diào)方法
@GetMapping("/index")public String qqcallback(HttpServletRequest request, HttpServletResponse response) throws Exception { HttpSession session = request.getSession(); //qq返回的信息 String code = request.getParameter("code"); String state = request.getParameter("state"); String uuid = (String) session.getAttribute("state"); if(uuid != null){ if(!uuid.equals(state)){ throw new QQStateErrorException("QQ,state錯(cuò)誤"); } } //Step2：通過(guò)Authorization Code獲取Access Token String backUrl = http + "/index"; String url = "https://graph.qq.com/oauth2.0/token?grant_type=authorization_code"+ "&client_id=" + QQHttpClient.APPID + "&client_secret=" + QQHttpClient.APPKEY + "&code=" + code + "&redirect_uri=" + backUrl; String access_token = QQHttpClient.getAccessToken(url); //Step3: 獲取回調(diào)后的 openid 值 url = "https://graph.qq.com/oauth2.0/me?access_token=" + access_token; String openid = QQHttpClient.getOpenID(url); //Step4：獲取QQ用戶信息 url = "https://graph.qq.com/user/get_user_info?access_token=" + access_token + "&oauth_consumer_key="+ QQHttpClient.APPID + "&openid=" + openid; //返回用戶的信息 JSONObject jsonObject = QQHttpClient.getUserInfo(url); //也可以放到redis和MySQL中，只取出了部分?jǐn)?shù)據(jù)，根據(jù)自己需要取 session.setAttribute("openid",openid); //openid,用來(lái)唯一標(biāo)識(shí)qq用戶 session.setAttribute("nickname",(String)jsonObject.get("nickname")); //QQ名 session.setAttribute("figureurl_qq_2",(String)jsonObject.get("figureurl_qq_2")); //大小為100*100像素的QQ頭像URL //響應(yīng)重定向到home路徑 return "redirect:/home";}
QQ客戶端類QQHttpClient：
主要用于QQ消息返回
import com.alibaba.fastjson.JSONObject;import org.apache.http.HttpEntity;import org.apache.http.HttpResponse;import org.apache.http.client.methods.HttpGet;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.util.EntityUtils; import JAVA.io.IOException; public class QQHttpClient { //QQ互聯(lián)中提供的 appid 和 appkey public static final String APPID = "appid"; public static final String APPKEY = "appkey"; private static JSONObject parseJSONP(String jsonp){ int startIndex = jsonp.indexOf("("); int endIndex = jsonp.lastIndexOf(")"); String json = jsonp.substring(startIndex + 1,endIndex); return JSONObject.parseobject(json); } //qq返回信息：access_token=FE04************************CCE2&expires_in=7776000&refresh_token=88E4************************BE14 public static String getAccessToken(String url) throws IOException { CloseableHttpClient client = HttpClients.createDefault(); String token = null; HttpGet httpGet = new HttpGet(url); HttpResponse response = client.execute(httpGet); HttpEntity entity = response.getEntity(); if(entity != null){ String result = EntityUtils.toString(entity,"UTF-8"); if(result.indexOf("access_token") >= 0){ String[] array = result.split("&"); for (String str : array){ if(str.indexOf("access_token") >= 0){ token = str.substring(str.indexOf("=") + 1); break; } } } } httpGet.releaseConnection(); return token; } //qq返回信息：callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} ); 需要用到上面自己定義的解析方法parseJSONP public static String getOpenID(String url) throws IOException { JSONObject jsonObject = null; CloseableHttpClient client = HttpClients.createDefault(); HttpGet httpGet = new HttpGet(url); HttpResponse response = client.execute(httpGet); HttpEntity entity = response.getEntity(); if(entity != null){ String result = EntityUtils.toString(entity,"UTF-8"); jsonObject = parseJSONP(result); } httpGet.releaseConnection(); if(jsonObject != null){ return jsonObject.getString("openid"); }else { return null; } } //qq返回信息：{ "ret":0, "msg":"", "nickname":"YOUR_NICK_NAME", ... }，為JSON格式，直接使用JSONObject對(duì)象解析 public static JSONObject getUserInfo(String url) throws IOException { JSONObject jsonObject = null; CloseableHttpClient client = HttpClients.createDefault(); HttpGet httpGet = new HttpGet(url); HttpResponse response = client.execute(httpGet); HttpEntity entity = response.getEntity(); if(entity != null){ String result = EntityUtils.toString(entity,"UTF-8"); jsonObject = JSONObject.parseObject(result); } httpGet.releaseConnection(); return jsonObject; }}
異常類QQStateErrorException：
public class QQStateErrorException extends Exception { public QQStateErrorException() { super(); } public QQStateErrorException(String message) { super(message); } public QQStateErrorException(String message, Throwable cause) { super(message, cause); } public QQStateErrorException(Throwable cause) { super(cause); } protected QQStateErrorException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) { super(message, cause, enableSuppression, writableStackTrace); }}
首頁(yè)controller用于跳轉(zhuǎn)頁(yè)面
@Controllerpublic class IndexController { @GetMapping({"/index", "/"}) public String index(){ return "index"; } @GetMapping("/home") public String home(HttpSession session, Model model){ String openid = (String) session.getAttribute("openid"); String nickname = (String) session.getAttribute("nickname"); String figureurl_qq_2 = (String) session.getAttribute("figureurl_qq_2"); model.addAttribute("openid",openid); model.addAttribute("nickname",nickname); model.addAttribute("figureurl_qq_2",figureurl_qq_2); return "home"; }}
還有兩個(gè)簡(jiǎn)單的登錄頁(yè)面和信息頁(yè)面
index.html
<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Title</title></head><body> <a href="/qq/login">QQ登錄</a></body></html>
home.html
<!DOCTYPE html><html lang="en"><head> <meta charset="UTF-8"> <title>Title</title></head><body><div> <img th:src="${figureurl_qq_2}"></div><span th:text="${openid}"></span><span th:text="${nickname}"></span></body></html>
最后附上下載地址：https://github.com/machaoyin/qqdemo
