RESTEasy 6.2: setja framsendingarproxy á biðl(a)rannsmiðinn

Stilltu netleiðina á RESTEasy-biðlarann áður en hannaða API-hluturinn er búinn til. Typað API-proxy er Java-hlutur, ekki framsendingar-netmilliliðurinn.

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

Þetta er Jakarta-API RESTEasy 6.2, þar sem RESTEasy er uppseti biðlaraveitandinn og MyApi er þegar skilgreint af forritinu. Proxy-færibreyturnar eru hýsingarheiti, heiltölutölugátt og flutningsskema proxysins. Fyrir leyfðar beiðnir til opinberra API-a skaltu nota samsvarandi HTTP-endapunkt frá þjónustunni þinni eða HTTP-proxylistann. Haltu áfangastað API-sins á target; HTTPS-API getur notað HTTP-proxy.

Haltu biðlaranum lifandi fyrir köll typaða proxysins og lokaðu honum þegar vinnunni lýkur. Að skila API-hlutnum úr þegar lokuðu biðlarasviði skilur hann eftir án flutnings.

Ákveddu hver á þennan flutning. Skjöl smiðsins lýsa sjálfgefinni samþættingu Apache HTTP Client. Uppgefið ClientHttpEngine breytir mörkunum: httpEngine gengur fram yfir SSL og tengingarsértæka stillingu smiðsins. Stilltu proxy og TLS í gegnum studda viðmót þeirrar vélar.

Eldri dæmi byggð á ClientExecutor stilla í staðinn umvafið Apache-biðlara. Fylgdu þeirri kynslóð í stað þess að líma hana inn í Jakarta-smiðinn.

Í báðum greinum skaltu halda hýsingarheiti API-sins sem TLS-auðkenni með sannprófun virkri. Proxy-auðkenning, innskráning í API og traust á skírteini eru aðskilin skilyrði; leið ein og sér veitir ekki allar auðkenningaraðferðir.