RESTEasy 6.2: nastavitev posredniškega proxyja v graditelju odjemalca

Nastavite omrežno pot v odjemalcu RESTEasy pred ustvarjanjem označenega objekta API. Tipizirani proxy API je objekt Java, ne pa posrednik omrežja naprej.

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

To je Jakarta API RESTEasy 6.2, kjer je RESTEasy nameščeni ponudnik odjemalca in je MyApi že definiran v aplikaciji. Argumenti proxyja so ime gostitelja, celoštevilsko vrata in shema transporta proxyja. Za dovoljene zahteve do javnih API-jev uporabite ustrezno končno točko HTTP iz svoje storitve ali seznam proxyjev HTTP. Ohranite cilj API-ja na target; API prek HTTPS lahko uporablja proxy HTTP.

Ohranjajte odjemalca živega za klice njegovega tipiziranega proxyja, nato ga zaprite ob zaključku dela. Vračanje objekta API iz že zaprtega obsega odjemalca ga pusti brez transporta.

Odločite, kdo je lastnik tega transporta. Dokumentacija graditelja opisuje privzeto integracijo Apache HTTP Client. Priloženi ClientHttpEngine spremeni mejo: httpEngine nadomesti SSL in konfiguracijo, specifično za povezavo, pri graditelju. Nastavite proxy in TLS prek podprtega vmesnika tega pogona.

Starejši primeri, ki temeljijo na ClientExecutor, namesto tega konfigurirajo ovit odjemalec Apache. Prilagodite se tej generaciji, namesto da bi jo prilepili v graditelj Jakarta.

V obeh vejah ohranite ime gostitelja API kot identiteto TLS z omogočenim preverjanjem. Preverjanje pristnosti proxyja, prijava v API in zaupanje v potrdilo so ločene zahteve; samo pot ne zagotavlja vseh shem preverjanja pristnosti.