1. 程式人生 > >基於Shiro,JWT實現微信小程式登入完整例子

基於Shiro,JWT實現微信小程式登入完整例子

小程式官方流程圖如下,官方地址 : developers.weixin.qq.com/miniprogram… :

avatar

如果此圖理解不清楚的地方,也可參看我的部落格 : www.cnblogs.com/ealenxie/p/…

本文是對接微信小程式自定義登入的一個完整例子實現 ,技術棧為 : SpringBoot+Shiro+JWT+JPA+Redis。

如果對該例子比較感興趣或者覺得言語表達比較囉嗦,可檢視完整的專案地址 : github.com/EalenXie/sh…

主要實現 : 實現了小程式的自定義登陸,將自定義登陸態token返回給小程式作為登陸憑證。使用者的資訊儲存在資料庫中,登陸態token快取在redis中。

效果如下 : 1 . 首先從我們的小程式端呼叫wx.login() ,獲取臨時憑證code :

image.png
2 . 模擬使用該code,進行小程式的登陸獲取自定義登陸態 token,用postman進行測試 :
image.png
3 . 呼叫我們需要認證的介面,並攜帶該token進行鑑權,獲取到返回資訊 :
image.png

前方高能,本例程式碼說明較多, 以下是主要的搭建流程 : 1 . 首先新建maven專案 shiro-jwt-applet ,pom依賴 ,主要是shiro和jwt的依賴,和SpringBoot的一些基礎依賴。

<?xml version="1.0" encoding="UTF-8"
?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>name.ealen</groupId> <artifactId
>
shiro-jwt-applet</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>shiro-wx-jwt</name> <description>Demo project for Spring Boot</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.0.6.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> <dependency> <groupId>org.apache.shiro</groupId> <artifactId>shiro-spring</artifactId> <version>1.4.0</version> </dependency> <dependency> <groupId>com.auth0</groupId> <artifactId>java-jwt</artifactId> <version>3.4.1</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.47</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> 複製程式碼

2 . 配置你的application.yml ,主要是配置你的小程式appid和secret,還有你的資料庫和redis

## 請自行修改下面資訊
spring:
  application:
    name: shiro-jwt-applet
  jpa:
    hibernate:
      ddl-auto: create      # 請自行修改 請自行修改 請自行修改

#  datasource本地配置
  datasource:
    url: jdbc:mysql://localhost:3306/yourdatabase
    username: yourname
    password: yourpass
    driver-class-name: com.mysql.jdbc.Driver

#  redis本地配置 請自行配置
  redis:
    database: 0
    host: localhost
    port: 6379

#  微信小程式配置 appid /appsecret
wx:
  applet:
    appid: yourappid
    appsecret: yourappsecret
複製程式碼

3 . 定義我們儲存的微信小程式登陸的實體資訊 WxAccount :

package name.ealen.domain.entity;
import org.springframework.format.annotation.DateTimeFormat;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.Table;
import java.util.Date;

/**
 * Created by EalenXie on 2018/11/26 10:26.
 * 實體 屬性描述 這裡只是簡單示例,你可以自定義相關使用者資訊
 */
@Entity
@Table
public class WxAccount {
    @Id
    @GeneratedValue
    private Integer id;
    private String wxOpenid;
    private String sessionKey;
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date lastTime;
    /**
     * 省略getter/setter
     */
}
複製程式碼

和一個簡單的dao 訪問資料庫 WxAccountRepository :

package name.ealen.domain.repository;
import name.ealen.domain.entity.WxAccount;
import org.springframework.data.jpa.repository.JpaRepository;
/**
 * Created by EalenXie on 2018/11/26 10:32.
 */
public interface WxAccountRepository extends JpaRepository<WxAccount, Integer> {
    /**
     * 根據OpenId查詢使用者資訊
     */
    WxAccount findByWxOpenid(String wxOpenId);
}
複製程式碼

4 . 定義我們應用的服務說明 WxAppletService :

