Rin 可以捕獲對 ASP.NET Core 應用程式的 HTTP 請求,並為捕獲的數據提供檢視器。它是偵錯 Web 應用程式(例如,網站、API 套用)的有用工具。
先看如下程式碼:
var
builder = WebApplication.CreateBuilder(args);
builder.Logging.AddRinLogger();
builder.Services.AddRin();
builder.Services.AddHttpClient();
var
app = builder.Build();
app.UseRin();
app.UseRinDiagnosticsHandler();
var
summaries = new
[]
{
"Freezing"
, "Bracing"
, "Chilly"
, "Cool"
, "Mild"
, "Warm"
, "Balmy"
, "Hot"
, "Sweltering"
, "Scorching"
};
app.MapGet("/weatherforecast"
, ()
=>
{
var
forecast = Enumerable.Range(1
, 5
).Select(index
=>
new
WeatherForecast
(
DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
Random.Shared.Next(-20
, 55
),
summaries[Random.Shared.Next(summaries.Length)]
))
.ToArray();
return
forecast;
});
app.MapPost("/weatherforecast"
, (WeatherForecast weather
) =>
{
return
weather;
});
app.MapPut("/weatherforecast"
, (WeatherForecast weather
) =>
{
return
weather;
});
app.MapDelete("/weatherforecast"
, (int id
) =>
{
return
true
;
});
app.MapGet("/weather"
, async
(IHttpClientFactory clientFactory) =>
{
var
lat = "35.71459525981295"
;
var
lon = "139.7989249730396"
;
var
apiKey = "6d43c019aa2aeb0e7dd5ce070f174248"
;
var
client = clientFactory.CreateClient();
var
url = $"https://api.openweathermap.org/data/2.5/forecast?lat={lat}&lon={lon}&appid={apiKey}"
;
Console.WriteLine(url);
var
response = await
client.GetAsync(url);
return
response.Content.ReadAsStringAsync();
});
app.Run();
internal record WeatherForecast(DateOnly Date
, int TemperatureC, string
? Summary)
{
public
int TemperatureF => 32
+ (int)(TemperatureC / 0.5556
);
}
Rin是內建的,執行起程式後,只需要換成/rin,就可以存取具體請求資訊,這點非常方便,輕巧。如下圖,是get請求的相關資訊。
Request基本資訊:
Response基本資訊:
Timleline:這是區分了Processing和Transferring兩個事件。
上面是get請求的三個Tab資訊。post,put,delete等其他類別請求類似,下圖是post的請求,增加了請求body資訊。
可能你覺得,如果只有這麽簡單,那直接用Postman等客戶端工具也是可以的。當然,是可以的,但Rin不僅如此,還可以對Web內部對第三方的請求也給記錄下來。
下圖是在Timeline,在Proccessing和Transferring增加Trace,來清晰地表示客戶端一個請求,後端的呼叫鏈路。
具體的Trace可以參看Trace的Tab,這裏清晰地說明了4個Trace分別對應的Start processing HTTP Request,Sending HTTP request,Received HTTP response,End procession HTTP request。
Rin很輕量,建議在偵錯時用,在生產環境上,有專業的日誌,監控和鏈路跟蹤系統,並不需要。雖然Rin已有兩年沒有更新,但它的輕量,容用,基本能滿足我們的需求了。