Package org.apache.juneau.http.header

Class Thrown

java.lang.Object

org.apache.juneau.http.header.BasicHeader

org.apache.juneau.http.header.BasicCsvHeader

org.apache.juneau.http.header.Thrown

All Implemented Interfaces:

Serializable, Cloneable, Header, NameValuePair

@Header("Thrown")
public class Thrown
extends BasicCsvHeader

Represents a parsed Thrown HTTP response header.

Contains exception information including name and optionally a message.

Example

Thrown: org.apache.juneau.http.response.NotFound;Resource was not found

This header isn't part of the RFC2616 specification, but is provided to allow for Java exception information to be delivered to remote REST Java interfaces.

This header supports comma-delimited values for multiple thrown values.

Thrown: org.apache.juneau.http.response.NotFound;Resource was not found,java.lang.RuntimeException;foo

Note that this is equivalent to specifying multiple header values.

Thrown: org.apache.juneau.http.response.NotFound;Resource was not found Thrown: java.lang.RuntimeException;foo

See Also:

• juneau-rest-common Basics

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Thrown.Part	Represents a single entry in this header.

Field Summary

Fields

Modifier and Type	Field	Description
static final Thrown	EMPTY	An empty unmodifiable Thrown header.

Constructor Summary

Constructors

Constructor	Description
Thrown(String value)	Constructor.
Thrown(List<Thrown.Part> value)	Constructor.

Method Summary

Modifier and Type	Method	Description
Optional<List<Thrown.Part>>	asParts()	Returns the class name portion of the header.
static Thrown	of(String value)	Static creator.
static Thrown	of(Throwable... values)	Static creator.

Methods inherited from class org.apache.juneau.http.header.BasicCsvHeader

asArray, asList, assertList, contains, containsIgnoreCase, getValue, of, of, of, orElse, toArray, toList

Methods inherited from class org.apache.juneau.http.header.BasicHeader

assertName, assertStringValue, asString, equals, equalsIgnoreCase, get, getElements, getName, hashCode, isNotEmpty, isPresent, of, of, orElse, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

EMPTY

public static final Thrown EMPTY

An empty unmodifiable Thrown header.

Constructor Details

Thrown

public Thrown(String value)

Constructor.

Parameters:

value - The header value.

Thrown

public Thrown(List<Thrown.Part> value)

Constructor.

Parameters:

value - The header value.

Method Details

of

public static Thrown of(String value)

Static creator.

Parameters:

value - The header value.
Can be null.

Returns:

A new header bean, or null if the value is null.

of

public static Thrown of(Throwable... values)

Static creator.

Parameters:

values - The header value.
Can be null.

Returns:

A new header bean, or null if the value is null.

asParts

public Optional<List<Thrown.Part>> asParts()

Returns the class name portion of the header.

Returns:

The class name portion of the header, or null if not there.