MemoryPoolMXBean (Платформа Java SE 8 b92)

Все Суперинтерфейсы:

PlatformManagedObject
```
public interface MemoryPoolMXBean
extends PlatformManagedObject
```
Интерфейс управления для пула памяти. Пул памяти представляет ресурс памяти, которым управляет виртуальная машина Java, и управляется один или больше memory managers.
У виртуальной машины Java есть один или более экземпляров реализации class этого интерфейса. Экземпляр, реализовывая этот интерфейс является MXBean, который может быть получен, вызывая ManagementFactory.getMemoryPoolMXBeans() метод или от platform MBeanServer метод.
ObjectName для однозначного определения MXBean для пула памяти в пределах MBeanServer:
java.lang:type=MemoryPoolИмя пула ,name=
Это может быть получено, вызывая PlatformManagedObject.getObjectName() метод.
Тип памяти

Виртуальная машина Java имеет "кучу" для объектного выделения и также поддерживает память не"кучи" для области метода и выполнения виртуальной машины Java. У виртуальной машины Java могут быть один или более пулов памяти. Каждый пул памяти представляет область памяти одного из следующих типов:
- heap
- non-heap
Контроль Использования памяти
У пула памяти есть следующие атрибуты:
- Использование памяти
- Пиковое использование памяти
- Порог использования
- Порог Использования набора (только поддерживаемый некоторыми собрал "мусор" пулы памяти),
1. Использование памяти
getUsage() метод обеспечивает оценку текущего использования пула памяти. Для собранного "мусор" пула памяти количество используемой памяти включает память, занятую всеми объектами в пуле и включая достижимые и включая недостижимые объекты.
Вообще, этот метод является легкой работой для того, чтобы получить приблизительное использование памяти. Для некоторых пулов памяти, например, когда объекты не упаковываются рядом, этот метод может быть дорогой работой, которая требует, чтобы некоторое вычисление определило текущее использование памяти. Реализация должна задокументировать когда дело обстоит так.
2. Пиковое Использование Памяти
Виртуальная машина Java поддерживает пиковое использование памяти пула памяти, так как виртуальная машина была запущена, или пик был сброшен. Пиковое использование памяти возвращается getPeakUsage() метод и сброс, вызывая resetPeakUsage() метод.
3. Порог использования
У каждого пула памяти есть управляемый атрибут, названный порогом использования, которому предоставляла значение по умолчанию виртуальная машина Java. Значение по умолчанию зависимо от платформы. Порог использования может быть установлен через setUsageThreshold метод. Если порог устанавливается к положительному значению, пороговая проверка пересечения использования включается в этом пуле памяти. Если порог использования обнуляется, пороговое пересечение использования, проверяющее этот пул памяти, отключается. isUsageThresholdSupported() метод может использоваться, чтобы определить, поддерживается ли эта функциональность.
Виртуальная машина Java выполняет пороговое пересечение использования, проверяющее основание пула памяти в его лучшее подходящее время, обычно, во время сборки "мусора". Каждый пул памяти поддерживает a usage threshold count это будет постепенно увеличено каждый раз, когда виртуальная машина Java обнаружит, что использование пула памяти пересекает порог.
Этот управляемый пороговый атрибут использования разрабатывается для того, чтобы контролировать увеличивающуюся тенденцию использования памяти с низкими издержками. Порог использования, возможно, не является подходящим для некоторых пулов памяти. Например, generational сборщик "мусора", общий алгоритм сборки "мусора", используемый во многих реализациях виртуальной машины Java, управляет двумя или больше поколениями, выделяющими объекты возрастом. Большинство объектов выделяется в самой молодой генерации (скажите детский пул памяти). Детский пул памяти разрабатывается, чтобы быть заполненным, и сбор детского пула памяти освободит большую часть своего пространства памяти, так как это, как ожидают, будет содержать главным образом недолгие объекты и главным образом недостижимо во время сборки "мусора". В этом случае для детского пула памяти более уместно не поддерживать порог использования. Кроме того, если стоимость объектного выделения в одном пуле памяти очень низка (например, только атомарный обмен указателя), виртуальная машина Java, вероятно, не поддерживала бы порог использования для того пула памяти, так как издержки в сравнении использования с порогом выше чем стоимость объектного выделения.
Использование памяти системы может контролироваться, используя опрос или пороговые механизмы уведомления.
1. Опрос
  Приложение может непрерывно контролировать свое использование памяти, вызывая любого getUsage() метод для всех пулов памяти или isUsageThresholdExceeded() метод для тех пулов памяти, которые поддерживают порог использования. Ниже пример кода, у которого есть поток delicated для распределения задачи и обработки. В каждом интервале это определит, должно ли это получить и обработать новые задачи, основанные на его использовании памяти. Если использование памяти превысит свой порог использования, то оно перераспределит все выдающиеся задачи к другому VMs и прекратит получать новые задачи до возвратов использования памяти ниже его порога использования.
