RESTEasy 6.2: establecer un proxy forward en el builder del cliente

Establezca la ruta de red en el cliente RESTEasy antes de crear el objeto de API anotado. Un proxy de API tipado es un objeto Java, no el intermediario de red de reenvío.

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

Esta es la API Jakarta de RESTEasy 6.2, con RESTEasy como proveedor de cliente instalado y MyApi ya definido por la aplicación. Los argumentos del proxy son el nombre de host, el puerto entero y el esquema de transporte del proxy. Para solicitudes permitidas a API públicas, use un punto de conexión HTTP correspondiente de su servicio o la lista de proxies HTTP. Mantenga el destino de la API en target; una API HTTPS puede usar un proxy HTTP.

Mantenga vivo el cliente para las llamadas de su proxy tipado y ciérrelo al terminar el trabajo. Devolver el objeto de API desde un ámbito de cliente ya cerrado lo deja sin su transporte.

Decida quién es propietario de ese transporte. La documentación del builder describe la integración predeterminada de Apache HTTP Client. Un ClientHttpEngine proporcionado cambia el límite: httpEngine sustituye la configuración SSL y la específica de conexión del builder. Establezca el proxy y TLS mediante la interfaz compatible de ese motor.

Los ejemplos más antiguos basados en ClientExecutor configuran en su lugar un cliente Apache envuelto. Ajústese a esa generación en vez de pegarlo en el builder Jakarta.

En cualquiera de las dos ramas, mantenga el nombre de host de la API como identidad TLS con la verificación activada. La autenticación del proxy, el inicio de sesión en la API y la confianza en el certificado son requisitos separados; una ruta por sí sola no cubre todos los esquemas de autenticación.