ASP.NET Core 的 HttpContex

HttpContext

HttpContext 类封装了HTTP Request 和 HTTP Response。

当收到一条HTTP Request 请求时,就会实例化一个HttpContext对象。HttpContext对象可以被中间件访问。

注意:HttpContext 不是线程安全的。

读取 HttpContext 的值

从Razer Page 读取

csharp 复制代码
public class IndexModel : PageModel
{
    public void OnGet()
    {
        var message = HttpContext.Request.PathBase;
    }
}

从Razer Page 的cshtml 读取

html 复制代码
@page
@model IndexModel
@{
    var message = HttpContext.Request.PathBase;
}

从 Controller 读取

csharp 复制代码
public class HomeController : Controller
{
    public IActionResult About()
    {
        var pathBase = HttpContext.Request.PathBase;
        return View();
    }
}

从 Minimal API 读取

csharp 复制代码
app.MapGet("/", (HttpContext context) => context.Response.WriteAsync("Hello World"));

修改 HttpContext.Request

HttpContext.Request 可以获取客户端发来的 HttpRequest 请求,并且可以修改其中的值,包括:

  • HttpRequest.Path
  • HttpRequest.Method
  • HttpRequest.Headers
  • HttpRequest.RouteValues
  • HttpRequest.Query
  • HttpRequest.ReadFormAsync()
  • HttpRequest.Body

例如下面的代码:

csharp 复制代码
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", (HttpRequest request) =>
{
    var userAgent = request.Headers.UserAgent;
    var customHeader = request.Headers["x-custom-header"];
    return Results.Ok(new { userAgent = userAgent, customHeader = customHeader });
});

app.Run();

修改 HttpContext.Response

除了能修改接收到的 HttpRequest,返回给客户端的 Response也可以修改。包括:

  • HttpResponse.StatusCode
  • HttpResponse.ContentType
  • HttpResponse.Headers
  • HttpResponse.Body

例子代码如下:

csharp 复制代码
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", (HttpResponse response) =>
{
    response.Headers.CacheControl = "no-cache";
    response.Headers["x-custom-header"] = "Custom value";
    return Results.File(File.OpenRead("helloworld.txt"));
});

app.Run();

设置 Response 尾巴

HTTP/2 和 HTTP/3 支持 Response 尾巴,可以在返回 Response 后设置Response 尾巴。

例子代码如下:

csharp 复制代码
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
app.MapGet("/", (HttpResponse response) =>
{
    // Write body
    response.WriteAsync("Hello world");
    if (response.SupportsTrailers())
    {
        response.AppendTrailer("trailername", "TrailerValue");
    }
});
app.Run();

终止 HttpRequest

HttpContext.RequestAborted cancellation token 可以用于通知HttpRequest 已经被终止。

在请求时:

csharp 复制代码
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var httpClient = new HttpClient();
app.MapPost("/books/{bookId}", async (int bookId, HttpContext context) =>
{
    var stream = await httpClient.GetStreamAsync(
        $"http://consoto/books/{bookId}.json", context.RequestAborted);
    return Results.Stream(stream, "application/json");
});
app.Run();
相关推荐
像风一样自由202023 分钟前
Go语言详细指南:特点、应用场景与开发工具
开发语言·后端·golang
IT_陈寒1 小时前
《Java 21新特性实战:5个必学的性能优化技巧让你的应用快30%》
前端·人工智能·后端
choice of1 小时前
SpringMVC通过注解实现全局异常处理
java·后端·spring
单线程bug1 小时前
Spring Boot中Filter与Interceptor的区别
java·spring boot·后端
小蒜学长1 小时前
基于uni-app的蛋糕订购小程序的设计与实现(代码+数据库+LW)
java·数据库·spring boot·后端·小程序·uni-app
程序员爱钓鱼1 小时前
Go语言实战案例 — 工具开发篇:Go 实现条形码识别器
后端·google·go
期待のcode9 小时前
Spring框架1—Spring的IOC核心技术1
java·后端·spring·架构
Livingbody10 小时前
10分钟完成 ERNIE-4.5-21B-A3B-Thinking深度思考模型部署
后端
胡萝卜的兔11 小时前
go 日志的分装和使用 Zap + lumberjack
开发语言·后端·golang
en-route11 小时前
如何在 Spring Boot 中指定不同的配置文件?
java·spring boot·后端