de.aristaflow.adept2.util.threading

Interface ThrowableCreatingCallable<V,T extends java.lang.Throwable>

Type Parameters:

V - The type of result of the method to call.

T - The type of the throwable to be created.

All Superinterfaces:

java.util.concurrent.Callable<V>

public interface ThrowableCreatingCallable<V,T extends java.lang.Throwable>
extends java.util.concurrent.Callable<V>

This interface encapsulates the creation of a new throwable based on an occurred throwable. The purpose is to create a new throwable replacing the occurred throwable because the occurred throwable may refer to a class that is not available where the throwable is handled. For instance JDBC exceptions may be specific to a driver. If these occur at the server, they usually cannot reach the client since a client does not have any class from the driver and therefore also not the exception class. When replacing the throwable, the log level can be set to use for the exception. This prevents minor exceptions from being logged as severe.

Method Summary

Modifier and Type	Method and Description
Pair<? extends T,java.util.logging.Level>	replaceThrowable(java.lang.String msg, java.lang.Throwable thrown) Creates a new throwable replacing the designated throwable.

Methods inherited from interface java.util.concurrent.Callable

call

Method Detail

replaceThrowable

Pair<? extends T,java.util.logging.Level> replaceThrowable(java.lang.String msg,
                                                           java.lang.Throwable thrown)

Creates a new throwable replacing the designated throwable. Usually you should use the designated message for the created throwable.

You must not re-use or wrap the designated throwable! This is allowing to differentiate the replacing throwable. But make sure the replacing throwable is compatible to all possible clients calling the actual method.

Parameters:

msg - The message that should be used for the created replacing throwable.

thrown - The occurred throwable that should be replaced by a different one. You must not re-use or wrap this in the replacing throwable.

Returns:

A new throwable replacing the designated one. Make that it is compatible to all possible clients calling the actual method. Additionally, the log level to use for the exception can be returned. If the log level is null, Level.SEVERE will be used.