يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
يشرح هذا المستند كيفية تفعيل إزالة تكرار السلاسل في معالجات الرسائل في Apigee Edge.
"إزالة تكرار السلاسل" هي ميزة من ميزات Java تساعدك في توفير الذاكرة التي تشغلها كائنات السلسلة المكرّرة في تطبيقات Java. تقلّل هذه الميزة من مساحة الذاكرة لكائنات السلسلة في ذاكرة Java Heap من خلال جعل قيم السلسلة المكرّرة أو المتطابقة تتشارك في مصفوفة الأحرف نفسها.
معالج رسائل Apigee Edge هو مكون قائم على Java. يمكن أن يؤدي استخدام إزالة تكرار السلاسل في "معالج الرسائل" إلى تحسين أداء الخوادم الوكيلة لواجهة برمجة التطبيقات من خلال تقليل استخدام الذاكرة، خاصةً إذا كانت الخوادم الوكيلة لواجهة برمجة التطبيقات تستخدم السلاسل بشكلٍ كبير.
لا يمكن استخدام ميزة "إزالة تكرار السلاسل" إلا مع أداة G1 Garbage Collector (G1GC) في تطبيقات Java. إذا أردت تفعيل هذه الميزة على "معالج الرسائل"، يجب أن يكون قد سبق تفعيل G1GC أو تفعيل كل من G1GC و"إزالة تكرار السلاسل" معًا في "معالج الرسائل".
قبل البدء
- إذا لم تكن معتادًا على استخدام G1GC، اطّلِع على بدء استخدام أداة تجميع القمامة في G1.
- إذا لم تكن معتادًا على إزالة تكرار السلاسل، اطّلِع على إزالة تكرار السلسلة لأداة تجميع البيانات المهملة في G1.
- إذا لم تكن معتادًا على تفعيل G1GC على معالِجات الرسائل، يمكنك الاطّلاع على تفعيل G1GC في معالِجات الرسائل.
- إذا لم تكن على دراية بكيفية ضبط خصائص Edge على السحابة الإلكترونية الخاصة، يُرجى الاطّلاع على المقالة كيفية إعداد Edge.
تفعيل إزالة تكرار السلاسل على معالجات الرسائل
يشرح هذا القسم طريقة تفعيل ميزة إزالة تكرار السلاسل في معالِجات الرسائل
على Edge. يمكن تفعيل ميزة إزالة تكرار السلسلة من خلال الموقع
useStringDeduplication
في مكوّن "معالج الرسائل". ويتم ضبط هذه السمة تلقائيًا على "خطأ" في معالجات الرسائل. لضبط أي خاصية على معالج الرسائل، استخدِم الرمز المميّز وفقًا للبنية الموضحة في كيفية إعداد Edge.
لتمكين إزالة تكرار السلاسل في معالجات الرسائل، نفذ الخطوات التالية:
تحديد الرمز المميّز للسمة useStringDeduplcate
توضّح الخطوات التالية كيفية تحديد موقع الرمز المميّز لـ useStringDeduplction:
-
ابحث عن السمة
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.