RESTEasy 6.2: establir un proxy intermediari al constructor de client

Establiu la ruta de xarxa al client RESTEasy abans de crear l'objecte API anotat. Un proxy API tipat és un objecte Java, no l'intermediari de xarxa intermediari.

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

Aquesta és l'API Jakarta de RESTEasy 6.2, amb RESTEasy com a proveïdor de client instal·lat i MyApi ja definit per l'aplicació. Els arguments del proxy són nom d'amfitrió, port enter i esquema de transport del proxy. Per a sol·licituds permeses a API públiques, feu servir un punt de connexió HTTP corresponent del vostre servei o la llista de proxys HTTP. Manteniu la destinació de l'API a target; una API HTTPS pot utilitzar un proxy HTTP.

Mantingueu el client viu per a les crides del seu proxy tipat i tanqueu-lo en acabar la feina. Retornar l'objecte API des d'un àmbit de client ja tancat el deixa sense transport.

Decidiu qui posseeix aquest transport. La documentació del constructor descriu la integració predeterminada d'Apache HTTP Client. Un ClientHttpEngine subministrat canvia el límit: httpEngine substitueix la configuració SSL i específica de connexió del constructor. Establiu el proxy i TLS mitjançant la interfície compatible d'aquest motor.

Els exemples antics basats en ClientExecutor configuren en canvi un client Apache embolcallat. Seguiu aquella generació en lloc d'enganxar-lo al constructor Jakarta.

En qualsevol de les dues branques, manteniu el nom d'amfitrió de l'API com a identitat TLS amb la verificació activada. L'autenticació del proxy, l'inici de sessió a l'API i la confiança en el certificat són requisits separats; una ruta per si sola no proporciona tots els esquemes d'autenticació.