package name.ealen.application;
import name.ealen.interfaces.dto.Token;
/**
 * Created by EalenXie on 2018/11/26 10:40.
 * 微信小程式自定義登陸 服務說明
 */
public interface WxAppletService {
    /**
     * 微信小程式使用者登陸,完整流程可參考下面官方地址,本例中是按此流程開發
     * https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html
     * 1 . 我們的微信小程式端傳入code。
     * 2 . 呼叫微信code2session介面獲取openid和session_key
     * 3 . 根據openid和session_key自定義登陸態(Token)
     * 4 . 返回自定義登陸態(Token)給小程式端。
     * 5 . 我們的小程式端呼叫其他需要認證的api,請在header的Authorization裡面攜帶 token資訊
     *
     * @param code 小程式端 呼叫 wx.login 獲取到的code,用於呼叫 微信code2session介面
     * @return Token 返回後端 自定義登陸態 token  基於JWT實現
     */
    public Token wxUserLogin(String code);
}
複製程式碼

返回給微信小程式token物件宣告 Token :

package name.ealen.interfaces.dto;
/**
 * Created by EalenXie on 2018/11/26 18:49.
 * DTO 返回值token物件
 */
public class Token {
    private String token;
    public Token(String token) {
        this.token = token;
    }
    /**
     * 省略getter/setter
     */
}
複製程式碼

5. 配置需要的基本元件,RestTemplate,Redis:

package name.ealen.infrastructure.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ClientHttpRequestFactory;
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
/**
 * Created by EalenXie on 2018-03-23 07:37
 * RestTemplate的配置類
 */
@Configuration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate(ClientHttpRequestFactory factory) {
        return new RestTemplate(factory);
    }
    @Bean
    public ClientHttpRequestFactory simpleClientHttpRequestFactory() {
        SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
        factory.setReadTimeout(1000 * 60);     //讀取超時時間為單位為60秒
        factory.setConnectTimeout(1000 * 10);  //連線超時時間設定為10秒
        return factory;
    }
}
複製程式碼

Redis的CacheManager配置。本例是Springboot2.0的寫法(和1.8的版本寫法略有不同) :

package name.ealen.infrastructure.config;
import org.springframework.cache.CacheManager;
import org.springframework.cache.annotation.EnableCaching;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.cache.RedisCacheManager;
import org.springframework.data.redis.connection.RedisConnectionFactory;
/**
 * Created by EalenXie on 2018-03-23 07:37
 * Redis的配置類
 */
@Configuration
@EnableCaching
public class RedisConfig {
    @Bean
    public CacheManager cacheManager(RedisConnectionFactory factory) {
        return RedisCacheManager.create(factory);
    }
}
複製程式碼

6. JWT的核心過濾器配置。繼承了Shiro的BasicHttpAuthenticationFilter,並重寫了其鑑權的過濾方法 :

package name.ealen.infrastructure.config.jwt;
import name.ealen.domain.vo.JwtToken;
import org.apache.shiro.web.filter.authc.BasicHttpAuthenticationFilter;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.RequestMethod;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
 * Created by EalenXie on 2018/11/26 10:26.
 * JWT核心過濾器配置
 * 所有的請求都會先經過Filter,所以我們繼承官方的BasicHttpAuthenticationFilter,並且重寫鑑權的方法。
 * 執行流程 preHandle->isAccessAllowed->isLoginAttempt->executeLogin
 */
