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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X.
מידע

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

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

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

איך זה עובד

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

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

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

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

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

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

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

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

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

מגבלות

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

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

שפות נתמכות

JavaScript

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

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

Java

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

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

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

Python

משתמשים במדיניות Python Script policy כדי לקרוא לקוד Python.

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