שילוב קוד פרוצדורלי

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X.
info

אפשר להוסיף קוד בשפות פרוצדורליות כמו JavaScript,‏ Java ו-Python, ואז להפעיל את הקוד הזה מחלקים אחרים של שרת proxy ל-API. התמיכה בקוד פרוצדורלי נועדה להקל עליכם להטמיע טיפול מורכב במשתני תהליך, בכשלים ובגופי בקשות ותשובות.

בעזרת קוד פרוצדורלי, אפשר:

  • ליצור ערכים מורכבים של גוף או לבצע בהם פעולות, כמו ערכים של בקשות ותשובות.
  • לכתוב מחדש כתובות URL, למשל כדי להסוות כתובת URL של נקודת קצה יעד.
  • להוסיף לוגיקה אחרת שלא זמינה במדיניות הכלולה.

איך זה עובד

משתמשים במדיניות ספציפית לשפה כדי לבצע קריאות מזרימה של שרת proxy לקוד שכלול. לכל אחת מהשפות הנתמכות, Apigee Edge כולל מדיניות נפרדת: מדיניות JavaScript, מדיניות קריאה ל-Java ומדיניות סקריפט Python.

בהמשך מתואר, ברמה גבוהה, אופן אחד שבו זה עובד. מומלץ לעיין במקורות המידע של המדיניות לקבלת פרטים נוספים.

  1. בקובץ נפרד, כותבים את הקוד שבו רוצים להשתמש.
  2. בקוד, מוסיפים את התוצאה של עיבוד הקוד למשתנה תהליך של Apigee Edge.

    תצטרכו לאחזר את ערך המשתנה במקום אחר בשרת ה-API. מידע נוסף על משתני תהליך זמין במאמר ניהול מצב שרת proxy באמצעות משתני תהליך.

  3. מוסיפים את הקובץ (או קובץ ה-JAR) כקובץ משאב לשרת ה-proxy של ה-API.

    מידע נוסף על קובצי משאבים זמין במאמר קובצי משאבים.

  4. מוסיפים את המדיניות התואמת לשפה שבה אתם משתמשים.

    מגדירים את המדיניות כך שתתבצע קריאה לקוד מהמקום הרצוי בתהליך של שרת ה-proxy של ה-API.

  5. משתמשים במדיניות כדי לאחזר את ערך הקוד ממשתנה התהליך.

מגבלות

מודל האבטחה של Apigee Edge לא מאפשר קריאות מערכת כמו קלט/פלט ברשת, קריאה/כתיבה במערכת הקבצים, פרטי המשתמש הנוכחי, רשימת התהליכים וניצול המעבד/הזיכרון. יכול להיות שחלק מהשיחות האלה יפעלו, אבל הן לא נתמכות ויכול להיות שהן יושבתו באופן פעיל בכל שלב. כדי לשמור על תאימות עתידית, כדאי להימנע מביצועים של קריאות כאלה בקוד.

יכולות להיות הגבלות נוספות לכל שפה נתמכת, כפי שמתואר במסמך העזרה של המדיניות הרלוונטית לשפה.

שפות נתמכות

JavaScript

התמיכה ב-JavaScript כוללת מודל אובייקט מלא לטיפול במשתנים ובערכים ספציפיים לשרת proxy של API. מידע נוסף זמין במאמר מודל אובייקטים של JavaScript.

למידע נוסף ולדוגמאות בנושא מדיניות, אפשר לעיין במאמרים מדיניות JavaScript ותכנות שרתים proxy של API באמצעות JavaScript. כדי למצוא קוד לדוגמה, מחפשים ברשימת הדוגמאות דוגמאות שכוללות JavaScript.

Java

משתמשים במדיניות של Java Callout כדי לבצע קריאות לקוד Java מהתהליך של שרת ה-proxy. בנושא העזרה בנושא המדיניות מפורטות דוגמאות.

יכול להיות שגם הנושאים הבאים יעניינו אותך:

כדי למצוא דוגמאות קוד, מחפשים ברשימת הדוגמאות דוגמאות שכוללות Java.

Python

משתמשים במדיניות של סקריפט Python כדי לבצע קריאה לקוד Python.

כדי למצוא קוד לדוגמה, מחפשים ברשימת הדוגמאות דוגמאות שכוללות Python.