کتاب RESTful Web API Patterns and Practices Cookbook

کتاب RESTful Web API Patterns and Practices Cookbook (راهنمای الگوها و تمرینات وب API RESTful: اتصال و هماهنگ‌سازی میکروسرویس‌ها و داده‌های توزیع شده)

در ادامه مقدمه‌ای از کتاب RESTful Web API Patterns and Practices Cookbook را از زبان نویسنده شرح خواهیم داد.

مقدمه‌ای بر کتاب RESTful Web API Patterns and Practices Cookbook:

به دنیای کتاب راهنمای الگوها و تمرینات وب API RESTful خوش آمدید.

این کاملاً یک نام است – نامی که ارزش توضیح و کاوش دارد. و این همان کاری است که ما در این مقدمه انجام خواهیم داد. اکنون به شما می‌گویم که کمی قوانین را زیر پا می‌گذارم و مقدار قابل توجهی از متن مرتبط را در قسمت اول این کتاب قرار می‌دهم (موضوع جلویی همه این صفحات با اعداد رومی به عنوان شماره صفحه است). جزئیات را برای بخش بعدی (قسمت اول) ذخیره خواهم کرد. بیایید ابتدا به برخی از تدارکات رسیدگی کنیم.

درباره کتاب RESTful Web API Patterns and Practices Cookbook

هدف این کتاب این است که طراحان، معماران، توسعه‌دهندگان و نگهبانان نرم‌افزار را قادر سازد تا رابط‌های سرویس (API) بسازند که از نقاط قوت وب استفاده کنند، در حالی که هزینه‌ها و خطرات ایجاد سرویس‌های سطح بالا قابل اعتماد را که وابستگی‌ها را حفظ می‌کنند، کاهش می‌دهد. در سایر API ها و سرویس‌هایی که فقط از طریق شبکه قابل دسترسی هستند.

برای انجام این کار، من مجموعه‌ای از بیش از 70 دستور العمل و الگو را جمع‌آوری کرده‌ام که طی چندین دهه برای کمک به مشتریان در طراحی، ساخت و استقرار خدمات تجاری موفق در وب باز، یاد گرفته‌ام و استفاده کرده‌ام. من گمان می‌کنم که حداقل با برخی از دستور العمل‌هایی که در اینجا پیدا خواهید کرد – احتمالاً با نام‌های دیگر یا به اشکال مختلف آشنا هستید. همچنین امیدوارم که رویکردهای جدیدی برای مشکلات مشابه پیدا کنید.

بیشتر بخوانید: کتاب Mastering API Architecture

توجه داشته باشید

در طول سال‌ها، متوجه شده‌ام که چالش‌های طراحی نرم‌افزار به ندرت تغییر می‌کند. راه حل‌های آن مشکلات بر اساس پیشرفت‌های تکنولوژی و روند مد اغلب تغییر می‌کند. ما روی چالش‌های این کتاب تمرکز خواهیم کرد و فناوری به‌روز و انتخاب‌های مد را به شما، خواننده، واگذار می‌کنم.

از آنجایی که این یک کتاب راهنمای است، کد قابل اجرا زیادی وجود نخواهد داشت. با این حال، نمودارها، تکه‌های کد و نمونه‌های پیام شبکه‌ای همراه با توضیحاتی که مشکلات را شناسایی می‌کنند، زیاد خواهد بود. چالش‌ها و بحث‌ها همیشه مبتنی بر فناوری و پلتفرم خواهند بود. این دستور العمل‌ها به گونه‌ای ارائه شده‌اند که به شما امکان می‌دهد آن‌ها را به کد و اجزایی ترجمه کنید که در محیط هدف شما کار می‌کنند.

چه کسی باید کتاب RESTful Web API Patterns and Practices Cookbook را بخواند؟

