Câu hỏi: SDN302 Chương 2 - API và giao thức HTTP

Các phương thức HTTP idempotent là những phương thức có thể được thực hiện nhiều lần mà không gây ra tác động khác biệt. Trong các phương thức HTTP, PUT và DELETE được coi là idempotent vì chúng không tạo ra tác động phụ thuộc vào số lần thực hiện. Ví dụ, khi bạn thực hiện PUT để cập nhật một tài nguyên, việc thực hiện PUT nhiều lần sẽ không gây ra tác động khác biệt so với việc thực hiện một lần. Tương tự, khi bạn thực hiện DELETE để xóa một tài nguyên, việc thực hiện DELETE nhiều lần sẽ không gây ra tác động khác biệt so với việc thực hiện một lần. Ngược lại, phương thức POST không được coi là idempotent vì nó tạo ra tác động phụ thuộc vào số lần thực hiện. Vì vậy, phương thức PUT và DELETE là idempotent.

Một SDK (Software Development Kit) là một bộ công cụ được thiết kế để giúp các nhà phát triển xây dựng ứng dụng cho một nền tảng cụ thể. Nó cung cấp các lớp trừu tượng cao hơn để đơn giản hóa quá trình phát triển và cung cấp truy cập vào các khả năng và tính năng đặc thù của nền tảng đó. Ví dụ, một SDK cho hệ điều hành di động có thể cung cấp các lớp trừu tượng để truy cập vào các tính năng như GPS, camera, v.v. Điều này giúp các nhà phát triển có thể tập trung vào việc xây dựng ứng dụng mà không cần phải lo lắng về các chi tiết kỹ thuật phức tạp.

Trả về mã trạng thái HTTP 201 khi một tài nguyên mới được tạo thành công. Điều này thường xảy ra khi thực hiện một yêu cầu HTTP POST để tạo một tài nguyên mới trên máy chủ. Ví dụ, khi tạo một tài khoản mới trên một trang web, máy chủ sẽ trả về mã trạng thái 201 để thông báo rằng tài khoản đã được tạo thành công. Mã trạng thái 201 không chỉ được sử dụng cho việc tạo tài nguyên mới mà còn có thể được sử dụng để báo cáo rằng một tài nguyên đã được cập nhật thành công.

Trong giao thức HTTP, phương thức GET được sử dụng để lấy thông tin từ máy chủ đã cho sử dụng một URL đã cho. Yêu cầu sử dụng phương thức GET chỉ nên lấy dữ liệu.

Để xử lý yêu cầu và phản hồi HTTP trong Node.js, bạn có thể sử dụng các module tích hợp sẵn của Node.js. Một trong những cách phổ biến nhất là sử dụng module http. Module http cho phép bạn tạo và quản lý các kết nối HTTP, xử lý yêu cầu và phản hồi, cũng như gửi phản hồi lại cho khách hàng. Bạn có thể sử dụng các phương thức như http.createServer(), http.request(), http.response để xử lý các yêu cầu và phản hồi HTTP. Ngoài ra, bạn cũng có thể sử dụng các module khác như morgan để ghi nhật ký các yêu cầu và phản hồi HTTP, nhưng module http là module cơ bản và quan trọng nhất để xử lý HTTP trong Node.js.

Mã HTTP 400 được sử dụng để chỉ ra rằng dữ liệu không đáp ứng các yêu cầu xác thực hoặc không được định dạng đúng. Điều này có thể xảy ra khi dữ liệu được gửi đến một API nhưng không đáp ứng các yêu cầu về cấu trúc hoặc nội dung. Ví dụ, nếu một ứng dụng gửi một yêu cầu đăng ký với thông tin không đầy đủ, API có thể trả về mã HTTP 400 để chỉ ra rằng dữ liệu không hợp lệ. Ngoài ra, mã HTTP 400 cũng có thể được sử dụng để chỉ ra rằng dữ liệu không được định dạng đúng, chẳng hạn như khi gửi dữ liệu JSON nhưng không đúng định dạng.

Một API Gateway (Cổng Trực tiếp API) là một phần mềm hoặc dịch vụ trung gian giúp quản lý và định tuyến các yêu cầu API. Nó đóng vai trò như một điểm vào duy nhất cho các ứng dụng và dịch vụ API, giúp phân phối và quản lý lưu lượng truy cập đến các nguồn dữ liệu khác nhau. API Gateway thường được sử dụng để bảo vệ và bảo mật các API khỏi các cuộc tấn công từ bên ngoài, đồng thời giúp tối ưu hóa hiệu suất và khả năng mở rộng của các ứng dụng và dịch vụ API. Nó cũng giúp cung cấp các tính năng như xác thực và ủy quyền, cũng như theo dõi và phân tích lưu lượng truy cập API.

Serialization là quá trình chuyển đổi một đối tượng thành một luồng byte. Điều này cho phép lưu trữ và truyền tải đối tượng một cách dễ dàng. Ví dụ, khi bạn muốn lưu trữ một đối tượng vào file hoặc truyền tải nó qua mạng, bạn cần chuyển đổi nó thành một chuỗi byte. Điều này giúp đối tượng có thể được lưu trữ và truyền tải một cách hiệu quả. Ngoài ra, Serialization còn giúp bảo vệ dữ liệu khỏi bị thay đổi hoặc mất mát trong quá trình truyền tải.

