United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-6204552 : EventHandler documentation and exception handling problems

Details
Type:
Bug
Submit Date:
2004-12-06
Status:
Resolved
Updated Date:
2010-04-02
Project Name:
JDK
Resolved Date:
2005-01-15
Component:
client-libs
OS:
linux_redhat_9.0,solaris_7,linux
Sub-Component:
java.beans
CPU:
x86,sparc
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.0,5.0,6
Fixed Versions:

Related Reports
Duplicate:
Duplicate:
Relates:

Sub Tasks

Description
EventHandler's documentation of the 'eventPropertyName' argument is not clear on what it supports.  Additionally EventHandler does not document what will happen with null args.
###@###.### 2004-12-06 17:48:02 GMT

                                    

Comments
EVALUATION

Yep.
EventHandler should better document the possibilities for the 'eventPropertyName' argument.
Currently EventHandler does not enforce valid arguments.  The 'target', 'action' and 'listenerInterface' arguments need to be non-null for it to work correctly.  The constructor and create method will now check these arguments and immediately throw an IllegalArgumentException if any are null.
###@###.### 2004-12-06 17:50:44 GMT

Also, I've determined through trial and error that specifying "" for the eventPropertyName causes the whole event to be passed to the target action. I think this is useful behavior, but we need to document it.
###@###.### 2004-12-06 18:08:22 GMT

The spec changes will cover what 'eventPropertyName' is capable of, as well as that target/action/listenerInterface need to be non-null.
###@###.### 2004-12-06 21:42:00 GMT

The documentation has been updated appropriately and a NullPointerException will be thrown from the create and constructor methods.
###@###.### 2004-12-17 20:34:46 GMT
                                     
2004-12-06



Hardware and Software, Engineered to Work Together