小程式登入、微信網頁授權（Java版）

廣州蘆葦科技Java開發團隊發表於2018-12-13
網頁Java

首先呢，“登入”、“授權”、“授權登入”，是一樣的意思，不用糾結。

寫小程式授權登入的程式碼前，需要了解清楚openid與unionid的區別，這裡再簡單介紹一下：

  1. 騰訊有個 “微信·開放平臺”，只有企業才能註冊賬號，可理解為微信體系裡，最頂級的賬號。官網地址：https://open.weixin.qq.com
  2. 除了這個微信開放平臺，還有另一個叫做 “微信公眾平臺”，可註冊四種賬號，包括服務號、訂閱號、小程式、企業微信。也就是說，公眾號（服務號和訂閱號可統稱為公眾號）佔一個賬號，小程式也佔一個賬號。在沒有繫結開放平臺前，小程式授權登入只能拿到使用者的openid。官網地址：https://mp.weixin.qq.com
  3. 小程式可繫結在公眾號下，公眾號可以繫結在微信開放平臺下，小程式也可以繫結在微信開放平臺下。（好像有點小繞）簡單點說，所有的公眾平臺賬號都需要繫結在 “開放平臺” 下，才可獲得的unionid，這是打通同個企業下所有微信公眾賬號的最有效方法（官方推薦）
  4. 更加具體的可自行百度…

一、以下為小程式登入的程式碼：

  • 方式一：通過code呼叫code2session介面獲得message，包含openid、session_key，滿足條件的情況下還能直接獲得unionid

    • 條件如下：（存在侷限性）

    1. 官方說明UnionID獲取途徑，如果開發者帳號下存在同主體的公眾號，並且該使用者已經關注了該公眾號。開發者可以直接通過 wx.login + code2Session 獲取到該使用者 UnionID，無須使用者再次授權。

    2. 開發者帳號下存在同主體的公眾號或移動應用，並且該使用者已經授權登入過該公眾號或移動應用。也可通過code2session獲取該使用者的 UnionID。

 1/**
 2 * Author: huanglp
 3 * Date: 2018-11-28
 4 */
 5public class WeiXinUtils {
 6
 7    private static Logger log = LoggerFactory.getLogger(WeiXinUtils.class);
 8
 9    /**
10     * 通過前端傳過來的code, 呼叫小程式登入介面, 獲取到message並返回 (包含openid session_key等)
11     *
12     * @param code
13     * @return
14     */
15    public static JSONObject login(String code) {
16        log.info("==============小程式登入方法開始================");
17        WxMiniProperties properties = WeiXinPropertiesUtils.getWxMiniProperties();
18        String url = properties.getInterfaceUrl() + "/sns/jscode2session?appid="
19            + properties.getAppId() + "&secret=" + properties.getAppSecret() 
20            + "&js_code=" + code + "&grant_type=authorization_code";
21        JSONObject message;
22        try {
23            // RestTemplate是Spring封裝好的, 挺好用, 可做成單例模式
24            RestTemplate restTemplate = new RestTemplate();
25            String response = restTemplate.getForObject(url, String.class);
26            message = JSON.parseObject(response);
27        } catch (Exception e) {
28            log.error("微信伺服器請求錯誤", e);
29            message = new JSONObject();
30        }
31        log.info("message：" + message.toString());
32        log.info("==============小程式登入方法結束================");
33        return message;
34
35        // 後續, 可獲取openid session_key等資料, 以下程式碼一般放在Service層
36        //if (message.get("errcode") != null) {
37        //    throw new ValidationException(message.toString());
38        //}
39        //String openid = message.get("openid").toString();
40        //String sessionKey = message.get("session_key").toString();
41        //...
42
43    }
44}
複製程式碼
  • - 補充1： WeiXinPropertiesUtils工具類
 1public class WeiXinPropertiesUtils {
 2
 3    // 微信小程式配置
 4    private static WxMiniProperties miniProperties;
 5    // 微信公眾號配置
 6    private static WxProperties wxProperties;
 7
 8    private static void init() {
 9        if (miniProperties == null) {
10            miniProperties = ContextLoader.getCurrentWebApplicationContext()
11                .getBean(WxMiniProperties.class);
12        }
13        if (wxProperties == null) {
14            wxProperties = ContextLoader.getCurrentWebApplicationContext()
15                .getBean(WxProperties.class);
16        }
17    }
18
19    public static WxMiniProperties getWxMiniProperties() {
20        init();
21        return miniProperties;
22    }
23
24    public static WxProperties getWxProperties() {
25        init();
26        return wxProperties;
27    }
28}
複製程式碼
  • - 補充2： WxMiniProperties配置類
 1@Data
 2@Component
 3@ConfigurationProperties(prefix = "luwei.module.wx-mini")
 4public class WxMiniProperties {
 5
 6    private String appId;
 7    private String appSecret;
 8    private String interfaceUrl;
 9
10}
複製程式碼

