כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
במסמך הזה מוסבר איך מפעילים שכפול מחרוזות במעבדי הודעות של Apigee Edge.
שכפול מחרוזות הוא תכונת Java שעוזרת לך לחסוך בזיכרון שבהם קיימים אובייקטי מחרוזת כפולים באפליקציות Java. הפונקציה מפחיתה את טביעת הרגל הפחמנית של הזיכרון של אובייקטים של מחרוזת Java בכך שערכי המחרוזת הכפולים או הזהים חולקים את אותו מערך תווים.
מעבד ההודעות של Apigee Edge הוא רכיב מבוסס Java. השימוש בביטול כפילויות של מחרוזות במעבד הודעות יכול לשפר את הביצועים של שרתי ה-proxy של ה-API על ידי צמצום השימוש בזיכרון, במיוחד אם בשרתי ה-API יש שימוש נרחב במחרוזות.
אפשר להשתמש בתכונה 'ביטול כפילויות של מחרוזות' רק ב-G1 Garbage Collector (G1GC) באפליקציות Java. אם רוצים להפעיל את התכונה הזו במעבד ההודעות, צריך כבר להפעיל את G1GC או לאפשר ביטול כפילויות של מחרוזות וגם של G1GC במעבד ההודעות.
לפני שמתחילים
- אם אתם לא מכירים את G1GC, כדאי לקרוא את המאמר תחילת העבודה עם G1 Garbage Collector
- אם זו הפעם הראשונה שאתם משתמשים בשכפול מחרוזות, מומלץ לקרוא את המאמר ביטול כפילויות של מחרוזות של G1 Garbage Collector
- אם אתם לא יודעים איך להפעיל G1GC במעבדי הודעות בקצה, כדאי לקרוא את המאמר הפעלת G1GC במעבדי הודעות.
- אם אתם לא יודעים איך להגדיר מאפיינים ל-Edge ב-Private Cloud, קראו את ההוראות להגדרה של Edge.
הפעלה של ביטול כפילויות של מחרוזות במעבדי הודעות
בקטע הזה מוסבר איך מפעילים את התכונה 'ביטול כפילויות של מחרוזות' במעבדי הודעות
של Edge. ניתן להפעיל ביטול כפילויות של מחרוזות דרך הנכס
useStringDeduplication
ברכיב מעבד ההודעות. כברירת מחדל, המאפיין הזה מוגדר
כ-False במעבדי ההודעות. כדי להגדיר מאפיין כלשהו במעבד ההודעות, צריך להשתמש באסימון בהתאם לתחביר המתואר בקטע איך מגדירים את Edge.
כדי להפעיל ביטול כפילויות של מחרוזות במעבדי ההודעות, יש לבצע את השלבים הבאים:
איתור אסימון לנכס useStringDeduplication
בשלבים הבאים מוסבר איך לאתר את האסימון של useStringDeduplication:
-
מחפשים את המאפיין
useStringDeduplication
בספריית המקור של מעבד ההודעות/opt/apigee/edge-message-processor/source
באמצעות הפקודה הבאה:grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
-
בפלט של הפקודה הזו מוצג האסימון של המאפיין
useStringDeduplication
של מעבד ההודעות באופן הבא:/opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}
כאשר המחרוזת בין התגים
{T}{/T}
היא שם האסימון שניתן להגדיר בקובץ.properties
של מעבד ההודעות. לכן, האסימון של הנכסuseStringDeduplication
הוא:conf_system_useStringDeduplication
הפעלת שכפול מחרוזות במעבדי הודעות
בשלבים הבאים מתארים איך להפעיל ביטול כפילויות של מחרוזות במעבדי הודעות של Apigee:
-
פותחים את הקובץ
/opt/apigee/customer/application/message-processor.properties
במחשב שבמעבד ההודעות. אם הקובץ עדיין לא קיים, יוצרים אותו. לדוגמה:vi /opt/apigee/customer/application/message-processor.properties
-
מוסיפים לקובץ הזה את השורה הבאה:
conf_system_useStringDeduplication=true
- שומרים את השינויים.
-
צריך לוודא שקובץ המאפיינים הזה הוא בבעלות המשתמש של
apigee
. לדוגמה:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
מפעילים מחדש את מעבד ההודעות באמצעות הפקודה הבאה:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- אם יש לכם יותר ממעבד הודעות אחד, צריך לחזור על השלבים האלה בכל מעבדי ההודעות.
אימות כפילויות של מחרוזות במעבדי ההודעות
בקטע הזה מוסבר איך לוודא שביטול הכפילויות של מחרוזות הופעל בהצלחה אצל מעבדי ההודעות.
למרות שמשתמשים באסימון conf_system_useStringDeduplication
כדי להפעיל שכפול מחרוזות
במעבד ההודעות, צריך לוודא שהנכס בפועל
useStringDeduplication
הוגדר עם הערך החדש באופן הבא:
-
מחפשים את הנכס
useStringDeduplication
בספרייה/opt/apigee/edge-message-processor/conf
ובודקים שהוא הוגדר עם הערך החדש. לדוגמה:grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
-
אם ביטול הכפילויות של מחרוזות הופעל בהצלחה במעבד ההודעות, הפקודה
הקודמת תציג את הערך החדש בקובץ
system.properties
.התוצאה לדוגמה מהפקודה הקודמת אחרי שהפעלתם שכפול מחרוזות במעבד ההודעות היא:
/opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true
בפלט לדוגמה, שימו לב שהנכס
useStringDeduplication
הוגדר עם הערך החדשtrue
ב-system.properties
. הסימון הזה מציין שביטול כפילויות של מחרוזות הופעל במעבד ההודעות. -
אם הערך הישן של המאפיין
useStringDeduplication
עדיין מופיע, צריך לוודא שביצעת את כל השלבים שמפורטים בקטע הפעלה של ביטול כפילויות של מחרוזות במעבדי הודעות בצורה נכונה. אם החמצתם שלב כלשהו, יש לחזור על כל השלבים בצורה נכונה. - אם עדיין אין אפשרות להפעיל כפילויות של מחרוזות, צריך לפנות לתמיכה של Apigee.