```
       // Assume the usage threshold is supported for this pool.
       // Set the threshold to myThreshold above which no new tasks
       // should be taken.
       pool.setUsageThreshold(myThreshold);
       ....

       boolean lowMemory = false;
       while (true) {
          if (pool.isUsageThresholdExceeded()) {
              // potential low memory, so redistribute tasks to other VMs
              lowMemory = true;
              redistributeTasks();
              // stop receiving new tasks
              stopReceivingTasks();
          } else {
              if (lowMemory) {
                  // resume receiving tasks
                  lowMemory = false;
                  resumeReceivingTasks();
              }
              // processing outstanding task
              ...
          }
          // sleep for sometime
          try {
              Thread.sleep(sometime);
          } catch (InterruptedException e) {
              ...
          }
       }
       
```
  Вышеупомянутый пример не дифференцирует случай, откуда использование памяти временно опустилось ниже порога использования случая, где использование памяти остается выше threshould между двумя итерациями. Пороговое количество использования, возвращенное getUsageThresholdCount() метод может использоваться, чтобы определить, возвратилось ли использование памяти ниже порога между двумя опросами.
  Ниже шоу другой пример, который предпринимает некоторые меры, если пул памяти находится под низкой памятью и игнорирует изменения использования памяти в течение времени обработки действия.
```
       // Assume the usage threshold is supported for this pool.
       // Set the threshold to myThreshold which determines if
       // the application will take some action under low memory condition.
       pool.setUsageThreshold(myThreshold);

       int prevCrossingCount = 0;
       while (true) {
           // A busy loop to detect when the memory usage
           // has exceeded the threshold.
           while (!pool.isUsageThresholdExceeded() ||
                  pool.getUsageThresholdCount() == prevCrossingCount) {
               try {
                   Thread.sleep(sometime)
               } catch (InterruptException e) {
                   ....
               }
           }

           // Do some processing such as check for memory usage
           // and issue a warning
           ....

           // Gets the current threshold count. The busy loop will then
           // ignore any crossing of threshold happens during the processing.
           prevCrossingCount = pool.getUsageThresholdCount();
       }
       
```
2. Пороговые Уведомления об использовании
  Пороговое уведомление об использовании будет испускаться MemoryMXBean. Когда виртуальная машина Java обнаруживает, что использование памяти пула памяти достигло или превысило порог использования, виртуальная машина инициирует MemoryMXBean, чтобы испустить usage threshold exceeded notification. Другой порог использования превышенное уведомление не будет сгенерировано до использования, упал ниже порога и затем превысил это снова.
  Ниже пример кода, реализовывая ту же самую логику как первый пример выше, но используя пороговый механизм уведомления об использовании, чтобы обнаружить низкие условия памяти вместо опроса. В этом примере кода, после получения уведомления, слушатель уведомления уведомляет другой поток, чтобы выполнить фактическое действие, например, перераспределить выдающиеся задачи, прекратить получить задачи, или продолжать получать задачи. Метод handleNotification должен быть разработан, чтобы сделать очень минимальный объем работы и возвратиться без задержки, чтобы избежать вызывать задержку поставки последующих уведомлений. Отнимающие много времени действия должны быть выполнены отдельным потоком. Слушатель уведомления может быть вызван многократными потоками одновременно; таким образом, задачи, выполняемые слушателем, должны должным образом синхронизироваться.
