[cdi-dev] [JBoss JIRA] (CDI-173) Improve javadoc for event-firing methods

[Jozef Hartinger (Updated) (JIRA)]

     [ https://issues.jboss.org/browse/CDI-173?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Jozef Hartinger updated CDI-173:
--------------------------------

    Description: 
The spec says

{quote}Otherwise, the exception aborts processing of the event. No other observer methods of that event will be called. The
BeanManager.fireEvent() or Event.fire() method rethrows the exception. If the exception is a checked exception,
it is wrapped and rethrown as an (unchecked) ObserverException.{quote}

The JavaDoc for BM.fireEvent() and Event.fire() only mentions IllegalArgumentException. The fact that the ObserverException or any other unchecked exception raised by an observer method is rethrown should be mentioned.

  was:
The spec says

{quote}Otherwise, the exception aborts processing of the event. No other observer methods of that event will be called. The
BeanManager.fireEvent() or Event.fire() method rethrows the exception. If the exception is a checked exception,
it is wrapped and rethrown as an (unchecked) ObserverException.{quote}

The JavaDoc for BM.fireEvent() and Event.fire() only mentions IllegalArgumentException. The fact that the ObserverException or any other unchecked exception raised by an observer method should be mentioned.


    
> Improve javadoc for event-firing methods
> ----------------------------------------
>
>                 Key: CDI-173
>                 URL: https://issues.jboss.org/browse/CDI-173
>             Project: CDI Specification Issues
>          Issue Type: Feature Request
>          Components: Javadoc and API
>    Affects Versions: 1.0
>            Reporter: Jozef Hartinger
>            Priority: Minor
>             Fix For: 1.1 (Proposed)
>
>
> The spec says
> {quote}Otherwise, the exception aborts processing of the event. No other observer methods of that event will be called. The
> BeanManager.fireEvent() or Event.fire() method rethrows the exception. If the exception is a checked exception,
> it is wrapped and rethrown as an (unchecked) ObserverException.{quote}
> The JavaDoc for BM.fireEvent() and Event.fire() only mentions IllegalArgumentException. The fact that the ObserverException or any other unchecked exception raised by an observer method is rethrown should be mentioned.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira