[cal10n-dev] [JIRA] Created: (CAL-24) IMessageConveyor throws MessageConveyorException which it shouldn't

[Michael Osipov (JIRA)]

IMessageConveyor throws MessageConveyorException which it shouldn't
-------------------------------------------------------------------

                 Key: CAL-24
                 URL: http://jira.qos.ch/browse/CAL-24
             Project: CAL10N
          Issue Type: Bug
            Reporter: Michael Osipov
            Assignee: Ceki Gulcu


As you can see here: http://cal10n.qos.ch/xref/ch/qos/cal10n/IMessageConveyor.html#58
The interface mandates all implementors to optionally throw this exception. This design has tow flaws:

1. This exception is not documented in the JavaDocs
2. It extends the RuntimeException (unchecked exception), which indicates an unrecoverable state of the client.

Such exceptions should never be declared in the throws block since the client can't do anything about it.
See reference here: http://www.javapractices.com/topic/TopicAction.do?Id=129
and Joshua Bloch's great book: http://www.amazon.de/Effective-Java-Programming-Language-Guide/dp/0321356683/ref=sr_1_1?ie=UTF8&s=books-intl-de&qid=1285356616&sr=8-1-spell

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.qos.ch/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira