RESTEasy 6.2: tetapkan proksi ke hadapan pada pembina klien

Tetapkan laluan rangkaian pada klien RESTEasy sebelum mencipta objek API beranotasi. Proksi API bertaip ialah objek Java, bukan perantara rangkaian ke hadapan.

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

Ini ialah API Jakarta RESTEasy 6.2, dengan RESTEasy sebagai penyedia klien yang dipasang dan MyApi sudah ditakrifkan oleh aplikasi. Argumen proksi ialah nama hos, port integer dan skema pengangkutan proksi. Untuk permintaan API awam yang dibenarkan, gunakan titik akhir HTTP yang sepadan daripada perkhidmatan anda atau senarai proksi HTTP. Kekalkan destinasi API pada target; API HTTPS boleh menggunakan proksi HTTP.

Kekalkan klien hidup untuk panggilan proksi bertaipnya, kemudian tutupnya apabila kerja selesai. Memulangkan objek API daripada skop klien yang sudah ditutup meninggalkannya tanpa pengangkutan.

Tentukan siapa yang memiliki pengangkutan itu. Dokumentasi pembina menerangkan integrasi Apache HTTP Client lalai. ClientHttpEngine yang dibekalkan mengubah sempadan: httpEngine menggantikan konfigurasi SSL dan konfigurasi khusus sambungan pembina. Tetapkan proksi dan TLS melalui antara muka yang disokong enjin itu.

Contoh lama berasaskan ClientExecutor sebaliknya mengkonfigurasi klien Apache yang dibalut. Ikut generasi itu dan bukannya menampalnya ke dalam pembina Jakarta.

Dalam kedua-dua cabang, kekalkan nama hos API sebagai identiti TLS dengan pengesahan didayakan. Pengesahan proksi, log masuk API dan kepercayaan sijil ialah keperluan berasingan; laluan sahaja tidak menyediakan semua skema pengesahan.