ASP.NET?Core在WebApi項目中使用Cookie
一、Cookie的作用
Cookie通常用來存儲有關(guān)用戶信息的一條數(shù)據(jù),可以用來標識登錄用戶,Cookie存儲在客戶端的瀏覽器上。在大多數(shù)瀏覽器中,每個Cookie都存儲為一個小文件。Cookie表示為鍵/值對的形式,可以利用鍵來讀取、寫入或刪除Cookie。
在ASP.NET Core中也可以使用Cookie來維護回話狀態(tài),包含回話ID的Cookie會隨著每個請求一起發(fā)送到客戶端。
二、在ASP.NET Core中使用Cookie
我們創(chuàng)建一個ASP.NET Core WebApi的項目,然后在WebApi中測試使用Cookie。
1、在控制器中直接使用Cookie
在項目中添加一個控制器,用來測試Cookie:
1.1、設(shè)置Cookie
我們在控制器里面可以使用下面的代碼設(shè)置Cookie:
HttpContext.Response.Cookies.Append("setCookie", "CookieValue");
如果想設(shè)置Cookie的過期時間,我們可以使用Append的重載方法:
CookieOptions options = new CookieOptions(); // 設(shè)置過期時間 options.Expires = DateTime.Now.AddDays(1); HttpContext.Response.Cookies.Append("setCookieExpires", "CookieValueExpires", options);
控制器里面的方法代碼如下:
using System; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; namespace CookieDemo.Controllers { [Route("api/")] [ApiController] public class CookieTestController : ControllerBase { /// <summary> /// 設(shè)置Cookie /// </summary> [HttpGet] [Route("SetCookie")] public void Get() { HttpContext.Response.Cookies.Append("setCookie", "CookieValue"); CookieOptions options = new CookieOptions(); // 設(shè)置過期時間 options.Expires = DateTime.Now.AddDays(1); HttpContext.Response.Cookies.Append("setCookieExpires", "CookieValueExpires", options); } } }
CookieOptions類可以在創(chuàng)建Cookie時指定如下的附加屬性:
- 域:用于指定與Cookie關(guān)聯(lián)的域。
- 過期時間:用于指定Cookie的過期時間。
- 路徑:用于指定Cookie路徑。
- 安全策略:用于指定Cookie是否可以通過HTTPS訪問。
- HttpOnly:用于指定Cookie是否僅對服務(wù)器可用。
運行程序,我們首先訪問WeatherForecast控制器,并且查看Cookie信息:
我們看到,這里只有一個Cookie信息,接下來方法SetCookie方法:
我們看到,這里已經(jīng)有我們剛才添加的Cookie信息了。
1.2、獲取Cookie
我們可以根據(jù)key來獲取Cookie信息:
HttpContext.Request.Cookies["key"];
我們來看具體代碼:
using System; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; namespace CookieDemo.Controllers { [Route("api/")] [ApiController] public class CookieTestController : ControllerBase { /// <summary> /// 設(shè)置Cookie /// </summary> [HttpGet] [Route("SetCookie")] public void Get() { HttpContext.Response.Cookies.Append("setCookie", "CookieValue"); CookieOptions options = new CookieOptions(); // 設(shè)置過期時間 options.Expires = DateTime.Now.AddDays(1); HttpContext.Response.Cookies.Append("setCookieExpires", "CookieValueExpires", options); } /// <summary> /// 根據(jù)key獲取Cookie的Value值 /// </summary> /// <returns></returns> [HttpGet] [Route("GetCookie")] public string GetCookid() { return HttpContext.Request.Cookies["setCookie"]; } } }
運行程序,查看效果:
1.3、刪除Cookie信息
我們可以根據(jù)key刪除Cookie信息,如下代碼:
HttpContext.Response.Cookies.Delete("key");
接下來看具體代碼:
using System; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; namespace CookieDemo.Controllers { [Route("api/")] [ApiController] public class CookieTestController : ControllerBase { /// <summary> /// 設(shè)置Cookie /// </summary> [HttpGet] [Route("SetCookie")] public void Get() { HttpContext.Response.Cookies.Append("setCookie", "CookieValue"); CookieOptions options = new CookieOptions(); // 設(shè)置過期時間 options.Expires = DateTime.Now.AddDays(1); HttpContext.Response.Cookies.Append("setCookieExpires", "CookieValueExpires", options); } /// <summary> /// 根據(jù)key獲取Cookie的Value值 /// </summary> /// <returns></returns> [HttpGet] [Route("GetCookie")] public string GetCookid() { return HttpContext.Request.Cookies["setCookie"]; } /// <summary> /// 根據(jù)key刪除Cookie /// </summary> [HttpGet] [Route("DeleteCookie")] public void DeleteCookie() { HttpContext.Response.Cookies.Delete("setCookie"); } } }
運行程序,我們看查看獲取Cookie的效果:
接下來我們訪問刪除Cookie的方法:
可以看到,剛才的Cookie信息已經(jīng)刪除掉了。
2、封裝Cookie
在上面的例子中,我們是訪問的HttpContext對象的Response和Request,然后才能設(shè)置、獲取或刪除Cookie信息。在具體的程序中,我們一般是把Cookie的操作進行封裝,我們可以使用IHttpContextAccessor接口訪問ASP.NET Core中的HttpContext.HttpContextAccessor類實現(xiàn)此接口。下面我們看一下如何在類庫中操作Cookie。
首先,我們需要注冊IHttpContextAccessor以進行依賴項注入,在Startup類的ConfigureServices方法中添加類型為HttpContextAccessor的單例服務(wù):
public void ConfigureServices(IServiceCollection services) { // 注冊為單例 services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>(); services.AddControllers(); }
因為我們是在類庫中使用Cookie,所以需要創(chuàng)建一個單獨的類庫:
接下來創(chuàng)建一個接口,里面封裝Cookie的一些操作:
namespace CookieDemo.Framework { public interface ICookieHelper { void SetCookie(string key, string value); void SetCookie(string key, string value, int expiresTime); string GetCookie(string key); void DeleteCookie(string key); } }
然后定義一個具體的實現(xiàn)類實現(xiàn)ICookieHelper接口:
using Microsoft.AspNetCore.Http; using System; namespace CookieDemo.Framework { public class CookieHelper : ICookieHelper { private readonly IHttpContextAccessor _httpContextAccessor; /// <summary> /// 通過構(gòu)造函數(shù)進行注入 /// </summary> /// <param name="httpContextAccessor"></param> public CookieHelper(IHttpContextAccessor httpContextAccessor) { _httpContextAccessor = httpContextAccessor; } /// <summary> /// 根據(jù)key值刪除對應(yīng)的Cookie /// </summary> /// <param name="key">key值</param> public void DeleteCookie(string key) { _httpContextAccessor.HttpContext.Response.Cookies.Delete(key); } /// <summary> /// 根據(jù)key值獲取Cookie的value值 /// </summary> /// <param name="key">key值</param> /// <returns></returns> public string GetCookie(string key) { return _httpContextAccessor.HttpContext.Request.Cookies[key]; } /// <summary> /// 設(shè)置Cookie值 /// </summary> /// <param name="key">key值</param> /// <param name="value">value值</param> public void SetCookie(string key, string value) { _httpContextAccessor.HttpContext.Response.Cookies.Append(key, value); } /// <summary> /// 設(shè)置Cookie及過期時間 /// </summary> /// <param name="key">key值</param> /// <param name="value">value值</param> /// <param name="expiresTime">過期時間,以分鐘為單位</param> public void SetCookie(string key, string value, int expiresTime) { CookieOptions options = new CookieOptions() { Expires = DateTime.Now.AddMinutes(expiresTime) }; _httpContextAccessor.HttpContext.Response.Cookies.Append(key, value,options); } } }
最后我們還需要在Startup的ConfigureServices方法里面注入:
public void ConfigureServices(IServiceCollection services) { // 注冊為單例 services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>(); // 注冊Cookie操作接口 services.AddSingleton<ICookieHelper, CookieHelper>(); services.AddControllers(); }
在添加一個控制器訪問Cookie:
using CookieDemo.Framework; using Microsoft.AspNetCore.Mvc; namespace CookieDemo.Controllers { [Route("api/CookieHelperTest")] [ApiController] public class CookieHelperTestController : ControllerBase { private readonly ICookieHelper _helper; public CookieHelperTestController(ICookieHelper helper) { _helper = helper; } /// <summary> /// 設(shè)置Cookie /// </summary> [HttpGet] [Route("SetCookie")] public void Get() { _helper.SetCookie("cookieHelperKey", "cookieHelperValue"); // 設(shè)置過期時間 _helper.SetCookie("cookieHelperExpiresKey", "cookieHelperExpitesValue",10); } /// <summary> /// 根據(jù)key獲取Cookie的Value值 /// </summary> /// <returns></returns> [HttpGet] [Route("GetCookie")] public string GetCookid() { return _helper.GetCookie("cookieHelperKey"); } /// <summary> /// 根據(jù)key刪除Cookie /// </summary> [HttpGet] [Route("DeleteCookie")] public void DeleteCookie() { _helper.DeleteCookie("cookieHelperKey"); } } }
運行程序,首先訪問設(shè)置Cookie的方法:
可以看到,已經(jīng)我們設(shè)置的Cookie信息了。
接下來訪問獲取Cookie:
可以根據(jù)key獲取到對應(yīng)的value值。
最后訪問刪除Cookie:
可以看到,key對應(yīng)的cookie已經(jīng)被刪除了。
GitHub源碼地址:https://github.com/jxl1024/Cookie
到此這篇關(guān)于ASP.NET Core在WebApi項目中使用Cookie的文章就介紹到這了。希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
- ASP.NET Core使用HttpClient調(diào)用WebService
- ASP.NET?Core項目中調(diào)用WebService的方法
- 創(chuàng)建ASP.NET?Core?Web應(yīng)用程序并介紹項目模板
- ASP.NET?Core命名空間System.Text.Encodings.Web介紹
- asp.net core webapi文件上傳功能的實現(xiàn)
- 在IIS上部署ASP.NET Core Web API的方法步驟
- ASP.NET Core實現(xiàn)自定義WebApi模型驗證詳解
- ASP.NET Core Web中使用AutoMapper進行對象映射
相關(guān)文章
ASP.NET設(shè)計網(wǎng)絡(luò)硬盤之刪除文件夾實現(xiàn)代碼
對于不再需要的文件/文件夾用戶有權(quán)限做刪除處理。這一節(jié)就介紹如何實現(xiàn)這一功能2012-10-10Server Application Unavailable出現(xiàn)的原因及解決方案小結(jié)
今天在服務(wù)器安裝了個.net 4.0 framework(原本有1.0和2.0的),配置好站點后,選擇版本為4.0,訪問出錯,asp.net經(jīng)常會出現(xiàn)這個問題,這里腳本之家簡單的給整理下2012-05-05asp.net中如何批量導出access某表內(nèi)容到word文檔
最近有項目需求是這樣的,需要將某表中的每一條記錄中的某些內(nèi)容導出在一個word文檔中。下面小編就把我的解決辦法分享給大家,供大家參考2015-10-10