public class JwtFilter extends BasicHttpAuthenticationFilter {
    /**
     * 判斷使用者是否想要進行 需要驗證的操作
     * 檢測header裡面是否包含Authorization欄位即可
     */
    @Override
    protected boolean isLoginAttempt(ServletRequest request, ServletResponse response) {
        String auth = getAuthzHeader(request);
        return auth != null && !auth.equals("");
    }
    /**
     * 此方法呼叫登陸,驗證邏輯
     */
    @Override
    protected boolean isAccessAllowed(ServletRequest request, ServletResponse response, Object mappedValue) {
        if (isLoginAttempt(request, response)) {
            JwtToken token = new JwtToken(getAuthzHeader(request));
            getSubject(request, response).login(token);
        }
        return true;
    }
    /**
     * 提供跨域支援
     */
    @Override
    protected boolean preHandle(ServletRequest request, ServletResponse response) throws Exception {
        HttpServletRequest httpServletRequest = (HttpServletRequest) request;
        HttpServletResponse httpServletResponse = (HttpServletResponse) response;
        httpServletResponse.setHeader("Access-control-Allow-Origin", httpServletRequest.getHeader("Origin"));
        httpServletResponse.setHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS,PUT,DELETE");
        httpServletResponse.setHeader("Access-Control-Allow-Headers", httpServletRequest.getHeader("Access-Control-Request-Headers"));
        // 跨域時會首先發送一個option請求,這裡我們給option請求直接返回正常狀態
        if (httpServletRequest.getMethod().equals(RequestMethod.OPTIONS.name())) {
            httpServletResponse.setStatus(HttpStatus.OK.value());
            return false;
        }
        return super.preHandle(request, response);
    }
}
複製程式碼

JWT的核心配置(包含Token的加密建立,JWT續期,解密驗證) :

package name.ealen.infrastructure.config.jwt;
import com.auth0.jwt.JWT;
import com.auth0.jwt.JWTVerifier;
import com.auth0.jwt.algorithms.Algorithm;
import com.auth0.jwt.exceptions.JWTDecodeException;
import name.ealen.domain.entity.WxAccount;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.stereotype.Component;
import java.util.Date;
import java.util.UUID;
import java.util.concurrent.TimeUnit;
/**
 * Created by EalenXie on 2018/11/22 17:16.
 */
@Component
public class JwtConfig {
    /**
     * JWT 自定義金鑰 我這裡寫死的
     */
    private static final String SECRET_KEY = "5371f568a45e5ab1f442c38e0932aef24447139b";
    /**
     * JWT 過期時間值 這裡寫死為和小程式時間一致 7200 秒,也就是兩個小時
     */
    private static long expire_time = 7200;
    @Autowired
    private StringRedisTemplate redisTemplate;
    /**
     * 根據微信使用者登陸資訊建立 token
     * 注 : 這裡的token會被快取到redis中,用作為二次驗證
     * redis裡面快取的時間應該和jwt token的過期時間設定相同
     *
     * @param wxAccount 微信使用者資訊
     * @return 返回 jwt token
     */
    public String createTokenByWxAccount(WxAccount wxAccount) {
        String jwtId = UUID.randomUUID().toString();                 //JWT 隨機ID,做為驗證的key
        //1 . 加密演算法進行簽名得到token
        Algorithm algorithm = Algorithm.HMAC256(SECRET_KEY);
        String token = JWT.create()
                .withClaim("wxOpenId", wxAccount.getWxOpenid())
                .withClaim("sessionKey", wxAccount.getSessionKey())
                .withClaim("jwt-id", jwtId)
                .withExpiresAt(new Date(System.currentTimeMillis() + expire_time*1000))  //JWT 配置過期時間的正確姿勢
                .sign(algorithm);
        //2 . Redis快取JWT, 注 : 請和JWT過期時間一致
        redisTemplate.opsForValue().set("JWT-SESSION-" + jwtId, token, expire_time, TimeUnit.SECONDS);
        return token;
    }
    /**
     * 校驗token是否正確
     * 1 . 根據token解密,解密出jwt-id , 先從redis中查找出redisToken,匹配是否相同
     * 2 . 然後再對redisToken進行解密,解密成功則 繼續流程 和 進行token續期
     *
     * @param token 金鑰
     * @return 返回是否校驗通過
     */
    public boolean verifyToken(String token) {
        try {
            //1 . 根據token解密,解密出jwt-id , 先從redis中查找出redisToken,匹配是否相同
            String redisToken = redisTemplate.opsForValue().get("JWT-SESSION-" + getJwtIdByToken(token));
            if (!redisToken.equals(token)) return false;
            //2 . 得到演算法相同的JWTVerifier
            Algorithm algorithm = Algorithm.HMAC256(SECRET_KEY);
            JWTVerifier verifier = JWT.require(algorithm)
                    .withClaim("wxOpenId", getWxOpenIdByToken(redisToken))
                    .withClaim("sessionKey", getSessionKeyByToken(redisToken))
                    .withClaim("jwt-id", getJwtIdByToken(redisToken))
                    .acceptExpiresAt(System.currentTimeMillis() + expire_time*1000 )  //JWT 正確的配置續期姿勢
                    .build();
            //3 . 驗證token
            verifier.verify(redisToken);
            //4 . Redis快取JWT續期
            redisTemplate.opsForValue().set("JWT-SESSION-" + getJwtIdByToken(token), redisToken, expire_time, TimeUnit.SECONDS);
            return true;
        } catch (Exception e) { //捕捉到任何異常都視為校驗失敗
            return false;
        }
    }
    /**
     * 根據Token獲取wxOpenId(注意坑點 : 就算token不正確,也有可能解密出wxOpenId,同下)
     */
    public String getWxOpenIdByToken(String token) throws JWTDecodeException {
        return JWT.decode(token).getClaim("wxOpenId").asString();
    }
    /**
     * 根據Token獲取sessionKey
     */
    public String getSessionKeyByToken(String token) throws JWTDecodeException {
        return JWT.decode(token).getClaim("sessionKey").asString();
    }
    /**
     * 根據Token 獲取jwt-id
     */
    private String getJwtIdByToken(String token) throws JWTDecodeException {
        return JWT.decode(token).getClaim("jwt-id").asString();
    }
}
複製程式碼

