RESTEasy 6.2: sett en videresendt proxy på klientbyggeren

Sett nettverksruten på RESTEasy-klienten før det annoterte API-objektet opprettes. En typet API-proxy er et Java-objekt, ikke den videresendende nettverksmekleren.

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

Dette er RESTEasy 6.2 sin Jakarta-API, med RESTEasy som installert klientleverandør og MyApi allerede definert av applikasjonen. Proxy-argumentene er vertsnavn, heltallsport og proxy-transportskjema. For tillatte offentlige API-forespørsler, bruk et samsvarende HTTP-endepunkt fra tjenesten din eller HTTP-proxylisten. Hold API-ets destinasjon på target; et HTTPS-API kan bruke en HTTP-proxy.

Hold klienten i live for kallene til den typede proxyen, og lukk den når arbeidet er ferdig. Returneres API-objektet fra et allerede lukket klientomfang, står det uten transport.

Bestem hvem som eier transporten. Byggerens dokumentasjon beskriver standardintegrasjonen av Apache HTTP Client. En medsendt ClientHttpEngine endrer grensen: httpEngine overstyrer byggerens SSL- og tilkoblingsspesifikke konfigurasjon. Sett proxy og TLS gjennom det støttede grensesnittet til den motoren.

Eldre eksempler basert på ClientExecutor konfigurerer i stedet en innpakket Apache-klient. Følg den generasjonen i stedet for å lime den inn i Jakarta-byggeren.

I begge grener, hold API-vertsnavnet som TLS-identitet med verifisering aktivert. Proxy-autentisering, API-innlogging og sertifikattillit er separate krav; en rute alene gir ikke alle autentiseringsskjemaer.