ادغام کد رویه‌ای

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

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

با کد رویه‌ای، می‌توانید:

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

روش کار

از خط‌مشی خاص زبان استفاده می‌کنید تا از جاری‌سازی پراکسی به کد دربرگیرنده خود تماس بگیرید. برای هریک از زبان‌های پشتیبانی‌شده، Apigee Edge خط‌مشی جداگانه‌ای دارد: خط‌مشی JavaScript، خط‌مشی Java Callout، و خط‌مشی Python Script.

در زیر، به‌طور کلی، یکی از روش‌های عملکرد این ویژگی توضیح داده شده است. برای جزئیات بیشتر، حتماً به مرجع‌های خط‌مشی مراجعه کنید.

  1. در فایلی جداگانه، کدی را که می‌خواهید استفاده کنید بنویسید.
  2. در کد خود، نتیجه پردازش کد را در متغیر جاری‌سازی Apigee Edge قرار دهید.

    مقدار متغیر را در جای دیگری در پراکسی API خود بازیابی خواهید کرد. برای اطلاعات بیشتر درباره متغیرهای جریان، مدیریت وضعیت پراکسی با متغیرهای جریان را ببینید.

  3. فایل (یا JAR) خود را به‌عنوان فایل منبع به پراکسی API اضافه کنید.

    برای اطلاعات بیشتر درباره فایل‌های منبع، فایل‌های منبع را ببینید.

  4. خط‌مشی مربوط به زبانی را که استفاده می‌کنید اضافه کنید.

    خط‌مشی را پیکربندی کنید تا از مکان موردنظر در جریان کارگزار API با کدتان تماس بگیرد.

  5. از خط‌مشی برای بازیابی مقدار کد از متغیر جاری‌سازی استفاده کنید.

محدودیت‌ها

مدل امنیتی Apigee Edge اجازه فراخوانی سیستم‌هایی مثل ورودی/خروجی شبکه، خواندن/نوشتن سیستم فایل، اطلاعات کاربر فعلی، فهرست فرایند، و استفاده از CPU/حافظه را نمی‌دهد. اگرچه برخی‌از این تماس‌ها ممکن است کار کنند، اما پشتیبانی نمی‌شوند و ممکن است در هر زمانی به‌طور فعال غیرفعال شوند. برای سازگاری رو به جلو، باید از انجام چنین تماس‌هایی در کد خود اجتناب کنید.

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

زبان‌های پشتیبانی‌شده

JavaScript

پشتیبانی از جاوا اسکریپت شامل مدل شیء کامل برای مدیریت متغیرها و مقادیر خاص برای پراکسی API است. برای اطلاعات بیشتر، مدل شیء جاوا اسکریپت را ببینید.

برای اطلاعات مرجع خط‌مشی و مثال‌ها، خط‌مشی جاوا اسکریپت و پراکسی‌های میانای برنامه‌سازی کاربردی برنامه‌نویسی با جاوا اسکریپت را ببینید. برای کد نمونه، Samples list را برای مواردی که شامل جاوا اسکریپت است جستجو کنید.

جاوا

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

ممکن است به موضوعات زیر نیز علاقه‌مند باشید:

برای کد نمونه، Samples list را برای مواردی که شامل Java است جستجو کنید.

Python

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

برای کد نمونه، فهرست «نمونه‌ها» را برای مواردی که شامل Python است جستجو کنید.