org.cthul.resolve

Class ResolvingException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.cthul.resolve.ResolvingException

All Implemented Interfaces:

Serializable, RResponse

public class ResolvingException
extends RuntimeException
implements RResponse

Wraps exceptions that occurred during resource lookup. Especially intended for checked exceptions.

Can be used as a return value to indicate non-critical exceptions. However, in most cases it will be more efficient to obtain a ResponseBuilder.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ResolvingException()
ResolvingException(RRequest request)
ResolvingException(RRequest request, String message)
ResolvingException(RRequest request, String message, Throwable cause)
ResolvingException(RRequest request, Throwable cause)
ResolvingException(String message)
ResolvingException(String message, Throwable cause)
ResolvingException(Throwable cause)

Method Summary

Modifier and Type	Method and Description
<T1 extends Throwable> RuntimeException	againAs(Class<T1> t1) Throws the cause if it is the specified type, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable> RuntimeException	againAs(Class<T1> t1, Class<T2> t2) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable,T3 extends Throwable> RuntimeException	againAs(Class<T1> t1, Class<T2> t2, Class<T3> t3) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable,T3 extends Throwable,T4 extends Throwable> RuntimeException	againAs(Class<T1> t1, Class<T2> t2, Class<T3> t3, Class<T4> t4) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
ResolvingException	asException() Represents the warnings as single exception.
RuntimeException	asRuntimeException() If the cause is a RuntimeException, returns the cause, otherwise returns this.
RRequest	getRequest() Returns the request that was responded to.
Throwable	getResolvingCause() Returns the underlying cause of this resolving exceptions.
RResult	getResult() Returns result if present, otherwise throws RResponse.asException().
List<Exception>	getWarningsLog() Returns a list of non-critical exceptions that occurred during look-up.
boolean	hasResult() Returns true if look-up found a result.
<T1 extends Throwable> RuntimeException	throwIf(Class<T1> t1) Throws the cause if it is the specified type, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable> RuntimeException	throwIf(Class<T1> t1, Class<T2> t2) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable,T3 extends Throwable> RuntimeException	throwIf(Class<T1> t1, Class<T2> t2, Class<T3> t3) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
<T1 extends Throwable,T2 extends Throwable,T3 extends Throwable,T4 extends Throwable> RuntimeException	throwIf(Class<T1> t1, Class<T2> t2, Class<T3> t3, Class<T4> t4) Throws the cause if it is one of the specified types, otherwise returns a runtime exception.
static ResolvingException	wrap(Exception e) Wraps e in an resolving exception, if it isn't one already.
static ResolvingException	wrap(RRequest request, Exception e) Wraps e in an resolving exception, if it isn't one already.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ResolvingException

public ResolvingException()

ResolvingException

public ResolvingException(String message)

ResolvingException

public ResolvingException(Throwable cause)

ResolvingException

public ResolvingException(String message,
                          Throwable cause)

ResolvingException

public ResolvingException(RRequest request)

ResolvingException

public ResolvingException(RRequest request,
                          String message)

ResolvingException

public ResolvingException(RRequest request,
                          String message,
                          Throwable cause)

ResolvingException

public ResolvingException(RRequest request,
                          Throwable cause)

Method Detail

wrap

public static ResolvingException wrap(Exception e)

Wraps e in an resolving exception, if it isn't one already.

Parameters:

e -

Returns:

resolving exception

wrap

public static ResolvingException wrap(RRequest request,
                                      Exception e)

Wraps e in an resolving exception, if it isn't one already.

Parameters:

request -

e -

Returns:

resolving exception

getRequest

public RRequest getRequest()

Description copied from interface: RResponse

Returns the request that was responded to.

Specified by:

getRequest in interface RResponse

Returns:

request

hasResult

public boolean hasResult()

Description copied from interface: RResponse

Returns true if look-up found a result.

Specified by:

hasResult in interface RResponse

Returns:

true if result is present

getResult

public RResult getResult()

Description copied from interface: RResponse

Returns result if present, otherwise throws RResponse.asException().

Specified by:

getResult in interface RResponse

Returns:

result

asException

public ResolvingException asException()

Description copied from interface: RResponse

Represents the warnings as single exception. Returns null if result is present and no warnings occurred.

Specified by:

asException in interface RResponse

Returns:

resolving exception

getWarningsLog

public List<Exception> getWarningsLog()

Description copied from interface: RResponse

Returns a list of non-critical exceptions that occurred during look-up.

Specified by:

getWarningsLog in interface RResponse

Returns:

list of exceptions.

asRuntimeException

