RESTEasy 6.2: ضبط وكيل أمامي على مُنشئ العميل

اضبط مسار الشبكة على عميل RESTEasy قبل إنشاء كائن API المشروح. وكيل API المكتوب هو كائن Java، وليس الوسيط الشبكي الأمامي.

import jakarta.ws.rs.client.ClientBuilder;
import org.jboss.resteasy.client.jaxrs.ResteasyClient;
import org.jboss.resteasy.client.jaxrs.ResteasyClientBuilder;

ResteasyClientBuilder builder =
    (ResteasyClientBuilder) ClientBuilder.newBuilder();

ResteasyClient client = builder
    .defaultProxy("proxy.example.net", 8080, "http")
    .build();

MyApi api = client
    .target("https://api.example.net")
    .proxy(MyApi.class);

هذه واجهة Jakarta API في RESTEasy 6.2، مع RESTEasy كمزوّد العميل المثبّت وMyApi معرَّف مسبقًا في التطبيق. وسائط الوكيل هي اسم المضيف والمنفذ الصحيح ومخطط نقل الوكيل. للطلبات المسموح بها إلى واجهات API العامة، استخدم نقطة نهاية HTTP مطابقة من خدمتك أو قائمة وكلاء HTTP. أبقِ وجهة API على target؛ يمكن لواجهة API عبر HTTPS استخدام وكيل HTTP.

أبقِ العميل حيًّا لنداءات وكيله المكتوب، ثم أغلقه عند اكتمال العمل. إرجاع كائن API من نطاق عميل مغلق مسبقًا يتركه بلا نقله.

حدّد من يملك ذلك النقل. توثيق المُنشئ يصف تكامل Apache HTTP Client الافتراضي. وجود ClientHttpEngine مُمرَّر يغيّر الحدود: httpEngine يلغي إعدادات SSL والاتصال الخاصة بالمُنشئ. اضبط الوكيل وTLS عبر الواجهة المدعومة لذلك المحرك.

الأمثلة الأقدم القائمة على ClientExecutor تهيّئ بدلًا من ذلك عميل Apache مُغلَّفًا. طابق ذلك الجيل بدلًا من لصقه في مُنشئ Jakarta.

في كلتا الحالتين، أبقِ اسم مضيف API كهوية TLS مع تمكين التحقق. مصادقة الوكيل وتسجيل الدخول إلى API وثقة الشهادة متطلبات منفصلة؛ المسار وحده لا يوفّر كل مخططات المصادقة.