Package com.sun.enterprise.admin.util.jmx

Class AttributeListUtils

  • public class AttributeListUtils
extends Object
    A class that has some useful utility methods to deal with
    • Jmx Attributes
    • Jmx AttributeLists.
    It is expected to enhance this class with more utility methods.
    Since:
    Sun Java System Application Server 8
    Author:
    [email protected]

    • Method Detail

      • containsNamedAttribute

        public static boolean containsNamedAttribute​(AttributeList al,
                                             String name)
        Checks whether this list contains a JMX Attribute with given name. Note that this method will return true if there is at least one attribute with given name.
        Parameters:
        al - an instance of AttributeList
        name - a String representing the name of the attribute. The name may not be null.
        Returns:
        true if there is at least one attribute in the list with given name, false otherwise
        Throws:
        IllegalArgumentException - if the attribute list or name is null

      • containsNamedAttribute

        public static boolean containsNamedAttribute​(AttributeList al,
                                             Attribute a)
        Checks whether an attribute with the name same as that of the given attribute exists in this list. The given name may not be null.
        Parameters:
        al - an instance of AttributeList
        a - an Attribute with a name and a value
        Returns:
        true if there exists at least one attribute with same name, false otherwise
        Throws:
        IllegalArgumentException - if the attribute list or name is null

      • asNameMap

        public static Map asNameMap​(AttributeList al)
        Returns the given list as a map of attributes, keyed on the names of the attribute in the list. The passed argument may not be null. The mappings are between the names of attributes and attributes themselves.
        Parameters:
        al - the list of attributes that need to be mapped
        Returns:
        an instance of Map
        Throws:
        IllegalArgumentException - if the argument is null

      • toJmx12Attribute

        public static String toJmx12Attribute​(String name)
        JMX 1.2 specification had a weird limitation that a Dynamic MBean may not have an attribute whose name is not a valid Java identifier . This method is a utility method to convert the any arbitrary name into a String that can be a valid JMX 1.2 attribute. Every character in the string passed that is neither a Character.isJavaIdentifierStart nor a Character.isJavaIdentifierPart is replace with a valid character '_'.
        Parameters:
        name - a String that represents any non null name
        Returns:
        a String that represents a name valid for a JMX 1.2 MBean.
        Throws:
        IllegalArgumentException - if the parameter is null or is of zero length

      • toString

        public static String toString​(AttributeList al)
        Returns a String representation of an attribute list such that:
        • Each attribute is a name and value separated by a ','. toString() on the value is called.
        • Each pair is separated by a new line character '\n'.
        Parameters:
        al - the list of attributes - may be null, in which case an empty String is returned.
        Returns:
        a String representing the parameter passed

      • dash2CamelCase

        public static String dash2CamelCase​(String dashed)