فعال کردن حذف تکراری رشته در «پردازشگرهای پیام»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

این سند نحوه فعال کردن «حذف تکرار رشته» در «پردازشگرهای پیام» Apigee Edge را توضیح می‌دهد.

«حذف تکراری رشته» ویژگی جاوا است که به شما کمک می‌کند حافظه اشغال‌شده توسط اشیای تکراری «رشته» را در برنامه‌های جاوا ذخیره کنید. با اینکه مقادیر «رشته» تکراری یا یکسان از آرایه نویسه یکسانی استفاده می‌کنند، این ویژگی ردپای حافظه اشیای «رشته» را در حافظه پشته Java کاهش می‌دهد.

«پردازشگر پیام Apigee Edge» یک مؤلفه مبتنی بر جاوا است. استفاده از «حذف تکراری رشته» در «پردازشگر پیام» می‌تواند عملکرد «پراکسی‌های API» را با کاهش استفاده از حافظه بهبود بخشد، به‌ویژه اگر «پراکسی‌های API» از «رشته‌ها» استفاده سنگین کنند.

از ویژگی «حذف تکرار رشته» فقط می‌توان با «جمع‌آوری‌کننده زباله G1» (G1GC) در برنامه‌های Java استفاده کرد. اگر می‌خواهید این ویژگی را در «پردازنده پیام» فعال کنید، باید ازقبل G1GC را فعال کرده باشید یا G1GC و «حذف تکرار رشته» را به‌طور هم‌زمان در «پردازنده پیام» فعال کنید.

قبل‌از شروع

فعال کردن حذف تکراری رشته در «پردازشگرهای پیام»

این بخش نحوه فعال کردن ویژگی «حذف تکراری‌های رشته» را در «پردازشگرهای پیام Edge» توضیح می‌دهد. «حذف رشته‌های تکراری» را می‌توان ازطریق دارایی useStringDeduplication در عنصر «پردازشگر پیام» فعال کرد. به‌طور پیش‌فرض، این دارایی در «پردازشگرهای پیام» روی «نادرست» تنظیم شده است. برای پیکربندی هر دارایی در Message Processor، از کد براساس دستور زبان شرح‌داده‌شده در نحوه پیکربندی Edge استفاده کنید.

برای فعال کردن «حذف تکرار رشته» در «پردازشگرهای پیام»، مراحل زیر را انجام دهید:

  1. یافتن کد برای استفاده از دارایی useStringDeduplication
  2. فعال کردن useStringDeduplication در «پردازشگر پیام»

مکان‌یابی کردن توکن برای دارایی useStringDeduplication

مراحل زیر نحوه یافتن نشان برای استفاده از useStringDeduplication را شرح می‌دهد:

  1. دارایی useStringDeduplication را در منبع «پردازشگر پیام» بااستفاده از فرمان زیر در دایرکتوری /opt/apigee/edge-message-processor/source جستجو کنید:
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. برونداد این فرمان نشان‌دهنده نشان برای دارایی «پردازشگر پیام» useStringDeduplication به‌صورت زیر است:
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

    که در آن رشته بین برچسب‌های {T}{/T} نام رمزی است که می‌توانید در فایل .properties «پردازشگر پیام» تنظیم کنید. بنابراین، رمز برای دارایی useStringDeduplication به‌صورت زیر است:

    conf_system_useStringDeduplication

فعال کردن حذف تکراری رشته در «پردازشگرهای پیام»

مراحل زیر نحوه فعال کردن «حذف تکرار رشته» در «پردازشگرهای پیام Apigee» را شرح می‌دهد:

  1. فایل /opt/apigee/customer/application/message-processor.properties را در دستگاه «پردازشگر پیام» در ویرایشگر باز کنید. اگر فایل ازقبل وجود ندارد، آن را ایجاد کنید. برای مثال:
    vi /opt/apigee/customer/application/message-processor.properties
  2. خط زیر را به این فایل اضافه کنید:
    conf_system_useStringDeduplication=true
  3. تغییرات را ذخیره کنید.
  4. مطمئن شوید که این فایل دارایی متعلق به کاربر apigee است. برای مثال:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. «پردازشگر پیام» را بااستفاده از فرمان زیر بازراه‌اندازی کنید:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. اگر بیش‌از یک «پردازشگر پیام» دارید، این مراحل را در همه «پردازشگرهای پیام» تکرار کنید.

درستی‌سنجی کردن حذف تکراری رشته در «پردازشگرهای پیام»

این بخش نحوه درستی‌سنجی اینکه «حذف تکراری رشته» باموفقیت در «پردازشگرهای پیام» فعال شده است را توضیح می‌دهد.

اگرچه از کد conf_system_useStringDeduplication برای فعال کردن «حذف تکراری» در «پردازشگر پیام» استفاده می‌کنید، باید تأیید کنید که دارایی واقعی useStringDeduplication با مقدار جدید به‌صورت زیر تنظیم شده است:

  1. دارایی useStringDeduplication را در دایرکتوری /opt/apigee/edge-message-processor/conf جستجو کنید و بررسی کنید که با مقدار جدید تنظیم شده باشد. برای مثال:
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. اگر «حذف تکراری‌های رشته» در «پردازشگر پیام» باموفقیت فعال شود، فرمان قبلی مقدار جدید را در فایل system.properties نشان می‌دهد.

    نتیجه نمونه از فرمان قبلی پس‌از فعال کردن «حذف تکرار رشته» در «پردازشگر پیام» به‌صورت زیر است:

    /opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true

    در برونداد مثال، توجه کنید که دارایی useStringDeduplication با مقدار جدید true در system.properties تنظیم شده است. این نشان می‌دهد که «حذف تکراری‌های رشته» باموفقیت در «پردازشگر پیام» فعال شده است.

  3. اگر هنوز مقدار قدیمی را برای دارایی useStringDeduplication می‌بینید، تأیید کنید که همه مراحل ذکرشده در فعال کردن حذف تکراری رشته در پردازنده‌های پیام را به‌درستی دنبال کرده‌اید. اگر مرحله‌ای را ازدست داده‌اید، همه مراحل را دوباره به‌درستی تکرار کنید.
  4. اگر همچنان نمی‌توانید «حذف تکرار رشته» را فعال کنید، با پشتیبانی Apigee تماس بگیرید.

گام بعدی چیست؟

فعال کردن G1GC در «پردازنده‌های پیام»