1.雲服務器
2.備案的域名
3.本地調試需要修改hosts文件,將域名映射到127.0.0.1
如何修改hosts文件:https://www.cnblogs.com/toSeeMyDream/p/9313440.html
申請QQ互聯,併成爲開發者
申請QQ互聯創建應用時需要備案域名,所以建議提前準備備案域名。
QQ互聯:https://connect.qq.com/index.html
登錄後,點擊頭像,進入認證頁面,填寫信息,等待審覈。
審覈通過後創建應用
應用創建通過審覈後,就可以使用APP ID 和 APP Key
前期工作就這些了,後面可以開始寫代碼了。
項目結構:
properties或者yml配置文件(這裏就是簡單的配置了一下,可以自行添加數據庫等配置)
- server.port=80
- server.servlet.context-path=/
-
- #qq互聯
- qq.oauth.http:QQ互聯中申請填寫的網站地址
在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>
發送QQ登錄請求
定義全局變量獲取配置文件中的網站地址
- @Value("${qq.oauth.http}")
- private String http;
定義登錄回調地址(可以用網站地址拼接或者直接寫)
- //QQ互聯中的回調地址
- String backUrl = http + "/index";
登錄請求方法代碼
- @GetMapping("/qq/login")
- public String qq(HttpSession session) throws UnsupportedEncodingException {
- //QQ互聯中的回調地址
- String backUrl = http + "/index";
-
- //用於第三方應用防止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;
- }
回調返回參數信息說明:
參數名稱 | 描述 |
---|---|
ret | 返回碼。詳見公共返回碼說明#OpenAPI V3.0 返回碼。 |
msg | 如果錯誤,返回錯誤信息。 |
is_lost | 判斷是否有數據丟失。如果應用不使用cache,不需要關心此參數。
0或者不返回:沒有數據丟失,可以緩存。 |
nickname | 暱稱。 |
gender | 性別。 |
country | 國家(當pf=qzone、pengyou或qplus時返回)。 |
province | 省(當pf=qzone、pengyou或qplus時返回)。 |
city | 市(當pf=qzone、pengyou或qplus時返回)。 |
figureurl | 頭像URL。詳見:前端頁面規範#6. 關於用戶頭像的獲取和尺寸說明。 |
openid | 用戶QQ號碼轉化得到的ID(當pf=qplus時返回)。 |
qq_level | 用戶QQ等級(當pf=qplus時返回)。 |
qq_vip_level | 用戶QQ會員等級(當pf=qplus時返回)。 |
qplus_level | 用戶Q+等級(當pf=qplus時返回)。 |
is_yellow_vip | 是否爲黃鑽用戶(0:不是; 1:是)。
(當pf=qzone、pengyou或qplus時返回) |
is_yellow_year_vip | 是否爲年費黃鑽用戶(0:不是; 1:是)。
(當pf=qzone、pengyou或qplus時返回) |
yellow_vip_level | 黃鑽等級,目前最高級別爲黃鑽8級(如果是黃鑽用戶才返回此參數)。
(當pf=qzone、pengyou或qplus時返回) |
is_yellow_high_vip | 是否爲豪華版黃鑽用戶(0:不是; 1:是)。
(當pf=qzone、pengyou或qplus時返回) |
is_blue_vip | 是否爲藍鑽用戶(0:不是; 1:是)。
(當pf=qqgame或3366時返回) |
is_blue_year_vip | 是否爲年費藍鑽用戶(0:不是; 1:是)。
(當pf=qqgame或3366時返回) |
blue_vip_level | 藍鑽等級(如果是藍鑽用戶才返回此參數)。
(當pf=qqgame或3366時返回) |
3366_level | 3366用戶的大等級。
(當pf=3366時返回) |
3366_level_name | 3366用戶的等級名,如小遊遊、小遊仙。
(當pf=3366時返回) |
3366_grow_level | 3366用戶的成長等級。
(當pf=3366時返回) |
3366_grow_value | 3366用戶的成長值。
(當pf=3366時返回) |
is_super_blue_vip | 是否是豪華藍鑽。
(當pf=qqgame或3366時返回) |
正確返回示例:
JSON示例:
- Content-type: text/html; charset=utf-8
- {
- "ret":0,
- "is_lost":0,
- "nickname":"Peter",
- "gender":"男",
- "country":"中國",
- "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
- }
錯誤返回示例
- Content-type: text/html; charset=utf-8
- {
- "ret":1002,
- "msg":"請先登錄"
- }
用戶資料的接口文檔:https://wiki.open.qq.com/wiki/v3/user/get_info
請求成功,用戶確認登錄後回調方法
- @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錯誤");
- }
- }
-
-
- //Step2:通過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: 獲取回調後的 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中,只取出了部分數據,根據自己需要取
- session.setAttribute("openid",openid); //openid,用來唯一標識qq用戶
- session.setAttribute("nickname",(String)jsonObject.get("nickname")); //QQ名
- session.setAttribute("figureurl_qq_2",(String)jsonObject.get("figureurl_qq_2")); //大小爲100*100像素的QQ頭像URL
-
- //響應重定向到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互聯中提供的 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對象解析
- 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);
- }
- }
首頁controller用於跳轉頁面
- @Controller
- public 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";
- }
- }
還有兩個簡單的登錄頁面和信息頁面
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