RESTEasy 6.2: magtakda ng forward proxy sa client builder

Itakda ang ruta ng network sa RESTEasy client bago gawin ang annotated na API object. Ang typed API proxy ay isang Java object, hindi ang forward na tagapamagitan ng network.

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

Ito ang Jakarta API ng RESTEasy 6.2, kung saan ang RESTEasy ang naka-install na client provider at ang MyApi ay tinukoy na ng application. Ang mga argumento ng proxy ay hostname, integer port at proxy transport scheme. Para sa pinapayagang pampublikong API request, gumamit ng tugmang HTTP endpoint mula sa iyong serbisyo o ang listahan ng HTTP proxy. Panatilihin ang destinasyon ng API sa target; ang HTTPS API ay maaaring gumamit ng HTTP proxy.

Panatilihing buhay ang client para sa mga tawag ng typed proxy nito, pagkatapos isara ito kapag tapos na ang trabaho. Ang pagbabalik ng API object mula sa sarado nang client scope ay nag-iiwan dito nang walang transport.

Magpasya kung kanino ang transport na iyon. Inilalarawan ng dokumentasyon ng builder ang default na integrasyon ng Apache HTTP Client. Ang ibinigay na ClientHttpEngine ay nagbabago sa hangganan: pinapalitan ng httpEngine ang SSL at connection-specific na configuration ng builder. Itakda ang proxy at TLS sa pamamagitan ng sinusuportahang interface ng engine na iyon.

Ang mas lumang mga halimbawa batay sa ClientExecutor ay nagko-configure sa halip ng nakabalot na Apache client. Sundin ang henerasyong iyon sa halip na i-paste ito sa Jakarta builder.

Sa alinmang sangay, panatilihin ang hostname ng API bilang TLS identity na naka-enable ang verification. Ang proxy authentication, API login at pagtitiwala sa certificate ay magkakahiwalay na pangangailangan; ang ruta lamang ay hindi nagbibigay ng lahat ng scheme ng authentication.