7 . 自定義Shiro的Realm配置,Realm是自定義登陸及授權的邏輯配置 :

package name.ealen.infrastructure.config.shiro;
import name.ealen.domain.vo.JwtToken;
import name.ealen.infrastructure.config.jwt.JwtConfig;
import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.AuthenticationToken;
import org.apache.shiro.authc.SimpleAuthenticationInfo;
import org.apache.shiro.authc.credential.CredentialsMatcher;
import org.apache.shiro.authz.AuthorizationInfo;
import org.apache.shiro.authz.SimpleAuthorizationInfo;
import org.apache.shiro.realm.AuthorizingRealm;
import org.apache.shiro.realm.Realm;
import org.apache.shiro.subject.PrincipalCollection;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;
import java.util.Collections;
import java.util.LinkedList;
import java.util.List;
/**
 * Created by EalenXie on 2018/11/26 12:12.
 * Realm 的一個配置管理類 allRealm()方法得到所有的realm
 */
@Component
public class ShiroRealmConfig {
    @Resource
    private JwtConfig jwtConfig;
    /**
     * 配置所有自定義的realm,方便起見,應對可能有多個realm的情況
     */
    public List<Realm> allRealm() {
        List<Realm> realmList = new LinkedList<>();
        AuthorizingRealm jwtRealm = jwtRealm();
        realmList.add(jwtRealm);
        return Collections.unmodifiableList(realmList);
    }
    /**
     * 自定義 JWT的 Realm
     * 重寫 Realm 的 supports() 方法是通過 JWT 進行登入判斷的關鍵
     */
    private AuthorizingRealm jwtRealm() {
        AuthorizingRealm jwtRealm = new AuthorizingRealm() {
            /**
             * 注意坑點 : 必須重寫此方法,不然Shiro會報錯
             * 因為建立了 JWTToken 用於替換Shiro原生 token,所以必須在此方法中顯式的進行替換,否則在進行判斷時會一直失敗
             */
            @Override
            public boolean supports(AuthenticationToken token) {
                return token instanceof JwtToken;
            }
            @Override
            protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
                return new SimpleAuthorizationInfo();
            }
            /**
             * 校驗 驗證token邏輯
             */
            @Override
            protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) {
                String jwtToken = (String) token.getCredentials();
                String wxOpenId = jwtConfig.getWxOpenIdByToken(jwtToken);
                String sessionKey = jwtConfig.getSessionKeyByToken(jwtToken);
                if (wxOpenId == null || wxOpenId.equals(""))
                    throw new AuthenticationException("user account not exits , please check your token");
                if (sessionKey == null || sessionKey.equals(""))
                    throw new AuthenticationException("sessionKey is invalid , please check your token");
                if (!jwtConfig.verifyToken(jwtToken))
                    throw new AuthenticationException("token is invalid , please check your token");
                return new SimpleAuthenticationInfo(token, token, getName());
            }
        };
        jwtRealm.setCredentialsMatcher(credentialsMatcher());
        return jwtRealm;
    }
    /**
     * 注意坑點 : 密碼校驗 , 這裡因為是JWT形式,就無需密碼校驗和加密,直接讓其返回為true(如果不設定的話,該值預設為false,即始終驗證不通過)
     */
    private CredentialsMatcher credentialsMatcher() {
        return (token, info) -> true;
    }
}
複製程式碼

