[asp.net core 源码分析] 01 - Session

 1、Session文档介绍

1. 毋庸置疑学习.Net core最好的方法之一就是学习微软.Net core的官方文档；；
2. .Net core Session的官方文档 
3. .Net core Session Github源码 

2、Session简单应用

2.1、在Startup类的ConfigureServices方法中添加

因为Session的服务端存储需要缓存，所以需要引入.Net core的缓存DistributedMemoryCache；

2.2、在Startup类的Configure方法中添加

app.UseSession();

2.3、使用（存储和获取）

HttpContext.Session.Set(,System.Text.Encoding.Default.GetBytes(<span style="color: #008000;">//<span style="color: #008000;"> 获取
HttpContext.Session.TryGetValue(<span style="color: #800000;">"<span style="color: #800000;">LoginId<span style="color: #800000;">",<span style="color: #0000ff;">out <span style="color: #0000ff;">byte<span style="color: #000000;">[] byteLoginId);
<span style="color: #0000ff;">var loginId = System.Text.Encoding.Default.GetString(byteLoginId); // LoginId="666";

 3、源码分析图

 

 4、源码分析

4.1、程序加载

4.1.1、在ConfigureServices中添加分布式缓存，services.AddDistributedMemoryCache()；

微软官方建议使用AddDistributedMemoryCache，当然也可以使用AddDistributedRedisCache、AddDistributedSqlServerCache或者自定义缓存也是可以的；

如果是分布式系统或者SSO单点登录，建议使用分布式的缓存AddDistributedRedisCache，AddDistributedSqlServerCache；

缓存的官方文档

4.1.2、在ConfigureServices中添加AddSession；

display: none;" onclick="cnblogs_code_hide('d896eb5b-09f2-47f0-a4d5-8b5661f515c0',event)" src="https://www.jb51.cc/res/2019/02-07/23/405b18b4b6584ae338e0f6ecaf736533.gif" alt="">

IServiceCollection AddSession( (services == services.AddTransient IServiceCollection AddSession( IServiceCollection services,Actionfigure) (services == (configure == figure)); figure(configure); }

AddSession为IServiceCollection的扩展方法，有1个重载（传入Session的设置，使用services.Configure(configure)，加载设置）；

services.AddDataProtection()注入数据加密解密DataProtection()，在加密解密SessionKey时使用；

services.AddTransient();注入distributedSessionStore，其中的Create 方法用做创建Session，调用Create方法时执行new distributedSession();  distributedSession类中包含了对IDictionary的增删改查；

 4.1.3、在Configure中UseSession

bedfbe5d6c5d')"> bedfbe5d6c5d" class="code_img_closed" src="https://www.jb51.cc/res/2019/02-07/23/1c53668bcee393edac0d7b3b3daff1ae.gif" alt="">bedfbe5d6c5d" class="code_img_opened" style="display: none;" onclick="cnblogs_code_hide('68b8b403-0f87-4db0-b848-bedfbe5d6c5d',event)" src="https://www.jb51.cc/res/2019/02-07/23/405b18b4b6584ae338e0f6ecaf736533.gif" alt="">

bedfbe5d6c5d" class="cnblogs_code_hide">

   IApplicationBuilder UseSession(       (app ==              
      app.UseMiddleware  
 
   IApplicationBuilder UseSession(noptions options)
       (app ==                   (options ==              
      app.UseMiddleware }

UseSession为IApplicationBuilder的扩展方法，也有1个重载，同样也是加载Session的设置，使用Options.Create(options)结合中间件加载设置；

关于中间件可以参考文档 

SessionMiddleware.cs为Session的中间件；其中包含Session的核心代码，操作MVC之前和之后的代码都在中间件中；

4.2、SessionMiddleware.cs类解析

 在SessionMiddleware中一个异步方法Invoke；主要逻辑中包含了注释，应该很好理解；

isNewSessionKey = Func<> tryEstablishSession = cookieValue = sessionKey = (.IsNullOrWhiteSpace(sessionKey) || sessionKey.Length != guidBytes = [ sessionKey = cookieValue = establisher = tryEstablishSession = isNewSessionKey = feature = feature.Session = context.Features.Set context.Features.Set( (feature.Session != 中的值放入缓存 }