مخاطبان اصلی این کتاب افرادی هستند که وظیفه برنامه ریزی، معماری و پیاده سازی رابط‌های خدماتی را بر روی HTTP دارند. برای برخی، این به معنای تمرکز بر ایجاد تولیدکنندگان و مصرف کنندگان خدمات در سطح سازمانی است.

برای دیگران، این به معنای ساخت سرویس‌هایی است که می‌توانند در وب باز زندگی کنند و به روشی مقیاس‌پذیر و قابل اعتماد برای مصرف‌کنندگان در سراسر جهان اجرا شوند. برای همه، این به معنای ایجاد رابط‌های برنامه‌نویسی کاربردی قابل استفاده است که به برنامه نویسان اجازه می‌دهد تا چالش‌های پیش روی خود را حل کنند.

چه در حال میزبانی راه حل‌های خود به صورت محلی بر روی سخت افزار خود یا ایجاد نرم افزاری باشید که در فضای ابری اجرا شود، دستور العمل‌های موجود در اینجا به شما کمک می‌کنند تا چالش‌ها را درک کنید و مجموعه‌ای از تکنیک‌ها را برای پیش‌بینی مشکلات و ایجاد بازیابی برای رسیدگی به موارد غیر قابل پیش‌بینی ارائه می‌دهد. رخ می‌دهد.

آنچه پوشش داده شده است:

از آنجایی که قرار است این کتاب برای مخاطبان گسترده مفید باشد، آن را به فصل‌هایی تقسیم کرده ام که بر موضوعات مرتبط متمرکز شده است. برای شروع، فصل‌های 1 و 2 قسمت اول کتاب RESTful Web API Patterns and Practices Cookbook را تشکیل می‌دهند، جایی که پیش‌زمینه و پایه‌های خدمات مشترک در وب را بررسی می‌کنیم.

برای تشدید قیاس کتاب راهنمای، قسمت اول را به عنوان داستان پشت «راهنمای فرارسانه‌ای» در نظر بگیرید که در قسمت دوم بررسی خواهیم کرد. مانند هر کتاب راهنمای خوب، هر یک از فصل‌های اصلی در قسمت دوم شامل مجموعه‌ای از دستور العمل‌های مستقل است که می‌توانید هنگام طراحی، ساختن و استقرار «ظروف» API وب خود، برای مقابله با چالش‌های خاصی از آن‌ها استفاده کنید.

منابع آنلاین

کتاب RESTful Web API Patterns and Practices Cookbook دارای تعدادی منابع آنلاین مرتبط است، از جمله مخزن GitHub و صفحات وب مرتبط، چند نمونه، و آخرین به روز رسانی‌های کاتالوگ دستور پخت. می‌توانید از طریق http://WebAPICookbook.com به همه این منابع دسترسی پیدا کنید.

در اینجا فهرستی سریع از فصول و آنچه که آنها را پوشش می‌دهند آورده شده است.

بخش اول: درک RESTful Hypermedia

فصل‌های آغازین (فصل 1 و 2) پایه و اساس همه دستور العمل‌های کتاب را توصیف می‌کنند. آنها ترکیبی از تاریخ، فلسفه و تفکر عملگرا هستند. اینها ایده‌ها و اصولی هستند که منعکس‌کننده درس‌هایی هستند که در طول سال‌ها طراحی، ساخت و پشتیبانی از برنامه‌های نرم‌افزاری شبکه‌ای که در وب اجرا می‌شوند، آموخته‌ام.

فصل 1، معرفی API های وب RESTful

این یک نمای کلی از منطق پشت دستور العمل‌های انتخاب شده در این کتاب است. این شامل بخشی است که به این سؤال پاسخ می‌دهد که «RESTful web APIs (RWA) چیست؟»، دلایلی که هایپرمدیا نقش مهمی در ایجاد RWA بازی می‌کند، و برخی از اصول مشترک سطح پایه که راهنمای انتخاب و توضیح دستور العمل‌ها در این است. کتاب. این فصل “جدول” را برای تمام مطالبی که در ادامه می‌آید تنظیم می‌کند.

