RESTEasy 6.2: persiunčiančiojo proxy nustatymas kliento kūrėjuje

Nustatykite tinklo maršrutą RESTEasy kliente prieš kurdami anotuotą API objektą. Tipizuotas API proxy yra Java objektas, o ne persiunčiantis tinklo tarpininkas.

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

Tai RESTEasy 6.2 Jakarta API, kur RESTEasy yra įdiegtas kliento teikėjas, o MyApi jau apibrėžtas programos. Proxy argumentai yra pagrindinio kompiuterio vardas, sveikasis prievadas ir proxy transporto schema. Leidžiamoms viešųjų API užklausoms naudokite atitinkamą HTTP galinį tašką iš savo paslaugos arba HTTP proxy sąrašą. Palikite API paskirties vietą target; HTTPS API gali naudoti HTTP proxy.

Palaikykite klientą gyvą jo tipizuoto proxy kvietimams, tada uždarykite jį baigus darbą. Grąžinus API objektą iš jau uždarytos kliento apimties, jis lieka be transporto.

Nuspręskite, kam priklauso tas transportas. Kūrėjo dokumentacija aprašo numatytąją Apache HTTP Client integraciją. Pateiktas ClientHttpEngine keičia ribą: httpEngine pakeičia kūrėjo SSL ir sujungimui būdingą konfigūraciją. Nustatykite proxy ir TLS per to variklio palaikomą sąsają.

Senesni ClientExecutor pagrįsti pavyzdžiai vietoj to konfigūruoja apgaubtą Apache klientą. Atitikite tą kartą, o ne įklijuokite jį į Jakarta kūrėją.

Abiejose šakose palikite API pagrindinio kompiuterio vardą kaip TLS tapatybę su įjungtu tikrinimu. Proxy autentifikavimas, API prisijungimas ir sertifikato pasitikėjimas yra atskiri reikalavimai; vien maršrutas neužtikrina visų autentifikavimo schemų.