HttpContextExtensions.cs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320
  1. using Microsoft.AspNetCore.Mvc.Controllers;
  2. using Microsoft.Extensions.Primitives;
  3. using System.Text;
  4. namespace IES.ExamServer
  5. {
  6. public static class HttpContextExtensions
  7. {
  8. /// <summary>
  9. /// 取得驗證金鑰,Authorization
  10. /// </summary>
  11. public static string GetToken(this HttpContext httpContext)
  12. {
  13. return httpContext.Request.Headers["Authorization"].ToString();
  14. }
  15. /// <summary>
  16. /// 获取 Action 特性
  17. /// </summary>
  18. /// <typeparam name="TAttribute"></typeparam>
  19. /// <param name="httpContext"></param>
  20. /// <returns></returns>
  21. public static TAttribute? GetMetadata<TAttribute>(this HttpContext httpContext)
  22. where TAttribute : class
  23. {
  24. return httpContext.GetEndpoint()?.Metadata?.GetMetadata<TAttribute>();
  25. }
  26. /// <summary>
  27. /// 获取 控制器/Action 描述器
  28. /// </summary>
  29. /// <param name="httpContext"></param>
  30. /// <returns></returns>
  31. public static ControllerActionDescriptor? GetControllerActionDescriptor(this HttpContext httpContext)
  32. {
  33. return httpContext.GetEndpoint()?.Metadata?.FirstOrDefault(u => u is ControllerActionDescriptor) as ControllerActionDescriptor;
  34. }
  35. /// <summary>
  36. /// 获取本机 IPv4地址
  37. /// </summary>
  38. /// <param name="context"></param>
  39. /// <returns></returns>
  40. public static string? GetLocalIpAddressToIPv4(this HttpContext context)
  41. {
  42. return context.Connection.LocalIpAddress?.MapToIPv4()?.ToString();
  43. }
  44. /// <summary>
  45. /// 获取本机 IPv6地址
  46. /// </summary>
  47. /// <param name="context"></param>
  48. /// <returns></returns>
  49. public static string? GetLocalIpAddressToIPv6(this HttpContext context)
  50. {
  51. return context.Connection.LocalIpAddress?.MapToIPv6()?.ToString();
  52. }
  53. /// <summary>
  54. /// 获取远程 IPv4地址
  55. /// </summary>
  56. /// <param name="context"></param>
  57. /// <returns></returns>
  58. public static string? GetRemoteIpAddressToIPv4(this HttpContext context)
  59. {
  60. return context.Connection.RemoteIpAddress?.MapToIPv4()?.ToString();
  61. }
  62. /// <summary>
  63. /// 获取远程 IPv6地址
  64. /// </summary>
  65. /// <param name="context"></param>
  66. /// <returns></returns>
  67. public static string? GetRemoteIpAddressToIPv6(this HttpContext context)
  68. {
  69. return context.Connection.RemoteIpAddress?.MapToIPv6()?.ToString();
  70. }
  71. /// <summary>
  72. /// 获取完整请求地址
  73. /// </summary>
  74. /// <param name="request"></param>
  75. /// <returns></returns>
  76. public static string GetRequestUrlAddress(this HttpRequest request)
  77. {
  78. return new StringBuilder()
  79. .Append(request.Scheme)
  80. .Append("://")
  81. .Append(request.Host)
  82. .Append(request.PathBase)
  83. .Append(request.Path)
  84. .Append(request.QueryString)
  85. .ToString();
  86. }
  87. /// <summary>
  88. /// 获取来源地址
  89. /// </summary>
  90. /// <param name="request"></param>
  91. /// <param name="refererHeaderKey"></param>
  92. /// <returns></returns>
  93. public static string GetRefererUrlAddress(this HttpRequest request, string refererHeaderKey = "Referer")
  94. {
  95. return request.Headers[refererHeaderKey].ToString();
  96. }
  97. /// <summary>
  98. /// 读取 Body 内容
  99. /// </summary>
  100. /// <param name="httpContext"></param>
  101. /// <remarks>需先在 Startup 的 Configure 中注册 app.EnableBuffering()</remarks>
  102. /// <returns></returns>
  103. public static async Task<string?> ReadBodyContentAsync(this HttpContext httpContext)
  104. {
  105. if (httpContext == null) return default;
  106. return await httpContext.Request.ReadBodyContentAsync();
  107. }
  108. /// <summary>
  109. /// 读取 Body 内容
  110. /// </summary>
  111. /// <param name="request"></param>
  112. /// <remarks>需先在 Startup 的 Configure 中注册 app.EnableBuffering()</remarks>
  113. /// <returns></returns>
  114. public static async Task<string> ReadBodyContentAsync(this HttpRequest request)
  115. {
  116. request.Body.Seek(0, SeekOrigin.Begin);
  117. using var reader = new StreamReader(request.Body, Encoding.UTF8, true, 1024, true);
  118. var body = await reader.ReadToEndAsync();
  119. // 回到顶部,解决此类问题 https://gitee.com/dotnetchina/Furion/issues/I6NX9E
  120. request.Body.Seek(0, SeekOrigin.Begin);
  121. return body;
  122. }
  123. /// <summary>
  124. /// 判断是否是 WebSocket 请求
  125. /// </summary>
  126. /// <param name="context"></param>
  127. /// <returns></returns>
  128. public static bool IsWebSocketRequest(this HttpContext context)
  129. {
  130. return context.WebSockets.IsWebSocketRequest || context.Request.Path == "/ws";
  131. }
  132. /// <summary>
  133. /// 设置响应头 Tokens
  134. /// </summary>
  135. /// <param name="httpContext"></param>
  136. /// <param name="accessToken"></param>
  137. /// <param name="refreshToken"></param>
  138. public static void SetTokensOfResponseHeaders(this HttpContext httpContext, string accessToken, string refreshToken = null)
  139. {
  140. httpContext.Response.Headers["access-token"] = accessToken;
  141. if (!string.IsNullOrWhiteSpace(refreshToken))
  142. {
  143. httpContext.Response.Headers["x-access-token"] = refreshToken;
  144. }
  145. }
  146. /// <summary>
  147. /// 取得JWT驗證金鑰,Authorization Bearer
  148. /// </summary>
  149. /// <param name="httpContext"></param>
  150. /// <returns></returns>
  151. public static string GetJwtToken(this HttpContext httpContext)
  152. {
  153. var token = string.Empty;
  154. string authorization = httpContext.Request.Headers["Authorization"].ToString();
  155. if (!string.IsNullOrWhiteSpace(authorization) && authorization.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase))
  156. {
  157. token = authorization.Substring("Bearer ".Length).Trim();
  158. }
  159. return token;
  160. }
  161. /// <summary>
  162. /// 取得遠端呼叫的IP
  163. /// </summary>
  164. public static string? GetRemoteIP(this HttpContext httpContext)
  165. {
  166. return httpContext?.Connection?.RemoteIpAddress?.ToString();
  167. }
  168. /// <summary>
  169. /// 取得X-Auth-Key值
  170. /// </summary>
  171. /// <param name="key">Key Name</param>
  172. /// <returns></returns>
  173. public static string? GetXAuth(this HttpContext httpContext, string? key = null)
  174. {
  175. try
  176. {
  177. if (httpContext.Request.Headers.TryGetValue($"X-Auth-{key}", out StringValues value))
  178. return value.ToString();
  179. else
  180. return null;
  181. }
  182. catch
  183. {
  184. return null;
  185. }
  186. }
  187. /// <summary>
  188. /// 取得X-Auth-Key值
  189. /// </summary>
  190. /// <param name="key">Key Name</param>
  191. /// <returns></returns>
  192. public static string? GetAuthorization(this HttpContext httpContext)
  193. {
  194. try
  195. {
  196. if (httpContext.Request.Headers.TryGetValue("Authorization", out StringValues value))
  197. return value.ToString();
  198. else
  199. return null;
  200. }
  201. catch
  202. {
  203. return null;
  204. }
  205. }
  206. /// <summary>
  207. /// 取得AuthToken權杖資訊
  208. /// </summary>
  209. /// <param name="key">Key Name</param>
  210. /// <returns></returns>
  211. public static (string? id, string? school) GetApiTokenInfo(this HttpContext httpContext, string? key = null)
  212. {
  213. object? id = null, school = null;
  214. httpContext?.Items.TryGetValue("ID", out id);
  215. httpContext?.Items.TryGetValue("School", out school);
  216. return (id?.ToString(), school?.ToString());
  217. }
  218. /// <summary>
  219. /// 取得AuthToken權杖資訊
  220. /// </summary>
  221. /// <param name="key">Key Name</param>
  222. /// <returns></returns>
  223. public static (string? id, string? name, string? picture, string? school) GetAuthTokenInfo(this HttpContext httpContext, string? key = null)
  224. {
  225. object? id = null, name = null, picture = null, school = null;
  226. httpContext?.Items.TryGetValue("ID", out id);
  227. httpContext?.Items.TryGetValue("Name", out name);
  228. httpContext?.Items.TryGetValue("Picture", out picture);
  229. httpContext?.Items.TryGetValue("School", out school);
  230. return (id?.ToString(), name?.ToString(), picture?.ToString(), school?.ToString());
  231. }
  232. /// <summary>
  233. /// 取得AuthToken權杖資訊
  234. /// </summary>
  235. /// <param name="key">Key Name</param>
  236. /// <returns></returns>
  237. public static (string? id, string? name, string? picture, string? school, string? area, string? keyData) GetAuthTokenKey(this HttpContext httpContext, string key = null)
  238. {
  239. object? id = null, name = null, picture = null, school = null, area = null, keyData = null;
  240. httpContext?.Items.TryGetValue("ID", out id);
  241. httpContext?.Items.TryGetValue("Name", out name);
  242. httpContext?.Items.TryGetValue("Picture", out picture);
  243. httpContext?.Items.TryGetValue("School", out school);
  244. httpContext?.Items.TryGetValue("Area", out area);
  245. if (!string.IsNullOrWhiteSpace(key))
  246. {
  247. httpContext?.Items.TryGetValue(key, out keyData);
  248. }
  249. return (id?.ToString(), name?.ToString(), picture?.ToString(), school?.ToString(), area?.ToString(), keyData?.ToString());
  250. }
  251. /// <summary>
  252. /// 取得User-Agent值
  253. /// </summary>
  254. public static string? GetUserAgent(this HttpContext httpContext)
  255. {
  256. try
  257. {
  258. return httpContext.Request.Headers["User-Agent"].ToString();
  259. }
  260. catch
  261. {
  262. return null;
  263. }
  264. }
  265. /// <summary>
  266. /// 取得Scheme值
  267. /// </summary>
  268. public static string? GetScheme(this HttpContext httpContext)
  269. {
  270. return httpContext?.Request?.Scheme;
  271. }
  272. /// <summary>
  273. /// 取得HostName值
  274. /// </summary>
  275. public static string? GetHostName(this HttpContext httpContext)
  276. {
  277. return httpContext?.Request?.Host.ToString();
  278. }
  279. /// <summary>
  280. /// 设置本地cookie
  281. /// </summary>
  282. /// <param name="key">键</param>
  283. /// <param name="value">值</param>
  284. /// <param name="minutes">过期时长,单位:分钟</param>
  285. public static void SetCookies(HttpResponse Response, string key, string value, int minutes = 30)
  286. {
  287. Response.Cookies.Append(key, value, new CookieOptions
  288. {
  289. Expires = DateTimeOffset.Now.AddMinutes(minutes)
  290. });
  291. }
  292. /// <summary>
  293. /// 删除指定的cookie
  294. /// </summary>
  295. /// <param name="key">键</param>
  296. public static void DeleteCookies(HttpContext httpContext, string key)
  297. {
  298. httpContext.Response.Cookies.Delete(key);
  299. }
  300. }
  301. }