RESTEasy 6.2: välityspalvelimen asettaminen asiakasohjelman rakentajaan

Aseta verkkoreitti RESTEasy-asiakkaaseen ennen annotoidun API-objektin luomista. Tyypitetty API-välitysohjelma on Java-objekti, ei edelleen välittävä verkkovälittäjä.

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

Tämä on RESTEasy 6.2:n Jakarta-API, jossa RESTEasy on asennettu asiakastoimittaja ja MyApi on sovelluksen jo määrittelemä. Välityspalvelimen argumentit ovat isäntänimi, kokonaislukuna annettu portti ja välityspalvelimen siirtomalli. Sallituille julkisten API:en pyynnöille käytä palvelusi vastaavaa HTTP-päätepistettä tai HTTP-välityspalvelinluetteloa. Pidä API:n kohde target-arvossa; HTTPS-API voi käyttää HTTP-välityspalvelinta.

Pidä asiakas elossa sen tyypitetyn välitysohjelman kutsuja varten ja sulje se työn päätyttyä. API-objektin palauttaminen jo suljetusta asiakasrajapinnasta jättää sen ilman siirtoa.

Päätä, kenelle siirto kuuluu. Rakentajan dokumentaatio kuvaa oletusarvoisen Apache HTTP Client -integraation. Annettu ClientHttpEngine muuttaa rajaa: httpEngine syrjäyttää rakentajan SSL- ja yhteyskohtaisen kokoonpanon. Aseta välityspalvelin ja TLS kyseisen moottorin tukeman rajapinnan kautta.

Vanhemmat ClientExecutor-pohjaiset esimerkit määrittävät sen sijaan käärityn Apache-asiakkaan. Noudata sitä sukupolvea sen sijaan, että liittäisit sen Jakarta-rakentajaan.

Molemmissa haaroissa pidä API:n isäntänimi TLS-identiteettinä varmennus käytössä. Välityspalvelimen todennus, API-kirjautuminen ja varmennehuolto ovat erillisiä vaatimuksia; pelkkä reitti ei tarjoa kaikkia todennusmalleja.