RESTEasy 6.2: nastavení forward proxy v builderu klienta

Nastavte síťovou trasu v klientu RESTEasy ještě před vytvořením anotovaného objektu API. Typovaná API proxy je objekt Java, nikoli dopředný síťový prostředník.

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

Toto je Jakarta API RESTEasy 6.2, přičemž RESTEasy je nainstalovaný poskytovatel klienta a MyApi je aplikací již definováno. Argumenty proxy jsou název hostitele, celočíselný port a schéma transportu proxy. Pro povolené požadavky na veřejná API použijte odpovídající HTTP koncový bod ze své služby nebo seznam HTTP proxy. Cíl API ponechte na target; API přes HTTPS může používat HTTP proxy.

Udržujte klienta naživu pro volání jeho typované proxy a poté jej po dokončení práce zavřete. Vrácení objektu API z již uzavřeného rozsahu klienta jej ponechá bez transportu.

Rozhodněte, kdo tento transport vlastní. Dokumentace builderu popisuje výchozí integraci Apache HTTP Client. Dodaný ClientHttpEngine mění hranici: httpEngine nahrazuje SSL a konfiguraci specifickou pro připojení v builderu. Proxy a TLS nastavte prostřednictvím podporovaného rozhraní tohoto enginu.

Starší příklady založené na ClientExecutor místo toho konfigurují obalený klient Apache. Držte se této generace, místo abyste je vkládali do Jakarta builderu.

V obou větvích ponechte název hostitele API jako identitu TLS s povoleným ověřováním. Ověřování proxy, přihlášení k API a důvěra v certifikát jsou samostatné požadavky; samotná trasa neposkytuje všechna schémata ověřování.