org.apache.juneau.http.response.BasicHttpResponse

org.apache.juneau.http.response.Found

All Implemented Interfaces:: HttpMessage, HttpResponse

@Response @StatusCode(302) @Schema(description="Found") public class Found extends BasicHttpResponse

Represents an HTTP 302 Found response.

Tells the client to look at (browse to) another url. 302 has been superseded by 303 and 307. This is an example of industry practice contradicting the standard. The HTTP/1.0 specification (RFC 1945) required the client to perform a temporary redirect (the original describing phrase was "Moved Temporarily"), but popular browsers implemented 302 with the functionality of a 303 See Other. Therefore, HTTP/1.1 added status codes 303 and 307 to distinguish between the two behaviours. However, some Web applications and frameworks use the 302 status code as if it were the 303.

Field Summary

Fields

Modifier and Type

Field

Description

static final Found

INSTANCE

Default unmodifiable instance

static final String

REASON_PHRASE

Default message

static final int

STATUS_CODE

HTTP status code
Constructor Summary

Constructors

Constructor

Description

Found()

Constructor.

Found(HttpResponse response)

Constructor.

Found(Found copyFrom)

Copy constructor.
Method Summary

Modifier and Type

Method

Description

Found

copy()

Creates a builder for this class initialized with the contents of this bean.

Found

setContent(String value)

Sets the body on this response.

Found

setContent(HttpEntity value)

Sets the body on this response.

Found

setHeader2(String name, String value)

Sets the specified header to the end of the headers in this builder.

Found

setHeader2(Header value)

Sets the specified header to the end of the headers in this builder.

Found

setHeaders(List<Header> values)

Sets the specified headers to the end of the headers in this builder.

Found

setHeaders(HeaderList value)

Sets the specified headers on this response.

Found

setHeaders2(Header... values)

Sets the specified headers to the end of the headers in this builder.

Found

setLocale2(Locale value)

Sets the locale used to retrieve reason phrases.

Found

setLocation(String value)

Specifies the value for the Location header.

Found

setLocation(URI value)

Specifies the value for the Location header.

Found

setProtocolVersion(ProtocolVersion value)

Sets the protocol version on the status line.

Found

setReasonPhrase2(String value)

Sets the reason phrase on the status line.

Found

setReasonPhraseCatalog(ReasonPhraseCatalog value)

Sets the reason phrase catalog used to retrieve reason phrases.

Found

setStatusCode2(int value)

Sets the status code on the status line.

Found

setStatusLine(BasicStatusLine value)

Sets the protocol version on the status line.

Found

setUnmodifiable()

Specifies whether this bean should be unmodifiable.

Methods inherited from class org.apache.juneau.http.response.BasicHttpResponse
addHeader, addHeader, assertModifiable, assertStatusCode, containsHeader, getAllHeaders, getEntity, getFirstHeader, getHeaders, getHeaders, getLastHeader, getLocale, getParams, getProtocolVersion, getStatusLine, headerIterator, headerIterator, isUnmodifiable, removeHeader, removeHeaders, setEntity, setHeader, setHeader, setHeaders, setLocale, setParams, setReasonPhrase, setStatusCode, setStatusLine, setStatusLine, setStatusLine, toString

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

Field Details
- STATUS_CODE
  
  public static final int STATUS_CODE
  
  HTTP status code
  See Also:
  
  Constant Field Values
- REASON_PHRASE
  
  public static final String REASON_PHRASE
  
  Default message
  See Also:
  
  Constant Field Values
- INSTANCE
  
  public static final Found INSTANCE
  
  Default unmodifiable instance
Constructor Details
- Found
  
  public Found()
  
  Constructor.
- Found
  
  public Found(Found copyFrom)
  
  Copy constructor.
  
  Parameters:
  
  copyFrom - The bean to copy from.
- Found
  
  public Found(HttpResponse response)
  
  Constructor.
  This is the constructor used when parsing an HTTP response.
  
  Parameters:
  
  response - The HTTP response to copy from. Must not be null.
  
  Throws:
  
  AssertionError - If HTTP response status code does not match what was expected.
Method Details
- copy
  
  public Found copy()
  
  Creates a builder for this class initialized with the contents of this bean.
  
  Returns:
  
  A new builder bean.
- setContent
  
  public Found setContent(String value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the body on this response.
  
  Overrides:
  
  setContent in class BasicHttpResponse
  
  Parameters:
  
  value - The body on this response.
  
  Returns:
  
  This object.
- setContent
  
  public Found setContent(HttpEntity value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the body on this response.
  
  Overrides:
  
  setContent in class BasicHttpResponse
  
  Parameters:
  
  value - The body on this response.
  
  Returns:
  
  This object.
- setHeader2
  
  public Found setHeader2(Header value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the specified header to the end of the headers in this builder.
  
  Overrides:
  
  setHeader2 in class BasicHttpResponse
  
  Parameters:
  
  value - The header to add. null values are ignored.
  
  Returns:
  
  This object.
- setHeader2
  
  public Found setHeader2(String name, String value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the specified header to the end of the headers in this builder.
  
  Overrides:
  
  setHeader2 in class BasicHttpResponse
  
  Parameters:
  
  name - The header name.
  
  value - The header value.
  
  Returns:
  
  This object.
- setHeaders
  
  public Found setHeaders(List<Header> values)
  
  Description copied from class: BasicHttpResponse
  
  Sets the specified headers to the end of the headers in this builder.
  
  Overrides:
  
  setHeaders in class BasicHttpResponse
  
  Parameters:
  
  values - The headers to add. null values are ignored.
  
  Returns:
  
  This object.
- setHeaders
  
  public Found setHeaders(HeaderList value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the specified headers on this response.
  
  Overrides:
  
  setHeaders in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setHeaders2
  
  public Found setHeaders2(Header... values)
  
  Description copied from class: BasicHttpResponse
  
  Sets the specified headers to the end of the headers in this builder.
  
  Overrides:
  
  setHeaders2 in class BasicHttpResponse
  
  Parameters:
  
  values - The headers to add. null values are ignored.
  
  Returns:
  
  This object.
- setLocale2
  
  public Found setLocale2(Locale value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the locale used to retrieve reason phrases.
  If not specified, uses Locale.getDefault().
  
  Overrides:
  
  setLocale2 in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setLocation
  
  public Found setLocation(String value)
  
  Description copied from class: BasicHttpResponse
  
  Specifies the value for the Location header.
  
  Overrides:
  
  setLocation in class BasicHttpResponse
  
  Parameters:
  
  value - The new header location.
  
  Returns:
  
  This object.
- setLocation
  
  public Found setLocation(URI value)
  
  Description copied from class: BasicHttpResponse
  
  Specifies the value for the Location header.
  
  Overrides:
  
  setLocation in class BasicHttpResponse
  
  Parameters:
  
  value - The new header location.
  
  Returns:
  
  This object.
- setProtocolVersion
  
  public Found setProtocolVersion(ProtocolVersion value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the protocol version on the status line.
  If not specified, "HTTP/1.1" will be used.
  
  Overrides:
  
  setProtocolVersion in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setReasonPhrase2
  
  public Found setReasonPhrase2(String value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the reason phrase on the status line.
  If not specified, the reason phrase will be retrieved from the reason phrase catalog using the locale on this builder.
  
  Overrides:
  
  setReasonPhrase2 in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setReasonPhraseCatalog
  
  public Found setReasonPhraseCatalog(ReasonPhraseCatalog value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the reason phrase catalog used to retrieve reason phrases.
  If not specified, uses EnglishReasonPhraseCatalog.
  
  Overrides:
  
  setReasonPhraseCatalog in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setStatusCode2
  
  public Found setStatusCode2(int value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the status code on the status line.
  If not specified, 0 will be used.
  
  Overrides:
  
  setStatusCode2 in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setStatusLine
  
  public Found setStatusLine(BasicStatusLine value)
  
  Description copied from class: BasicHttpResponse
  
  Sets the protocol version on the status line.
  If not specified, "HTTP/1.1" will be used.
  
  Overrides:
  
  setStatusLine in class BasicHttpResponse
  
  Parameters:
  
  value - The new value.
  
  Returns:
  
  This object.
- setUnmodifiable
  
  public Found setUnmodifiable()
  
  Description copied from class: BasicHttpResponse
  
  Specifies whether this bean should be unmodifiable.
  When enabled, attempting to set any properties on this bean will cause an UnsupportedOperationException.
  
  Overrides:
  
  setUnmodifiable in class BasicHttpResponse
  
  Returns:
  
  This object.

Class Found

See Also:

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.apache.juneau.http.response.BasicHttpResponse

Methods inherited from class java.lang.Object

Field Details

STATUS_CODE

REASON_PHRASE

INSTANCE

Constructor Details

Found

Found

Found

Method Details

copy

setContent

setContent

setHeader2

setHeader2

setHeaders

setHeaders

setHeaders2

setLocale2

setLocation

setLocation

setProtocolVersion

setReasonPhrase2

setReasonPhraseCatalog

setStatusCode2

setStatusLine

setUnmodifiable