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 लगइन र प्रमाणपत्र विश्वास छुट्टाछुट्टै आवश्यकताहरू हुन्; मात्र मार्गले सबै प्रमाणीकरण योजनाहरू प्रदान गर्दैन।