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已有兩年沒有更新，但它的輕量，容用，基本能滿足我們的需求了。
