הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
אפשר להוסיף קוד בשפות פרוצדורליות כמו JavaScript, Java ו-Python, ואז לקרוא לקוד הזה מחלקים אחרים של proxy ל-API. התמיכה בקוד פרוצדורלי נועדה להקל עליכם להטמיע טיפול מורכב במשתני זרימה, בתקלות ובגופי הבקשות והתגובות.
בעזרת קוד פרוצדורלי, אפשר:
- ליצור או לשנות ערכים מורכבים של גוף הבקשה, כמו ערכי בקשה ותגובה.
- לשכתב כתובות URL, למשל כדי להסתיר כתובת URL של נקודת קצה של יעד.
- להוסיף לוגיקה אחרת שלא זמינה במדיניות הכלולה.
איך זה עובד
אתם משתמשים במדיניות שספציפית לשפה כדי לבצע שיחות מזרימת פרוקסי לקוד שכלול. לכל אחת מהשפות הנתמכות, Apigee כולל מדיניות נפרדת: JavaScript policy, JavaCallout policy ו-PythonScript policy.
ההסבר הבא מתאר באופן כללי איך זה עובד. פרטים נוספים מופיעים בהפניות למדיניות.
- כותבים את הקוד שבו רוצים להשתמש בקובץ נפרד.
- בקוד, מכניסים את התוצאה של עיבוד הקוד למשתנה של זרימת נתונים ב-Apigee.
אחרי זה תוכלו לאחזר את ערך המשתנה במקום אחר ב-proxy ל-API. מידע נוסף על משתני זרימה זמין במאמר ניהול מצב ה-proxy באמצעות משתני זרימה.
- מוסיפים את הקובץ (או קובץ ה-JAR) כקובץ משאב ל-proxy ל-API.
מידע נוסף על קובצי משאבים זמין במאמר קובצי משאבים.
- מוסיפים את המדיניות שמתאימה לשפה שבה משתמשים.
מגדירים את המדיניות כך שתתבצע קריאה לקוד מהמקום הרצוי בתהליך של ה-API proxy.
- משתמשים במדיניות כדי לאחזר את ערך הקוד ממשתנה של התהליך.
מגבלות
מודל האבטחה של Apigee לא מאפשר קריאות למערכת כמו קלט/פלט של רשת, קריאה/כתיבה של מערכת קבצים, מידע על המשתמש הנוכחי, רשימת תהליכים וניצול מעבד (CPU)/זיכרון. יכול להיות שחלק מהשיחות האלה יפעלו, אבל הן לא נתמכות ויש סיכוי שהן יושבתו בכל שלב. כדי לשמור על תאימות קדימה, מומלץ להימנע מביצוע קריאות כאלה בקוד.
יכולות להיות מגבלות נוספות לכל שפה נתמכת, כפי שמתואר בהפניה למדיניות שמתאימה לשפה.
שפות נתמכות
JavaScript
התמיכה ב-JavaScript כוללת מודל אובייקטים מלא לטיפול במשתנים ובערכים שספציפיים ל-proxy ל-API. מידע נוסף זמין במאמר מודל אובייקטים של JavaScript.
מידע על הפניות למדיניות ודוגמאות זמין במאמר בנושא מדיניות JavaScript.
Java
אפשר להשתמש במדיניות JavaCalloutכדי לבצע קריאות לקוד Java מהזרימה של ה-proxy. נושא ההפניה למדיניות כולל דוגמאות.
Python
משתמשים במדיניות Python Script policy כדי לקרוא לקוד Python.