Loslegen
Zuerst erkläre ich die Verwendung des typed-rx-http Core-Clients selbst und dann, wie man in den benötigten Projekten das gemeinsame HTTP-Adapter und den automatisch generierten Swagger-Dienst verbindet.
1. Installation
2. Direkte Verwendung des Core-Clients ohne automatische Generierung
Zuerst ist die grundlegendste Nutzung createHttpClient<Paths>()einmal einen Client zu erstellen und die callApi des Clients aufzurufen. Paths ist der in OpenAPI generierte Pfadtyp, aber es können auch benutzerdefinierte Typen mit derselben Struktur verwendet werden.
httpClient.ts
ts3. Auswahl: Was ist rxjsHttpService/commonService?
Das, was im Dokument als rxjsHttpService.ts oder commonService.ts bezeichnet wird, ist kein fester Dateiname, der von der Bibliothek automatisch generiert wird. Es handelt sich um eine HTTP-Adapterdatei, die direkt vom Projekt besessen wird. Mehrere automatisch generierte REST-Dienste verwenden nicht jeweils createHttpClient, sondern nutzen die von dieser Datei exportierten Funktionen callApi/callApiStream/cache als gemeinsamen Einstiegspunkt.
Die kleinste Form besteht darin, headerStore und createHttpClient einmal zu erstellen und die Methoden der Bibliothek als Projektfunktionen erneut zu exportieren, wie im gesamten Code unten. Wenn der automatisch generierte Dienst keine Cache-Funktion verwendet, kann man mit dieser Konfiguration die Struktur verstehen.
rxjsHttpService.ts
tsUm in einem echten Next.js-Projekt Sitzungsauthentifizierung, Cookie/Authorization pro SSR-Anfrage, CSR-Cache und SSR-Cache in einer Datei gemeinsam zu behandeln, kann es wie unten erweitert werden. Diese Datei ist ebenfalls kein automatisches Produkt, sondern Projektcode.
rxjsHttpService.ts
ts4. Auswahl: Wenn Sie den automatisch generierten Swagger-Dienst verwenden.
Nach dem Anschluss des OpenAPI-Service-Generators werden die URL und der Antworttyp auf dem Bildschirm nicht erneut geschrieben. Die generierten Funktionen werden importiert und nur die benötigten Pfade, Parameter und den Body übergeben.