فصل دوم، تفکر و طراحی در هایپر مدیا

این فصل پیش‌زمینه سیستم‌های توزیع‌شده مبتنی بر رسانه‌ای را بررسی می‌کند که پایه و اساس برنامه‌های کاربردی وب را تشکیل می‌دهند. هر مجموعه دستور العمل پوشش داده شده در بخش دوم (طراحی، مشتریان، خدمات، داده‌ها، و گردش کار) با ترکیبی از تاریخ، فلسفه، و تفکر عملی بررسی می‌شود. خواندن این فصل به شما کمک می‌کند تا برخی از ایده‌های کلیدی طراحی و مبانی فنی را برای همه الگوها و شیوه‌هایی که در ادامه کتاب بیان شده‌اند، درک کنید.

بخش دوم: کاتالوگ دستور العمل هایپر مدیا

بخش دوم کتاب RESTful Web API Patterns and Practices Cookbook شامل تمام دستور العمل‌هایی است که من برای این جلد انتخاب کرده‌ام. متوجه خواهید شد که بیشتر فصل‌ها با کلمه «هایپر رسانه» شروع می‌شوند. این باید به شما سرنخی از رویکرد کلی که در سراسر کتاب در پیش خواهیم گرفت، بدهد.

فصل 3، طراحی هایپر مدیا

خدمات قابل اعتماد و انعطاف‌پذیر با طراحی‌های متفکرانه شروع می‌شود. این فصل مجموعه‌ای از چالش‌های رایج را پوشش می‌دهد که باید قبل از اینکه حتی به سطح کدنویسی و انتشار خدمات خود برسید، با آنها مقابله کنید. این فصل به ویژه برای معماران و همچنین طراحان خدمات مفید خواهد بود و به تنظیم لحن برای دستور العمل‌های مختلف که در ادامه می‌آید کمک می‌کند.

فصل 4، مشتریان هایپر مدیا

این فصل بر چالش‌هایی که هنگام ایجاد برنامه‌های کاربردی مصرف‌کننده سرویس/API با آن‌ها مواجه خواهید شد، تمرکز دارد. من قبل از صحبت در مورد دستور العمل‌های خود رابط‌های سرویس، به بحث در مورد برنامه‌های مشتری اشاره کردم. یک رویکرد مشترک برای ایجاد مشتریان خدمات انعطاف‌پذیر و انعطاف‌پذیر برای هر برنامه‌ای که برای ایجاد یک پلتفرم پایدار و قابل اعتماد برای خدمات باز برنامه‌ریزی می‌کند که می‌تواند در وب و همچنین درون یک سازمان زندگی کند، ضروری است.

فصل 5، خدمات هایپر مدیا

با پایه‌ای محکم از اصول طراحی و برنامه‌های کاربردی مشتری که به درستی معماری شده‌اند، می‌توان ساخت و انتشار تولیدکنندگان خدمات پایداری را آسان تر کرد که می‌توانند به طور ایمن در طول زمان بدون شکستن مصرف کنندگان API موجود به روز شوند.

این مجموعه دستور العمل‌ها نه تنها بر اصول طراحی رابط سرویس جامد، بلکه بر اهمیت پشتیبانی از بازیابی خطای زمان اجرا و الگوهای قابلیت اطمینان نیز تمرکز دارد تا مطمئن شود راه‌حل‌های شما حتی زمانی که بخش‌هایی از سیستم شما با شکست مواجه می‌شوند، فعال و فعال می‌مانند.

فصل 6، داده‌های توزیع شده

این فصل بر چالش‌های پشتیبانی از داده‌های پایدار در یک محیط آنلاین و توزیع شده تمرکز دارد. بیشتر دستور العمل‌ها در اینجا با هدف بهبود پاسخگویی، مقیاس‌پذیری و قابلیت اطمینان سرویس‌های داده شما با اطمینان از یکپارچگی داده‌ها – حتی زمانی که مدل‌های داده داخلی و پیاده‌سازی در زمان اجرا تغییر می‌کنند.