Mỗi yêu cầu tiếp theo từ phía khách hàng nên bao gồm thông tin ______ trong tiêu đề yêu cầu. Thông tin này giúp máy chủ xác thực và xác minh tính hợp lệ của yêu cầu. Trong một số trường hợp, thông tin này có thể được sử dụng để lưu trữ thông tin về trạng thái phiên hoạt động của khách hàng. Ví dụ, trong một ứng dụng cần xác thực người dùng, thông tin này có thể là một token được tạo ra khi khách hàng đăng nhập thành công. Token này sẽ được gửi lại trong mỗi yêu cầu tiếp theo để máy chủ có thể xác thực và cung cấp thông tin cần thiết cho khách hàng.

Sử dụng async/await trong mã nguồn này mang lại nhiều lợi ích. Trước hết, nó giúp mã nguồn trở nên dễ đọc và dễ hiểu hơn. Điều này là do async/await cho phép chúng ta viết mã nguồn theo trình tự thời gian thực, giống như viết mã nguồn đồng bộ. Điều này giúp giảm thiểu sự phức tạp và khó hiểu của mã nguồn. Ngoài ra, async/await cũng giúp đơn giản hóa việc xử lý lỗi bằng cách sử dụng khối try/catch. Khi sử dụng async/await, chúng ta có thể dễ dàng bắt và xử lý lỗi bằng cách sử dụng khối try/catch, thay vì phải sử dụng các hàm callback phức tạp. Điều này giúp giảm thiểu sự phức tạp và khó hiểu của mã nguồn. Tuy nhiên, async/await không loại bỏ hoàn toàn nhu cầu sử dụng hàm callback. Trong một số trường hợp, chúng ta vẫn cần sử dụng hàm callback để xử lý các tác vụ phức tạp. Vì vậy, async/await không phải là giải pháp hoàn hảo, nhưng nó là một công cụ mạnh mẽ giúp chúng ta viết mã nguồn dễ đọc, dễ hiểu và dễ bảo trì.

Để gửi dữ liệu JSON trong một yêu cầu API, bạn cần sử dụng tiêu đề 'Content-Type' với giá trị 'application/json'. Điều này cho biết server biết rằng dữ liệu được gửi dưới dạng JSON. Ví dụ, khi gửi yêu cầu API bằng phương thức POST, bạn có thể thêm tiêu đề 'Content-Type' vào header của yêu cầu như sau: Content-Type: application/json. Điều này giúp server hiểu và xử lý dữ liệu JSON một cách chính xác.

Serialization là quá trình chuyển đổi một đối tượng dữ liệu thành một chuỗi byte để lưu trữ hoặc truyền tải. Quá trình này giúp cho dữ liệu có thể được lưu trữ trong các tệp tin hoặc truyền tải qua mạng mà không bị mất thông tin. Serialization thường được sử dụng trong các ứng dụng cần lưu trữ và tải lại dữ liệu, chẳng hạn như các trò chơi điện tử, các ứng dụng di động và các hệ thống quản lý cơ sở dữ liệu. Quá trình này cũng giúp cho dữ liệu có thể được truy cập và sử dụng lại một cách dễ dàng.

Để tạo và bắt đầu một máy chủ HTTP trong Node.js, bạn cần sử dụng các phương thức và lệnh cụ thể. Đầu tiên, bạn cần tạo một đối tượng máy chủ bằng cách sử dụng phương thức http.createServer(). Phương thức này sẽ tạo một máy chủ mới và cho phép bạn cấu hình các thuộc tính và hành vi của nó. Sau đó, bạn cần sử dụng phương thức server.listen() để bắt đầu máy chủ và chờ đợi các yêu cầu từ khách hàng. Phương thức này sẽ giúp máy chủ lắng nghe trên một cổng cụ thể và xử lý các yêu cầu khi chúng đến. Ngoài ra, bạn cần sử dụng lệnh require('http') để nhập mô-đun http vào mã của bạn. Điều này sẽ cho phép bạn truy cập vào các phương thức và thuộc tính của mô-đun http.

Trong trường hợp này, chúng ta cần phân tích xem nên sử dụng API hay SDK để tương tác với camera và GPS của thiết bị cũng như lấy dữ liệu thời tiết từ một dịch vụ bên ngoài. Một SDK (Toolkit phần mềm) là một tập hợp các thư viện và công cụ được thiết kế để giúp các nhà phát triển xây dựng các ứng dụng trên một nền tảng cụ thể. Trong trường hợp này, SDK sẽ cung cấp các chức năng để tương tác với camera và GPS của thiết bị, giúp giảm thiểu thời gian và công sức của nhà phát triển. Ngược lại, API (Application Programming Interface) là một giao diện được thiết kế để cho phép các ứng dụng tương tác với các dịch vụ hoặc hệ thống khác. Đối với việc lấy dữ liệu thời tiết từ một dịch vụ bên ngoài, API sẽ là lựa chọn phù hợp hơn vì nó cho phép ứng dụng của chúng ta tương tác với dịch vụ đó một cách linh hoạt và dễ dàng. Vì vậy, kết luận là chúng ta nên sử dụng SDK để tương tác với camera và GPS của thiết bị, và API để lấy dữ liệu thời tiết từ một dịch vụ bên ngoài.

