RESTEasy 6.2: forward proxy bat ezarri bezeroaren builder-ean

Ezarri sare-bidea RESTEasy bezeroan API objektu anotatua sortu aurretik. API proxy tipatua Java objektua da, ez aurreranzko sare-bitartekaria.

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

Hau RESTEasy 6.2-ren Jakarta APIa da, RESTEasy instalatutako bezero-hornitzailea izanik eta MyApi aplikazioak jada definituta. Proxy argumentuak hostnamea, osoko portua eta proxy garraio-eskema dira. Baimendutako API publikoen eskaeretarako, erabili zure zerbitzuko HTTP amaierako puntu egokia edo HTTP proxy zerrenda. Eutsi APIaren helmuga target-n; HTTPS API batek HTTP proxy bat erabil dezake.

Mantendu bezeroa bizirik bere proxy tipatuaren deietarako, eta itxi lanaren amaieran. Bezero-eremu itxi batetik API objektua itzultzeak garraiorik gabe uzten du.

Erabaki garraio horren jabe nor den. Builder-aren dokumentazioak Apache HTTP Client-en integrazio lehenetsia deskribatzen du. Emandako ClientHttpEngine batek muga aldatzen du: httpEngine-k builder-aren SSL eta konexioaren berariazko konfigurazioa ordezkatzen du. Ezarri proxy eta TLS motor horren interfaze onartuaren bidez.

ClientExecutor-ean oinarritutako adibide zaharragoek Apache bezero bildu bat konfiguratzen dute. Belaunaldi horri egokitu, Jakarta builder-ean itsatsi ordez.

Bi adarretan, mantendu APIaren hostnamea TLS identitate gisa, egiaztapena gaituta. Proxy autentifikazioa, API saioa eta ziurtagiriaren konfiantza baldintza bereiziak dira; bide soil batek ez ditu autentifikazio eskema guztiak ematen.