JDK-6204552 : EventHandler documentation and exception handling problems
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.beans
  • Affected Version: 1.4.0,5.0,6
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: linux,linux_redhat_9.0,solaris_7
  • CPU: x86,sparc
  • Submitted: 2004-12-06
  • Updated: 2017-05-16
  • Resolved: 2005-01-15
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 6
6 b20Fixed
Related Reports
Duplicate :  
Duplicate :  
Relates :  
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
06-12-2004