خدمات الويب RESTful في جاكرتا

خدمات الويب RESTful من جاكرتا ( JAX-RS ؛ المعروفة سابقًا باسم Java API لخدمات الويب RESTful ) هي مواصفات واجهة برمجة تطبيقات جاكرتا EE ، توفر الدعم لإنشاء خدمات الويب وفقًا لنمط REST المعماري. [ ¹^]^تستخدم JAX-RS التعليقات التوضيحية ، التي تم تقديمها في Java SE 5 ، لتبسيط تطوير ونشر عملاء ونقاط نهاية خدمات الويب.

ابتداءً من الإصدار 1.1، أصبح JAX-RS جزءًا رسميًا من Java EE 6. ومن أبرز مزايا كونه جزءًا رسميًا من Java EE أنه لا يتطلب أي إعدادات لبدء استخدامه. أما في بيئات غير Java EE 6، فيلزم إضافة سطر صغير في ملف وصف النشر web.xml .

مواصفة

توفر JAX-RS بعض التعليقات التوضيحية للمساعدة في ربط فئة مورد (كائن POJO ) كمورد ويب. تستخدم هذه التعليقات حزمة Javajakarta.ws.rs (كانت تُسمى سابقًا javax.ws.rsولكن أُعيد تسميتها في 19 مايو 2019 ^{[ 2 ]} ). وهي تشمل:

@Pathيحدد المسار النسبي لفئة أو طريقة مورد.
@GETتحدد , @POST, @PUT, @PATCH(منذ JAX-RS 2.1), @DELETE, @HEADو (منذ JAX-RS 1.1) نوع طلب HTTP لمورد ما.@OPTIONS
@Producesيحدد أنواع وسائط الإنترنت للاستجابة (المستخدمة للتفاوض على المحتوى ).
@Consumesيحدد أنواع وسائط الإنترنت المقبولة للطلب.

بالإضافة إلى ذلك، يوفر هذا النظام تعليقات توضيحية إضافية لمعاملات الطريقة لاستخراج المعلومات من الطلب. @*Paramوتأخذ جميع التعليقات التوضيحية مفتاحًا من نوع ما يُستخدم للبحث عن القيمة المطلوبة.

@PathParamيربط معلمة الطريقة بجزء من المسار.
@QueryParamيربط معلمة الطريقة بقيمة معلمة استعلام HTTP .
@MatrixParamيربط معلمة الطريقة بقيمة معلمة مصفوفة HTTP .
@HeaderParamيربط معلمة الطريقة بقيمة رأس HTTP .
@CookieParamيربط معلمة الطريقة بقيمة ملف تعريف الارتباط .
@FormParamيربط معلمة الطريقة بقيمة النموذج .
@DefaultValueيحدد قيمة افتراضية للروابط المذكورة أعلاه عندما لا يتم العثور على المفتاح.
@Contextيعيد السياق الكامل للكائن (على سبيل المثال @Context HttpServletRequest request).

JAX-RS 2.0

في يناير 2011، شكّلت لجنة JCP فريق خبراء JSR 339 للعمل على JAX-RS 2.0. وتشمل الأهداف الرئيسية (من بين أمور أخرى) واجهة برمجة تطبيقات عميل مشتركة ودعم الوسائط المتعددة الفائقة وفقًا لمبدأ HATEOAS الخاص بـ REST . وفي مايو 2013، وصل المشروع إلى مرحلة الإصدار النهائي. ^{[ 3 ]}

في 22 أغسطس 2017، تم نشر الإصدار النهائي من مواصفات JAX-RS 2.1 ^{[ 4 ]} . تشمل الميزات الجديدة الرئيسية المدعومة الأحداث المرسلة من الخادم ، والعملاء التفاعليين ، وJSON-B. ^{[ 5 ]}