بخش های اصلی

وب سرویس RESTful

وب سرویس های RESTful – جاوا (JAX-RS)

JAX-RS، کوتاه شده ی JAVA API برای وب سرویس های RESTful است. JAX-RS یک API زبان برنامه نویسیِ مبتنی بر جاوا است و اعتبارنامه ایِه برای فراهم کردن پشتیبانی جهت ایجاد وب سرویس های RESTful. ورژنِ 2.0 آن، در 24اُم میِ سال 2013 منتشر شد. JAX-RS، برای ساده کردن طراحی و ایجاد وب سرویس های مبتنی بر جاوا، از annotationهای موجود در JAVA SE 5  خیلی استفاده می کنه. همچنین از ایجاد کلاینت های وب سرویس های RESTful هم پشتیبانی می کنه.

اعتبارنامه

در ادامه پرکاربردترین annotationهای استفاده شده برای map کردن یک منبع (resource)، بعنوان منبعِ وب سرویس، آورده شده ان.

شماره

Annotation و توضیحات

1

@Path

مسیر نسبی کلاینت/متدِ منبع (resource)

2

@GET

درخواستِ HTTP GET، برای واکشی منبع (resource) به کار میره.

3

@PUT

درخواستِ HTTP PUT، برای ایجاد منبع (resource) به کار میره.

4

@POST

درخواستِ HTTP POST، برای ایجاد/بروز رسانیِ منبع (respurce) به کار میره.

5

@DELETE

درخواستِ HTTP DELETE ، برای حذف منبع (resource) به کار میره.

6

@HEAD

درخواستِ HTTP HEAD ، برای نشان دادن قابل دسترس بودن متد به کار میره.

7

@Produces

پاسخِ HTTP تولید شده توسط وب سرویس را نشان میده، برای مثال APPLICATION/XML, TEXT/HTML, APPLICATION/JSON  و ... .

8

@Consumes

نوع درخواستِ HTTP را مشخص میکنه، برای مثال application/x-www-form-urlencoded برای پذیرش داده ی داخل بدنه ی HTTP در طی درخواستِ POST.

9

@PathParam

پارامتر پاس داده شده به متد را به یک مقدار در مسیر (path) متصل می کنه.

10

@QueryParam

پارامتر پاس داده شده به متد را به یک پارامترِ کوئری (query) در مسیر (path) متصل می کنه.

11

@MatrixParam

پارامتر پاس داده شده به متد را به یک پارامترِ HTTP matrix در مسیر (path) متصل می کنه.

12

@HeaderParam

پارامتر پاس داده شده به متد را به یک سرآیندِ HTTP متصل می کنه.

13

@CookieParam

پارامتر پاس داده شده به متد را به یک کوکی (Cookie) متصل می کنه.

14

@FormParam

پارامتر پاس داده شده به متد را به یک مقدارِ فرم (form value) متصل می کنه.

15

@DefaultValue

به پارامتر پاس داده شده به متد، یک مقدار پیش فرض اختصاص میده.

16

@Context

محتوای منبع، برای مثال درخواستِ HTTP، بعنوان محتوا.

در صورتی که سوال و یا نظری دارید، از بخش نظرات با ما در میان بگذارید.

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد

شما چه نظر و یا سوالی درباره این نوشته دارید؟

مبحث آموزشی

وب سرویس RESTful

RESTful Web Services

پرســیدن سؤال جدید

سؤال های تخصصی خود را از ما بپرسید

دنبال کردن تلگرام کانال سافت اسکیل

https://telegram.me/softskill_ir

عملیات کاربران

خبـرنــامه

Newsletters

در خبــرنـامه سافت اسکیل عضو شویــد تا جدیدترین هـای سایت را بلافاصله در ایمیل خـود دریافت کنیـد