Spring Session工做原理

時間 2020-05-21

原文原文鏈接

本文首發於 vivo互聯網技術微信公衆號 https://mp.weixin.qq.com/s/KCOFv0nRuymkX79-RZi9eg
做者：張正林

HTTP協議自己是無狀態的，爲了保存會話信息，瀏覽器Cookie經過SessionID標識會話請求，服務器以SessionID爲key來存儲會話信息。在單實例應用中，能夠考慮應用進程自身存儲，隨着應用體量的增加，須要橫向擴容，多實例session共享問題隨之而來。html

Spring Session就是爲了解決多進程session共享的問題，本文將介紹怎麼使用Spring Session，以及Spring Session工做原理。java

一、引入背景

應用部署在Tomcat時，session是由Tomcat內存維護，若是應用部署多個實例，session就不能共享。Spring Session就是解決爲了解決分佈式場景中的session共享問題。git

二、使用方法

Spring Session支持存儲在Hazelcast 、Redis、MongoDB、關係型數據庫，本文主要討論session存儲在Redis。github

web.xml配置：web

<!-- spring session -->
  <filter>
    <filter-name>springSessionRepositoryFilter</filter-name>
    <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>springSessionRepositoryFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

Spring 主要配置：redis

<!--建立了一個RedisConnectionFactory，它將Spring會話鏈接到Redis服務器-->
    <bean id="jedisConnectionFactory" class="org.springframework.data.redis.connection.jedis.JedisConnectionFactory">
        <!--配置Redis鏈接池 ，能夠不配置，使用默認就行！-->
        p:poolConfig-ref="jedisPoolConfig"
    </bean>
 
    <!--建立一個Spring Bean的名稱springSessionRepositoryFilter實現過濾器-->
    <bean class="org.springframework.session.data.redis.config.annotation.web.http.RedisHttpSessionConfiguration">
        <!--默認session時效30分鐘-->
        <property name="maxInactiveIntervalInSeconds" value="60" />
    </bean>

三、工做流程

Tomcat web.xml解析步驟：spring

contextInitialized(ServletContextEvent arg0); // Listener
init(FilterConfig filterConfig); // Filter
init(ServletConfig config); // Servlet

初始化順序：Listener > Filter > Servlet。數據庫

1) 經過 Tomcat 的 listener 把SessionRepositoryFilter加載到Spring容器中。瀏覽器

上一小節Spring配置文件裏面聲明瞭RedisHttpSessionConfiguration，正是在其父類SpringHttpSessionConfiguration中生成了SessionRepositoryFilter：緩存

@Bean
public <S extends ExpiringSession> SessionRepositoryFilter<? extends ExpiringSession> springSessionRepositoryFilter(
        SessionRepository<S> sessionRepository) {
    ......
    return sessionRepositoryFilter;
}

RedisHttpSessionConfiguration類繼承關係

2) filter初始化

web.xml裏面配置的filter是DelegatingFilterProxy。

DelegatingFilterProxy類繼承關係

DelegatingFilterProxy初始化入口在其父類GenericFilterBean中：

public final void init(FilterConfig filterConfig) throws ServletException {
        ......
        // Let subclasses do whatever initialization they like.
        initFilterBean();
        ......
    }

DelegatingFilterProxy去Spring容器取第1步初始化好的springSessionRepositoryFilter：

protected void initFilterBean() throws ServletException {
        synchronized (this.delegateMonitor) {
            if (this.delegate == null) {
                // If no target bean name specified, use filter name.
                if (this.targetBeanName == null) {
                    //targetBeanName 爲springSessionRepositoryFilter
                    this.targetBeanName = getFilterName();
                }
                WebApplicationContext wac = findWebApplicationContext();
                if (wac != null) {
                    this.delegate = initDelegate(wac);
                }
            }
        }
    }

至此 sessionRepositoryFilter 初始化完成，DelegatingFilterProxy 實際代理了SessionRepositoryFilter。

SessionRepositoryFilter 工做核心流程：

protected void doFilterInternal(HttpServletRequest request,
           HttpServletResponse response, FilterChain filterChain)
           throws ServletException, IOException {
       request.setAttribute(SESSION_REPOSITORY_ATTR, this.sessionRepository);
       //包裝了HttpServletRequest，覆寫了HttpServletRequest中 getSession(boolean create)方法
       SessionRepositoryRequestWrapper wrappedRequest = new SessionRepositoryRequestWrapper(
               request, response, this.servletContext);
             ......
       try {
           filterChain.doFilter(strategyRequest, strategyResponse);
       }
       finally {
           //保證session持久化
           wrappedRequest.commitSession();
       }
   }

四、緩存機制

每個session，Redis實際緩存的數據以下：

spring:session:sessions:1b8b2340-da25-4ca6-864c-4af28f033327
spring:session:sessions:expires:1b8b2340-da25-4ca6-864c-4af28f033327
spring:session:expirations:1557389100000

spring:session:sessions爲hash結構，存儲Spring Session的主要內容：

hgetall spring:session:sessions:1b8b2340-da25-4ca6-864c-4af28f033327
 1) "creationTime"
 2) "\xac\xed\x00\x05sr\x00\x0ejava.lang.Long;\x8b\xe4\x90\xcc\x8f#\xdf\x02\x00\x01J\x00\x05valuexr\x00\x10java.lang.Number\x86\xac\x95\x1d\x0b\x94\xe0\x8b\x02\x00\x00xp\x00\x00\x01j\x9b\x83\x9d\xfd"
 3) "maxInactiveInterval"
 4) "\xac\xed\x00\x05sr\x00\x11java.lang.Integer\x12\xe2\xa0\xa4\xf7\x81\x878\x02\x00\x01I\x00\x05valuexr\x00\x10java.lang.Number\x86\xac\x95\x1d\x0b\x94\xe0\x8b\x02\x00\x00xp\x00\x00\a\b"
 5) "lastAccessedTime"
 6) "\xac\xed\x00\x05sr\x00\x0ejava.lang.Long;\x8b\xe4\x90\xcc\x8f#\xdf\x02\x00\x01J\x00\x05valuexr\x00\x10java.lang.Number\x86\xac\x95\x1d\x0b\x94\xe0\x8b\x02\x00\x00xp\x00\x00\x01j\x9b\x83\x9d\xfd"

spring:session:sessions:expires 爲 string 結構，存儲一個空值。

spring:session:expirations爲set結構，存儲1557389100000 時間點過時的spring:session:sessions:expires鍵值：

smembers spring:session:expirations:1557389100000
1) "\xac\xed\x00\x05t\x00,expires:1b8b2340-da25-4ca6-864c-4af28f033327"

RedisSessionExpirationPolicy，三個鍵值生成流程：

public void onExpirationUpdated(Long originalExpirationTimeInMilli,
            ExpiringSession session) {
        String keyToExpire = "expires:" + session.getId();
        long toExpire = roundUpToNextMinute(expiresInMillis(session));
                ......
        //把spring:session:sessions:expires加入到spring:session:expirations開頭的key裏面
        String expireKey = getExpirationKey(toExpire);
        BoundSetOperations<Object, Object> expireOperations = this.redis
                .boundSetOps(expireKey);
        expireOperations.add(keyToExpire);
 
        long fiveMinutesAfterExpires = sessionExpireInSeconds
                + TimeUnit.MINUTES.toSeconds(5);
        //spring:session:expirations開頭的key過時時間爲xml配置的時間後五分鐘
        expireOperations.expire(fiveMinutesAfterExpires, TimeUnit.SECONDS);
        if (sessionExpireInSeconds == 0) {
            this.redis.delete(sessionKey);
        }
        else {
            //spring:session:sessions:expires開頭的key過時時間爲xml配置的時間
            this.redis.boundValueOps(sessionKey).append("");
            this.redis.boundValueOps(sessionKey).expire(sessionExpireInSeconds,
                    TimeUnit.SECONDS);
        }
        //spring:session:sessions開頭的key過時時間爲xml配置的時間後五分鐘
        this.redis.boundHashOps(getSessionKey(session.getId()))
                .expire(fiveMinutesAfterExpires, TimeUnit.SECONDS);
    }

Redis過時鍵有三種刪除策略，分別是定時刪除，惰性刪除，按期刪除。

定時刪除：經過維護一個定時器，過時立刻刪除，是最有效的，可是也是最浪費cpu時間的。
惰性刪除：程序在取出鍵時才判斷它是否過時，過時才刪除，這個方法對cpu時間友好，對內存不友好。
按期刪除：每隔必定時間執行一次刪除過時鍵的操做，並限制每次刪除操做的執行時長和頻率，是一種折中。

Redis採用了惰性刪除和按期刪除的策略。因而可知依賴 Redis 的過時策略實時刪除過時key是不可靠的。

另一方面，業務可能會在Spring Session過時後作業務邏輯處理，同時須要session裏面的信息，若是隻有一個 spring:session:sessions鍵值，那麼Redis刪除就刪除了，業務無法獲取session信息。

