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

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

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

תבנית של לקוח HTTP ב-JavaScript

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

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

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

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

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

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

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

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