بخش های اصلی

وب سرویس RESTful

وب سرویس های RESTful – آدرس دهی (Addressing)

آدرس دهی، به قرار دادن یک منبع (resource) یا تعدادی منبع در سرور اشاره داره. آدرس دهی شبیه به قرار دادن آدرس پستی شخصِه.

هر منبعی در معماری REST، توسط URI، شناگر منبع متحدالشکل، شناسایی میشه. فرمتِ URI، بصورت زیرِه:

<protocol>://<service-name>/<ResourceType>/<ResourceID>

هدفِ URI، قرار دادن منبع(ها) در سرورِ هاستِ (server hosting) وب سرویسِه. خصیصه ی (attribute) مهم دیگه ی درخواست، VERB است که عملیاتی که قراره روی منبع انجام بشه را شناسایی می کنه. برای مثال، در آموزش وب سرویس های RESTful – اولین برنامه، URI معادل با http://localhost:8080/UserManagement/rest/UserService/users و VERB معادل با GET است.

ساختن یک URI استاندارد

در ادامه نکات مهمی که هنگام طراحیِ URI باید به آن ها توجه کنین، آمده:

  • استفاده از اسم جمع – برای تعریف منابع از اسم جمع استفاده کنین. برای مثال، ما برای شناسایی کابران بعنوان یک منبع (resource) ، از users استفاده کردیم.
  • از کاراکتر فاصله (space) استفاده نکنین – برای تعریف نام های طولانی برای منابع، از زیرخط (_) یا خط (-) استفاده کنین، برای مثال از authorized_users، به جای authorized%20users استفاده کنین.
  • از حروف کوچک استفاده کنین – اگرچه URI، حساس به حروفِه، ولی بهتره url را فقط با حروف کوچک بنویسیم.
  • حفظ سازگاری – ازآن جایی که وب سرویس، یک سرویسِ عمومی (public) است، یک URI که بصورت public (عمومی) ایجاد شده، باید همیشه دسترس پذیر باشه. در مواردی که، URI بروز رسانی میشه، URI قدیمی را با استفاده از کد وضعیتیِ HTTP 300، به URI جدید هدایت مجدد کنین.
  • استفاده از عملگرهای HTTP - همیشه از عملگرهای HTTP مانند GET, POST, DELETE و ... استفاده کنید. آوردن این موارد در آدرس URL کار درستی نیست.

مثال

در ادامه مثالی از یک URI بد، برای واکشی کاربر مشاهده می کنین.

http://localhost:8080/UserManagement/rest/UserService/getUser/1

در ادامه مثالی از یک URI خوب برای واکشی کاربر مشاهده می کنین.

http://localhost:8080/UserManagement/rest/UserService/users/1
در صورتی که سوال و یا نظری دارید، از بخش نظرات با ما در میان بگذارید.

خبـرنــامه

Newsletters

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

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

مبحث آموزشی

وب سرویس RESTful

RESTful Web Services

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

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

تبلیغات

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

https://telegram.me/softskill_ir

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

خبـرنــامه

Newsletters

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