OpenJDK 27 · com.sun.jmx.mbeanserver.DefaultMXBeanMappingFactory

A converter between Java types and the limited set of classes defined by Open MBeans.

A Java type is an instance of java.lang.reflect.Type. For our purposes, it is either a Class, such as String.class or int.class; or a ParameterizedType, such as List<String> or Map<Integer, String[]>. On J2SE 1.4 and earlier, it can only be a Class.

Each Type is associated with an DefaultMXBeanMappingFactory. The DefaultMXBeanMappingFactory defines an OpenType corresponding to the Type, plus a Java class corresponding to the OpenType. For example:

Type                     Open class     OpenType
 ----                     ----------     --------
 Integer                  Integer        SimpleType.INTEGER
 int                      int            SimpleType.INTEGER
 Integer[]                Integer[]      ArrayType(1, SimpleType.INTEGER)
 int[]                    Integer[]      ArrayType(SimpleType.INTEGER, true)
 String[][]               String[][]     ArrayType(2, SimpleType.STRING)
 List<String>             String[]       ArrayType(1, SimpleType.STRING)
 ThreadState (an Enum)    String         SimpleType.STRING
 Map<Integer, String[]>   TabularData    TabularType(
                                         CompositeType(
                                           {"key", SimpleType.INTEGER},
                                           {"value",
                                             ArrayType(1,
                                              SimpleType.STRING)}),
                                         indexNames={"key"})

Apart from simple types, arrays, and collections, Java types are converted through introspection into CompositeType. The Java type must have at least one getter (method such as "int getSize()" or "boolean isBig()"), and we must be able to deduce how to reconstruct an instance of the Java class from the values of the getters using one of various heuristics.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	DefaultMXBeanMappingFactory.ArrayMapping
private static class	DefaultMXBeanMappingFactory.CollectionMapping
private abstract static class	DefaultMXBeanMappingFactory.CompositeBuilder Converts from a CompositeData to an instance of the targetClass.
private static class	DefaultMXBeanMappingFactory.CompositeBuilderCheckGetters This builder never actually returns success.
private static class	DefaultMXBeanMappingFactory.CompositeBuilderViaConstructor Builder for when the target class has a constructor that is annotated with @ConstructorParameters or `@ConstructorProperties` so we can see the correspondence to getters.
private static class	DefaultMXBeanMappingFactory.CompositeBuilderViaFrom Builder for when the target class has a method "public static from(CompositeData)".
private static class	DefaultMXBeanMappingFactory.CompositeBuilderViaProxy Builder for when the target class is an interface and contains no methods other than getters.
private static class	DefaultMXBeanMappingFactory.CompositeBuilderViaSetters Builder for when the target class has a setter for every getter.
private static class	DefaultMXBeanMappingFactory.CompositeMapping
private static class	DefaultMXBeanMappingFactory.EnumMapping<T extends Enum<T>>
private static class	DefaultMXBeanMappingFactory.IdentityMapping
private static class	DefaultMXBeanMappingFactory.Mappings
private static class	DefaultMXBeanMappingFactory.MXBeanRefMapping
pack-priv abstract static class	DefaultMXBeanMappingFactory.NonNullMXBeanMapping
private static class	DefaultMXBeanMappingFactory.RecordCompositeBuilder Builder for when the target class is a record
private static class	DefaultMXBeanMappingFactory.TabularMapping

Field Summary

Modifier and Type	Field and Description
private static final Map<Type, Type>	inProgress
private static final String[]	keyArray
private static final String[]	keyValueArray
private static final DefaultMXBeanMappingFactory.Mappings	mappings
private static final List<MXBeanMapping>	permanentMappings Following List simply serves to keep a reference to predefined MXBeanMappings so they don't get garbage collected.

Inherited from com.sun.jmx.mbeanserver.MXBeanMappingFactory:: DEFAULT

Constructor Summary

Access	Constructor and Description
public	DefaultMXBeanMappingFactory()

Method Summary

Modifier and Type	Method and Description
pack-priv static String	capitalize(String name) Reverse operation for java.beans.Introspector.decapitalize.
public static String	Returns: The decapitalized version of the string. decapitalize(String The string to be decapitalized. name) Utility method to take a string and convert it to normal Java variable name capitalization.
private static synchronized MXBeanMapping	getMapping(Type type)
pack-priv static InvalidObjectException	invalidObjectException(String msg, Throwable cause)
pack-priv static InvalidObjectException	invalidObjectException(Throwable cause)
pack-priv static boolean	isIdentity(MXBeanMapping mapping)
private MXBeanMapping	makeArrayOrCollectionMapping(Type collectionType, Type elementType, MXBeanMappingFactory factory)
private MXBeanMapping	makeCompositeMapping(Class<?> c, MXBeanMappingFactory factory)
private static <T extends Enum<T>> MXBeanMapping	makeEnumMapping(Class<?> enumClass, Class<T> fake)
private MXBeanMapping	makeMapping(Type objType, MXBeanMappingFactory factory)
private static MXBeanMapping	makeMXBeanRefMapping(Type t)
private MXBeanMapping	makeParameterizedTypeMapping(ParameterizedType objType, MXBeanMappingFactory factory)
private MXBeanMapping	makeTabularMapping(Type objType, boolean sortedMap, Type keyType, Type valueType, MXBeanMappingFactory factory)
public synchronized MXBeanMapping	mappingForType(Type objType, MXBeanMappingFactory factory) Implements abstract com.sun.jmx.mbeanserver.MXBeanMappingFactory.mappingForType. Get the converter for the given Java type, creating it if necessary.
pack-priv static void	mustBeComparable(Class<?> collection, Type element)
pack-priv static OpenDataException	openDataException(String msg, Throwable cause)
pack-priv static OpenDataException	openDataException(Throwable cause)
public static String	propertyName(Method m)
private static synchronized void	putMapping(Type type, MXBeanMapping mapping)
private static synchronized void	putPermanentMapping(Type type, MXBeanMapping mapping)

public Class DefaultMXBeanMappingFactory

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary