Package org.apache.juneau.http.classic.response

Class Found

java.lang.Object

org.apache.juneau.http.classic.response.BasicHttpResponse<Found>

org.apache.juneau.http.classic.response.Found

All Implemented Interfaces:

HttpMessage, HttpResponse

Direct Known Subclasses:

Found.Unmodifiable

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

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.

See Also:

• juneau-rest-common

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Found.Unmodifiable	Unmodifiable point-in-time snapshot of the enclosing Found response.

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	unmodifiable()	Returns an unmodifiable snapshot of this bean.

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

addHeader, addHeader, assertStatusCode, containsHeader, equals, freeze, getAllHeaders, getEntity, getFirstHeader, getHeaders, getHeaders, getLastHeader, getLocale, getParams, getProtocolVersion, getStatusLine, hashCode, headerIterator, headerIterator, isUnmodifiable, modify, removeHeader, removeHeaders, self, setContent, setContent, setEntity, setHeader, setHeader, setHeader2, setHeader2, setHeaders, setHeaders, setHeaders, setHeaders2, setLocale, setLocale2, setLocation, setLocation, setParams, setProtocolVersion, setReasonPhrase, setReasonPhrase2, setReasonPhraseCatalog, setStatusCode, setStatusCode2, setStatusLine, setStatusLine, setStatusLine, setStatusLine, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, 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. Must not be null.

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:

IllegalArgumentException - 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.

unmodifiable

public Found unmodifiable()

Description copied from class: BasicHttpResponse

Returns an unmodifiable snapshot of this bean.

The returned instance is a point-in-time copy of the leaf's nested Unmodifiable type; any attempt to set a property on it throws an UnsupportedOperationException. This method is idempotent: if this bean is already unmodifiable it returns itself rather than taking another snapshot. The receiver is left unchanged (and still modifiable unless it was already unmodifiable).

Specified by:

unmodifiable in class BasicHttpResponse<Found>

Returns:

An unmodifiable snapshot of this bean, or this bean if it is already unmodifiable.