Shiro的核心配置,包含配置Realm :

package name.ealen.infrastructure.config.shiro;
import name.ealen.infrastructure.config.jwt.JwtFilter;
import org.apache.shiro.mgt.DefaultSessionStorageEvaluator;
import org.apache.shiro.mgt.DefaultSubjectDAO;
import org.apache.shiro.spring.LifecycleBeanPostProcessor;
import org.apache.shiro.spring.security.interceptor.AuthorizationAttributeSourceAdvisor;
import org.apache.shiro.spring.web.ShiroFilterFactoryBean;
import org.apache.shiro.web.mgt.DefaultWebSecurityManager;
import org.springframework.aop.framework.autoproxy.DefaultAdvisorAutoProxyCreator;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.DependsOn;
import javax.servlet.Filter;
import java.util.HashMap;
import java.util.Map;
/**
 * Created by EalenXie on 2018/11/22 18:28.
 */
@Configuration
public class ShirConfig {
    /**
     * SecurityManager,安全管理器,所有與安全相關的操作都會與之進行互動;
     * 它管理著所有Subject,所有Subject都繫結到SecurityManager,與Subject的所有互動都會委託給SecurityManager
     * DefaultWebSecurityManager :
     * 會建立預設的DefaultSubjectDAO(它又會預設建立DefaultSessionStorageEvaluator)
     * 會預設建立DefaultWebSubjectFactory
     * 會預設建立ModularRealmAuthenticator
     */
    @Bean
    public DefaultWebSecurityManager securityManager(ShiroRealmConfig shiroRealmConfig) {
        DefaultWebSecurityManager securityManager = new DefaultWebSecurityManager();
        securityManager.setRealms(shiroRealmConfig.allRealm());     //設定realm
        DefaultSubjectDAO subjectDAO = (DefaultSubjectDAO) securityManager.getSubjectDAO();
        // 關閉自帶session
        DefaultSessionStorageEvaluator evaluator = (DefaultSessionStorageEvaluator) subjectDAO.getSessionStorageEvaluator();
        evaluator.setSessionStorageEnabled(Boolean.FALSE);
        subjectDAO.setSessionStorageEvaluator(evaluator);
        return securityManager;
    }
    /**
     * 配置Shiro的訪問策略
     */
    @Bean
    public ShiroFilterFactoryBean factory(DefaultWebSecurityManager securityManager) {
        ShiroFilterFactoryBean factoryBean = new ShiroFilterFactoryBean();
        Map<String, Filter> filterMap = new HashMap<>();
        filterMap.put("jwt", new JwtFilter());
        factoryBean.setFilters(filterMap);
        factoryBean.setSecurityManager(securityManager);
        Map<String, String> filterRuleMap = new HashMap<>();
        //登陸相關api不需要被過濾器攔截
        filterRuleMap.put("/api/wx/user/login/**", "anon");
        filterRuleMap.put("/api/response/**", "anon");
        // 所有請求通過JWT Filter
        filterRuleMap.put("/**", "jwt");
        factoryBean.setFilterChainDefinitionMap(filterRuleMap);
        return factoryBean;
    }
    /**
     * 添加註解支援
     */
    @Bean
    @DependsOn("lifecycleBeanPostProcessor")
    public DefaultAdvisorAutoProxyCreator defaultAdvisorAutoProxyCreator() {
        DefaultAdvisorAutoProxyCreator defaultAdvisorAutoProxyCreator = new DefaultAdvisorAutoProxyCreator();
        defaultAdvisorAutoProxyCreator.setProxyTargetClass(true); // 強制使用cglib,防止重複代理和可能引起代理出錯的問題
        return defaultAdvisorAutoProxyCreator;
    }
    /**
     * 添加註解依賴
     */
    @Bean
    public LifecycleBeanPostProcessor lifecycleBeanPostProcessor() {
        return new LifecycleBeanPostProcessor();
    }
    /**
     * 開啟註解驗證
     */
    @Bean
    public AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor(DefaultWebSecurityManager securityManager) {
        AuthorizationAttributeSourceAdvisor authorizationAttributeSourceAdvisor = new AuthorizationAttributeSourceAdvisor();
        authorizationAttributeSourceAdvisor.setSecurityManager(securityManager);
        return authorizationAttributeSourceAdvisor;
    }
}
複製程式碼

用於Shiro鑑權的JwtToken物件 :

package name.ealen.domain.vo;
import org.apache.shiro.authc.AuthenticationToken;
/**
 * Created by EalenXie on 2018/11/22 18:21.
 * 鑑權用的token vo ,實現 AuthenticationToken
 */
public class JwtToken implements AuthenticationToken {
    private String token;
    public JwtToken(String token) {
        this.token = token;
    }
    @Override
    public Object getPrincipal() {
        return token;
    }
    @Override
    public Object getCredentials() {
        return token;
    }
    public String getToken() {
        return token;
    }
    public void setToken(String token) {
        this.token = token;
    }
}
複製程式碼

8 . 實現實體的行為及業務邏輯,此例主要是呼叫微信介面code2session和建立返回token :

package name.ealen.domain.service;
import name.ealen.application.WxAppletService;
import name.ealen.domain.entity.WxAccount;
import name.ealen.domain.repository.WxAccountRepository;
import name.ealen.domain.vo.Code2SessionResponse;
import name.ealen.infrastructure.config.jwt.JwtConfig;
import name.ealen.infrastructure.util.HttpUtil;
import name.ealen.infrastructure.util.JSONUtil;
import name.ealen.interfaces.dto.Token;
import org.apache.shiro.authc.AuthenticationException;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpMethod;
import org.springframework.stereotype.Service;
import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;
import org.springframework.web.client.RestTemplate;
import javax.annotation.Resource;
import java.net.URI;
import java.util.Date;
/**
 * Created by EalenXie on 2018/11/26 10:50.
 * 實體 行為描述
 */
