RESTEasy 6.2: កំណត់ forward proxy នៅលើ client builder

កំណត់ផ្លូវបណ្តាញនៅលើ RESTEasy client មុនពេលបង្កើត annotated API object។ Typed API proxy គឺជា Java object មិនមែនជាអន្តរការីបណ្តាញឆ្ពោះទៅមុខទេ។

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 ជាអ្នកផ្តល់ client ដែលបានដំឡើង ហើយ MyApi ត្រូវបានកំណត់រួចហើយដោយកម្មវិធី។ អាគុយម៉ង់របស់ proxy គឺឈ្មោះ host ច្រកជាចំនួនគត់ និងគ្រោងការណ៍ transport របស់ proxy។ សម្រាប់សំណើ API សាធារណៈដែលបានអនុញ្ញាត សូមប្រើ HTTP endpoint ដែលត្រូវគ្នាពីសេវារបស់អ្នក ឬ បញ្ជី HTTP proxy។ រក្សាគោលដៅរបស់ API នៅលើ target; API បែប HTTPS អាចប្រើ HTTP proxy។

រក្សា client ឲ្យនៅរស់សម្រាប់ការហៅរបស់ typed proxy របស់វា បន្ទាប់មកបិទវានៅពេលការងារបញ្ចប់។ ការត្រឡប់ API object ពី scope client ដែលបានបិទរួចហើយ ធ្វើឲ្យវាគ្មាន transport។

សម្រេចថាអ្នកណាជាម្ចាស់ transport នោះ។ ឯកសារ builder ពិពណ៌នាអំពីការរួមបញ្ចូល Apache HTTP Client លំនាំដើម។ ClientHttpEngine ដែលផ្តល់ឲ្យផ្លាស់ប្តូរព្រំដែន៖ httpEngine ជំនួស SSL និងការកំណត់រចនាសម្ព័ន្ធជាក់លាក់នៃការតភ្ជាប់របស់ builder។ កំណត់ proxy និង TLS តាមរយៈចំណុចប្រទាក់ដែលគាំទ្ររបស់ engine នោះ។

ឧទាហរណ៍ចាស់ៗដែលផ្អែកលើ ClientExecutor កំណត់រចនាសម្ព័ន្ធ Apache client ដែលរុំជំនួសវិញ។ ស្របទៅនឹងជំនាន់នោះ ជំនួសឲ្យការបិទភ្ជាប់វាទៅក្នុង Jakarta builder។

នៅក្នុងសាខាទាំងពីរ រក្សាឈ្មោះ host របស់ API ជាអត្តសញ្ញាណ TLS ជាមួយការផ្ទៀងផ្ទាត់បើក។ ការផ្ទៀងផ្ទាត់ proxy ការចូល API និងទំនុកចិត្តលើវិញ្ញាបនបត្រ គឺជាតម្រូវការដោយឡែក។ ផ្លូវតែមួយមិនផ្តល់នូវគ្រោងការណ៍ផ្ទៀងផ្ទាត់ទាំងអស់ទេ។