RESTEasy 6.2: ορισμός forward proxy στον builder πελάτη

Διαμορφώστε τη μεταφορά HTTP του RESTEasy πριν δημιουργήσετε το τυποποιημένο API proxy και λάβετε υπόψη τη μηχανή HTTP που χρησιμοποιείται.

Ορίστε τη διαδρομή δικτύου στον πελάτη RESTEasy πριν δημιουργήσετε το σχολιασμένο αντικείμενο API. Ένα τυποποιημένο API proxy είναι αντικείμενο Java, όχι ο ενδιάμεσος δικτύου προώθησης.

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

Αυτό είναι το Jakarta API του RESTEasy 6.2, με το RESTEasy ως εγκατεστημένο πάροχο πελάτη και το MyApi ήδη ορισμένο από την εφαρμογή. Τα ορίσματα proxy είναι όνομα κεντρικού υπολογιστή, ακέραια θύρα και σχήμα μεταφοράς proxy. Για επιτρεπόμενα αιτήματα δημόσιου API, χρησιμοποιήστε αντίστοιχο τελικό σημείο HTTP από την υπηρεσία σας ή τη λίστα HTTP proxy. Διατηρήστε τον προορισμό του API στο target· ένα API μέσω HTTPS μπορεί να χρησιμοποιήσει HTTP proxy.

Κρατήστε τον πελάτη ενεργό για τις κλήσεις του τυποποιημένου proxy και κλείστε τον όταν ολοκληρωθεί η εργασία. Η επιστροφή του αντικειμένου API από ήδη κλειστό πεδίο πελάτη το αφήνει χωρίς μεταφορά.

Αποφασίστε ποιος κατέχει αυτή τη μεταφορά. Η τεκμηρίωση του builder περιγράφει την προεπιλεγμένη ενσωμάτωση Apache HTTP Client. Ένα παρεχόμενο ClientHttpEngine αλλάζει το όριο: το httpEngine υπερισχύει της ρύθμισης SSL και της ρύθμισης ειδικά για τη σύνδεση του builder. Ορίστε proxy και TLS μέσω της υποστηριζόμενης διεπαφής αυτής της μηχανής.

Παλαιότερα παραδείγματα βασισμένα σε ClientExecutor διαμορφώνουν αντ' αυτού έναν τυλιγμένο πελάτη Apache. Ταιριάξτε με αυτή τη γενιά αντί να το επικολλήσετε στον builder Jakarta.

Και στις δύο διακλαδώσεις, κρατήστε το όνομα κεντρικού υπολογιστή του API ως ταυτότητα TLS με ενεργοποιημένη επαλήθευση. Ο έλεγχος ταυτότητας proxy, η σύνδεση στο API και η εμπιστοσύνη πιστοποιητικού είναι ξεχωριστές απαιτήσεις· μια διαδρομή μόνη της δεν παρέχει κάθε σχήμα ελέγχου ταυτότητας.

Σχετικά άρθρα