RESTEasy 6.2: କ୍ଲାଏଣ୍ଟ ବିଲଡରରେ ଫରୱାର୍ଡ ପ୍ରକ୍ସି ସେଟ୍ କରନ୍ତୁ

ଆନୋଟେଟେଡ୍ API ଅବଜେକ୍ଟ ସୃଷ୍ଟି କରିବା ପୂର୍ବରୁ RESTEasy କ୍ଲାଏଣ୍ଟରେ ନେଟୱାର୍କ ମାର୍ଗ ସେଟ୍ କରନ୍ତୁ। ଏକ ଟାଇପଡ୍ API ପ୍ରକ୍ସି ହେଉଛି 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);

ଏହା RESTEasy 6.2 ର Jakarta API, ଯେଉଁଥିରେ RESTEasy ସ୍ଥାପିତ କ୍ଲାଏଣ୍ଟ ପ୍ରଦାନକାରୀ ଏବଂ MyApi ଆପ୍ଲିକେସନ୍ ଦ୍ୱାରା ପୂର୍ବରୁ ପରିଭାଷିତ। ପ୍ରକ୍ସି ଆର୍ଗୁମେଣ୍ଟଗୁଡ଼ିକ ହେଉଛି ହୋଷ୍ଟନାମ, ପୂର୍ଣ୍ଣସଂଖ୍ୟା ପୋର୍ଟ ଏବଂ ପ୍ରକ୍ସି ପରିବହନ ସ୍କିମ୍। ଅନୁମତିପ୍ରାପ୍ତ ସାର୍ବଜନୀନ API ଅନୁରୋଧ ପାଇଁ ଆପଣଙ୍କ ସେବାର ମେଳ ଖାଉଥିବା HTTP ଏଣ୍ଡପଏଣ୍ଟ କିମ୍ବା HTTP ପ୍ରକ୍ସି ତାଲିକା ବ୍ୟବହାର କରନ୍ତୁ। API ର ଗନ୍ତବ୍ୟ target ରେ ରଖନ୍ତୁ; HTTPS API HTTP ପ୍ରକ୍ସି ବ୍ୟବହାର କରିପାରିବ।

କ୍ଲାଏଣ୍ଟକୁ ଏହାର ଟାଇପଡ୍ ପ୍ରକ୍ସିର କଲ୍ ପାଇଁ ଜୀବିତ ରଖନ୍ତୁ, ତାପରେ କାର୍ଯ୍ୟ ସମାପ୍ତ ହେଲେ ବନ୍ଦ କରନ୍ତୁ। ପୂର୍ବରୁ ବନ୍ଦ ହୋଇଥିବା କ୍ଲାଏଣ୍ଟ ସ୍କୋପରୁ API ଅବଜେକ୍ଟ ଫେରାଇଲେ ଏହା ପରିବହନ ବିନା ରହିଯାଏ।

ସେହି ପରିବହନ କାହାର ତାହା ନିର୍ଣ୍ଣୟ କରନ୍ତୁ। ବିଲଡର ଡକୁମେଣ୍ଟେସନ୍ ଡିଫଲ୍ଟ Apache HTTP Client ସଂହତି ବର୍ଣ୍ଣନା କରେ। ପ୍ରଦାନ କରାଯାଇଥିବା ClientHttpEngine ସୀମା ବଦଳାଏ: httpEngine ବିଲଡରର SSL ଏବଂ ସଂଯୋଗ-ନିର୍ଦ୍ଦିଷ୍ଟ କନଫିଗରେସନକୁ ବଦଳାଏ। ପ୍ରକ୍ସି ଏବଂ TLS ସେହି ଇଞ୍ଜିନର ସମର୍ଥିତ ଇଣ୍ଟରଫେସ ମାଧ୍ୟମରେ ସେଟ୍ କରନ୍ତୁ।

ClientExecutor ଉପରେ ଆଧାରିତ ପୁରୁଣା ଉଦାହରଣଗୁଡ଼ିକ ଏହାର ପରିବର୍ତ୍ତେ ଗୁଡ଼ାଯାଇଥିବା Apache କ୍ଲାଏଣ୍ଟ କନଫିଗର କରେ। Jakarta ବିଲଡରରେ ଲଗାଇବା ପରିବର୍ତ୍ତେ ସେହି ପିଢ଼ି ସହିତ ମେଳ ରଖନ୍ତୁ।

ଉଭୟ ଶାଖାରେ API ହୋଷ୍ଟନାମକୁ TLS ପରିଚୟ ଭାବରେ ରଖନ୍ତୁ, ଯାଞ୍ଚ ସକ୍ଷମ ରଖି। ପ୍ରକ୍ସି ପ୍ରାମାଣୀକରଣ, API ଲଗଇନ୍ ଏବଂ ପ୍ରମାଣପତ୍ର ବିଶ୍ୱାସ ଅଲଗା ଆବଶ୍ୟକତା; କେବଳ ମାର୍ଗ ସମସ୍ତ ପ୍ରାମାଣୀକରଣ ସ୍କିମ୍ ପ୍ରଦାନ କରେ ନାହିଁ।