شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
شما می‌توانید کد را به زبان‌های رویه‌ای مانند جاوا اسکریپت، جاوا و پایتون اضافه کنید، سپس آن کد را از سایر بخش‌های یک پروکسی API فراخوانی کنید. پشتیبانی از کد رویه‌ای به گونه‌ای طراحی شده است که پیاده‌سازی مدیریت پیچیده متغیرهای جریان، خطاها و بدنه‌های درخواست و پاسخ را برای شما آسان‌تر کند.
با کد رویه ای، شما می توانید:
- مقادیر پیچیده بدنه، مانند مقادیر درخواست و پاسخ را ایجاد یا دستکاری کنید.
- بازنویسی URLها، مثلاً برای پوشاندن URL نقطه پایانی هدف.
- منطق دیگری را که با سیاست‌های گنجانده شده در دسترس نیست، اضافه کنید.
چگونه کار می‌کند؟
شما برای برقراری تماس از یک جریان پروکسی به کد گنجانده شده خود، از یک سیاست خاص برای آن زبان استفاده می‌کنید. برای هر یک از زبان‌های پشتیبانی شده، Apigee Edge یک سیاست جداگانه در نظر گرفته است: سیاست جاوا اسکریپت ، سیاست فراخوانی جاوا و سیاست اسکریپت پایتون .
در ادامه، در سطح بالا، یکی از روش‌های این کار شرح داده شده است. برای جزئیات بیشتر، حتماً به منابع مربوط به خط‌مشی مراجعه کنید.
- در یک فایل جداگانه، کدی را که قرار است استفاده کنید بنویسید.
- در کد خود، نتیجه پردازش کد را در یک متغیر جریان Apigee Edge قرار دهید.
مقدار متغیر را در جای دیگری از پروکسی API خود بازیابی خواهید کرد. برای اطلاعات بیشتر در مورد متغیرهای جریان، به مدیریت وضعیت پروکسی با متغیرهای جریان مراجعه کنید.
- فایل (یا JAR) خود را به عنوان یک فایل منبع به پروکسی API خود اضافه کنید.
برای اطلاعات بیشتر در مورد فایل‌های منبع، به «فایل‌های منبع» مراجعه کنید.
- سیاست مربوط به زبانی که استفاده می‌کنید را اضافه کنید.
سیاست را طوری پیکربندی کنید که از محل مورد نظر در جریان پروکسی API شما، کد شما فراخوانی شود.
- از یک سیاست برای بازیابی مقدار کد از متغیر جریان استفاده کنید.
محدودیت‌ها
مدل امنیتی Apigee Edge اجازه فراخوانی‌های سیستمی مانند ورودی/خروجی شبکه، خواندن/نوشتن فایل سیستم، اطلاعات کاربر فعلی، لیست فرآیندها و میزان استفاده از CPU/حافظه را نمی‌دهد. اگرچه برخی از این فراخوانی‌ها ممکن است کاربردی باشند، اما پشتیبانی نمی‌شوند و ممکن است در هر زمانی به طور فعال غیرفعال شوند. برای سازگاری رو به جلو، باید از انجام چنین فراخوانی‌هایی در کد خود خودداری کنید.
محدودیت‌های دیگری نیز ممکن است برای هر زبان پشتیبانی‌شده وجود داشته باشد، همانطور که در مرجع سیاست مربوط به آن زبان توضیح داده شده است.
زبان‌های پشتیبانی‌شده
جاوا اسکریپت
پشتیبانی از جاوا اسکریپت شامل یک مدل شیء کامل برای مدیریت متغیرها و مقادیر خاص یک پروکسی API است. برای اطلاعات بیشتر، به مدل شیء جاوا اسکریپت مراجعه کنید.
برای اطلاعات مرجع سیاست‌ها و مثال‌ها، به سیاست جاوا اسکریپت و پروکسی‌های API برنامه‌نویسی با جاوا اسکریپت مراجعه کنید. برای کد نمونه، لیست نمونه‌ها را برای مواردی که جاوا اسکریپت در آنها گنجانده شده است، جستجو کنید.
جاوا
از سیاست فراخوانی جاوا برای فراخوانی کد جاوا از جریان پروکسی خود استفاده کنید. موضوع مرجع سیاست شامل مثال‌هایی است.
شاید به موضوعات زیر نیز علاقه‌مند باشید:
- نحوه ایجاد یک فراخوان جاوا
- نحوه مدیریت خطاهای فراخوانی جاوا
- نحوه استفاده از ویژگی‌ها در یک فراخوانی جاوا
برای کد نمونه، فهرست نمونه‌ها را برای کدهایی که جاوا را شامل می‌شوند، جستجو کنید.
پایتون
برای فراخوانی کد پایتون از سیاست اسکریپت پایتون استفاده کنید.
برای کد نمونه، فهرست نمونه‌ها را برای مواردی که پایتون در آنها گنجانده شده است، جستجو کنید.