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 පිවිසුම සහ සහතික විශ්වාසය වෙන වෙනම අවශ්‍යතා වේ; මාර්ගය පමණක් සියලු සත්‍යාපන ක්‍රම සපයන්නේ නැත.