Bắt đầu
Đầu tiên, tôi sẽ giải thích cách sử dụng client của typed-rx-http Core, sau đó sẽ giải thích cách kết nối HTTP adapter công cộng thuộc sở hữu dự án và dịch vụ tự động tạo Swagger chỉ trong các dự án cần thiết.
1. Cài đặt
2. Sử dụng Core client trực tiếp mà không tự động tạo
Trước tiên, cách sử dụng cơ bản nhất là createHttpClient<Paths>()tạo một client một lần và gọi callApi của client đó. Paths là kiểu paths được tạo ra từ OpenAPI, nhưng cũng có thể sử dụng kiểu tự định nghĩa tương thích với cấu trúc tương tự.
httpClient.ts
ts3. Lựa chọn: rxjsHttpService/commonService là gì?
Tài liệu gọi là rxjsHttpService.ts hoặc commonService.ts không phải là tên tệp cố định do thư viện tự động tạo. Đây là tệp HTTP adapter mà dự án sở hữu. Nhiều dịch vụ REST tự động tạo không tạo riêng createHttpClient, mà sử dụng các hàm callApi/callApiStream/cache được xuất từ tệp này làm điểm vào chung.
Hình thức nhỏ nhất là tạo một lần headerStore và createHttpClient như mã dưới đây và xuất lại các phương thức của thư viện thành các hàm của dự án. Nếu không sử dụng chức năng cache trong dịch vụ tự động tạo, cấu hình như vậy cũng đủ để hiểu cấu trúc.
rxjsHttpService.ts
tsĐể xử lý chung xác thực phiên, Cookie/Authorization theo yêu cầu SSR, cache CSR và cache SSR trong một tệp trong dự án Next.js thực tế, có thể mở rộng như dưới đây. Tệp này cũng không phải là sản phẩm tự động tạo mà là mã của dự án.
rxjsHttpService.ts
ts4. Lựa chọn: Khi sử dụng dịch vụ tự động tạo Swagger,
Sau khi kết nối trình tạo dịch vụ OpenAPI, không cần viết lại URL và loại phản hồi trên giao diện. Chỉ cần import hàm đã tạo và truyền các path, params, body cần thiết.