البدء

أولاً، سأشرح كيفية استخدام عميل typed-rx-http Core، ثم سأشرح كيفية ربط محول HTTP العام المملوك للمشروع وخدمة Swagger التلقائية فقط في المشاريع التي تحتاج إلى ذلك.

1. التثبيت

bash

2. استخدام العميل الأساسي مباشرة بدون توليد تلقائي

أولاً، أبسط طريقة للاستخدام هي createHttpClient<Paths>()إنشاء عميل مرة واحدة، واستدعاء callApi لهذا العميل. Paths هو نوع المسارات الذي تم إنشاؤه في OpenAPI، ولكن يمكنك أيضًا استخدام نوع معرف مباشرة يتوافق مع نفس الهيكل.

httpClient.ts

القيمة المرجعة دائمًا هي Observable

callApi و callApiStream لا ترجعان Promise، بل RxJS Observable. عند استخدام استجابة واحدة في دالة async، يجب تحويلها صراحة باستخدام firstValueFrom أو lastValueFrom، بينما يتم معالجة الطلبات التي تحتوي على قيم متعددة باستخدام pipe أو subscribe.

3. اختيار: ما هو rxjsHttpService/commonService؟

ما يُشار إليه في الوثيقة باسم rxjsHttpService.ts أو commonService.ts ليس اسم ملف ثابت يتم إنشاؤه تلقائيًا بواسطة المكتبة. إنه ملف محول HTTP مملوك مباشرة للمشروع. تستخدم عدة خدمات REST التي تم إنشاؤها تلقائيًا نفس الوظائف callApi/callApiStream/cache التي تصدرها هذا الملف كنقطة دخول مشتركة.

أبسط شكل هو إنشاء headerStore وcreateHttpClient مرة واحدة كما في الكود الكامل أدناه، وإعادة تصدير طرق المكتبة كوظائف للمشروع. إذا لم تستخدم وظيفة التخزين المؤقت في الخدمة التي تم إنشاؤها تلقائيًا، يمكنك فهم الهيكل باستخدام هذا التكوين فقط.

rxjsHttpService.ts

للتعامل مع مصادقة الجلسة، وطلبات SSR لكل ملف تعريف، وذاكرة التخزين المؤقت CSR وذاكرة التخزين المؤقت SSR في مشروع Next.js الفعلي، يمكنك توسيعها كما هو موضح أدناه. هذا الملف أيضًا ليس منتجًا تم إنشاؤه تلقائيًا، بل هو كود المشروع.

rxjsHttpService.ts

ما يشير إليه commonServiceFile هو هذا الملف.

ملف commonServiceFile لمولد OpenAPI ليس خيارًا لإنشاء الملف أعلاه. يحدد مسار ملف المشروع الذي يستورد callApi وcallApiStream وcallApiClientCache أو callApiServerCache. لذلك، يجب تحديد دور هذا الملف وتصديره قبل إعداد المولد.

4. اختيار: في حالة استخدام خدمة Swagger التلقائية.

بعد ربط مولد خدمة OpenAPI، لا تعيد كتابة عنوان URL ونوع الاستجابة في الشاشة. يتم استيراد الدوال المولدة وتمرير المسار والمعلمات والجسم المطلوبة فقط.

MemberSearchPage.tsx

tsx

المستند التالي

HTTP Client

تحقق من الكود الكامل لـ commonService ودور كل مكون.

بدء سريع

تحقق أولاً من كيفية استخدام المكتبة بالكامل، ثم تابع للتحقق من أمثلة الاستدعاء الفعلية للواجهة الأمامية/الخلفية لمشروع WebFlux + Swagger التلقائي.

OpenAPI Generator

تحقق من القواعد التي يتم بها إنشاء الأنواع والخدمات من swagger.json.