HTTP 客戶端
首先說明如何直接使用 Core 客戶端，然後以選擇性整合範例說明自動生成服務使用的專案共用 HTTP adapter。
直接使用 Core 客戶端
注入到 createHttpClient<Paths>() 的 Paths 是請求合約。url 和 method 來自 Paths 的鍵，queryString 和 pathVariable 來自 parameters，body 的類型由 requestBody 決定。
響應類型由調用者指定為 callApi<R>() 的 R。Core 不會自動推斷 OpenAPI 響應中的響應類型。
httpClient.ts
ts響應形狀根據 API 選擇
typed-rx-http 不強制使用 ResponseWrapper。如果伺服器響應是包裝器，則將包裝器類型指定為 R，否則直接指定實際響應類型。
選擇：專案共用 adapter + 自動生成服務
下面的 commonService 配置不是 Core 的必需結構，而是希望一次性將多個生成服務的認證·SSR 標頭·快取策略應用於專案的整合模式。
專案 commonService 的功能
commonService 不是 @byeolnaerim/typed-rx-http 提供的特殊類名，而是用於將項目中的公共 HTTP 政策集中到一個地方的用戶擁有文件。文件名是自由的，以下示例中使用了實際項目名稱 rxjsHttpService.ts。
界面和自動生成服務不重複使用 createHttpClient，而是使用此文件生成的 callApi 和 callApiStream 作為公共入口點。因此，認證更新、SSR 標頭傳遞、緩存和錯誤處理規則只需修改一次，即可應用於所有生成的服務。
從 commonService/rxjsHttpService 全部代碼開始查看
1. 最小完成型
commonService的本質如下代碼所示。只需創建一次headerStore和typed HTTP client，然後export生成的服務以供共用的callApi/callApiStream使用。uploadFile和createSSEObservable也可以在同一client中直接暴露出來。
rxjsHttpService.ts
ts2. 包含session auth + CSR/SSR快取的擴展型
以下是將session auth、SSR header和CSR/SSR快取添加到相同公共適配器的完整專案範例。如果生成的服務導入了快取包裝器，則此形式為基準。只需複製並調整setLogin導入、ApiTypes和CacheNames位置、認證API路徑、環境變數和unauthorized路徑以符合自己的專案即可。
rxjsHttpService.ts
ts代碼組成的角色
paths
createHttpClient和ServiceArguments用於檢查URL、方法、路徑變數、查詢和主體類型的OpenAPI路徑類型。
headerStore
在瀏覽器中存儲Content-Type和Authorization等公共標頭，並與會話認證和RSocket連接共享。
headersProvider
在CSR中返回headerStore，而在SSR中讀取當前請求的Cookie和Authorization，為每個請求提供不同的標頭。
service
具有基本URL、公共標頭、伺服器401處理和基本錯誤消息的實際類型化HTTP客戶端。
sessionAuth
在請求之前同步會話token，若為401則刷新後重新嘗試原始Observable一次，若失敗則執行登出流程。
callApi / callApiStream
自動生成的通用REST服務和NDJSON流服務所導入的公共函數。兩者都返回RxJS Observable。
callApiClientCache / callApiServerCache
在瀏覽器中使用CSR快取，並在伺服器中動態加載@byeolnaerim/typed-rx-http/next的SSR快取的快取包裝器。
與自動生成服務的連接方式
生成器計算commonServiceFile的相對路徑並為每個服務添加導入。畫面不直接調用公共文件，而是導入生成的函數，生成函數將路徑、參數、主體轉換為ServiceArguments的pathVariable、queryString、body並傳遞給callApi。
generateSwagger.cjs
js一次響應是 firstValueFrom
像搜索、保存、刪除這樣一次響應結束的 REST API，可以通過生成的 ObservablefirstValueFrom在現有的 async 函數中自然使用。
BusinessSearchPage.tsx
tsx在畫面上只顯示 params，但生成的服務中包含 URL、HTTP 方法和響應類型。查詢參數始終{ params: { ... } }傳遞為
多個回應請訂閱
像是工作進度或 RSocket stream 等多個值到達的請求subscribe接收後，當組件消失時取消訂閱。
BatchJobPage.tsx
tsx直接使用 callApi 的情況
在不使用服務生成器的項目中，或在生成前檢查臨時端點時，可以直接調用公共服務的callApi。請求類型在paths中檢查，響應類型由調用者指定為泛型。