```
       class MyListener implements javax.management.NotificationListener {
            public void handleNotification(Notification notification, Object handback)  {
                String notifType = notification.getType();
                if (notifType.equals(MemoryNotificationInfo.MEMORY_THRESHOLD_EXCEEDED)) {
                    // potential low memory, notify another thread
                    // to redistribute outstanding tasks to other VMs
                    // and stop receiving new tasks.
                    lowMemory = true;
                    notifyAnotherThread(lowMemory);
                }
            }
       }

       // Register MyListener with MemoryMXBean
       MemoryMXBean mbean = ManagementFactory.getMemoryMXBean();
       NotificationEmitter emitter = (NotificationEmitter) mbean;
       MyListener listener = new MyListener();
       emitter.addNotificationListener(listener, null, null);

       // Assume this pool supports a usage threshold.
       // Set the threshold to myThreshold above which no new tasks
       // should be taken.
       pool.setUsageThreshold(myThreshold);

       // Usage threshold detection is enabled and notification will be
       // handled by MyListener.  Continue for other processing.
       ....

       
```
  Нет никакой гарантии о том, когда MemoryMXBean испустит пороговое уведомление и когда уведомление будет поставлено. Когда слушатель уведомления вызывается, использование памяти пула памяти, возможно, пересекло порог использования не раз. MemoryNotificationInfo.getCount() метод возвращает число раз, что использование памяти пересекло порог использования в моменте времени, когда уведомление было создано. Это может быть по сравнению с текущим пороговым количеством использования, возвращенным getUsageThresholdCount() метод, чтобы определить, произошла ли такая ситуация.
4. Порог Использования набора
Порог использования набора является управляемым атрибутом, только применимым к некоторым, собрал "мусор" пулы памяти. После того, как виртуальная машина Java израсходовала усилие в исправлении пространства памяти, перерабатывая неиспользованные объекты в пуле памяти во время сборки "мусора", некоторое число байтов в пулах памяти, которые являются собранным garbaged, будет все еще использоваться. Порог использования набора позволяет значению быть установленным для этого числа байтов так, что, если порог превышается, a collection usage threshold exceeded notification будет испускаться MemoryMXBean. Кроме того, collection usage threshold count будет тогда постепенно увеличен.
isCollectionUsageThresholdSupported() метод может использоваться, чтобы определить, поддерживается ли эта функциональность.
Виртуальная машина Java выполняет порог использования набора, проверяющий основание пула памяти. Эта проверка включается, если порог использования набора устанавливается к положительному значению. Если порог использования набора обнуляется, эта проверка отключается на этом пуле памяти. Значение по умолчанию является нулем. Во время сборки "мусора" виртуальная машина Java выполняет пороговую проверку использования набора.
Некоторые собрали "мусор", пулы памяти могут хотеть не поддерживать порог использования набора. Например, пулом памяти только управляет непрерывный параллельный сборщик "мусора". Объекты могут быть выделены в этом пуле памяти некоторым потоком, в то время как неиспользованные объекты исправляются параллельным сборщиком "мусора" одновременно. Если нет четко определенное время сборки "мусора", которое является лучшим подходящим временем, чтобы проверить использование памяти, порог использования набора не должен поддерживаться.
Порог использования набора разрабатывается для того, чтобы контролировать использование памяти после того, как виртуальная машина Java израсходовала усилие в исправлении пространства памяти. Использование набора могло также контролироваться опросом и пороговым механизмом уведомления, описанным выше для порога использования подобным способом.
С тех пор:

1.5

См. Также:

