Package groovy.jmx

Class GroovyMBean

java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.jmx.GroovyMBean
All Implemented Interfaces:
GroovyObject

public class GroovyMBean
extends GroovyObjectSupport
A GroovyObject facade for an underlying MBean which acts like a normal groovy object but which is actually implemented via an underlying JMX MBean. Properties and normal method invocations delegate to the MBeanServer to the actual MBean.
  • Constructor Summary

    Constructors
    Constructor Description
    GroovyMBean​(javax.management.MBeanServerConnection server, java.lang.String objectName)  
    GroovyMBean​(javax.management.MBeanServerConnection server, java.lang.String objectName, boolean ignoreErrors)  
    GroovyMBean​(javax.management.MBeanServerConnection server, javax.management.ObjectName name)  
    GroovyMBean​(javax.management.MBeanServerConnection server, javax.management.ObjectName name, boolean ignoreErrors)  
  • Method Summary

    Modifier and Type Method Description
    protected java.lang.String createOperationKey​(java.lang.String operation, int params)
    Construct a simple key based on the method name and the number of parameters
    protected java.lang.String[] createSignature​(javax.management.MBeanOperationInfo info)  
    java.lang.String describeAttribute​(java.lang.String attributeName)
    Description of the specified attribute name.
    protected java.lang.String describeAttribute​(javax.management.MBeanAttributeInfo attr)
    Description of the specified attribute name.
    java.util.List<java.lang.String> describeOperation​(java.lang.String operationName)
    Get the description of the specified operation.
    protected java.lang.String describeOperation​(javax.management.MBeanOperationInfo operation)
    Description of the operation.
    java.lang.Object getProperty​(java.lang.String property)
    Retrieves a property value.
    javax.management.MBeanInfo info()  
    java.lang.Object invokeMethod​(java.lang.String method, java.lang.Object arguments)
    Invokes the given method.
    java.util.Collection<java.lang.String> listAttributeDescriptions()
    List of string representations of all of the attributes on the MBean.
    java.util.Collection<java.lang.String> listAttributeNames()
    List of the names of each of the attributes on the MBean
    java.util.List<java.lang.String> listAttributeValues()
    The values of each of the attributes on the MBean
    java.util.Collection<java.lang.String> listOperationDescriptions()
    Description of all of the operations available on the MBean.
    java.util.Collection<java.lang.String> listOperationNames()
    Names of all the operations available on the MBean.
    javax.management.ObjectName name()  
    javax.management.MBeanServerConnection server()  
    void setProperty​(java.lang.String property, java.lang.Object value)
    Sets the given property to the new value.
    java.lang.String toString()
    Return an end user readable representation of the underlying MBean

    Methods inherited from class groovy.lang.GroovyObjectSupport

    getMetaClass, setMetaClass

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • GroovyMBean

      public GroovyMBean​(javax.management.MBeanServerConnection server, java.lang.String objectName) throws javax.management.JMException, java.io.IOException
      Throws:
      javax.management.JMException
      java.io.IOException
    • GroovyMBean

      public GroovyMBean​(javax.management.MBeanServerConnection server, java.lang.String objectName, boolean ignoreErrors) throws javax.management.JMException, java.io.IOException
      Throws:
      javax.management.JMException
      java.io.IOException
    • GroovyMBean

      public GroovyMBean​(javax.management.MBeanServerConnection server, javax.management.ObjectName name) throws javax.management.JMException, java.io.IOException
      Throws:
      javax.management.JMException
      java.io.IOException
    • GroovyMBean

      public GroovyMBean​(javax.management.MBeanServerConnection server, javax.management.ObjectName name, boolean ignoreErrors) throws javax.management.JMException, java.io.IOException
      Throws:
      javax.management.JMException
      java.io.IOException
  • Method Details

    • server

      public javax.management.MBeanServerConnection server()
    • name

      public javax.management.ObjectName name()
    • info

      public javax.management.MBeanInfo info()
    • getProperty

      public java.lang.Object getProperty​(java.lang.String property)
      Description copied from interface: GroovyObject
      Retrieves a property value.
      Parameters:
      property - the name of the property of interest
      Returns:
      the given property
    • setProperty

      public void setProperty​(java.lang.String property, java.lang.Object value)
      Description copied from interface: GroovyObject
      Sets the given property to the new value.
      Parameters:
      property - the name of the property of interest
      value - the new value for the property
    • invokeMethod

      public java.lang.Object invokeMethod​(java.lang.String method, java.lang.Object arguments)
      Description copied from interface: GroovyObject
      Invokes the given method.
      Parameters:
      method - the name of the method to call
      arguments - the arguments to use for the method call
      Returns:
      the result of invoking the method
    • createSignature

      protected java.lang.String[] createSignature​(javax.management.MBeanOperationInfo info)
    • createOperationKey

      protected java.lang.String createOperationKey​(java.lang.String operation, int params)
      Construct a simple key based on the method name and the number of parameters
      Parameters:
      operation - - the mbean operation name
      params - - the number of parameters the operation supports
      Returns:
      simple unique identifier for a method
    • listAttributeNames

      public java.util.Collection<java.lang.String> listAttributeNames()
      List of the names of each of the attributes on the MBean
      Returns:
      list of attribute names
    • listAttributeValues

      public java.util.List<java.lang.String> listAttributeValues()
      The values of each of the attributes on the MBean
      Returns:
      list of values of each attribute
    • listAttributeDescriptions

      public java.util.Collection<java.lang.String> listAttributeDescriptions()
      List of string representations of all of the attributes on the MBean.
      Returns:
      list of descriptions of each attribute on the mbean
    • describeAttribute

      protected java.lang.String describeAttribute​(javax.management.MBeanAttributeInfo attr)
      Description of the specified attribute name.
      Parameters:
      attr - - the attribute
      Returns:
      String the description
    • describeAttribute

      public java.lang.String describeAttribute​(java.lang.String attributeName)
      Description of the specified attribute name.
      Parameters:
      attributeName - - stringified name of the attribute
      Returns:
      the description
    • listOperationNames

      public java.util.Collection<java.lang.String> listOperationNames()
      Names of all the operations available on the MBean.
      Returns:
      all the operations on the MBean
    • listOperationDescriptions

      public java.util.Collection<java.lang.String> listOperationDescriptions()
      Description of all of the operations available on the MBean.
      Returns:
      full description of each operation on the MBean
    • describeOperation

      public java.util.List<java.lang.String> describeOperation​(java.lang.String operationName)
      Get the description of the specified operation. This returns a Collection since operations can be overloaded and one operationName can have multiple forms.
      Parameters:
      operationName - the name of the operation to describe
      Returns:
      Collection of operation description
    • describeOperation

      protected java.lang.String describeOperation​(javax.management.MBeanOperationInfo operation)
      Description of the operation.
      Parameters:
      operation - the operation to describe
      Returns:
      pretty-printed description
    • toString

      public java.lang.String toString()
      Return an end user readable representation of the underlying MBean
      Overrides:
      toString in class java.lang.Object
      Returns:
      the user readable description