Package org.infinispan.jmx

Class CacheManagerJmxRegistration

  • All Implemented Interfaces:
    ObjectNameKeys
    public final class CacheManagerJmxRegistration
extends java.lang.Object
    Registers all the components from global component registry to the mbean server.
    Since:
    4.0
    Author:
    Mircea.Markus@jboss.com, Galder Zamarreño

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getDomain()
      Gets the domain name.
      java.lang.String getGroupName()
      Gets the group name.
      javax.management.MBeanServer getMBeanServer()
      Gets the MBean server.
      protected java.lang.String initGroup()
      Subclasses must implement this hook to initialize groupName during start.
      javax.management.ObjectName registerExternalMBean​(java.lang.Object managedComponent, java.lang.String groupName)
      Registers a MBean, but does not track it to perform automatic unregistration on stop.
      void registerMBean​(java.lang.Object managedComponent)
      Registers a MBean (and tracks it to perform automatic unregistration on stop).
      void registerMBean​(java.lang.Object managedComponent, java.lang.String groupName)
      Registers a MBean (and tracks it to perform automatic unregistration on stop).
      void start()
      Looks up the MBean server and initializes domain and group.
      void stop()
      Unregisters the MBeans that were registered on start.
      void unregisterMBean​(javax.management.ObjectName objectName)
      Unregisters the MBean located under the given ObjectName, if it exists.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • CacheManagerJmxRegistration

        public CacheManagerJmxRegistration()

    • Method Detail

      • initGroup

        protected java.lang.String initGroup()
        Subclasses must implement this hook to initialize groupName during start.

      • start

        public void start()
        Looks up the MBean server and initializes domain and group. Overriders must ensure they call super.

      • stop

        public void stop()
        Unregisters the MBeans that were registered on start. Overriders must ensure they call super.

      • getDomain

        public final java.lang.String getDomain()
        Gets the domain name. This should not be called unless JMX is enabled.

      • getGroupName

        public final java.lang.String getGroupName()
        Gets the group name. This should not be called unless JMX is enabled.

      • getMBeanServer

        public final javax.management.MBeanServer getMBeanServer()
        Gets the MBean server. This should not be called unless JMX is enabled.

      • registerExternalMBean

        public javax.management.ObjectName registerExternalMBean​(java.lang.Object managedComponent,
                                                         java.lang.String groupName)
                                                  throws java.lang.Exception
        Registers a MBean, but does not track it to perform automatic unregistration on stop. The caller is expected to perform unregistration using the returned ObjectName.
        Throws:
        java.lang.Exception

      • registerMBean

        public void registerMBean​(java.lang.Object managedComponent)
                   throws java.lang.Exception
        Registers a MBean (and tracks it to perform automatic unregistration on stop). This method should be used for components that are registered after the startup of the component registry and did not get registered automatically.
        Throws:
        java.lang.Exception

      • registerMBean

        public void registerMBean​(java.lang.Object managedComponent,
                          java.lang.String groupName)
                   throws java.lang.Exception
        Registers a MBean (and tracks it to perform automatic unregistration on stop). This method should be used only for components that are registered after the startup of the component registry and did not get registered automatically.
        Throws:
        java.lang.Exception

      • unregisterMBean

        public void unregisterMBean​(javax.management.ObjectName objectName)
                     throws java.lang.Exception
        Unregisters the MBean located under the given ObjectName, if it exists.
        Parameters:
        objectName - ObjectName where the MBean is registered
        Throws:
        java.lang.Exception - If unregistration could not be completed.