ویرگول
ورودثبت نام
پرووید
پرووید
پرووید
پرووید
خواندن ۶ دقیقه·۵ سال پیش

بررسی Routing در ASP.NET MVC

در ASP.NET Web Forms Application ها، هر URL باید با یک فایل Aspx متناظر شود. برای مثال، یک URL با آدرس http://domain/studentsinfo.aspx متناظر با یک فایل با نام studentsinfo.aspx است. این فایل می تواند شامل کد و Markup باشد و طبیعتاً وظیفه ی ارسال یک Response را به Browser را دارد.

با استفاده از Routing در ASP.NET می توان این محدودیت که هر URL باید به یک فایل فیزیکی Map شود را حذف کرد. در واقع با استفاده از Routing می توان یک URL Pattern را تعریف کند. این URL Handler باعث Map شدن یک URL به یک Request Handler می شود. این Request Handler می تواند یک کلاس یا یک فایل باشد. در ASP.NET Web Forms Application ها این Request Handler یک فایل Aspx می باشد و در MVC یک Controller و یک Action Method است. برای مثال؛ آدرس http://domain/students می تواند به فایل http://domain/studentsinfo.aspx در ASP.NET Web Forms Application و به Controller با نام Student و یک Action Method با نام Index نگاشت شود.

یک Route چیست؟

به طور ساده یک rR یک روش برای تعریف کردن یک URL Pattern و اطلاعات مربوط به Request Handler است. تمامی Route های پیکربندی شده در یک برنامه در یک جدول با نام RouteTable قرار می گیرند. این جدول توسط Routing Engine برای مشخص کردن Request Handler مناسب برای یک Incoming Request (منظور از Incoming Request یک درخواست ووردی است. در واقع در Request که توسط Browser به سمت سرور ارسال می شود با یک پاسخ یا اصطلاحاً یک Response جواب داده می شود.) استفاده می شود. در تصویر زیر مکانیزم Routing را در MVC به سادگی مشاهده می کنید.

پیکربندی یک Route در MVC

هر MVC Application حداقل باید یک Route را اصطلاحاً Register یا ثبت کند. شاید بدانید که کلمه ی پیکربندی در زبان انگلیسی Configure است. اغلب از همین کلمه استفاده می شود. به طور پیش فرض، فریم ورک MVC یک Route را Register می کند. برای Register کردن یک Route از کلاس RouteConfig.cs که در فولدر App_Start وجود دارد. نحوه ی Register در یک Route در تصویر زیر نشان داده شده است.

همانطور که در تصویر بالا مشاهده می کنید عملیات Register کردن یک Route با استفاده از یک Extension Method به نام MapRoute از کلاس RouteCollection انجام شده است. همانطور که در تصویر بالا مشاهده می کنید نام Default برای این Route در نظر گرفته شده است. علاوه بر این، URL Pattern به صورت “{controller}/{action}/{id}” تعریف شده است و برای هر کدام از پارامترهای Controller، Action و id مقدار پیش فرض در نظر گرفته شده است. مقادیر پیش فرض برای این سه پارامتر به منظور در نظر گرفته شده است که اگر در url مربوط به Incoming Request هر کدام از این پارامترها مشخص نشده باشد، مقداری برای آنها وجود داشته باشد.

به همین صورت می توان با استفاده از متد MapRoute از کلاس RouteCollection اقدام به Configure کردن Route های دیگری نیز کنید. شاید جالب باشد که بدانید RouteCollection یک Property از کلاس RouteTable است.

بررسی URL Pattern در MVC

برای Register کردن یک Route به URL Pattern نیاز داریم. در مثالی که در قسمت قبل بررسی شد “{controller}/{action}/{id}” یک URL Pattern است. در واقع هر چیزی که بعد از Domain Name می آید یک URL Pattern است. به عبارت دیگر در localhost:1234/{controller}/{action}/{id} قسمت localhost:1234/ همان Domain Name و {controller}/{action}/{id} یک URL Pattern است که مشخص کننده ی نام Controller و Action Method درون آن Controller و پارامتر ورودی آن Action Method است. تصویر زیر این موضوع را نشان می دهد.

اگر در URL نام Controller و Action Method مشخص نشده باشد، مقدار پیش فرضی که در Route پیکربندی شده اند لحاظ می شوند. به عبارتی، در http://lcoalhost:1234 که نه Controller و نه Action Method مشخص شده اند، از HomeController به عنوان Controller و Index به عنوان Action Method مناسب برای ارسال Response استفاده می شود. این موضوع به دلیل پیکربندی route مورد نظر انجام می پذیرد.

