Package org.apache.juneau.http.response

Class PermanentRedirect

java.lang.Object

org.apache.juneau.http.response.BasicHttpResponse

org.apache.juneau.http.response.PermanentRedirect

All Implemented Interfaces:

HttpMessage, HttpResponse

@Response
@StatusCode(308)
@Schema(description="Permanent Redirect")
public class PermanentRedirect
extends BasicHttpResponse

Represents an HTTP 308 Permanent Redirect response.

The request and all future requests should be repeated using another URI. 307 and 308 parallel the behaviors of 302 and 301, but do not allow the HTTP method to change. So, for example, submitting a form to a permanently redirected resource may continue smoothly.

See Also:

• juneau-rest-common

Field Summary

Fields

Modifier and Type	Field	Description
static final PermanentRedirect	INSTANCE	Default unmodifiable instance
static final String	REASON_PHRASE	Reason phrase
static final int	STATUS_CODE	HTTP status code

Constructor Summary

Constructors

Constructor	Description
PermanentRedirect()	Constructor.
PermanentRedirect(HttpResponse response)	Constructor.
PermanentRedirect(PermanentRedirect copyFrom)	Copy constructor.

Method Summary

Modifier and Type	Method	Description
PermanentRedirect	copy()	Creates a builder for this class initialized with the contents of this bean.
PermanentRedirect	setContent(String value)	Sets the body on this response.
PermanentRedirect	setContent(HttpEntity value)	Sets the body on this response.
PermanentRedirect	setHeader2(String name, String value)	Sets the specified header to the end of the headers in this builder.
PermanentRedirect	setHeader2(Header value)	Sets the specified header to the end of the headers in this builder.
PermanentRedirect	setHeaders(List<Header> values)	Sets the specified headers to the end of the headers in this builder.
PermanentRedirect	setHeaders(HeaderList value)	Sets the specified headers on this response.
PermanentRedirect	setHeaders2(Header... values)	Sets the specified headers to the end of the headers in this builder.
PermanentRedirect	setLocale2(Locale value)	Sets the locale used to retrieve reason phrases.
PermanentRedirect	setLocation(String value)	Specifies the value for the Location header.
PermanentRedirect	setLocation(URI value)	Specifies the value for the Location header.
PermanentRedirect	setProtocolVersion(ProtocolVersion value)	Sets the protocol version on the status line.
PermanentRedirect	setReasonPhrase2(String value)	Sets the reason phrase on the status line.
PermanentRedirect	setReasonPhraseCatalog(ReasonPhraseCatalog value)	Sets the reason phrase catalog used to retrieve reason phrases.
PermanentRedirect	setStatusCode2(int value)	Sets the status code on the status line.
PermanentRedirect	setStatusLine(BasicStatusLine value)	Sets the protocol version on the status line.
PermanentRedirect	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

Reason phrase

See Also:

• Constant Field Values

INSTANCE

public static final PermanentRedirect INSTANCE

Default unmodifiable instance

Constructor Details

PermanentRedirect

public PermanentRedirect()

Constructor.

PermanentRedirect

public PermanentRedirect(PermanentRedirect copyFrom)

Copy constructor.

Parameters:

copyFrom - The bean to copy from.

PermanentRedirect

public PermanentRedirect(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 PermanentRedirect copy()

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

Returns:

A new builder bean.

setContent

public PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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 PermanentRedirect 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.