เริ่มต้น
จะอธิบายวิธีการใช้ typed-rx-http Core client ก่อน จากนั้นจะอธิบายวิธีการเชื่อมต่อ HTTP adapter สาธารณะของเจ้าของโครงการและบริการสร้างอัตโนมัติ Swagger เฉพาะในโครงการที่จำเป็น.
1. ติดตั้ง
2. ใช้ Core client โดยตรงโดยไม่ต้องสร้างอัตโนมัติ
ก่อนอื่นวิธีการใช้งานที่พื้นฐานที่สุดคือ createHttpClient<Paths>()สร้าง client หนึ่งครั้งและเรียกใช้ callApi ของ client นั้น. Paths เป็นประเภท paths ที่สร้างจาก OpenAPI โดยทั่วไป แต่สามารถใช้ประเภทที่กำหนดเองที่มีโครงสร้างเดียวกันได้.
httpClient.ts
ts3. ตัวเลือก: rxjsHttpService/commonService คืออะไร
สิ่งที่เรียกว่า rxjsHttpService.ts หรือ commonService.ts ในเอกสารไม่ใช่ชื่อไฟล์ที่สร้างโดยไลบรารี แต่เป็นไฟล์ HTTP adapter ที่โครงการเป็นเจ้าของโดยตรง บริการ REST ที่สร้างอัตโนมัติหลายรายการจะไม่สร้าง createHttpClient แยกกัน แต่จะใช้ฟังก์ชัน callApi/callApiStream/cache ที่ไฟล์นี้ส่งออกเป็นจุดเข้าใช้ร่วม.
รูปแบบที่เล็กที่สุดคือการสร้าง headerStore และ createHttpClient หนึ่งครั้งตามโค้ดทั้งหมดด้านล่าง และส่งออกวิธีการของไลบรารีเป็นฟังก์ชันของโครงการอีกครั้ง หากไม่ใช้ฟังก์ชัน cache ในบริการที่สร้างอัตโนมัติ โครงสร้างนี้ก็เพียงพอในการทำความเข้าใจ.
rxjsHttpService.ts
tsในโครงการ Next.js ที่แท้จริง หากต้องการจัดการการรับรองความถูกต้องของเซสชัน, คุกกี้/การอนุญาตตามคำขอ SSR, CSR cache และ SSR cache ในไฟล์เดียว สามารถขยายได้ตามด้านล่าง ไฟล์นี้ก็ไม่ใช่สิ่งที่สร้างอัตโนมัติ แต่เป็นโค้ดของโครงการ.
rxjsHttpService.ts
ts4. ตัวเลือก: หากใช้บริการสร้างอัตโนมัติ Swagger
หลังจากเชื่อมต่อ generator ของ OpenAPI service จะไม่เขียน URL และประเภทการตอบสนองใหม่ในหน้าจอ. นำเข้าฟังก์ชันที่สร้างขึ้นและส่ง path, params, body ที่จำเป็นเท่านั้น.