@Service
public class WxAccountService implements WxAppletService {
    @Resource
    private RestTemplate restTemplate;
    @Value("${wx.applet.appid}")
    private String appid;
    @Value("${wx.applet.appsecret}")
    private String appSecret;
    @Resource
    private WxAccountRepository wxAccountRepository;
    @Resource
    private JwtConfig jwtConfig;
    /**
     * 微信的 code2session 介面 獲取微信使用者資訊
     * 官方說明 : https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/code2Session.html
     */
    private String code2Session(String jsCode) {
        String code2SessionUrl = "https://api.weixin.qq.com/sns/jscode2session";
        MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
        params.add("appid", appid);
        params.add("secret", appSecret);
        params.add("js_code", jsCode);
        params.add("grant_type", "authorization_code");
        URI code2Session = HttpUtil.getURIwithParams(code2SessionUrl, params);
        return restTemplate.exchange(code2Session, HttpMethod.GET, new HttpEntity<String>(new HttpHeaders()), String.class).getBody();
    }
    /**
     * 微信小程式使用者登陸,完整流程可參考下面官方地址,本例中是按此流程開發
     * https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html
     * @param code 小程式端 呼叫 wx.login 獲取到的code,用於呼叫 微信code2session介面
     * @return 返回後端 自定義登陸態 token  基於JWT實現
     */
    @Override
    public Token wxUserLogin(String code) {
        //1 . code2session返回JSON資料
        String resultJson = code2Session(code);
        //2 . 解析資料
        Code2SessionResponse response = JSONUtil.jsonString2Object(resultJson, Code2SessionResponse.class);
        if (!response.getErrcode().equals("0"))
            throw new AuthenticationException("code2session失敗 : " + response.getErrmsg());
        else {
            //3 . 先從本地資料庫中查詢使用者是否存在
            WxAccount wxAccount = wxAccountRepository.findByWxOpenid(response.getOpenid());
            if (wxAccount == null) {
                wxAccount = new WxAccount();
                wxAccount.setWxOpenid(response.getOpenid());    //不存在就新建使用者
            }
            //4 . 更新sessionKey和 登陸時間
            wxAccount.setSessionKey(response.getSession_key());
            wxAccount.setLastTime(new Date());
            wxAccountRepository.save(wxAccount);
            //5 . JWT 返回自定義登陸態 Token
            String token = jwtConfig.createTokenByWxAccount(wxAccount);
            return new Token(token);
        }
    }
}
複製程式碼

小程式code2session介面的返回VO物件Code2SessionResponse :

package name.ealen.domain.vo;
/**
 * 微信小程式 Code2Session 介面返回值 物件
 * 具體可以參考小程式官方API說明 : https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/code2Session.html
 */
public class Code2SessionResponse {
    private String openid;
    private String session_key;
    private String unionid;
    private String errcode = "0";
    private String errmsg;
    private int expires_in;
    /**
     * 省略getter/setter
     */
}
複製程式碼

9. 定義我們的介面資訊WxAppletController,此例包含一個登入獲取token的api和一個需要認證的測試api :

package name.ealen.interfaces.facade;
import name.ealen.application.WxAppletService;
import org.apache.shiro.authz.annotation.RequiresAuthentication;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.HashMap;
import java.util.Map;
/**
 * Created by EalenXie on 2018/11/26 10:44.
 * 小程式後臺 某 API
 */
@RestController
public class WxAppletController {
    @Resource
    private WxAppletService wxAppletService;
    /**
     * 微信小程式端使用者登陸api
     * 返回給小程式端 自定義登陸態 token
     */
    @PostMapping("/api/wx/user/login")
    public ResponseEntity wxAppletLoginApi(@RequestBody Map<String, String> request) {
        if (!request.containsKey("code") || request.get("code") == null || request.get("code").equals("")) {
            Map<String, String> result = new HashMap<>();
            result.put("msg", "缺少引數code或code不合法");
            return new ResponseEntity<>(result, HttpStatus.BAD_REQUEST);
        } else {
            return new ResponseEntity<>(wxAppletService.wxUserLogin(request.get("code")), HttpStatus.OK);
        }
    }
    /**
     * 需要認證的測試介面  需要 @RequiresAuthentication 註解,則呼叫此介面需要 header 中攜帶自定義登陸態 authorization
     */
    @RequiresAuthentication
    @PostMapping("/sayHello")
    public ResponseEntity sayHello() {
        Map<String, String> result = new HashMap<>();
        result.put("words", "hello World");
        return new ResponseEntity<>(result, HttpStatus.OK);
    }
}
複製程式碼

10 . 執行主類,檢查與資料庫和redis的連線,進行測試 :

package name.ealen;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
 * Created by EalenXie on 2018/11/26 10:25.
 */
@SpringBootApplication
public class ShiroJwtAppletApplication {
    public static void main(String[] args) {
        SpringApplication.run(ShiroJwtAppletApplication.class, args);
    }
}
複製程式碼

以上,就是基於Shiro,JWT實現微信小程式登入完整例子的