RESTEasy 6.2: क्लाइंट बिल्डर पर फ़ॉरवर्ड प्रॉक्सी सेट करें

एनोटेटेड API ऑब्जेक्ट बनाने से पहले RESTEasy क्लाइंट पर नेटवर्क मार्ग सेट करें। टाइप्ड 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);

यह RESTEasy 6.2 का Jakarta API है, जिसमें RESTEasy इंस्टॉल किया गया क्लाइंट प्रोवाइडर है और MyApi ऐप्लिकेशन द्वारा पहले से परिभाषित है। प्रॉक्सी आर्ग्युमेंट होस्टनाम, पूर्णांक पोर्ट और प्रॉक्सी ट्रांसपोर्ट स्कीम हैं। अनुमत सार्वजनिक API अनुरोधों के लिए अपनी सेवा का मेल खाता HTTP एंडपॉइंट या HTTP प्रॉक्सी सूची उपयोग करें। API का गंतव्य target पर रखें; HTTPS API HTTP प्रॉक्सी का उपयोग कर सकता है।

क्लाइंट को उसकी टाइप्ड प्रॉक्सी के कॉल के लिए जीवित रखें, फिर काम पूरा होने पर बंद करें। पहले से बंद क्लाइंट स्कोप से API ऑब्जेक्ट लौटाने पर वह बिना ट्रांसपोर्ट के रह जाता है।

तय करें कि वह ट्रांसपोर्ट किसका है। बिल्डर दस्तावेज़ डिफ़ॉल्ट Apache HTTP Client एकीकरण का वर्णन करता है। दिया गया ClientHttpEngine सीमा बदलता है: httpEngine बिल्डर के SSL और कनेक्शन-विशिष्ट कॉन्फ़िगरेशन को प्रतिस्थापित करता है। प्रॉक्सी और TLS उस इंजन के समर्थित इंटरफ़ेस से सेट करें।

ClientExecutor आधारित पुराने उदाहरण इसके बजाय लिपटा हुआ Apache क्लाइंट कॉन्फ़िगर करते हैं। Jakarta बिल्डर में चिपकाने के बजाय उसी पीढ़ी से मेल खाएँ।

दोनों शाखाओं में API होस्टनाम को TLS पहचान के रूप में रखें, सत्यापन सक्षम रखते हुए। प्रॉक्सी प्रमाणीकरण, API लॉगिन और प्रमाणपत्र विश्वास अलग-अलग आवश्यकताएँ हैं; केवल मार्ग सभी प्रमाणीकरण स्कीम प्रदान नहीं करता।