Эта страница переведена с помощью Cloud Translation API.

Включение дедупликации строк в процессорах сообщений

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

В этом документе объясняется, как включить дедупликацию строк в обработчиках сообщений Apigee Edge.

Дедупликация строк — это функция Java, которая помогает экономить память, занимаемую повторяющимися строковыми объектами в Java-приложениях. Она уменьшает объем памяти, занимаемый строковыми объектами в куче Java, за счет того, что повторяющиеся или идентичные строковые значения используют один и тот же символьный массив.

Apigee Edge Message Processor — это компонент на основе Java. Использование дедупликации строк в обработчике сообщений может повысить производительность ваших API-прокси за счет снижения потребления памяти, особенно если API-прокси активно используют строки.

Функция дедупликации строк может использоваться только со сборщиком мусора G1 (G1GC) в Java-приложениях. Если вы хотите включить эту функцию в обработчике сообщений, вам необходимо либо уже включить G1GC, либо включить G1GC и дедупликацию строк одновременно в обработчике сообщений.

Прежде чем начать

Если вы не знакомы с G1GC, прочтите статью «Начало работы с мусоросборщиком G1».
Если вы не знакомы с дедупликацией строк, прочтите статью «Дедупликация строк в сборщике мусора G1».
Если вы не знакомы с включением G1GC на периферийных обработчиках сообщений, прочтите раздел «Включение G1GC на обработчиках сообщений» .
Если вы не знакомы с настройкой параметров Edge в частном облаке, прочтите статью «Как настроить Edge» .

Включение дедупликации строк в обработчиках сообщений

В этом разделе объясняется, как включить функцию дедупликации строк в обработчиках сообщений Edge. Дедупликацию строк можно включить с помощью свойства useStringDeduplication компонента обработчика сообщений. По умолчанию это свойство установлено в значение false для обработчиков сообщений. Чтобы настроить любое свойство обработчика сообщений, используйте токен в соответствии с синтаксисом, описанным в разделе «Как настроить Edge» .

Для включения дедупликации строк в обработчиках сообщений выполните следующие действия:

Найдите токен для свойства useStringDeduplication.
Включите параметр useStringDeduplication в обработчике сообщений.

Найдите токен для свойства 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
```
Примечание: Если вы хотите одновременно включить G1GC и дедупликацию строк, добавьте следующие строки в файл /opt/apigee/customer/application/message-processor.properties :
```
conf_system_useG1GC=true
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 в файле system.properties получило новое значение true . Это указывает на то, что дедупликация строк успешно включена в обработчике сообщений.
Если для свойства useStringDeduplication по-прежнему отображается старое значение, убедитесь, что вы правильно выполнили все шаги, описанные в разделе «Включение дедупликации строк в обработчиках сообщений» . Если вы пропустили какой-либо шаг, повторите все шаги заново.
Если вам по-прежнему не удается включить дедупликацию строк, обратитесь в службу поддержки Apigee .

Что дальше?

Включите G1GC в обработчиках сообщений .