Please refer to 6337679 for the context.
Basically, the javadoc should explicitely say the use of DescriptorKey for an MBean interface is considered only for that interface and not for its super interface, if any.
The javadoc might also say how DescriptorKey use within an MBean interface (on getter/setter/operation) is handled; Foo implements FooMBean and FooMBean extends Fooliest:
- if the annotated method is defined only in the MBean super interface (Fooliest), then DescriptorKey is considered,
- if the annotated method is defined both in interface and super interface, only the use in the interface is considered.