ManagementFactory.getPlatformMXBeans(Class), Спецификация JMX., Способы Получить доступ к MXBeans

Сводка метода

Все Методы Методы экземпляра Абстрактные Методы
Модификатор и Тип	Метод и Описание
`MemoryUsage`	`getCollectionUsage()` Возвращает использование памяти после виртуальной машины Java последний раз израсходованное усилие в рециркуляции неиспользованных объектов в этом пуле памяти.
`long`	`getCollectionUsageThreshold()` Возвращает пороговое значение использования набора этого пула памяти в байтах.
`long`	`getCollectionUsageThresholdCount()` Возвращает число раз, что виртуальная машина Java обнаружила, что использование памяти достигло или превысило порог использования набора.
`Строка[]`	`getMemoryManagerNames()` Возвращает имя диспетчеров памяти, которое управляет этим пулом памяти.
`Строка`	`getName()` Возвращает имя, представляющее этот пул памяти.
`MemoryUsage`	`getPeakUsage()` Возвращает пиковое использование памяти этого пула памяти, так как виртуальная машина Java была запущена или так как пик был сброшен.
`MemoryType`	`getType()` Возвращает тип этого пула памяти.
`MemoryUsage`	`getUsage()` Возвращает оценку использования памяти этого пула памяти.
`long`	`getUsageThreshold()` Возвращает пороговое значение использования этого пула памяти в байтах.
`long`	`getUsageThresholdCount()` Возвращает число раз, что использование памяти пересекло порог использования.
`boolean`	`isCollectionUsageThresholdExceeded()` Тесты, если использование памяти этого пула памяти после того, как новый набор, на который виртуальная машина Java израсходовала усилие, достиг или превысил свой порог использования набора.
`boolean`	`isCollectionUsageThresholdSupported()` Тесты, если этот пул памяти поддерживает порог использования набора.
`boolean`	`isUsageThresholdExceeded()` Тесты, если использование памяти этого пула памяти достигает или превышает свое пороговое значение использования.
`boolean`	`isUsageThresholdSupported()` Тесты, если этот пул памяти поддерживает порог использования.
`boolean`	`isValid()` Тесты, если этот пул памяти допустим в виртуальной машине Java.
`void`	`resetPeakUsage()` Сбрасывает пиковую статистическую величину использования памяти этого пула памяти к текущему использованию памяти.
`void`	`setCollectionUsageThreshold(long threshold)` Устанавливает порог использования набора этого пула памяти к данному значению `threshold`.
`void`	`setUsageThreshold(long threshold)` Устанавливает порог этого пула памяти к данному значению `threshold`, если этот пул памяти поддерживает порог использования.

Методы, наследованные от интерфейса java.lang.management.PlatformManagedObject
getObjectName

- Деталь метода
  - getName
```
String getName()
```
    Возвращает имя, представляющее этот пул памяти.
    
    Возвраты:
    
    имя этого пула памяти.
  - getType
```
MemoryType getType()
```
    Возвращает тип этого пула памяти.
    Доступ MBeanServer:
    Отображенным типом MemoryType является String, и значение является именем MemoryType.
    
    Возвраты:
    
    тип этого пула памяти.
  - getUsage
```
MemoryUsage getUsage()
```
    Возвращает оценку использования памяти этого пула памяти. Этот метод возвращает null, если этот пул памяти не допустим (то есть больше существует).
    Этот метод запрашивает виртуальную машину Java сделать оценку максимальных усилий из текущего использования памяти этого пула памяти. Для некоторых пулов памяти этот метод может быть дорогой работой, которая требует, чтобы некоторое вычисление определило оценку. Реализация должна задокументировать когда дело обстоит так.
    Этот метод разрабатывается для использования в использовании памяти системы контроля и обнаруживающий низкое условие памяти.
    Доступ MBeanServer:
    Отображенным типом MemoryUsage является CompositeData с атрибутами как определено в MemoryUsage.
    
    Возвраты:
    
    a MemoryUsage объект; или null, если этот пул, не допустимый.
  - getPeakUsage