到此已能通過code獲取到使用者的openid和session_key，但若不滿足條件，即使將小程式繫結到微信開放平臺上，也獲取不到unionid，所以此方式不穩定，推薦使用解密的方式獲取資料。

  • 方式二：通過解密的方式獲取使用者unionid
 1/**
 2 * 通過encryptedData,sessionKey,iv獲得解密資訊, 擁有使用者豐富的資訊, 包含openid,unionid,暱稱等
 3 */
 4public static JSONObject decryptWxData(String encryptedData, String sessionKey, String iv) throws Exception {
 5    log.info("============小程式登入解析資料方法開始==========");
 6    String result = AesCbcUtil.decrypt(encryptedData, sessionKey, iv, "UTF-8");
 7    JSONObject userInfo = new JSONObject();
 8    if (null != result && result.length() > 0) {
 9        userInfo = JSONObject.parseObject(result);
10    }
11    log.info("result: " + userInfo);
12    log.info("============小程式登入解析資料方法結束==========");
13    return userInfo;
14}
複製程式碼
  • - 補充1： AesCbcUtil工具類，直接複製即可，需要新增bouncycastle依賴。BouncyCastle是一個開源的加解密解決方案，官網可檢視www.bouncycastle.org/
 1package com.luwei.common.utils;
 2
 3import org.bouncycastle.jce.provider.BouncyCastleProvider;
 4import org.apache.commons.codec.binary.Base64；
 5import javax.crypto.Cipher;
 6import javax.crypto.spec.IvParameterSpec;
 7import javax.crypto.spec.SecretKeySpec;
 8import java.security.AlgorithmParameters;
 9import java.security.Security;
10
11/**
12 * Updated by huanglp
13 * Date: 2018-11-28
14 */
15public class AesCbcUtil {
16
17    static {
18        Security.addProvider(new BouncyCastleProvider());
19    }
20
21    /**
22     * AES解密
23     *
24     * @param data     //被加密的資料
25     * @param key      //加密祕鑰
26     * @param iv       //偏移量
27     * @param encoding //解密後的結果需要進行的編碼
28     */
29    public static String decrypt(String data, String key, String iv, String encoding) {
30
31        // org.apache.commons.codec.binary.Base64
32        byte[] dataByte = Base64.decodeBase64(data);
33        byte[] keyByte = Base64.decodeBase64(key);
34        byte[] ivByte = Base64.decodeBase64(iv);
35
36        try {
37            Cipher cipher = Cipher.getInstance("AES/CBC/PKCS7Padding");
38            SecretKeySpec spec = new SecretKeySpec(keyByte, "AES");
39            AlgorithmParameters parameters = AlgorithmParameters.getInstance("AES");
40            parameters.init(new IvParameterSpec(ivByte));
41
42            cipher.init(Cipher.DECRYPT_MODE, spec, parameters);// 初始化
43            byte[] resultByte = cipher.doFinal(dataByte);
44            if (null != resultByte && resultByte.length > 0) {
45                return new String(resultByte, encoding);
46            }
47            return null;
48
49        } catch (Exception e) {
50            e.printStackTrace();
51        }
52
53        return null;
54    }
55}
複製程式碼

到此已經獲取到 JSONObject型別的 userInfo，包含openid，unionid，暱稱，頭像等資料

後續可以將使用者資訊儲存到資料庫，再返回給前端一個token即可，shiro經過公司封裝了一層，程式碼如下：

1...
2// 獲得使用者ID
3int userId = wxUser.getWxUserId();
4shiroTokenService.afterLogout(userId);
5String uuid = UUID.randomUUID().toString();
6String token = StringUtils.deleteAny(uuid, "-") + Long.toString(System.currentTimeMillis(), Character.MAX_RADIX);
7shiroTokenService.afterLogin(userId, token, null);
8return token;
複製程式碼

二、以下為公眾號（網頁）授權的程式碼：

網頁授權更加簡單，可檢視 官方文件

需新增 riversoft 相關依賴包，公眾號網頁授權，只需要將公眾號繫結了開放平臺，就能獲取到unionid及其他使用者資訊。

 1public static OpenUser webSiteLogin(String code, String state) {
 2    log.info("============微信公眾號(網頁)授權開始===========");
 3    WxProperties properties = WeiXinPropertiesUtils.getWxProperties();
 4    AppSetting appSetting = new AppSetting(properties.getAppId(), properties.getAppSecret());
 5    OpenOAuth2s openOAuth2s = OpenOAuth2s.with(appSetting);
 6    AccessToken accessToken = openOAuth2s.getAccessToken(code);
 7
 8    // 獲取使用者資訊
 9    OpenUser openUser = openOAuth2s.userInfo(accessToken.getAccessToken(), accessToken.getOpenId());
10    log.info("============微信公眾號(網頁)授權結束===========");
11    return openUser;
12
13    // 後續, 可將使用者資訊儲存
14    // 最後一步, 生成token後, 需重定向回頁面
15    //return "redirect:" + state + "?token=" + token;
16}
複製程式碼

以下就是本人整理的關於微信公眾號授權和小程式授權的一些經驗和問題彙總，希望大家能夠從中獲得解決方法。


隆鵬

廣州蘆葦科技Java開發團隊

蘆葦科技-廣州專業網際網路軟體服務公司

抓住每一處細節 ，創造每一個美好

關注我們的公眾號，瞭解更多

想和我們一起奮鬥嗎？lagou搜尋“ 蘆葦科技 ”或者投放簡歷到 server@talkmoney.cn 加入我們吧

關注我們，你的評論和點贊對我們最大的支援


相關文章