مدیریت خطای جهانی در NET 8

Summarize this content to 400 words in Persian Lang
مدیریت خطا یکی از اجزای حیاتی هر برنامه وب قوی است. در NET 8، مدیریت خطای جهانی برای ارائه مدیریت ساده تر و کارآمدتر استثناها بهبود یافته است. این پست شما را از طریق راه‌اندازی مدیریت خطای سراسری در برنامه NET 8 خود راهنمایی می‌کند و اطمینان می‌دهد که برنامه شما می‌تواند به خوبی خطاهای غیرمنتظره را مدیریت کند.

چرا مدیریت خطای جهانی؟

مدیریت خطای جهانی به شما امکان می دهد استثناها را به صورت متمرکز مدیریت کنید. این رویکرد تضمین می کند که همه استثناهای کنترل نشده به طور یکنواخت شناسایی و پردازش می شوند و استحکام و تجربه کاربری برنامه شما را بهبود می بخشد.

راه اندازی مدیریت خطای جهانی

برای راه‌اندازی مدیریت خطای سراسری در NET 8، این مراحل را دنبال کنید:

مرحله 1. یک میان افزار سفارشی ایجاد کنید

ابتدا یک میان افزار سفارشی برای رسیدگی به استثناها ایجاد کنید. این میان افزار استثناها را می گیرد و یک پاسخ خطای کاربر پسند را برمی گرداند.

public class GlobalExceptionHandlerMiddleware
{
private readonly RequestDelegate _next;

public GlobalExceptionHandlerMiddleware(RequestDelegate next)
{
_next = next;
}

public async Task InvokeAsync(HttpContext context)
{
try
{
await _next(context);
}
catch (Exception ex)
{
await HandleExceptionAsync(context, ex);
}
}

private static Task HandleExceptionAsync(HttpContext context, Exception exception)
{
context.Response.ContentType = “application/json”;
context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;

var response = new { message = “An unexpected error occurred.”, details = exception.Message };
return context.Response.WriteAsync(JsonConvert.SerializeObject(response));
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

مرحله 2. Middleware را ثبت کنید

بعد، میان افزار را در قسمت ثبت کنید Configure روش شما Startup کلاس

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseMiddlewareGlobalExceptionHandlerMiddleware>();

// Other middleware registrations
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

مرحله 3. کنترل خطا را تست کنید

برای آزمایش مدیریت خطای جهانی، می‌توانید کنترل‌کننده‌ای ایجاد کنید که یک استثنا ایجاد کند.

[ApiController] [Route(“[controller]”)] public class TestController : ControllerBase
{
[HttpGet] public IActionResult Get()
{
throw new Exception(“Test exception”);
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

هنگامی که به نقطه پایانی حرکت می کنید، باید یک پاسخ JSON با پیام خطا مشاهده کنید.

مزایای مدیریت خطای جهانی

سازگاری: اطمینان حاصل می کند که همه خطاها به شیوه ای ثابت مدیریت می شوند.

قابلیت نگهداری: مدیریت خطای متمرکز نگهداری کد را آسان تر می کند.

تجربه کاربری: با بازگرداندن پیام های خطای دوستانه، تجربه کاربری بهتری را ارائه می دهد.

نتیجه گیری

مدیریت خطای جهانی در دات نت 8 یک ویژگی قدرتمند است که می تواند به شما در ساخت برنامه های کاربردی قوی تر و کاربر پسند کمک کند. با دنبال کردن مراحل ذکر شده در این پست، می توانید مدیریت خطای جهانی را در برنامه خود تنظیم کنید و اطمینان حاصل کنید که همه استثناها به خوبی مدیریت می شوند.

   public class GlobalExceptionHandlerMiddleware
   {
       private readonly RequestDelegate _next;

       public GlobalExceptionHandlerMiddleware(RequestDelegate next)
       {
           _next = next;
       }

       public async Task InvokeAsync(HttpContext context)
       {
           try
           {
               await _next(context);
           }
           catch (Exception ex)
           {
               await HandleExceptionAsync(context, ex);
           }
       }

       private static Task HandleExceptionAsync(HttpContext context, Exception exception)
       {
           context.Response.ContentType = "application/json";
           context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;

           var response = new { message = "An unexpected error occurred.", details = exception.Message };
           return context.Response.WriteAsync(JsonConvert.SerializeObject(response));
       }
   }

   public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
   {
       app.UseMiddlewareGlobalExceptionHandlerMiddleware>();

       // Other middleware registrations
       app.UseRouting();
       app.UseEndpoints(endpoints =>
       {
           endpoints.MapControllers();
       });
   }

   [ApiController]
   [Route("[controller]")]
   public class TestController : ControllerBase
   {
       [HttpGet]
       public IActionResult Get()
       {
           throw new Exception("Test exception");
       }
   }