الگوهای کتاب آشپزی پروکسی API

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

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

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

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

الگوی ترکیب سیاست

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

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

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

در اینجا خلاصه‌ای از این سه سیاست آمده است:

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

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