Asp mvc là gì
Bắt đầu từ bài này chúng ta sẽ tìm hiểu về lập trình ASP.NET MVC, lập trình ứng dụng web với mô hình hiện đại, hoạt động của dự án được chia ra thành các tầng - lớp để dễ dàng bảo trì - mở rộng. Bài học đầu tiên về ASP.NET MVC gồm các mục: Show
Tạo ứng dụng ASP.NET MVC đầu tiên
MVC đó là một mô hình lập trình, có gắng chia code thành 3 phần: model triển khai các mô hình dữ liệu, truy cập dữ liệu. view biểu diễn dữ liệu cho người dùng, controller nhận các yêu cầu browser gửi đến và trả về http response. Trong NET Core 3.x tạo ứng dụng mẫu ASP.NET MVC nhanh từ template bằng lệnh dotnet new mvcHãy tạo ra một thư mục mẫu đặt tên là mvc01_HelloWorld, vào thư mục đó, rồi gõ lệnh trên để tạo dự án thực hành.
Dự án mẫu tạo ra là cấu trúc cơ bản cho ứng dụng ASP.NET CORE MVC. Trong tổ chức thư mục dự án thấy có:
Kết quả chạy trang web như hình sau:
Mở file Startup.cs ra, thấy mã sinh ra có đưa vào pipeline một Middleware là HttpsRedirection với lệnh app.UseHttpsRedirection();. Điều này có nghĩa ứng dụng tạo ra mặc định chỉ truy cập bởi https, sau này trên môi trường sản phẩm bạn cần cấu hình Web Server như Apache, Nginx, IIS để xác thực ssl. Tuy nhiên, ở môi trường phát triển bạn cần tự xác thực SSL - nếu không thì có lỗi truy cập. Công cụ dotnet hỗ trợ làm điều này, bạn thực hiện lệnh sau: dotnet dev-certs https --clean dotnet dev-certs https --trustSau đó bạn đã có thể truy cập được đến https://localhost:5001 Route - Định tuyển trong ASP.NET MVCRouting (định tuyển) là quá quá trình xử lý thông qua nó ứng dụng xác định được cần thi hành các phương thức nào cho mỗi URL gửi đến. ASP.NET Core sử dụng một middleware để ánh xạ các URL tương ứng với phương thức nào của ứng dụng. Cụ thể hơn, Route xác định được phương thức (action) trong Controller - qua đó nó chuyển các thông tin Request đến và thi hành. Để định tuyển, đã trình bày trong phần trước ví dụ như Sử dụng EndpointMiddleware để tạo các điểm cuối rẽ nhánh trong pipeline trong UseEndpoints với các phương thức như Map, MapGet, MapPost ... Đồng thời cũng đã nói về rẽ nhánh bằng cách sử dụng IApplicationBuilder.Map Trong phần này, khi mở rộng dự án áp dụng MVC sử dụng thêm các phương thức tạo điểm cuối rẽ nhánh khi sử dụng với EndpointMiddleware, đầu tiên là MapControllerRoute IEndpointRouteBuilder.MapControllerRoute Cú pháp cơ bản đó là: MapControllerRoute(string name, string pattern, object defaults = null, object constraints = null);name tên của route. pattern mẫu URL. defaults giá trị mặc định cho route. constraints là các ràng buộc Ví dụ: /... app.UseRouting(); // Tạo các Endpoint app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); }); /...Đoạn code trên đã tạo ra một Route ánh xạ URL vào Controller, mẫu này xác định trong pattern đó là URL với cấu trúc {controller=Home}/{action=Index}/{id?} nghĩa URL phù hợp mẫu có ba phần /controller/action/id phần thứ nhất tương ứng với tên Controller (tên lớp trong thư mục Controllers, ví dụ này là HomeController), phần thứ 2 biến action - là Action trong Controller (tên phương thức), phần thứ 3 là một tham số tên biến id (tham số này có dấu ? có nghĩa là có thể có hoặc không - tùy chọn) Như vậy nếu truy cập địa chỉ /Home/Index thì có nghĩa sẽ tham chiếu đến lớp HomeController, gọi đến action (phương thức) Index của nó. Tất nhiên, sẽ thêm được nhiều endpoint ánh xạ URL, khi truy vấn đến nó so sánh từ trên xuống, gặp cái nào phù hợp sẽ chuyển thi hành controller/action tương ứng. Ví dụ: app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); endpoints.MapControllerRoute( name: "myroute", defaults: new {controller="Home", action = "Index"}, pattern: "{title}-{id}.html"); });Ở Route tên myroute phù hợp khi truy cập URL dạng /tieude-134.html, ROUTE này không chỉ rõ Controller, Action trong pattern mà chỉ ra trong defaults như trên. Các Url phù hợp đều dẫn đến thi hành HomeController::Index Tạo ràng buộc trong Route - URL Với mỗi biến trong Route (như controller, action, id, title ...) có thể khống chế phải phù hợp với điều kiện nào đó, thường những điều kiện là biểu thức chính quy (RegEx - xem biểu thức chính quy). Ví dụ như Route có tên myroute sau đây: /.. app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); endpoints.MapControllerRoute( name: "myroute", // đặt tên route defaults: new {controller="Home", action = "Index"}, constraints: new { id = @"\d+", // id phải có và phải là số title = new RegexRouteConstraint(new Regex(@"^[a-z0-9-]*$")) // title chỉ chứa số, chữ thường và ký hiệu - }, pattern: "{title}-{id}.html"); }); /..Bạn cũng có thể viết các dàng buộc trực tiếp trong pattern (xem thêm ở EndpointMiddleware đọc kỹ phần ràng buộc), các dàng buộc tham khảo tại route-constraint-reference ), ví dụ: endpoints.MapControllerRoute ( name: "myroute", // đặt tên route defaults : new { controller = "Home", action = "Index" }, pattern: "{title:alpha:maxlength(8)}-{id:int}.html"); // title chỉ chứa các chữ cái, dài tối đa 8, id là số nguyênTạo Controller trong ASP.NET MVCController có chức năng nhận Request gửi đến và trả về Response. ASP.NET MVC thì các Controller lưu trong thư mục Controllers, đồng thời các lớp controller đặt tên có hậu tố là Controller, ví dụ *Controller, như trong ứng dụng đã tạo ra có sẵn lớp HomeController Thông thường các controller kế thừa từ lớp Controller, sau đó khai báo các phương thức có thể được gọi khi Route ánh xạ đến gọi là Action public class HomeController : Controller { /... public IActionResult Index() { return View(); } /... }Các Action Controller có các phương thức gọi là Action, như trên action Index nó trả về IActionResult, thực tế nó có thể trả về bất kỳ kiểu dữ liệu nào. Ví dụ: /... public string XinChao() => "Xin chào ASP.NET Core 3.0"; /...Truy cập địa chỉ /Home/XinChao thấy dòng text trên. Trong Controller có sẵn các phương thức trả về các kiểu triển khai từ IActionResult như: Kiểu trả về | Phương thức ------------------------------------------------ ContentResult | Content() EmptyResult | new EmptyResult() FileResult | File() ForbidResult | Forbid() JsonResult | Json() LocalRedirectResult | LocalRedirect() RedirectResult | Redirect() RedirectToActionResult | RedirectToAction() RedirectToPageResult | RedirectToRoute() RedirectToRouteResult | RedirectToPage() PartialViewResult | PartialView() ViewComponentResult | ViewComponent() StatusCodeResult | StatusCode() ViewResult | View()Action trả về ContentResult Lớp ContentResult là mở rộng của ActionResult, nó cho phép bạn tạo ra nội dung tài liệu trả về trong Action. Để tạo ra đối tượng ContentResult cần khởi tạo nó với ba tham số gồm: nội dung tài liệu, kiểu tài liệu và encoding của tài liệu Ví dụ, trả về một nội dung văn bản: /... public IActionResult GetContent () { // mime - tham khảo https://en.wikipedia.org/wiki/Media_type string contentType = "text/plain"; string content = "Đây là nội dung file văn bản"; return Content (content, contentType, Encoding.UTF8); } /...Action trả về JsonResult Phương thức Json của Controller trích xuất các thuộc tính của đối tượng và chuyển thành Json, Response trả về có header Content-Type application/json Truy cập địa chỉ /Home/GetJson kết quả {"key1":100,"key2":["a","b","c"]}Chuyển hướng truy cập Có một số phương thức để chuyển hướng, thường có tiền tố Redirect, ví dụ vài phương thức như: public IActionResult TestRedirect() { return Redirect("https://xuanthulab.net"); // Redirect 302 - chuyển hướng sang URL khác // return RedirectToRoute(new {controller="Home", action="Index"}); // Redirect 302 - Found // return RedirectPermanent("https://xuanthulab.net"); // Redirect 301 - chuyển hướng URL khác // return RedirectToAction("Index"); // Chuyển hướng sang Action khác }Trả về nội dung file Phương thức File, tùy ngữ cảnh nó trả về nội dung file. /... public IActionResult FileAnh() { string filepath = "logo.png"; return File(filepath, "image/png"); } /...Trả về 404 - NotFound /... public IActionResult KhongCoGi() { return NotFound( "Trang không thấy" ); } /...Sử dụng tham số cho Action Có thể khai báo các Action có tham số, các tham số này được truyền thiết lập qua biến trong Route hay trong Url Query /... public IActionResult Sum(int x, int y) { return Content((x+y).ToString(), "text/plain", Encoding.UTF8); } /...Truy cập /Home/Sum?x=10&y=100 trả về nội dung 110 Trong lớp Controller còn có các thuộc tính truy cập nhiều loại thông tin rất đa dạng, những thuộc tính này sẽ tìm hiểu dần ở các phần sau như:
Tạo View trong ASP.NET MVC - Razor View EngineView kết hợp với dữ liệu nó nhận được, phát sinh nội dung HTML trả về cho client. Các View (file .cshtml) được bố trí trong thư mục Views, nó là các template - là các file có phần mở rộng .cshtml, trong đó nó chứa mã HTML, đồng thời nhúng mã C# (server side script), những đoạn nhúng mã server side thì bắt đầu bằng ký hiệu @ View là các file .cshtml sử dụng cú pháp Razor, thực tế trong ứng dụng mô hình MVC có áp dụng lại cả các trang Razor Page hoàn chỉnh, nên bạn cần hiểu rõ về Razor Page đã trình bày ở phần trước, ví dụ như Cú pháp Razor, Layout Razor ... Nhiệm vụ của View là xuất HTML, trong NET Core có thành phần gọi là Razor View Engine (từ đây gọi là Razor), nó có nhiệm vụ đọc các file View, thi hành các mã nhúng rồi xuất ra HTML. Khi một Action trả về đối tượng ViewResult (phương thức View của Controller tạo ra loại đối tượng này). Thì nó sẽ sử dụng View .cshtml và Razor làm việc để tạo nội dung HTML. Nó sẽ tìm đến thư mục Views, tìm đến thư mục cùng tên Controller ví dụ Home, sau đó là file .cshtml cùng tên với Action - file .cshtml tìm được sẽ sinh HTML. Nếu vậy: public class HomeController : Controller { /... public IActionResult Index() { return View(); // Trả về ViewResult } /... }Action trên sẽ sử dụng View tương ứng là Views/Home/Index.cshtml, hãy biên tập nội dung file thành: @{ Layout = null; }View .CSHTML là template Razor - nó chứa code C# bắt đầu bởi @@ @DateTime.Now.ToLongDateString() Để chèn một dòng code server side, thì sử dụng @ sau đó là dòng code, Razor tự nhận biết được đoạn kết thúc hết code khi phát hiện thẻ HTML, như ví dụ trên @DateTime.Now.ToLongDateString() xuanthulab.net Để mở khối thì sử dụng thêm { ... } @{ //code C# }Thêm thư mục lưu trữ các View .cshtmlCác View cho các Action mặc định lưu theo cấu trúc thư mục /View/ControllerName/ActionName.cshtml, nếu muốn thay đổi hoặc thêm cấu trúc mới thì thiết lập cho RazorEngine ở Startup.ConfigureService, ví dụ: // • {0} - Action Name // • {1} - Controller Name // • {2} - Area Name // • RazorViewEngine.ViewExtension - .cshtml services.ConfigureTruyền dữ liệu Controller tới View với ViewBagĐể truyền dữ liệu trong MVC, bạn có thể sử dụng:
Để truyền dữ liệu từ Controller sang View, trong Controller có thể sử dụng thuộc tính ViewBag, đây là kiểu Dynamic, có thể thiết lập dữ liệu vào nó với cặp key/value Khi controller thiết lập dữ liệu qua ViewBag, thì ở View truy cập được thuộc tính này của Controller với ký hiệu @, đó là: @ViewBag.key @{ Layout = null; }View .CSHTML là template Razor - nó chứa code C# bắt đầu bởi @@ @DateTime.Now.ToLongDateString() @ViewBag.dulieu1 @ViewBag.dulieu2 Truyền dữ liệu Controller tới View với ModelTrong Razor có một thuộc tính có tên Model thuộc tính này là một kiểu gereric (trong cú pháp ký hiệu nó là TModel, xem thêm Generic trong C# , TModel thực tế là kiểu gì được quyết định khi khởi tạo ViewResult) Từ Controller, khi khởi tạo ViewResult với phương thức View, bạn có thể chỉ ra tham số chính là Model, ví dụ: return View(ModelObject); // ModelObject là đối tượng bất kỳ - nó là Model trong RazorLúc này, trong .phtml, Razor sẽ đọc được qua thuộc tính với tên Model - Ví dụ: public IActionResult Index() { ViewBag.dulieu1 = "Đây là dữ liệu 1"; ViewBag.dulieu2 = 12345; // Một danh sách tênn các sản phầm ListLúc này ở View, Razor có thể truy cập được nó thông qua thuộc tính Model, nhưng ở phần đầu cần khai báo kiểu Model này với @model List View .CSHTML là template Razor - nó chứa code C# bắt đầu bởi @@ @DateTime.Now.ToLongDateString() xuanthulab.net @ViewBag.dulieu1 @ViewBag.dulieu2
@model là một chỉ thị của Razor, nó cho biết kiểu của Model, cú pháp khai báo là @model Kiểu_Của_Model Phát sinh controller, view, razor page, areaaspnet-codegenerator là công cụ bổ sung vào lệnh dotnet nó trợ giúp phát sinh nhanh các cấu trúc thư mục chuẩn, tạo controller, view, razor page nhanh hơn, tránh những thao tác đơn giả bạn phải làm thủ công. Đảm bảo cài đặt công cụ lệnh dotnet aspnet-codegenerator dotnet tool install -g dotnet-aspnet-codegenerator dotnet tool update -g dotnet-aspnet-codegeneratorThêm package dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.DesignGõ lệnh để xem hướng dẫn dotnet aspnet-codegenerator -hTạo một AreaArea là khu vực (thư mục) gom các Controller, Razor page thành nhóm (xem Area) Để tạo ra cấu trúc thư mục cho một Area nào đó gõ lệnh: dotnet aspnet-codegenerator NameAreaNó sẽ tạo thư mục Areas/NameArea/ và trong nó là các thư mục con theo chuẩn như: Controller, View, Models ... Tạo ra ControllerTạo một controller tên First mã nguồn lưu ở thư mục Controllers dotnet aspnet-codegenerator controller -name First -outDir ControllersNó sẽ tạo ra lớp FirstController trong thư mục Controllers Tạo ViewTạo ra View đặt tên Index, mẫu tạo là Empty, kết quả lưu tại Views/First sử dụng layout là _Layout dotnet aspnet-codegenerator view Index Empty -outDir Views/First -l _Layout -fCác lệnh trên nó còn phát sinh làm việc với với các Model, tạo các trang CRUD - tuy nhiên cần tích hợp dự án với DbContext, sẽ nói ở các phần khác Mã nguồn ví dụ ASP_NET_CORE/mvc01_HelloWorld hoặc tải về ex053
|