Khi chúng ta muốn lưu trữ một đối tượng JavaScript thành một chuỗi JSON, chúng ta sử dụng hàm JSON.stringify(). Hàm này sẽ chuyển đổi đối tượng thành một chuỗi JSON. Ví dụ, trong đoạn mã trên, JSON.stringify(obj) sẽ chuyển đổi đối tượng obj thành một chuỗi JSON. Điều này được thực hiện bởi hàm JSON.stringify(), vì vậy nó chịu trách nhiệm cho quá trình serial hóa. Sau đó, chúng ta sử dụng hàm JSON.parse() để chuyển đổi chuỗi JSON trở lại thành một đối tượng JavaScript. Điều này được thực hiện bởi hàm JSON.parse(), vì vậy nó chịu trách nhiệm cho quá trình giải mã. Các câu lệnh console.log() chỉ đơn giản là in ra kết quả, chúng không chịu trách nhiệm cho quá trình serial hóa hay giải mã.

Để tạo một Node.js server xử lý GET request và trả về nội dung của một file, chúng ta cần sử dụng các module http và fs. Module http được sử dụng để tạo một server, trong khi module fs được sử dụng để đọc nội dung của file. Trong câu trả lời đúng, chúng ta sử dụng http.createServer để tạo một server và kiểm tra phương thức của yêu cầu (req.method === 'GET') để quyết định đọc nội dung của file hay không. Nếu phương thức là GET, chúng ta sử dụng fs.readFile để đọc nội dung của file và trả về nó qua phương thức res.end().

Trong thiết kế API, mục đích chính của việc sử dụng tham số truy vấn trong URL là để lọc hoặc sắp xếp các tài nguyên mà không thay đổi chúng. Điều này cho phép người dùng có thể yêu cầu dữ liệu được sắp xếp theo một cách cụ thể hoặc được lọc theo một tiêu chí nhất định mà không cần phải thay đổi dữ liệu gốc. Ví dụ, khi yêu cầu danh sách các sản phẩm, người dùng có thể thêm tham số truy vấn để yêu cầu danh sách sản phẩm được sắp xếp theo giá tăng dần hoặc giảm dần. Điều này giúp người dùng có thể dễ dàng tìm kiếm và sử dụng dữ liệu mà không cần phải thực hiện các thao tác phức tạp trên server.

Khi một yêu cầu GET được thực hiện đến địa chỉ `http://localhost:8080/?name=Alice` trong mã Node.js sau đây, chương trình sẽ phân tích URL yêu cầu và thực hiện các hành động tương ứng. Mã Node.js sử dụng thư viện `http` để tạo một server và thư viện `url` để phân tích URL yêu cầu. Khi một yêu cầu GET được gửi đến server, chương trình sẽ phân tích URL yêu cầu và kiểm tra nếu đường dẫn yêu cầu (`pathname`) là `/`. Nếu đúng, chương trình sẽ lấy giá trị của tham số `name` từ URL yêu cầu và sử dụng nó để tạo một thông điệp chào đón. Nếu giá trị của `name` là `undefined` (do không có tham số `name` trong URL yêu cầu), chương trình sẽ sử dụng giá trị mặc định là `Guest`. Cuối cùng, chương trình sẽ trả về thông điệp chào đón với mã trạng thái 200 (OK). Trong trường hợp này, giá trị của tham số `name` là `Alice`, vì vậy thông điệp chào đón sẽ là `Hello, Alice!`.

Một trong những điểm khác biệt quan trọng giữa một bộ cân bằng tải và một cổng API là chức năng của chúng. Bộ cân bằng tải (load balancer) chủ yếu tập trung vào việc phân phối lưu lượng mạng trên nhiều máy chủ. Điều này giúp phân phối tải cân bằng, tăng hiệu suất và giảm thiểu khả năng quá tải. Ngược lại, cổng API (API Gateway) chủ yếu tập trung vào việc quản lý và định tuyến các yêu cầu đến các dịch vụ backend. Điều này bao gồm việc xác thực, mã hóa và kiểm soát truy cập. Ngoài ra, cổng API còn có thể thực hiện các chức năng khác như quản lý phiên, quản lý quyền và quản lý dữ liệu.

Để tạo một file package.json trong dự án Node.js, bạn cần sử dụng lệnh npm init. Lệnh này sẽ giúp tạo ra một file package.json mới với các thông tin cơ bản về dự án như tên dự án, phiên bản Node.js, và các tùy chọn khác. Khi bạn chạy lệnh npm init, bạn sẽ được hỏi một loạt các câu hỏi để nhập thông tin về dự án của mình. Sau khi nhập xong, lệnh sẽ tạo ra một file package.json mới với các thông tin đã nhập. File này sẽ được sử dụng để quản lý các tùy chọn và phụ thuộc của dự án.