Xây dựng web service dùng API REST ful Service

XÂY DỰNG VÀ TRIỂN KHAI WEB SERVICE CHO ỨNG DỤNG DI ĐỘNGHiện nay, nhu cầu về sự tương tác giữa người dùng, giữa client – server trong các ứng dụng đang ngày càng nâng cao. Vì vậy, công nghệ Web Service được ra đời nhiều ưu điểm như: Có thể chạy trên nhiều nền tảng khác nhau, sử dụng các giao thức và các chuẩn mở, nâng cao khả năng tái sử dụng… Với lợi thế khi đa phần các kỹ thuật của Web Service đều được xây dựng dựa trên mã nguồn mở và được phát triển theo các chuẩn đã công nhận, công nghệ Web Service đang được các nhà phát triển ứng dụng lựa chọn như một giải pháp tối ưu và hiệu quả nhất. Cùng với xu thế đó, Web Service chính là một phần kiến thức không thể thiếu đối với các lập trình viên di động chuyên nghiệp. Môn học “Xây Dựng Và Triển Khai Web Service Cho Ứng Dụng Di Động” với hi vọng giúp bạn bổ sung những kiến thức cần thiết và nâng cao kỹ năng phát triển ứng dụng di động thực tế. Sau khi hoàn thành môn học này, các bạn sẽ có khả năng:Tự xây dựng Web Service hoàn chỉnh sử dụng: LinQ, Entity Framework.Triển khai Web Service lên server.Tương tác giữa Web Service với ứng dụng trên thiết bị di động.Tương tác Web Service với các Web Service khác.Tự xây dựng dự án với Web Service hoàn chỉnh.

Xây dựng Web Service dùng API REST ful Service Bài 1: Xây dựng Web Service dùng API RESTful Service (phần 1) Trong Tui trình bày cách tạo web service dùng API RESTful Service, tảng hỗ trợ từ net version 4.0 trở lên Những bạn lập trình thiết bị di động cần phải hiểu khái niệm chế vận hành sử dụng API RESTful, theo Tui thấy hay tiện lợi việc triển khai dự án liên quan tới tương tác liệu Server Trước triển khai webservice, bạn cần đọc hiểu khái niệm qua mục đây: Giới thiệu ASP.NET Web API Giới thiệu RESTful Service Các nguyên tắc để tạo RESTful Service Xây dựng Web Service 1.Giới thiệu ASP.NET Web API ASP.NET Web API gì? Là framework giúp tạo Web API – API web (HTTP) Web API dịch vụ Web (Web service) xây dựng dựa HTTP sử dụng mô hình lập trình convention (như ASP.NET MVC) Đặc điểm Web API (.NET 4.0 trơ lên) Giúp cho việc xây dựng HTTP service đơn giản, nhanh chóng   Mã nguồn mở (Open Source) sử dụng client hỗ trợ XML, JSON  Hỗ trợ đầy đủ thành phần HTTP: URI, request/response headers, caching, versioning, content formats  Có thể host ứng dụng IIS  Kiến trúc lý tưởng cho thiết bị có băng thông giới hạn thiết bị di động  Định dạng liệu JSON, XML kiểu liệu  Làm đại hóa mẫu dự án mặc định  Mẫu dự án điện thoại di động  Nhiều tính để hỗ trợ ứng dụng di động  Tùy chỉnh sinh mã(code)  Tăng cường hỗ trợ cho phương pháp bất đồng  Đọc danh sách đầy đủ tính ghi phát hành Ưu điểm của Web API  Cấu hình đơn giản nhiều so với WCF  Hiệu suất(performance) cao  Hỗ trợ RESTfull đầy đủ  Hỗ trợ đầy đủ thành phần MVC như: routing, controller, action result, filter, model binder, IoC container, dependency injection, unit test, … Mã nguồn mở (Open source)  Giới thiệu RESTful Service -Là dịch vụ web đơn giản sử dụng HTTP tính chất REST -Nó tuân thủ theo nguyên tắc thiết kế sau:  Sử dụng phương thức HTTP cách rõ ràng  Phi trạng thái  Hiển thị cấu trúc thư mục URls  Chuyển đổi linh hoạt JavaScript Object Notation (JSON) XML hai Nguyên tắc để tạo RESTful Service nguyên tắc thiết kế sau: Nguyên tắc 1: Sử dụng phương thức HTTP cách rõ ràng Thiết lập ánh xạ 1-1 hành động: tạo, đọc, cập nhật xoá (CRUD) trình vận hành phương thức HTTP:  POST (HttpPost) – Tạo tài nguyên máy chủ  GET (HttpGet) – Truy xuất tài nguyên  PUT (HttpPut) – Thay đổi trạng thái tài nguyên để cập nhật  DELETE (HttpDelete) – Huỷ bỏ xoá tài nguyên Nguyên tắc 2: Phi trạng thái Ta xem mô hình trạng thái phi trạng thái để dễ so sánh: Mô hình phi trạng thái: Mô hình trạng thái: Nguyên tắc 3: Hiển thị cấu trúc thư mục URls Cấu trúc địa RESTful service:  Giấu đuôi tài liệu mở rộng gốc máy chủ (.jsp, php, asp)  Để thứ chữ thường (thực không phân biệt, nên tuân thủ để khỏi phải nhớ HOA-thường lung tung)  Thay khoảng trống gạch chân gạch nối (một hai loại)  Tránh chuỗi yêu cầu  Thay sử dụng mã (404 Not Found) yêu cầu địa cho phần đường dẫn luôn cung cấp trang mặc định tài nguyên phản hồi Nguyên tắc 4: Chuyển đổi JavaScript Object Notation (JSON) XML hoặc hai Là tóm tắt thuộc tính thứ mô hình liệu hệ  thống    Định dạng liệu mà ứng dụng trao đổi dịch vụ mức đáp ứng yêu cầu/ phản hồi phần thân HTTP Các chủ thể mô hình liệu có liên quan với Cấu trúc dịch vụ cho tận dụng phần đầu chấp nhận HTTP có sẵn bên – loại MIME 4.Xây dựng Web Service Tui liệt kê bước tương đối (chi tiết trình bày kế tiếp): Bước 1: Khởi động Visual Studio → tạo project ASP.NET Web Application chọn template Web API Bước 2: Tạo Data Model sử dụng Entity Framework để Web API service tương tác CRUD (Create, Read, Update, Delete) liệu (không tạo được) Bước 3: Tạo Web API Nhấp chuột phải vào thư mục Controllers chọn thêm controller  Web API Controller Empty: tự viết phương thức từ đầu  Web API Controller with read/write actions: phát sinh phương thức ví dụ để bạn biết cách viết service Bước 4: Chạy thử kiểm tra Bài Tui trình bày chi tiết cách tạo Web API service, cách cấu sử dụng Service Bài 2: Xây dựng Web Service dùng API RESTful Service Trong Tui hướng dẫn chi tiết cách tạo Web API (lý thuyết đây), cách cấu hình IIS, cách sử dụng công cụ Postman(với dùng chrome), cách sử dụng HttpRequester (với dùng Firefox) Postman HttpRequester công cụ hiệu để TEST coding ta, code ta pass qua công cụ kết luận Webservice ta chắn hoạt động tốt Để cho có cảm giác Tui tạo sở liệu SQL Server, WebAPI tương tác liệu cách sử dụng LinQ to SQL: Bước 1: Tạo sở liệu tên “dbFood”, có bảng “Food” gồm cột (id để auto) đây: Các bạn tải SQL Script để tạo CSDL cho lẹ: http://www.mediafire.com/download/48dkwoqka2e1w07/dbFood.sql Bước 2: Tiến hành viết Web API Để tạo Project sử dụng Web API có nhiều cách tạo, Tui sử dụng cách đơn giản để bạn bớt rối Từ Visual Studio 2013 vào menu File/chọn new/ chọn Project: Sau chọn Project, hình sau xuất hiện: Chọn cấu trên, đặt tên Project “FoodServer” rồi nhấn OK Project mặc định ban đầu sau: Giờ ta tiến hành tạo LinQ to SQL cho CSDL dbFood để dễ xử lý sau: Bấm chuột phải vào Project/ chọn : Màn hình tạo tên LINQ to SQL hiển thị lên, ta tạo tên rồi nhấn OK: (chú ý bạn không thấy LINQ to SQL Classes hình này), không thấy chọn New Item: Ta chọn mục giống bên dưới, tìm tới LINQ to SQL Classes rồi đặt tên DBFood tương tự trên: Cả cách cuối trạo DBFood LINQ sau: – Ta tiến hành cấu hình để kéo Cơ sở liệu vào làm lớp tương tác: Bạ mở Server Explorer (vào menu View/Server Explorer), bấm chọn theo bước bên (lệ thuộc vào Server bạn mà chọn Server name, User đăng nhập cho phù hợp): 10 Giờ Tui làm tiếp trường hợp Delete: Trong combobox, bạn chọn DELETE, nhập Parameter rồi bấm Submit, thấy kết true==> xóa thành công 2.Cách sử dụng Postman Mở trình duyệt Chrome, tìm từ khóa “postman plugin”, https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbn cdddomop?hl=en tiến hành cài đặt, sau cài thành công: 28 Kích hoạt postman để sử dụng Để lấy toàn liệu (HttpGet) ta chọn Get hình đây: Để lấy Food theo mã ta làm theo bước (Ví dụ lấy Food có id=1): 29 Để sử dụng HttpPost (tạo Food mới) ta làm theo bước đây: Ở bấm Send, trả true==> thêm Food thành công Để xóa Food có mã bất kỳ: 30 Trên cách sử dụng HttpRequester Postman, công cụ hiệu giúp kiểm tra trình thực HttpPost,HttpGet,HttpPut,HttpDelete trước triển khai vào hệ thống thực 31 Bài 4: Xây dựng Web Service dùng API REST ful Service Trong bài 68 69 70 bạn đã hiểu RESTful cách thức hoạt động HttpPost, HttpGet, HttpPut HttpDelete Tuy nhiên để tương tác với cần cấu hình lên Webserver, cụ thể IIS, trước Tui có hướng dẫn bạn cách tạo lên somee.com, bạn xem lại hướng dẫn Trong Tui hướng dẫn bạn bước cài đặt lên IIS Server máy local bạn, việc test máy local quan trọng test hoàn chỉnh xong ta publish Dưới chi tiết bước cách dựng IIS Server cách triển khai FoodServer lên IIS (Tui setup Win 10, 64 bit) Bước 1: Vào Control panel chọn Programs and Features Bước 2: Chọn Turn Windows features on or off: 32 Bước 3: Tiến hành lựa chọn để cài IIS Web Server theo hình đây: 33 Sau lựa chọn giống khung khoanh màu đỏ, nhấn OK để tiến hành cài đặt, tùy thuộc vào máy mà chương trình cài từ 5-10 phút Bước 4: Sử dụng IIS Web Server: Sau cài xong IIS Web Server, bạn quay lại hình Control panel, bạn thấy Administrative Tools: 34 Bạn click vào biểu tượng Administrative Tools, ta có giao diện tiếp theo: B ạn chọn “Internet Information Services (IIS) Manager” hình trên: 35 Trong hình quản trị bạn thấy có vùng: Application Pools Default Web site Bước 4.1 Cấu hình Application Pools: Application Pool gì? Application Pool chứa nhiều ứng dụng cho phép cấu hình cấp độ ứng dụng web khác Ví dụ, bạn muốn cô lập tất ứng dụng web chạy máy, bạn làm điều cách tạo Application Pool riêng biệt cho ứng dụng web đặt chúng Application Pool tương ứng Bởi Application Pool chạy trình làm việc riêng mình, lỗi Application Pool không ảnh hưởng đến ứng dụng chạy Application Pool khác Triển khai ứng dụng Application Pool lợi IIS trình làm việc chế độ cách ly bạn tùy chỉnh Application Pool để đạt cấp độ tách biệt ứng dụng mà bạn cần Khi bạn cấu hình Application Pool để sẵn sàng tối ưu, bạn nên xem xét làm để cấu hình Application Pool bảo mật ứng dụng Ví dụ, bạn cần phải tạo Application Pool riêng cho ứng dụng đòi hỏi mức độ bảo mật cao, cho phép ứng dụng đòi hỏi mức độ thấp bảo mật để chia sẻ Application Pool Bạn bấm chuột phải vào hình Application Pools/ chọn Add Application Pool… hình đây: 36 Màn hình tạo Application Pool hiển thị lên, ta nhập “FoodServer_Pool” rồi bấm OK: Sau bấm OK, bạn quan sát: 37 Ở hình bạn tiếp tục chọn Advanced Settings cho FoodServer_Pool: Bạn cần chỉnh ApplicationPoolIdentity qua LocalSystem 38 Bước 4.2: Cấu hình WebService lên IIS Server Bấm chuột phải vào Default Web Site / chọn Add Application … Màn hình hiển thị Add Application: Mục Alias (1): Đặt tên cho Service, ta đặt foodserver Mục Application pool (2): Nhấn nút Select… chọn FoodServer_Pool Mục Physical path (3): Trỏ tới đường dẫn chứa source code project Sau bấm OK để tạo Bạn quan sát kết quả: 39 http://localhost/foodserver/api/food kết sau cấu hình xong Tới hệ thống đã chạy 24/24 Các bạn dùng Postman HttpRequester để test HttpPost, HttpGet, HttpPut HttpDelete Các bạn ý từ Mobile kết nối tới Web Service dùng localhost (vì lầm tưởng mobile), đo dó bạn cần đưa localhost địa IP để test Cách lấy địa IP của máy local của ta: – Nhấn tổ hợp phím có biểu tượng Windows + R để mở cửa sổ Run: 40 – gõ lệnh cmd, hình command line hiển thị lên, tiếp tục gõ lệnh ipconfig Ở máy local Tui có địa IP: 192.168.100.3 Bây Tui thay cho localhost: 41 Như ta có kết mong muốn Các bạn cố gắng cấu hình để kết 42 ... sử dụng Service Bài 2: Xây dựng Web Service dùng API RESTful Service Trong Tui hướng dẫn chi tiết cách tạo Web API (lý thuyết đây), cách cấu hình IIS, cách sử dụng công cụ Postman(với dùng chrome),... Xây dựng Web Service dùng API REST ful Service Trong Tui hướng dẫn bạn cách sử dụng công cụ HttpRequester (firefox addon) Postman (chrome addon) Các bạn cần nắm rõ 68 69 để hiểu triển khai Web. .. loại MIME 4 .Xây dựng Web Service Tui liệt kê bước tương đối (chi tiết trình bày kế tiếp): Bước 1: Khởi động Visual Studio → tạo project ASP.NET Web Application chọn template Web API Bước 2: Tạo