در جدول زیر مثال هایی از URL های متفاوت و Controller و Action Method مناسب برای پردازش هر کدام مشاهده می شود.

پیکربندی چندین Route در MVC

دقت کنید که در برنامه های MVC مجبور نیستید که فقط یک Route داشته باشید. می توانید چندین Route را با همان MapRoute که به عنوان یک Extension Method در قسمت های قبلی معرفی شد استفاده کنید. در این متد حداقل باید دو پارامتر لحاظ شود: نام Route مورد نظر و URL Pattern آن. پارامتر مربوط به تعریف کردن Controller و Action Method های پیشفرض اختیاری یا اصطلاحاً Optional هستند.

بیایید کار را در قالب یک مثال بررسی کنیم. در مثال زیر نحوه ی تعریف کردن یک Route به نام Student را مشاهده می کنید.

public class RouteConfig {

public static void RegisterRoutes(RouteCollection routes) {

routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

routes.MapRoute(

name: "Student",

url: "students/{id}",

defaults: new {

controller = "Student", action = "Index"

}

);

routes.MapRoute(

name: "Default",

url: "{controller}/{action}/{id}",

defaults: new {

controller = "Home", action = "Index", id = UrlParameter.Optional

}

);

}

}

همانطور که در کد بالا مشاهده می کنید، URL Pattern مربوط به این Route که Student نیز نام دارد به صورت students/{id} است. بر اساس این URL Pattern هر URL ای که به صورت domainName/students باشد باید توسط یک Controller با نام StudentController هندل شود.

دقت کنید که در این URL Pattern ما قسمت {action} که به منظور تعریف کردن Action Method است را تعریف نکرده ایم. این موضوع باعث می شود که هر URL ای که با کلمه ی Student آغاز می شود، توسط یک Action Method با نام Index که در StudentController وجود دارد Handle شود. به عبارت دیگر با تعریف قسمت Defaults به سادگی Controller پیش فرض و Action Method پیش فرض برای تمامی URL Request هایی که به شکل domainname/students می باشند را مشخص کرده ایم.

نکته ی دیگری که باید به آن دقت کرد این است که MVC به صورت ترتیبی Route های Register شده را بررسی می کند و سعی می کند که URL مورد نظر را با یکی از آن Route ها Match کند. در مثال بالا، Routing Engine در ابتدا route اول یعنی Student را بررسی کرده و سعی می کند که URL مورد نظر را با آن Match کند. اگر URL با /students آغاز نشده باشد، (به عبارتی توسط Route اول قابل پردازش نباشد) سپس Route دوم بررسی می شود. Route دوم یک Default Route است. در جدول زیر نحوه ی Match شدن هر کدام از Route ها را با Student مشاهده می کنید.

پیاده سازی Route Constraint ها

کلمه ی Constraint در زبان انگلیسی به معنی قید یا محدودیت است. پس Route Constraint به معنی قیود یا شرط هایی است که برای Route ها در نظر گرفته می شوند. با استفاده از Constraint ها می توانیم محدودیت هایی را در زمان Register کردن Route ها پیاده سازی کنیم. برای مثال، در کد زیر یک Constraint برای پارامتر id در نظر گرفته شده است. بر اساس این Constraint این پارامتر باید حتماً یک مقدار عددی باشد.

routes.MapRoute(

name: "Student",

url: "student/{id}/{name}/{standardId}",

defaults: new { controller = "Student", action = "Index", id = UrlParameter.Optional, name = UrlParameter.Optional, standardId = UrlParameter.Optional },

constraints: new { id = @"\d+" }

);

بنابراین اگر شما برای این پارامتر یک مقدار غیر عددی در نظر بگیرید آن Request خاص توسط یک Route دیگر هندل خواهد شد و طبیعتاً اگر هیچ Route ای وجود نداشته باشد که بتواند این Request را هندل کند خطا ایجاد میشود.

رجیستر کردن Route ها

پس از پیکربندی تمامی Route ها در کلاس RouteConfig نیاز هست که آنها را در فایل Global.asax و در Event ای با نام Application_Start ثبت یا رجیستر کنید. این کار باعث می‌شود که Route های تعریف شده شما در RouteTable قرار بگیرد. کد زیر این موضوع را نشان می دهد.

public class MvcApplication : System.Web.HttpApplication

{

protected void Application_Start()

{

RouteConfig.RegisterRoutes(RouteTable.Routes);

}

}

علاوه بر این تصویری که در قسمت زیر مشاهده می‌ کنید فرایند ثبت شدن یا رجیستر شدن Route ها را نشان می دهد.

منبع: وبسایت پرووید

۰
۰
پرووید
پرووید
شاید از این پست‌ها خوشتان بیاید