Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 6649542
Votes 0
Synopsis Document explicitly in registerMBean etc that MBeanServerNotification is emitted
Category jmx:doc
Reported Against
Release Fixed 7(b26)
State 10-Fix Delivered, request for enhancement
Priority: 4-Low
Related Bugs 6677903
Submit Date 11-JAN-2008
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
Work Around
N/A
Evaluation
A simple clarification which will make it easier for new users of the API to find out about MBeanServerNotification.
Posted Date : 2008-01-11 12:07:51.0
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang