RESTEasy 6.2: client builder တွင် forward proxy သတ်မှတ်ခြင်း

typed API proxy မဖန်တီးမီ RESTEasy ၏ HTTP သယ်ယူပို့ဆောင်မှုကို ပြင်ဆင်ပြီး အသုံးပြုနေသော HTTP engine ကို ထည့်သွင်းစဉ်းစားပါ။

annotated API object မဖန်တီးမီ RESTEasy client တွင် ကွန်ရက်လမ်းကြောင်းကို သတ်မှတ်ပါ။ typed API proxy သည် Java object ဖြစ်ပြီး forward ကွန်ရက်ကြားခံ မဟုတ်ပါ။

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

ဤသည် RESTEasy 6.2 ၏ Jakarta API ဖြစ်ပြီး RESTEasy သည် ထည့်သွင်းထားသော client ပံ့ပိုးသူဖြစ်ကာ MyApi ကို application မှ ကြိုတင်သတ်မှတ်ထားပြီးဖြစ်သည်။ proxy argument များမှာ hostname၊ ကိန်းပြည့် port နှင့် proxy သယ်ယူပို့ဆောင်မှု scheme ဖြစ်သည်။ ခွင့်ပြုထားသော အများပြည်သူ API တောင်းဆိုမှုများအတွက် သင့်ဝန်ဆောင်မှုမှ ကိုက်ညီသော HTTP endpoint သို့မဟုတ် HTTP proxy စာရင်း ကို အသုံးပြုပါ။ API ၏ ဦးတည်ရာကို target တွင် ထားရှိပါ။ HTTPS API သည် HTTP proxy ကို အသုံးပြုနိုင်သည်။

client ကို ၎င်း၏ typed proxy ခေါ်ဆိုမှုများအတွက် ရှင်သန်ထားပြီး အလုပ်ပြီးဆုံးချိန်တွင် ပိတ်ပါ။ ပိတ်ပြီးသော client scope မှ API object ကို ပြန်ပေးပါက ၎င်းသည် သယ်ယူပို့ဆောင်မှုမရှိဘဲ ကျန်ရစ်သည်။

ထိုသယ်ယူပို့ဆောင်မှုကို မည်သူပိုင်ဆိုင်သည်ကို ဆုံးဖြတ်ပါ။ builder စာရွက်စာတမ်းသည် မူရင်း Apache HTTP Client ပေါင်းစပ်မှုကို ဖော်ပြသည်။ ပေးထားသော ClientHttpEngine သည် နယ်နိမိတ်ကို ပြောင်းသည်။ httpEngine သည် builder ၏ SSL နှင့် ချိတ်ဆက်မှုဆိုင်ရာ ပြင်ဆင်မှုကို အစားထိုးသည်။ proxy နှင့် TLS ကို ထို engine ၏ ပံ့ပိုးထားသော interface ဖြင့် သတ်မှတ်ပါ။

ClientExecutor အခြေခံသော ဟောင်းနွမ်းသော ဥပမာများသည် အစားထိုးအနေဖြင့် ခြုံထားသော Apache client ကို ပြင်ဆင်သည်။ Jakarta builder ထဲသို့ ကူးထည့်မည့်အစား ထိုမျိုးဆက်နှင့် ကိုက်ညီပါစေ။

အခွဲနှစ်ခုစလုံးတွင် API hostname ကို TLS အထောက်အထားအဖြစ် ထားရှိပြီး အတည်ပြုခြင်းကို ဖွင့်ထားပါ။ proxy အတည်ပြုခြင်း၊ API ဝင်ရောက်ခြင်းနှင့် လက်မှတ်ယုံကြည်မှုသည် သီးခြားလိုအပ်ချက်များဖြစ်သည်။ လမ်းကြောင်းတစ်ခုတည်းဖြင့် အတည်ပြုခြင်း scheme အားလုံးကို မပေးစွမ်းပါ။

ဆက်စပ်ဆောင်းပါးများ