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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

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

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

איך זה עובד

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

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

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

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

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

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

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

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

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

מגבלות

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

ייתכן שיהיו הגבלות אחרות על כל שפה נתמכת, כפי שמתואר בחומר העזר בנושא המדיניות של השפה.

שפות נתמכות

JavaScript

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

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

Java

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

נושאים נוספים שעשויים לעניין אותך:

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

Python

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

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