com.jcabi.log

Class VerboseCallable<T>

java.lang.Object

com.jcabi.log.VerboseCallable<T>

All Implemented Interfaces:

Callable<T>

public final class VerboseCallable<T>
extends Object
implements Callable<T>

Wrapper of Callable, that logs all uncaught runtime exceptions.

You can use it with scheduled executor, for example:

 Executors.newFixedThreadPool(1).submit(
   new VerboseCallable(callable, true)
 );

Now, every runtime exception that is not caught inside your Callable will be reported to log (using Logger). Two-arguments constructor can be used when you need to instruct the class about what to do with the exception: either swallow it or escalate. Sometimes it's very important to swallow exceptions. Otherwise an entire thread may get stuck (like in the example above).

This class is thread-safe.

Since:

0.16

Version:

$Id: d2cb7c735555e40a04b9a6ae9621e754a8c40e05 $

Author:

Yegor Bugayenko (yegor@teamed.io)

See Also:

VerboseThreads

Constructor Summary

Constructors

Constructor and Description
VerboseCallable(Callable<T> callable) Default constructor, doesn't swallow exceptions.
VerboseCallable(Callable<T> callable, boolean swallow) Default constructor, doesn't swallow exceptions.
VerboseCallable(Callable<T> callable, boolean swallow, boolean vrbs) Default constructor, with fully configurable behavior.
VerboseCallable(Runnable runnable, boolean swallow) Default constructor, with configurable behavior for exceptions.
VerboseCallable(Runnable runnable, boolean swallow, boolean vrbs) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
T	call()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VerboseCallable

public VerboseCallable(Callable<T> callable)

Default constructor, doesn't swallow exceptions.

Parameters:

callable - Callable to wrap

VerboseCallable

public VerboseCallable(Callable<T> callable,
               boolean swallow)

Default constructor, doesn't swallow exceptions.

Parameters:

callable - Callable to wrap

swallow - Shall we swallow exceptions (TRUE) or re-throw (FALSE)? Exception swallowing means that call() will never throw any exceptions (in any case all exceptions are logged using Logger.

VerboseCallable

public VerboseCallable(Runnable runnable,
               boolean swallow,
               boolean vrbs)

Default constructor.

Parameters:

runnable - Runnable to wrap

swallow - Shall we swallow exceptions (TRUE) or re-throw (FALSE)? Exception swallowing means that call() will never throw any exceptions (in any case all exceptions are logged using Logger.

vrbs - Shall we report the entire stacktrace of the exception (TRUE) or just its message in one line (FALSE)

VerboseCallable

public VerboseCallable(Runnable runnable,
               boolean swallow)

Default constructor, with configurable behavior for exceptions.

Parameters:

runnable - Runnable to wrap

swallow - Shall we swallow exceptions (TRUE) or re-throw (FALSE)? Exception swallowing means that call() will never throw any exceptions (in any case all exceptions are logged using Logger.

VerboseCallable

public VerboseCallable(Callable<T> callable,
               boolean swallow,
               boolean vrbs)

Default constructor, with fully configurable behavior.

Parameters:

callable - Runnable to wrap

swallow - Shall we swallow exceptions (TRUE) or re-throw (FALSE)? Exception swallowing means that call() will never throw any exceptions (in any case all exceptions are logged using Logger.

vrbs - Shall we report the entire stacktrace of the exception (TRUE) or just its message in one line (FALSE)

Method Detail

call

public T call()
       throws Exception

We catch RuntimeException and Error here. All other types of exceptions are "checked exceptions" and won't be thrown out of Callable@call() method.

Specified by:

call in interface Callable<T>

Throws:

Exception