在 ASP.NET Core 中 使用 cookies

  cookie 常用于保存用户相关并保存在客户端电脑上的一段数据，在大多数浏览器下，每一个cookie 都会是一个小文件的形式存在，只有 Firefox 例外，它将所有的 cookie 都保存在一个文件中，cookie 是以 key-value 的形式表现的，可以通过这个 key 去 读取，删除，写入 等操作

  ASP.NET Core 中使用 cookie 机制来维护 session 状态，在客户端的每一次请求中，server 端都会将 sessionid 放在 cookie 中发送给客户端来实现用户跟踪

读取Cookie

• 要想读取 Cookie 可以采用 ASP.NET Core 中的 ​​Request.Cookies​​ 属性，从 Request 对象中读取 cookie

string cookie = Request.Cookies["Key"];

• 如果你想给 cookie 设置一个过期时间，可以使用 ​​Cookies.Append​​ 重载方法，如下代码所示：

CookieOptions option = new CookieOptions(); 
option.Expires = DateTime.Now.AddMilliseconds(10); 
Response.Cookies.Append(key, value, option);

  从上面代码中可以看到，在生成 Cookie 的过程中可以使用 CookieOptions 来给其配置一些额外参数

写入 cookie

• 要想写 cookie，可以利用 ​​Cookies.Append​​ 方法

Response.Cookies.Append(somekey, somevalue);

删除 cookie

• 要想删除 cookie，可以利用 ​​Cookies.Delete​​ 方法

Response.Cookies.Delete(somekey);

使用 HttpContext

  如何在 ASP.NET Core 中使用 cookie，要想得到 cookie 必须要有 ​​Request​​​ 对象，要想得到 Request 对象 必须要有 ​​HttpContext​​​，要想得到 ​​HttpContext​​​ 必须要利用 ​​IHttpContextAccessor​​ 接口

public interface IHttpContextAccessor
{
  HttpContext HttpContext { get; set; }
}

• ASP.NET Core 中就内置了一个实现了该接口的 ​​HttpContextAccessor​​ 类

public class HttpContextAccessor : IHttpContextAccessor
{
  public HttpContextAccessor();

  public HttpContext HttpContext { get; set; }
}

  有些朋友可能要问，为啥这里不直接使用父类 Controller 的 ​​Request​​​ 和 ​​HttpContext​​​，这是因为此方式是一种强依赖，接下来给大家演示如何通过依赖注入的方式获取 ​​HttpContext​​，此种更加灵活。

  为了实现依赖注入，需要将 ​​IHttpContextAccessor​​​ 和 ​​HttpContextAccessor​​​ 注入到 ​​ServiceCollection​​ 中，下面就用单例的模式进行注入

public void ConfigureServices(IServiceCollection services)
{
  services.AddSingleton<IHttpContextAccessor,
  HttpContextAccessor>();
  // 逻辑代码
}

  然后就可以通过依赖注入的方式获取 ​​IHttpContextAccessor​​​ 接口的实例，再依次获取 ​​HttpContext​​​ 对象，下面的代码片段展示了如何在 Controller 中访问 ​​IHttpContextAccessor​​ 实例

public class HomeController : Controller
{
    private readonly IHttpContextAccessor _httpContextAccessor;
    public HomeController(IHttpContextAccessor httpContextAccessor)
    {
        this._httpContextAccessor = httpContextAccessor;
    }   
  // 逻辑代码
}

在 Controller 中写入 cookie

• 在 Controller 中通过如下方法将 数据 写入 cookie

public IActionResult Write(string key, string value, bool isPersistent)
{
  CookieOptions options = new CookieOptions();
  if (isPersistent)
    options.Expires = DateTime.Now.AddDays(1);
  else
    options.Expires = DateTime.Now.AddSeconds(10);
  _httpContextAccessor.HttpContext.Response.Cookies.Append(key, value, options);
  return View("WriteCookie");
}

在 Controller 中读取 cookie

• 一旦 cookie 成功写入之后，就可以用如下方法读取 cookie

public IActionResult Read(string key)
{
  ViewBag.Data = _httpContextAccessor.HttpContext.Request.Cookies[key];
  return View("ReadCookie");
}

• 可以使用 浏览器的 开发者工具 来查看 Cookie 是否成功写入并读取到

====