spring:session:expirations鍵中存儲了spring:session:sessions:expires鍵，而spring:session:sessions:expires鍵過時五分鐘早於spring:session:expirations鍵和spring:session:sessions鍵（實際Spring Session對於過時事件處理訂閱的spring:session:sessions:expires鍵，下一節會具體講），這樣在訂閱到過時事件時還能獲取spring:session:sessions鍵值。

若是經過Redis自己清理機制未及時清除spring:session:sessions:expires，能夠經過Spring Session提供的定時任務兜底，保證spring:session:sessions:expires清除。

RedisSessionExpirationPolicy，session清理定時任務

public void cleanExpiredSessions() {
        long now = System.currentTimeMillis();
        long prevMin = roundDownMinute(now);
        ......
        //獲取到spring:session:expirations鍵
        String expirationKey = getExpirationKey(prevMin);
        // 取出當前這一分鐘應當過時的 session
        Set<Object> sessionsToExpire = this.redis.boundSetOps(expirationKey).members();
        // 注意：這裏刪除的是spring:session:expirations鍵，不是刪除 session 自己！
        this.redis.delete(expirationKey);
        for (Object session : sessionsToExpire) {
            String sessionKey = getSessionKey((String) session);
            //遍歷一下spring:session:sessions:expires鍵
            touch(sessionKey);
        }
    }
 
    /**
     * By trying to access the session we only trigger a deletion if it the TTL is
     * expired. This is done to handle
     * https://github.com/spring-projects/spring-session/issues/93
     *
     * @param key the key
     */
    private void touch(String key) {
        //並非直接刪除 key，而只是訪問 key，經過惰性刪除確保spring:session:sessions:expires鍵實時刪除，
        // 同時也保證多線程併發續簽的場景下，key移動到不一樣spring:session:expirations鍵裏面時，
        //以spring:session:sessions:expires鍵實際ttl時間爲準
        this.redis.hasKey(key);
    }

五、事件訂閱

默認至少訂閱鍵空間通知gxE事件（http://redisdoc.com/topic/notification.html）。

ConfigureNotifyKeyspaceEventsAction，開啓鍵空間通知：

public void configure(RedisConnection connection) {
       String notifyOptions = getNotifyOptions(connection);
       String customizedNotifyOptions = notifyOptions;
       if (!customizedNotifyOptions.contains("E")) {
           customizedNotifyOptions += "E";
       }
       boolean A = customizedNotifyOptions.contains("A");
       if (!(A || customizedNotifyOptions.contains("g"))) {
           customizedNotifyOptions += "g";
       }
       if (!(A || customizedNotifyOptions.contains("x"))) {
           customizedNotifyOptions += "x";
       }
       if (!notifyOptions.equals(customizedNotifyOptions)) {
           connection.setConfig(CONFIG_NOTIFY_KEYSPACE_EVENTS, customizedNotifyOptions);
       }
   }

RedisHttpSessionConfiguration，註冊監聽事件：

@Bean
 public RedisMessageListenerContainer redisMessageListenerContainer(
         RedisConnectionFactory connectionFactory,
         RedisOperationsSessionRepository messageListener) {
             ......
     //psubscribe del和expired事件
     container.addMessageListener(messageListener,
             Arrays.asList(new PatternTopic("__keyevent@*:del"),
                     new PatternTopic("__keyevent@*:expired")));
     //psubscribe created事件
     container.addMessageListener(messageListener, Arrays.asList(new PatternTopic(
             messageListener.getSessionCreatedChannelPrefix() + "*")));
     return container;
 }

RedisOperationsSessionRepository，事件處理：

public void onMessage(Message message, byte[] pattern) {
      ......
      if (channel.startsWith(getSessionCreatedChannelPrefix())) {
          ...
          //處理spring:session created事件
          handleCreated(loaded, channel);
          return;
      }
 
      //非spring:session:sessions:expires事件不作處理
      String body = new String(messageBody);
      if (!body.startsWith(getExpiredKeyPrefix())) {
          return;
      }
 
      boolean isDeleted = channel.endsWith(":del");
      if (isDeleted || channel.endsWith(":expired")) {
          ......
          if (isDeleted) {
              //處理spring:session:sessions:expires del事件
              handleDeleted(sessionId, session);
          }
          else {
              //處理spring:session:sessions:expires expired事件
              handleExpired(sessionId, session);
          }
          ......
          return;
      }
  }

事件訂閱樣例：

@Component
public class SessionExpiredListener implements ApplicationListener<SessionExpiredEvent> {
    @Override
    public void onApplicationEvent(SessionExpiredEvent event) {
        ......
    }
}