فصل 7، گردش کار Hypermedia

آخرین مجموعه دستور العمل‌ها بر ایجاد و مدیریت گردش کار خدمات در وب متمرکز است. چالش کلیدی برای گردش کار خدمات باز، ایجاد مجموعه ای امن و قابل اعتماد از راه حل‌ها برای به کارگیری چندین سرویس نامرتبط در یک گردش کار منفرد و انعطاف پذیر است تا مشکلی را حل کند که هیچ یک از خدمات فردی درباره آن چیزی نمی‌دانند. من این فصل را برای آخرین بار ذخیره کردم زیرا بر بسیاری از دستور العمل‌هایی که قبلاً در کتاب توضیح داده شده است متکی است.

فصل هشتم، سخنان پایانی

فصل آخر یک جمع‌بندی کوتاه از مطالب و همچنین یک “تماس به جلو” است تا به شما کمک کند تا در مورد “مراحل بعدی” خود تصمیم بگیرید، همانطور که قصد دارید این دستور العمل‌ها را در محیط خود اعمال کنید.

ضمیمه‌ها

یک سری ضمائم برای کتاب RESTful Web API Patterns and Practices Cookbook وجود دارد که می‌توانید از آنها به عنوان مواد کمکی اضافی استفاده کنید. گاهی اوقات به این موارد در متن اشاره می‌شود، اما می‌توانند به عنوان ارجاعات مستقل نیز در نظر گرفته شوند.

ضمیمه الف، اصول راهنما

این ضمیمه یک نسخه کوتاه “پوستر انگیزشی” از اصل راهنما در پشت دستور العمل‌های انتخاب شده، و همچنین برخی از اصول ثانویه است که برای شکل دادن به توضیحات و در نهایت، اجرای این الگوها به طور کلی استفاده می‌شود.

پیوست ب، خواندن تکمیلی

در سرتاسر کتاب RESTful Web API Patterns and Practices Cookbook، مطالعه بیشتر، نقل قول از کتاب‌ها و مقالات، و فراخوانی ارائه‌ها و ویدئوهایی را که منبع بسیاری از توصیه‌های کتاب هستند، توصیه می‌کنم. این ضمیمه حاوی فهرستی مستقل از مطالب خواندن و مشاهده است که می‌توانید هنگام کار با دستور العمل‌ها از آنها به عنوان مرجع و راهنما استفاده کنید.

پیوست ج، استانداردهای مرتبط

از آنجایی که هدف این کتاب ایجاد خدماتی است که بتوانند با موفقیت «در وب» زندگی کنند، دستور العمل‌ها به تعدادی از استانداردهای مهم وب باز بستگی دارد. این ضمیمه شامل فهرستی از اسناد استاندارد مربوطه می‌باشد.

پیوست D، با استفاده از HyperCLI

در چندین جای کتاب RESTful Web API Patterns and Practices Cookbook، من به یک ابزار رابط خط فرمان به نام HyperCLI اشاره می‌کنم. شما می‌توانید از این ابزار برای تعامل با سرویس‌های فرارسانه آگاه استفاده کنید. این ضمیمه مقدمه کوتاهی بر ابزار و برخی از اشاره‌ها به سایر منابع آنلاین در مورد نحوه استفاده از HyperCLI و HyperLang ارائه می‌کند.

آنچه تحت پوشش نیست:

این متن به عنوان کتابی از دستور العمل‌ها، برای آموزش نحوه اجرای الگوها و ایده‌های فهرست شده در اینجا به خواننده مناسب نیست. اگر با هر یک از ارکانی که این کتاب بر آن‌ها ساخته شده است تازه کار هستید، باید به منابع دیگری برای کمک نگاه کنید.

کتاب‌های زیر برخی از آنها هستند که من از آنها در آموزش و مشاوره در مورد موضوعاتی استفاده کرده‌ام که در این کتاب به طور مفصل به آنها پرداخته نشده است:

پروتکل HTTP

بیشتر دستور العمل‌های کتاب RESTful Web API Patterns and Practices Cookbook برای پیاده‌سازی پروتکل HTTP توسعه داده شده است. برای اطلاعات بیشتر در مورد قدرت و چالش‌های HTTP، من کتاب راهنمای توسعه‌دهنده HTTP توسط کریس شیفلت (سامز) را توصیه می‌کنم. متن شیفلت کمک بزرگی به من در یادگیری جزئیات داخلی پروتکل HTTP بوده است. این کتاب که در سال 2003 منتشر شد، هنوز کتاب ارزشمندی است که من آن را به شدت توصیه می‌کنم.

طراحی API

برای جزئیات در مورد طراحی API برای سرویس‌های توزیع شده، به خوانندگان پیشنهاد می‌کنم API های Building Hypermedia من را با HTML5 و Node (O’Reilly) بررسی کنند. برای کسانی که به دنبال کتابی متمرکز بر برنامه‌نویسی API هستند، کتاب جدیدتر من، طراحی و ساخت APIهای وب عالی (قفسه کتاب عملی)، راهنمای عملی مفصلی برای چرخه عمر کامل API ارائه می‌دهد.

مشتریان API

کار کدنویسی سرویس گیرندگان API/سرویس برای خود یک مهارت است. برای نگاهی گسترده به فرآیند ایجاد برنامه‌های کاربردی کلاینت مبتنی بر هایپر رسانه انعطاف پذیر، خوانندگان را به مشتریان وب RESTful خود (O’Reilly) ارجاع می‌دهم.

API های وب

برای جزئیات بیشتر در مورد ایجاد خود API های وب، خوانندگان را تشویق می‌کنم که کتاب RESTful Web APIs (O’Reilly) را که من با Leonard Richardson تالیف کرده ام و کتاب طراحی و ساخت API های وب عالی (O’Reilly) را بررسی کنند. از دیگر کتاب‌هایی که در دسترسم هستم می‌توان به اصول طراحی وب API نوشته جیمز هیگین‌بوهام (ادیسون-وسلی) و طراحی APIهای وب (منینگ) اثر آرنو لورت اشاره کرد.

داده‌ها

برای اطلاعات بیشتر در مورد مدیریت داده‌ها در مقیاس، من مدیریت داده در مقیاس توسط Piethein Strengholt (O’Reilly) و مدیریت داده: راهنمای قطعی توسط Evren Eryurek و همکاران را توصیه می‌کنم. (اوریلی).

جریان کار

کتاب‌های اتوماسیون فرآیند عملی اثر Bernd Ruecker (O’Reilly) و ارکستراسیون خدمات به عنوان سازمان توسط Malinda Kapuruge و همکاران. (O’Reilly) مکان خوبی برای شروع کاوش در دنیای مهندسی گردش کار است.

بسیاری از منابع دیگر برای مشاوره حکیم در مورد طراحی و ساخت خدمات توزیع شده وجود دارد، و فهرستی از مطالب پیشنهادی را در پیوست B خواهید دید.

سرفصل‌های کتاب RESTful Web API Patterns and Practices Cookbook:

• Foreword
• Preface
• I. Understanding RESTful Hypermedia
• 1. Introducing RESTful Web APIs
• 2. Thinking and Designing in Hypermedia
• II. Hypermedia Recipe Catalog
• 3. Hypermedia Design
• 4. Hypermedia Clients
• 5. Hypermedia Services
• 6. Distributed Data
• 7. Hypermedia Workflow
• 8. Closing Remarks
• A. Guiding Principles of RESTful Web APIs
• B. Additional Reading
• C. Related Standards
• D. Using the HyperCLI
• Index

فایل کتاب RESTful Web API Patterns and Practices Cookbook را می‌توانید پس از پرداخت، دریافت کنید.