RESTEasy 6.2: agordi antaŭan prokurilon en la klienta konstruilo

Agordi la retan vojon en la RESTEasy-kliento antaŭ ol krei la anotitan API-objekton. Tipa API-prokurilo estas Java-objekto, ne la antaŭa reta peranto.

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

Ĉi tio estas la Jakarta-API de RESTEasy 6.2, kun RESTEasy kiel la instalita klienta provizanto kaj MyApi jam difinita de la aplikaĵo. La prokurilaj argumentoj estas gastigantnomo, entjera pordo kaj prokurila transporta skemo. Por permesitaj publikaj API-petoj, uzu kongruan HTTP-finpunkton el via servo aŭ la liston de HTTP-prokuriloj. Konservu la celon de la API sur target; HTTPS-API povas uzi HTTP-prokurilon.

Tenadu la klienton viva por la vokoj de ĝia tipa prokurilo, poste fermu ĝin ĉe fino de la laboro. Redoni la API-objekton el jam fermita klienta amplekso lasas ĝin sen sia transporto.

Decidu, kiu posedas tiun transporton. La dokumentaro de la konstruilo priskribas la defaŭltan integriĝon de Apache HTTP Client. Provizita ClientHttpEngine ŝanĝas la limon: httpEngine anstataŭas la SSL- kaj konekto-specifan agordon de la konstruilo. Agordu prokurilon kaj TLS per la subtenata interfaco de tiu motoro.

Pli malnovaj ekzemploj bazitaj sur ClientExecutor anstataŭe agordas ĉirkaŭitan Apache-klienton. Sekvu tiun generacion anstataŭ englui ĝin en la Jakarta-konstruilon.

En ambaŭ branĉoj, konservu la API-gastigantnomon kiel TLS-identecon kun verifikado ŝaltita. Prokurila aŭtentikigo, API-ensaluto kaj atestila fido estas apartaj postuloj; vojo sola ne provizas ĉiun aŭtentikigan skemon.