Công nghệ ASP NET web API

Giới thiệu ASP.NET Web API Giới thiệu Cùng với việc giới thiệu công nghệ dịch vụ (service) thập niên gần đây, Microsoft tạo nên chuỗi công nghệ cho phép dễ dàng xây dựng hỗ trợ dịch vụ web tảng NET: Bắt đầu với XML Web Service, sau mở rộng thông qua Windows Communication Foundation vài năm sau đó, Microsoft cho phép nhà phát triển NET có nhiều lựa chọn để xây dựng dịch vụ sở SOAP Chỉ với số thay đổi nhỏ cấu hình, cho phép bạn hỗ trợ nhiều thiết bị đa dạng giao thức kết nối, chế xác thực, định dạng thông báo chuẩn hỗ trợ bảo mật WS-* với WCF Nhưng giới thiết bị kết nối phát triển, kéo theo nhu cầu giao tiếp đơn giản HTTP – sử dụng tảng dịch vụ - bỏ qua yếu tố phức tạp xác thực liên đồn (federated authentication) hay mã hóa thơng báo, không cần phải tạo phiên giao dịch (transaction), khám phá dịch vụ sở Ngôn ngữ mô tả dịch vụ (Web Services Description Language – WSDL), … Theo cách đơn giản, giao tiếp dịch vụ di động (mobile-to-service) sở trình duyệt, ứng dụng trang đơn lẻ (Single-Page Application – SPA) Khi nhà phát triển tạo ứng dụng JavaScript, ứng dụng mobile giá rẻ (nhỏ USD) – ứng dụng cần giao thức HTTP đơn giản, giao tiếp liệu backend tương thích JSON Đáp lại đó, Microsoft tạo ASP.NET Web API, tảng đầy hiệu mà đơn giản với giao thức HTTP dịch vụ web theo mặc định sử dụng JSON Các model làm việc để xử lý trả đóng gói qua đối tượng đơn giản (Plain Old CLR Objects) a Những lợi ích sử dụng ASP.NET Web API Cấu hình Ngay bạn xây dựng website, không cần cấu hình cài đặt sử dụng dịch vụ ASP.NET Web API Khái niệm điểm đầu cuối (xuất WCF) khơng còn, không cần contract Và bạn thấy sau đây, dịch vụ ASP.NET Web API thiết lập lỏng lẻo ta so sánh với dịch vụ WCF Theo bạn cần sử dụng REST (Representational State Transfer – bạn xem giải vắn tắt REST cuối bài) URL, tham số đầu vào, kết trả tin JSON hay XML b Mặc định sử dụng REST Việc xây dựng dịch vụ với ASP.NET Web API cung cấp cho ta hầu hết thành phần thiết yếu để xây dựng kiến trúc REST Đó tính điều hướng (Route) URL tích hợp tảng, địa dịch vụ với ASP.NET Web API điều hướng RESTful ánh xạ với phương thức controller Vì cho phép sử dụng đường dẫn theo phong cách REST thân thiện c Trìu tượng hóa với Route Tương tự giao diện dịch vụ thực thi chúng WCF, route cho phép nhà phát triển ASP.NET Web API tạo lớp trìu tương bên yêu cầu nhìn thấy thực thi lớp Nói theo cách khác bạn gắn kết URL với phương thức controller Với thay đổi phiên dịch vụ, đơn giản cách thêm route (ví dụ “v2”) vào URL cho phép ta trì song song nhiều phiên dịch vụ hệ thống mà không ảnh hưởng đến dị vụ có d Mở rộng chức xử lý dạng đường ống đơn giản ASP.NET Web API cung cấp khả mở rộng dạng đường ống thông qua lọc (filter) cho phép xử lý trước sau thực thi action controller Bằng việc gắn lọc cho phép ta thực lọc action (theo tham số request), lọc vai trò (authorization) lọc ngoại lệ Để dùng đơn giản cách khai báo attribute, hay cấu hình tồn cục áp dụng cho tất phương thức a Một số đặc điểm trội ASP.NET Web API Thuận tiện cho hành động (action) CRUD (create – read – update – delete) Các action HTTP (như GET, POST) tự động gắn kết vào phương thức controller (chính controller action) thơng qua tên chúng Ví dụ b Thỏa thuận nội dung tích hợp sẵn Với MVC, phép phương thức controller trả liệu JSON hay XML phải tùy biến kết trả dạng nguyên gốc (raw) Nhưng với ASP.NET Web API, phương thức controller cần trả liệu gốc, tồn phần lại tự động chuyển đổi sang JSON hay XML tùy theo yêu cầu từ gọi tới Trong đó, yêu cầu từ bên gọi tới cần sử dụng tiêu đề (header) Accept hay Content-Type c Cho phép sử dụng attribute tiền tố điều hướng (route prefix) route Trong nhiều trường hợp bạn không muốn phương thức controller tuân theo quy tắc chung ta sử dụng attribute để cài đặt riêng RouteAttribute, RoutePrefixAttribute, HttpGetAttribute, HttpPostAttribute, … d Định nghĩa quy tắc ràng buộc cho route Đặc điểm cung cấp chế cho phép bạn nguyên tắc nghiệp vụ riêng xử lý route: e Hỗ trợ CORS (Cross-Origin Resource Sharing ~ Chia sẻ nguồn tài nguyên gốc) Trong ASP.NET Web API ta kích hoạt chức việc đặt attribute EnableCorsAttribute phép yêu cầu JavaScript từ domain khác truy cập domain dịch vụ bạn f Quản lý lỗi toàn cục Đây cải thiện lớn từ phiên ASP.NET Web API 2.1 Theo đó, tất exception khơng bắt ném bắt thông qua chế tập trung Việc hỗ trợ nhiều ghi log ngoại lệ thực tảng (framework), cho phép ta truy xuất đến ngoại lệ bị ném ngữ cảnh g Giao diện IHttpActionResult Việc thực thi giao diện định nghĩa HttpResponseMessage factory tái sử dụng thuận tiện xây dựng unit-test: REST gì? REST tạo Roy Fielding, tác giả đưa đặc tả giao thức HTTP, theo REST sinh để tận dụng lợi chẩn công nghệ giao thức HTTP SOAP thời điểm đời Ví dụ, thay phải tạo phương thức SOAP phức tạo, nhà phát triển REST API khuyến nghị sử dụng phương thức HTTP (HTTP verbs):  GET  POST  PUT  DELETE Mặt khác REST tài nguyên trung tâm, theo RESTful API sử dụng phương thức HTTP để tương tác hay truy vấn thơng tin tài ngun: Theo cách nói REST có danh từ (như Nhiệm vụ, Người dùng, Khách hàng, Đơn hàng) Vì vậy, ta sử dụng động từ tác động vào danh từ (verbs acting on nouns), hay theo cách hiểu ta thực hành động tác động lên tài ngun Ngồi ra, REST tận dụng lợi khía cạnh khác hệ thống HTTP như:  Caching (đệm liệu)  Security (bảo mật)  Statelessness (phi trạng thái)  Network layering (phân tầng lớp mạng với nhiều tường lửa, cổng – gateway – client server) ... cần cấu hình cài đặt sử dụng dịch vụ ASP. NET Web API Khái niệm điểm đầu cuối (xuất WCF) khơng còn, khơng cần contract Và bạn thấy sau đây, dịch vụ ASP. NET Web API thiết lập lỏng lẻo ta so sánh với... dựng dịch vụ với ASP. NET Web API cung cấp cho ta hầu hết thành phần thiết yếu để xây dựng kiến trúc REST Đó tính điều hướng (Route) URL tích hợp tảng, địa dịch vụ với ASP. NET Web API điều hướng... vụ web theo mặc định sử dụng JSON Các model làm việc để xử lý trả đóng gói qua đối tượng đơn giản (Plain Old CLR Objects) a Những lợi ích sử dụng ASP. NET Web API Cấu hình Ngay bạn xây dựng website,