Interface MemoryPoolMXBean

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      MemoryUsage getCollectionUsage()
      If supported by the virtual machine, returns a MemoryUsage which encapsulates this memory pool's memory usage after the most recent run of the garbage collector.
      long getCollectionUsageThreshold()
      Returns this memory pool's collection usage threshold.
      long getCollectionUsageThresholdCount()
      Returns the number of times that the memory usage for this memory pool has grown to exceed the collection usage threshold.
      String[] getMemoryManagerNames()
      Returns a string array containing the unique names of each memory manager that manages this memory pool.
      String getName()
      Returns the name of this memory pool.
      MemoryUsage getPeakUsage()
      Returns information on the peak usage of the memory pool.
      MemoryType getType()
      Returns the memory pool's type.
      MemoryUsage getUsage()
      Returns the current memory usage of this memory pool as estimated by the virtual machine.
      long getUsageThreshold()
      Returns this memory pool's usage threshold.
      long getUsageThresholdCount()
      Returns the number of times that the memory usage for this memory pool has grown to exceed the current usage threshold.
      boolean isCollectionUsageThresholdExceeded()
      Returns a boolean indication of whether or not this memory pool hit or exceeded the current value of the collection usage threshold after the latest garbage collection run.
      boolean isCollectionUsageThresholdSupported()
      Returns a boolean indication of whether or not this memory pool supports a collection usage threshold.
      boolean isUsageThresholdExceeded()
      Returns a boolean indication of whether or not this memory pool has hit or has exceeded the current value of the usage threshold.
      boolean isUsageThresholdSupported()
      Returns a boolean indication of whether or not this memory pool supports a usage threshold.
      boolean isValid()
      Returns a boolean indication of whether or not this memory pool may still be considered valid.
      void resetPeakUsage()
      Updates this memory pool's memory usage peak value to be whatever the value of the current memory usage is.
      void setCollectionUsageThreshold​(long threshold)
      Updates this memory pool to have a new value for its collection usage threshold.
      void setUsageThreshold​(long threshold)
      Updates this memory pool to have a new value for its usage threshold.
    • Method Detail

      • getCollectionUsage

        MemoryUsage getCollectionUsage()
        If supported by the virtual machine, returns a MemoryUsage which encapsulates this memory pool's memory usage after the most recent run of the garbage collector. No garbage collection will be actually occur as a result of this method getting called.
        Returns:
        a MemoryUsage object that may be interrogated by the caller to determine the details of the memory usage. Returns null if the virtual machine does not support this method.
      • getCollectionUsageThreshold

        long getCollectionUsageThreshold()
        Returns this memory pool's collection usage threshold.
        Returns:
        the collection usage threshold in bytes. The default value as set by the virtual machine will be zero.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a collection usage threshold.
        See Also:
        isCollectionUsageThresholdSupported()
      • getCollectionUsageThresholdCount

        long getCollectionUsageThresholdCount()
        Returns the number of times that the memory usage for this memory pool has grown to exceed the collection usage threshold.
        Returns:
        a count of the number of times that the collection usage threshold has been surpassed.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a collection usage threshold.
        See Also:
        isCollectionUsageThresholdSupported()
      • getMemoryManagerNames

        String[] getMemoryManagerNames()
        Returns a string array containing the unique names of each memory manager that manages this memory pool. A memory pool will always have at least one memory manager associated with it.
        Returns:
        the names of all the memory managers for this memory pool.
      • getName

        String getName()
        Returns the name of this memory pool.
        Returns:
        the name of this memory pool.
      • getPeakUsage

        MemoryUsage getPeakUsage()
        Returns information on the peak usage of the memory pool. The scope of this covers all elapsed time since either the start of the virtual machine or the peak usage was reset.
        Returns:
        a MemoryUsage which can be interrogated by the caller to determine details of the peak memory usage. A null value will be returned if the memory pool no longer exists (and the pool is therefore considered to be invalid).
        See Also:
        resetPeakUsage(), isValid()
      • getType

        MemoryType getType()
        Returns the memory pool's type.
        Returns:
        a MemoryType value indicating the type of the memory pool (heap or non-heap).
      • getUsage

        MemoryUsage getUsage()
        Returns the current memory usage of this memory pool as estimated by the virtual machine.
        Returns:
        an instance of MemoryUsage that can be interrogated by the caller to determine details on the pool's current memory usage. A null value will be returned if the memory pool no longer exists (in which case it is considered to be invalid).
        See Also:
        isValid()
      • getUsageThreshold

        long getUsageThreshold()
        Returns this memory pool's usage threshold.
        Returns:
        the usage threshold in bytes. The default value as set by the virtual machine depends on the platform the virtual machine is running on. will be zero.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a usage threshold.
        See Also:
        isUsageThresholdSupported(), setUsageThreshold(long)
      • getUsageThresholdCount

        long getUsageThresholdCount()
        Returns the number of times that the memory usage for this memory pool has grown to exceed the current usage threshold.
        Returns:
        a count of the number of times that the usage threshold has been surpassed.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a usage threshold.
        See Also:
        isUsageThresholdSupported()
      • isCollectionUsageThresholdExceeded

        boolean isCollectionUsageThresholdExceeded()
        Returns a boolean indication of whether or not this memory pool hit or exceeded the current value of the collection usage threshold after the latest garbage collection run.
        Returns:
        true if the collection usage threshold was surpassed after the latest garbage collection run, otherwise false.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a collection usage threshold.
        See Also:
        isCollectionUsageThresholdSupported()
      • isCollectionUsageThresholdSupported

        boolean isCollectionUsageThresholdSupported()
        Returns a boolean indication of whether or not this memory pool supports a collection usage threshold.
        Returns:
        true if supported, false otherwise.
      • isUsageThresholdExceeded

        boolean isUsageThresholdExceeded()
        Returns a boolean indication of whether or not this memory pool has hit or has exceeded the current value of the usage threshold.
        Returns:
        true if the usage threshold has been surpassed, otherwise false.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a usage threshold.
        See Also:
        isUsageThresholdSupported()
      • isUsageThresholdSupported

        boolean isUsageThresholdSupported()
        Returns a boolean indication of whether or not this memory pool supports a usage threshold.
        Returns:
        true if supported, false otherwise.
      • isValid

        boolean isValid()
        Returns a boolean indication of whether or not this memory pool may still be considered valid. A memory pool becomes invalid once it has been removed by the virtual machine.
        Returns:
        true if the memory pool has not been removed by the virtual machine, false otherwise.
      • resetPeakUsage

        void resetPeakUsage()
        Updates this memory pool's memory usage peak value to be whatever the value of the current memory usage is.
        Throws:
        SecurityException - if there is a security manager active and the method caller does not have ManagementPermission "control".
        See Also:
        ManagementPermission
      • setCollectionUsageThreshold

        void setCollectionUsageThreshold​(long threshold)
        Updates this memory pool to have a new value for its collection usage threshold. Only values of zero or greater should be supplied. A zero value effectively turns off any further checking of collection memory usage by the virtual machine. A value greater than zero establishes the new threshold which the virtual machine will check against after each run of the garbage collector in the memory pool.
        Parameters:
        threshold - the size of the new collection usage threshold expressed in bytes.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a collection usage threshold.
        IllegalArgumentException - if input value threshold is either negative or else is in excess of any maximum memory size that may have been defined for this memory pool.
        SecurityException - if there is a security manager active and the method caller does not have ManagementPermission"control".
      • setUsageThreshold

        void setUsageThreshold​(long threshold)
        Updates this memory pool to have a new value for its usage threshold. Only values of zero or greater should be supplied. A zero value effectively turns off any further checking of memory usage by the virtual machine. A value greater than zero establishes the new threshold which the virtual machine will check against.
        Parameters:
        threshold - the size of the new usage threshold expressed in bytes.
        Throws:
        UnsupportedOperationException - if the memory pool does not support a usage threshold.
        IllegalArgumentException - if input value threshold is either negative or else is in excess of any maximum memory size that may have been defined for this memory pool.
        SecurityException - if there is a security manager active and the method caller does not have ManagementPermission"control".