RESTEasy 6.2: pārstūrēšanas starpniekservera iestatīšana klienta veidotājā

Iestatiet tīkla maršrutu RESTEasy klientā pirms anotētā API objekta izveides. Tipizēts API starpniekserveris ir Java objekts, nevis pārstūrēšanas tīkla starpnieks.

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);

Šī ir RESTEasy 6.2 Jakarta API, kur RESTEasy ir instalētais klienta nodrošinātājs un MyApi jau ir definēts lietojumprogrammā. Starpniekservera argumenti ir resursdatora nosaukums, vesela skaitļa ports un starpniekservera transporta shēma. Atļautiem publisko API pieprasījumiem izmantojiet atbilstošu HTTP galapunktu no jūsu pakalpojuma vai HTTP starpniekserveru sarakstu. Saglabājiet API galamērķi uz target; HTTPS API var izmantot HTTP starpniekserveri.

Turiet klientu dzīvu tā tipizētā starpniekservera izsaukumiem, pēc tam aizveriet to darba beigās. API objekta atgriešana no jau aizvērtas klienta tvēruma atstāj to bez transporta.

Izlemiet, kam pieder šis transports. Veidotāja dokumentācija apraksta noklusējuma Apache HTTP Client integrāciju. Nodrošināts ClientHttpEngine maina robežu: httpEngine aizstāj veidotāja SSL un savienojumam raksturīgo konfigurāciju. Iestatiet starpniekserveri un TLS, izmantojot šī dzinēja atbalstīto saskarni.

Vecāki ClientExecutor balstīti piemēri tā vietā konfigurē ietītu Apache klientu. Atbilstiet šai paaudzei, nevis ielīmējiet to Jakarta veidotājā.

Abos zaros saglabājiet API resursdatora nosaukumu kā TLS identitāti ar iespējotu pārbaudi. Starpniekservera autentifikācija, API pieteikšanās un sertifikāta uzticēšanās ir atsevišķas prasības; tikai maršruts nenodrošina visas autentifikācijas shēmas.