תבניות של ספר בישול לשרת proxy ל-API

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

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

דפוס הלקוח HTTP ב-JavaScript

דפוס הלקוח ב-JavaScript של HTTP הוא אחד מכמה תבניות שבהן אפשר להשתמש כדי ליצור מיזוג תכנים בצד השרת באמצעות Apigee Edge. מודל JavaScript Object Model של Apigee מאפשר לחבר קוד JavaScript ישירות לזרימה של שרת proxy ב-API. האובייקט httpClient במודל האובייקט מאפשר לבצע קריאות לשירותים לקצה העורפי ולאחזר תוצאות באמצעות JavaScript.

הדפוס של הרכב המדיניות

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

בליבה של תבנית היצירה של המדיניות נמצאת המדיניות בנושא ServiceCallout. המדיניות של ServiceCallout פועלת כלקוח HTTP לשירות או לממשק העורפי של הקצה העורפי. עם זאת, כדי להפעיל את הפונקציה הזו באופן מלא, היתרונות של יתרונות מרכזיים מסתמכים על כללי מדיניות אחרים כדי לאפשר אינטראקציה משמעותית עם ממשק API או שירות מרוחק. כללי מדיניות אחרים משמשים ליצירת הודעת הבקשה שנשלחת על ידי ה-ServiceCallout, ולניתוח התוכן בהודעת התגובה מה-API או מהשירות המרוחק.

בדוגמה של ספר המתכונים של המדיניות בנושא יצירה יש שלושה כללי מדיניות: AssignMessage, ServiceCallout ו-ExtractVariables. כללי המדיניות האלה כוללים את הודעות הבקשות שרוצים לשלוח לקצה העורפי, את הלקוח שמנתב את ההודעה לקצה העורפי, וגם מנתח הודעות שמנתח את התגובה מכל ממשק API ומקצה משתנים לנתוני התגובה. אחרי שכל הקריאות בוצעו, המשתנים שנאספו משולבים ומוחזרים באובייקט JSON אחד.

הנה סיכום קצר של שלושת כללי המדיניות האלה:

  • AssignMessage: יצירת הודעת בקשה, מאכלסת כותרות HTTP ופרמטרים של שאילתה, מגדירה את פועל ה-HTTP.
  • ServiceCallout: הפניה להודעה שנוצרה על ידי המדיניות assignMessage, הגדרת כתובת URL המשמשת כיעד לקריאה החיצונית והגדרה של שם אובייקט התגובה ששירות היעד מחזיר.
  • ExtractVariables: בדרך כלל מגדיר ביטוי JSONPath או XPath שמנתח את ההודעה שנוצרה על ידי המדיניות הקודמת של ServiceCallout. לאחר מכן, המדיניות מגדירה משתנים שמכילים את הערכים שנותחו מהתגובה של ServiceCallout.

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