RESTEasy 6.2: előrehaladó proxy beállítása az ügyfélépítőn

Állítsa be a hálózati útvonalat a RESTEasy-ügyfélen, mielőtt létrehozná az annotált API-objektumot. A típusos API-proxy Java-objektum, nem az előrehaladó hálózati közvetítő.

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

Ez a RESTEasy 6.2 Jakarta API-ja, a RESTEasy a telepített ügyfélszolgáltató, és a MyApi már definiálva van az alkalmazásban. A proxy argumentumai a gazdagépnév, az egész számú port és a proxy szállítási sémája. Az engedélyezett nyilvános API-kérésekhez használja a szolgáltatása megfelelő HTTP-végpontját vagy a HTTP-proxylistát. Tartsa az API célját a target értéken; egy HTTPS API használhat HTTP-proxyt.

Tartsa életben az ügyfelet a típusos proxy hívásaihoz, majd a munka befejeztével zárja be. Az API-objektum visszaadása egy már lezárt ügyfélhatókörből szállítás nélkül hagyja.

Döntse el, kié ez a szállítás. Az építő dokumentációja az alapértelmezett Apache HTTP Client-integrációt írja le. Egy megadott ClientHttpEngine megváltoztatja a határt: a httpEngine felülírja az építő SSL- és kapcsolatspecifikus konfigurációját. A proxyt és a TLS-t az adott motor támogatott felületén keresztül állítsa be.

A ClientExecutor alapú régebbi példák helyette egy becsomagolt Apache-ügyfelet konfigurálnak. Ahhoz a generációhoz igazodjon, ahelyett hogy beillesztené a Jakarta-építőbe.

Mindkét ágban tartsa az API gazdagépnevét TLS-identitásként, engedélyezett ellenőrzéssel. A proxyhitelesítés, az API-bejelentkezés és a tanúsítványbizalom külön követelmények; egy útvonal önmagában nem biztosít minden hitelesítési sémát.