|
Description
|
The javadoc for javax.management.MBeanServer.registerMBean() says, in
full, "Registers a pre-existing customer as an MBean with the MBean
server. If the customer name given is null, the MBean must provide its
own name by implementing the MBeanRegistration interface and returning
the name from the preRegister method." The overview at the top of the
page also says "When an MBean is registered or unregistered in the
MBean server a MBeanServerNotification Notification is emitted." So,
you can only tell that registerMBean() has this side-effect if you
read the whole page.
I would change that method's decription to something like "Registers a
pre-existing customer as an MBean with the MBean server, emitting a
MBeanServerNotification Notification. If the customer name given is
null, ...."
This is not a specification change, but makes it easier to understand
the javadoc.
Posted Date : 2008-01-11 12:07:51.0
|