[concurrency-interest] More Javadoc problems

cowwoc cowwoc at bbs.darktech.org
Fri Dec 19 17:47:22 EST 2014


On 19/12/2014 5:15 PM, Peter Levart wrote:
>
> On 12/19/2014 10:30 PM, cowwoc wrote:
>> On 19/12/2014 4:10 PM, Peter Levart wrote:
>>> If you want to change the exceptional OR nonexceptional outcome of 
>>> preceeding stage, then use handle() instead of whenComplete().
>>
>> I can't.
>>
>> If you handle() and attempt to re-throw the same exception, you will get:
>>
>>     unreported exception Throwable; must be caught or declared to be 
>> thrown
>
> This problem has been discussed before on the list. See here:
>
> http://cs.oswego.edu/pipermail/concurrency-interest/2014-August/012907.html
>
> The basic principle is to wrap the Throwable as a cause into a 
> CompletionException.

This is very useful, but why is this not documented in the Javadoc? It 
could be mentioned after (or as part of) the last bullet item in the 
class-level Javadoc.

I highly doubt anyone else will run into the aforementioned mailing list 
post. This information should be easier to find.

Thanks,
Gili
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://cs.oswego.edu/pipermail/concurrency-interest/attachments/20141219/9272569d/attachment.html>


More information about the Concurrency-interest mailing list