الگوهای کتاب آشپزی پراکسی میانای برنامه‌سازی کاربردی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

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

الگوی کارخواه HTTP جاوا اسکریپت

الگوی کارخواه HTTP جاوا اسکریپت یکی از چندین الگویی است که می‌توانید برای ایجاد ترکیب‌های سرور-کارخواه با Apigee Edge استفاده کنید. «مدل شیء جاوا اسکریپت» Apigee به شما امکان می‌دهد کد جاوا اسکریپت را مستقیماً در جریان پراکسی API قرار دهید. شیء مدل httpClient به شما امکان می‌دهد بااستفاده از جاوا اسکریپت با سرویس‌های زیرینه تماس بگیرید و نتایج را بازیابی کنید.

الگوی ترکیب خط‌مشی

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

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

خط‌مشی مثال کتاب آشپزی ترکیب از سه خط‌مشی استفاده می‌کند: AssignMessage، ServiceCallout، و ExtractVariables. این خط‌مشی‌ها پیام(های) درخواستی را که می‌خواهید به کارساز پشتیبان ارسال کنید، کارخواهی که پیام را به کارساز پشتیبان هدایت می‌کند، و تجزیه‌گر پیامی که پاسخ هر API را تجزیه می‌کند و متغیرهایی را برای داده‌های پاسخ اختصاص می‌دهد دربرمی‌گیرد. پس‌از انجام همه تماس‌ها، متغیرهای جمع‌آوری‌شده ترکیب می‌شوند و در یک شیء JSON واحد برگردانده می‌شوند.

در اینجا خلاصه کوتاهی از این سه خط‌مشی ارائه شده است:

  • AssignMessage: پیام درخواستی ایجاد می‌کند، سرصفحه‌های HTTP و پارامترهای پُرسمان را تکمیل می‌کند، فعل HTTP را تنظیم می‌کند.
  • ServiceCallout: به پیامی که توسط خط‌مشی AssignMessage ایجاد شده است ارجاع می‌دهد، نشانی وب هدف را برای تماس خارجی تعریف می‌کند، و نامی را برای شیء پاسخ که سرویس هدف برمی‌گرداند تعریف می‌کند.
  • ExtractVariables: معمولاً عبارت JSONPath یا XPath را تعریف می‌کند که پیام تولیدشده توسط خط‌مشی ServiceCallout قبلی را تجزیه می‌کند. سپس خط‌مشی متغیرهایی را تنظیم می‌کند که حاوی مقادیر تجزیه‌شده از پاسخ ServiceCallout هستند.

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