RESTEasy 6.2: nastavenie forward proxy v builderi klienta

Nastavte sieťovú trasu v klientovi RESTEasy ešte pred vytvorením anotovaného objektu API. Typovaná API proxy je objekt Java, nie dopredný sieťový sprostredkovateľ.

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, pričom RESTEasy je nainštalovaný poskytovateľ klienta a MyApi je aplikáciou už definované. Argumenty proxy sú názov hostiteľa, celočíselný port a schéma transportu proxy. Pre povolené požiadavky na verejné API použite zodpovedajúci HTTP koncový bod zo svojej služby alebo zoznam HTTP proxy. Cieľ API ponechajte na target; API cez HTTPS môže používať HTTP proxy.

Udržujte klienta nažive pre volania jeho typovanej proxy a potom ho po dokončení práce zatvorte. Vrátenie objektu API z už uzavretého rozsahu klienta ho ponechá bez transportu.

Rozhodnite, kto tento transport vlastní. Dokumentácia buildera popisuje predvolenú integráciu Apache HTTP Client. Dodaný ClientHttpEngine mení hranicu: httpEngine nahrádza SSL a konfiguráciu špecifickú pre pripojenie v builderi. Proxy a TLS nastavte prostredníctvom podporovaného rozhrania tohto enginu.

Staršie príklady založené na ClientExecutor namiesto toho konfigurujú obalený klient Apache. Držte sa tejto generácie, namiesto vkladania do Jakarta buildera.

V oboch vetvách ponechajte názov hostiteľa API ako identitu TLS s povoleným overovaním. Overovanie proxy, prihlásenie do API a dôvera k certifikátu sú samostatné požiadavky; samotná trasa neposkytuje všetky schémy overovania.