Exceptions (Apache Brooklyn)

java.lang.Object
- brooklyn.util.exceptions.Exceptions

public class Exceptions
extends java.lang.Object

Constructor Summary

Constructors
Constructor and Description

Exceptions()

Constructors
Constructor and Description
`Exceptions()`

Method Summary

Methods
Modifier and Type	Method and Description
`static java.lang.Throwable`	`collapse(java.lang.Throwable source)` creates (but does not throw) a new `PropagatedRuntimeException` whose message and cause are taken from the first _interesting_ element in the source
`static java.lang.Throwable`	`collapse(java.lang.Throwable source, boolean collapseCausalChain)` creates (but does not throw) a new `PropagatedRuntimeException` whose message is taken from the first _interesting_ element in the source, and optionally also the causal chain
`static java.lang.Throwable`	`collapseIncludingAllCausalMessages(java.lang.Throwable source)` as `collapse(Throwable)` but includes causal messages in the message as per `collapseTextIncludingAllCausalMessages(Throwable)`; use with care (limit once) as repeated usage can result in multiple copies of the same message
`static java.lang.String`	`collapseText(java.lang.Throwable t)` like `collapse(Throwable)` but returning a one-line message suitable for logging without traces
`static java.lang.String`	`collapseTextIncludingAllCausalMessages(java.lang.Throwable t)` normally `collapseText(Throwable)` will stop following causal chains when encountering an interesting exception with a message; this variant will continue to follow such causal chains, showing all messages.
`static java.lang.Throwable`	`create(java.util.Collection<? extends java.lang.Throwable> exceptions)` creates the given exception, but without propagating it, for use when caller will be wrapping
`static java.lang.RuntimeException`	`create(java.lang.String prefix, java.util.Collection<? extends java.lang.Throwable> exceptions)` creates the given exception, but without propagating it, for use when caller will be wrapping
`static java.lang.Throwable`	`getFirstInteresting(java.lang.Throwable throwable)` returns the first exception in the call chain which is not of common uninteresting types (ie excluding ExecutionException and PropagatedRuntimeExceptions); or the original throwable if all are uninteresting
`static <T extends java.lang.Throwable> T`	`getFirstThrowableOfType(java.lang.Throwable from, java.lang.Class<T> clazz)` returns the first exception of the given type, or null
`static boolean`	`isPrefixBoring(java.lang.Throwable t)` Returns whether this is throwable either known to be boring or to have an unuseful prefix; null is not boring.
`static java.lang.RuntimeException`	`propagate(java.util.Collection<? extends java.lang.Throwable> exceptions)`
`static java.lang.RuntimeException`	`propagate(java.lang.String prefix, java.util.Collection<? extends java.lang.Throwable> exceptions)`
`static java.lang.RuntimeException`	`propagate(java.lang.Throwable throwable)` Propagate a `Throwable` as a `RuntimeException`.
`static java.lang.RuntimeException`	`propagateCollapsed(java.lang.Throwable source)` Deprecated. since 0.7.0 same as `propagate(Throwable)`
`static void`	`propagateIfFatal(java.lang.Throwable throwable)` Propagate exceptions which are fatal.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Exceptions
```
public Exceptions()
```
- Method Detail
  - isPrefixBoring
```
public static boolean isPrefixBoring(java.lang.Throwable t)
```
    Returns whether this is throwable either known to be boring or to have an unuseful prefix; null is *not* boring.
  - propagate
```
public static java.lang.RuntimeException propagate(java.lang.Throwable throwable)
```
    Propagate a Throwable as a RuntimeException.
    Like Guava Throwables.propagate(Throwable) but:
  - throws RuntimeInterruptedException to handle InterruptedExceptions; and
  - wraps as PropagatedRuntimeException for easier filtering

propagateIfFatal
```
public static void propagateIfFatal(java.lang.Throwable throwable)
```
Propagate exceptions which are fatal.
Propagates only those exceptions which one rarely (if ever) wants to capture, such as InterruptedException and Errors.

getFirstThrowableOfType

public static <T extends java.lang.Throwable> T getFirstThrowableOfType(java.lang.Throwable from,
                                                        java.lang.Class<T> clazz)

returns the first exception of the given type, or null

getFirstInteresting
```
public static java.lang.Throwable getFirstInteresting(java.lang.Throwable throwable)
```
returns the first exception in the call chain which is not of common uninteresting types (ie excluding ExecutionException and PropagatedRuntimeExceptions); or the original throwable if all are uninteresting

collapse
```
public static java.lang.Throwable collapse(java.lang.Throwable source)
```
creates (but does not throw) a new PropagatedRuntimeException whose message and cause are taken from the first _interesting_ element in the source

collapseIncludingAllCausalMessages
```
public static java.lang.Throwable collapseIncludingAllCausalMessages(java.lang.Throwable source)
```
as collapse(Throwable) but includes causal messages in the message as per collapseTextIncludingAllCausalMessages(Throwable); use with care (limit once) as repeated usage can result in multiple copies of the same message

collapse
```
public static java.lang.Throwable collapse(java.lang.Throwable source,
                           boolean collapseCausalChain)
```
creates (but does not throw) a new PropagatedRuntimeException whose message is taken from the first _interesting_ element in the source, and optionally also the causal chain

propagateCollapsed
```
public static java.lang.RuntimeException propagateCollapsed(java.lang.Throwable source)
```
Deprecated. since 0.7.0 same as propagate(Throwable)

removes uninteresting items from the top of the call stack (but keeps interesting messages), and throws

collapseText
```
public static java.lang.String collapseText(java.lang.Throwable t)
```
like collapse(Throwable) but returning a one-line message suitable for logging without traces

collapseTextIncludingAllCausalMessages
```
public static java.lang.String collapseTextIncludingAllCausalMessages(java.lang.Throwable t)
```
normally collapseText(Throwable) will stop following causal chains when encountering an interesting exception with a message; this variant will continue to follow such causal chains, showing all messages. for use e.g. when verbose is desired in the single-line message.

propagate

public static java.lang.RuntimeException propagate(java.util.Collection<? extends java.lang.Throwable> exceptions)

propagate

public static java.lang.RuntimeException propagate(java.lang.String prefix,
                                   java.util.Collection<? extends java.lang.Throwable> exceptions)

create

public static java.lang.Throwable create(java.util.Collection<? extends java.lang.Throwable> exceptions)

creates the given exception, but without propagating it, for use when caller will be wrapping

create

public static java.lang.RuntimeException create(java.lang.String prefix,
                                java.util.Collection<? extends java.lang.Throwable> exceptions)

creates the given exception, but without propagating it, for use when caller will be wrapping

Class Exceptions

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Exceptions

Method Detail

isPrefixBoring

propagate

propagateIfFatal

getFirstThrowableOfType

getFirstInteresting

collapse

collapseIncludingAllCausalMessages

collapse

propagateCollapsed

collapseText

collapseTextIncludingAllCausalMessages

propagate

propagate

create

create