```
MemoryUsage getPeakUsage()
```
    Возвращает пиковое использование памяти этого пула памяти, так как виртуальная машина Java была запущена или так как пик был сброшен. Этот метод возвращает null, если этот пул памяти не допустим (то есть больше существует).
    Доступ MBeanServer:
    Отображенным типом MemoryUsage является CompositeData с атрибутами как определено в MemoryUsage.
    
    Возвраты:
    
    a MemoryUsage объект, представляющий пиковое использование памяти; или null, если этот пул не допустим.
  - resetPeakUsage
```
void resetPeakUsage()
```
    Сбрасывает пиковую статистическую величину использования памяти этого пула памяти к текущему использованию памяти.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.
  - isValid
```
boolean isValid()
```
    Тесты, если этот пул памяти допустим в виртуальной машине Java. Пул памяти становится недопустимым, как только виртуальная машина Java удаляет его из системы памяти.
    
    Возвраты:
    
    true, если пул памяти допустим в рабочей виртуальной машине Java; false иначе.
  - getMemoryManagerNames
```
String[] getMemoryManagerNames()
```
    Возвращает имя диспетчеров памяти, которое управляет этим пулом памяти. Каждым пулом памяти будет управлять по крайней мере один диспетчер памяти.
    
    Возвраты:
    
    массив объектов String, каждый - имя диспетчера памяти, управляющего этим пулом памяти.
  - getUsageThreshold
```
long getUsageThreshold()
```
    Возвращает пороговое значение использования этого пула памяти в байтах. У каждого пула памяти есть зависимое от платформы пороговое значение значения по умолчанию. Текущий порог использования может быть изменен через setUsageThreshold метод.
    
    Возвраты:
    
    пороговое значение использования этой памяти объединяет в пул в байтах.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования.
    
    См. Также:
    
    isUsageThresholdSupported()
  - setUsageThreshold
```
void setUsageThreshold(long threshold)
```
    Устанавливает порог этого пула памяти к данному значению threshold, если этот пул памяти поддерживает порог использования. Пороговая проверка пересечения использования включается в этом пуле памяти, если порог устанавливается к положительному значению. Пороговая проверка пересечения использования отключается, если она обнуляется.
    
    Параметры:
    
    threshold - новое пороговое значение в байтах. Должно быть неотрицательным.
    
    Броски:
    
    IllegalArgumentException - если threshold отрицателен или больше чем максимальный объем памяти для этого пула памяти если определено.
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования.
    
    SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.
    
    См. Также:
    
    isUsageThresholdSupported(), Порог использования
  - isUsageThresholdExceeded
```
boolean isUsageThresholdExceeded()
```
    Тесты, если использование памяти этого пула памяти достигает или превышает свое пороговое значение использования.
    
    Возвраты:
    
    true, если использование памяти этого пула памяти достигает или превышает пороговое значение; false иначе.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования.
  - getUsageThresholdCount
```
long getUsageThresholdCount()
```
    Возвращает число раз, что использование памяти пересекло порог использования.
    
    Возвраты:
    
    число раз, что использование памяти пересекло свое пороговое значение использования.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования.
  - isUsageThresholdSupported
```
boolean isUsageThresholdSupported()
```
    Тесты, если этот пул памяти поддерживает порог использования.
    
    Возвраты:
    
    true, если этот пул памяти поддерживает порог использования; false иначе.
  - getCollectionUsageThreshold
```
long getCollectionUsageThreshold()
```
    Возвращает пороговое значение использования набора этого пула памяти в байтах. Значение по умолчанию является нулем. Порог использования набора может быть изменен через setCollectionUsageThreshold метод.
    
    Возвраты:
    
    порог использования набора этой памяти объединяет в пул в байтах.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования набора.
    
    См. Также:
    
    isCollectionUsageThresholdSupported()
  - setCollectionUsageThreshold
