RESTEasy 6.2: vendosja e një proxy përpara te ndërtuesi i klientit

Vendosni rrugën e rrjetit te klienti RESTEasy përpara se të krijoni objektin e API-së të anotuar. Një proxy API i tipizuar është objekt Java, jo ndërmjetësi i rrjetit përpara.

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

Ky është API Jakarta i RESTEasy 6.2, me RESTEasy si ofruesin e klientit të instaluar dhe MyApi tashmë të përcaktuar nga aplikacioni. Argumentet e proxy-t janë emri i hostit, porta e plotë dhe skema e transportit të proxy-t. Për kërkesat e lejuara drejt API-ve publike, përdorni një pikë fundore HTTP përkatëse nga shërbimi juaj ose listën e proxy-ve HTTP. Mbani destinacionin e API-së në target; një API HTTPS mund të përdorë një proxy HTTP.

Mbani klientin gjallë për thirrjet e proxy-t të tij të tipizuar, pastaj mbylleni në përfundim të punës. Kthimi i objektit të API-së nga një fushë klienti tashmë e mbyllur e lë atë pa transport.

Vendosni kush e zotëron atë transport. Dokumentacioni i ndërtuesit përshkruan integrimin e parazgjedhur Apache HTTP Client. Një ClientHttpEngine i furnizuar ndryshon kufirin: httpEngine zëvendëson SSL dhe konfigurimin specifik të lidhjes së ndërtuesit. Vendosni proxy-n dhe TLS përmes ndërfaqes së mbështetur të atij motori.

Shembujt më të vjetër të bazuar në ClientExecutor konfigurojnë në vend të kësaj një klient Apache të mbështjellë. Përputhuni me atë gjeneratë në vend që ta ngjitni në ndërtuesin Jakarta.

Në të dyja degët, mbani emrin e hostit të API-së si identitet TLS me verifikimin e aktivizuar. Vërtetimi i proxy-t, hyrja në API dhe besimi te certifikata janë kërkesa të veçanta; një rrugë e vetme nuk ofron të gjitha skemat e vërtetimit.