public RuntimeException asRuntimeException()

If the cause is a RuntimeException, returns the cause, otherwise returns this.

Returns:

runtime exception.

againAs

public <T1 extends Throwable> RuntimeException againAs(Class<T1> t1)
                                                throws T1 extends Throwable

Throws the cause if it is the specified type, otherwise returns a runtime exception.

Intended to be written as throw e.againAs(IOException.class).

Type Parameters:

T1 -

Parameters:

t1 -

Returns:

Throws:

T1

T1 extends Throwable

againAs

public <T1 extends Throwable,T2 extends Throwable> RuntimeException againAs(Class<T1> t1,
                                                                            Class<T2> t2)
                                                                     throws T1 extends Throwable,
                                                                            T2 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Intended to be written as throw e.againAs(IOException.class).

Type Parameters:

T1 -

T2 -

Parameters:

t1 -

t2 -

Returns:

runtime exception

Throws:

T1

T2

T1 extends Throwable

againAs

public <T1 extends Throwable,T2 extends Throwable,T3 extends Throwable> RuntimeException againAs(Class<T1> t1,
                                                                                                 Class<T2> t2,
                                                                                                 Class<T3> t3)
                                                                                          throws T1 extends Throwable,
                                                                                                 T2 extends Throwable,
                                                                                                 T3 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Intended to be written as throw e.againAs(IOException.class).

Type Parameters:

T1 -

T2 -

T3 -

Parameters:

t1 -

t2 -

t3 -

Returns:

runtime exception

Throws:

T1

T2

T3

T1 extends Throwable

againAs

public <T1 extends Throwable,T2 extends Throwable,T3 extends Throwable,T4 extends Throwable> RuntimeException againAs(Class<T1> t1,
                                                                                                                      Class<T2> t2,
                                                                                                                      Class<T3> t3,
                                                                                                                      Class<T4> t4)
                                                                                                               throws T1 extends Throwable,
                                                                                                                      T2 extends Throwable,
                                                                                                                      T3 extends Throwable,
                                                                                                                      T4 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Intended to be written as throw e.againAs(IOException.class).

Type Parameters:

T1 -

T2 -

T3 -

T4 -

Parameters:

t1 -

t2 -

t3 -

t4 -

Returns:

runtime exception

Throws:

T1

T2

T3

T4

T1 extends Throwable

throwIf

public <T1 extends Throwable> RuntimeException throwIf(Class<T1> t1)
                                                throws T1 extends Throwable

Throws the cause if it is the specified type, otherwise returns a runtime exception.

Type Parameters:

T1 -

Parameters:

t1 -

Returns:

runtime exception

Throws:

T1

T1 extends Throwable

throwIf

public <T1 extends Throwable,T2 extends Throwable> RuntimeException throwIf(Class<T1> t1,
                                                                            Class<T2> t2)
                                                                     throws T1 extends Throwable,
                                                                            T2 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Type Parameters:

T1 -

T2 -

Parameters:

t1 -

t2 -

Returns:

runtime exception

Throws:

T1

T2

T1 extends Throwable

throwIf

public <T1 extends Throwable,T2 extends Throwable,T3 extends Throwable> RuntimeException throwIf(Class<T1> t1,
                                                                                                 Class<T2> t2,
                                                                                                 Class<T3> t3)
                                                                                          throws T1 extends Throwable,
                                                                                                 T2 extends Throwable,
                                                                                                 T3 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Type Parameters:

T1 -

T2 -

T3 -

Parameters:

t1 -

t2 -

t3 -

Returns:

runtime exception

Throws:

T1

T2

T3

T1 extends Throwable

throwIf

public <T1 extends Throwable,T2 extends Throwable,T3 extends Throwable,T4 extends Throwable> RuntimeException throwIf(Class<T1> t1,
                                                                                                                      Class<T2> t2,
                                                                                                                      Class<T3> t3,
                                                                                                                      Class<T4> t4)
                                                                                                               throws T1 extends Throwable,
                                                                                                                      T2 extends Throwable,
                                                                                                                      T3 extends Throwable,
                                                                                                                      T4 extends Throwable

Throws the cause if it is one of the specified types, otherwise returns a runtime exception.

Type Parameters:

T1 -

T2 -

T3 -

T4 -

Parameters:

t1 -

t2 -

t3 -

t4 -

Returns:

runtime exception

Throws:

T1

T2

T3

T4

T1 extends Throwable

getResolvingCause

public Throwable getResolvingCause()

Returns the underlying cause of this resolving exceptions. Unpacks nested resolving exceptions if necessary.

Returns:

cause