```
void setCollectionUsageThreshold(long threshold)
```
    Устанавливает порог использования набора этого пула памяти к данному значению threshold. Когда этот порог будет установлен к положительному, виртуальная машина Java проверит использование памяти в свое лучшее подходящее время после того, как это израсходовало усилие в рециркуляции неиспользованных объектов в этом пуле памяти.
    Пороговая проверка пересечения использования набора включается в этом пуле памяти, если порог устанавливается к положительному значению. Пороговая проверка пересечения использования набора отключается, если она обнуляется.
    
    Параметры:
    
    threshold - новое пороговое значение использования набора в байтах. Должно быть неотрицательным.
    
    Броски:
    
    IllegalArgumentException - если threshold отрицателен или больше чем максимальный объем памяти для этого пула памяти если определено.
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования набора.
    
    SecurityException - если менеджер безопасности существует, и вызывающая сторона не имеет контроля ManagementPermission.
    
    См. Также:
    
    isCollectionUsageThresholdSupported(), Порог использования набора
  - isCollectionUsageThresholdExceeded
```
boolean isCollectionUsageThresholdExceeded()
```
    Тесты, если использование памяти этого пула памяти после того, как новый набор, на который виртуальная машина Java израсходовала усилие, достиг или превысил свой порог использования набора. Этот метод не запрашивает виртуальную машину Java выполнить любую сборку "мусора" кроме своего нормального автоматического управления памятью.
    
    Возвраты:
    
    true, если использование памяти этого пула памяти достигает или превышает пороговое значение использования набора в новом наборе; false иначе.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования.
  - getCollectionUsageThresholdCount
```
long getCollectionUsageThresholdCount()
```
    Возвращает число раз, что виртуальная машина Java обнаружила, что использование памяти достигло или превысило порог использования набора.
    
    Возвраты:
    
    число раз, что использование памяти достигло или превысило порог использования набора.
    
    Броски:
    
    UnsupportedOperationException - если этот пул памяти не поддерживает порог использования набора.
    
    См. Также:
    
    isCollectionUsageThresholdSupported()
  - getCollectionUsage
```
MemoryUsage getCollectionUsage()
```
    Возвращает использование памяти после виртуальной машины Java последний раз израсходованное усилие в рециркуляции неиспользованных объектов в этом пуле памяти. Этот метод не запрашивает виртуальную машину Java выполнить любую сборку "мусора" кроме своего нормального автоматического управления памятью. Этот метод возвращает null, если виртуальная машина Java не поддерживает этот метод.
    Доступ MBeanServer:
    Отображенным типом MemoryUsage является CompositeData с атрибутами как определено в MemoryUsage.
    
    Возвраты:
    
    a MemoryUsage представление использования памяти этого пула памяти после виртуальной машины Java последний раз израсходованное усилие в рециркуляции неиспользованных объектов; null, если этот метод не поддерживается.
  - isCollectionUsageThresholdSupported
```
boolean isCollectionUsageThresholdSupported()
```
    Тесты, если этот пул памяти поддерживает порог использования набора.
    
    Возвраты:
    
    true, если этот пул памяти поддерживает порог использования набора; false иначе.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Интерфейс MemoryPoolMXBean

Тип памяти

Контроль Использования памяти

1. Использование памяти

2. Пиковое Использование Памяти

3. Порог использования

4. Порог Использования набора

Сводка метода

Методы, наследованные от интерфейса java.lang.management.PlatformManagedObject

Деталь метода

getName

getType

getUsage

getPeakUsage

resetPeakUsage

isValid

getMemoryManagerNames

getUsageThreshold

setUsageThreshold

isUsageThresholdExceeded

getUsageThresholdCount

isUsageThresholdSupported

getCollectionUsageThreshold

setCollectionUsageThreshold

isCollectionUsageThresholdExceeded

getCollectionUsageThresholdCount

getCollectionUsage

isCollectionUsageThresholdSupported