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

Class Conflict

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.juneau.commons.BasicRuntimeException

org.apache.juneau.marshall.BasicRuntimeException

org.apache.juneau.http.classic.response.BasicHttpException

org.apache.juneau.http.classic.response.Conflict

All Implemented Interfaces:

Serializable, HttpMessage, HttpResponse

Direct Known Subclasses:

Conflict.Unmodifiable

@Response
@StatusCode(409)
@Schema(description="Conflict")
public class Conflict
extends BasicHttpException

Exception representing an HTTP 409 (Conflict).

Indicates that the request could not be processed because of conflict in the request, such as an edit conflict between multiple simultaneous updates.

See Also:

• juneau-rest-common

Nested Class Summary

Nested Classes

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

Field Summary

Fields

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

Constructor Summary

Constructors

Modifier	Constructor	Description
	Conflict()	Constructor.
	Conflict(String msg, Object... args)	Constructor.
	Conflict(Throwable cause)	Constructor.
	Conflict(Throwable cause, String msg, Object... args)	Constructor.
	Conflict(HttpResponse response)	Constructor.
protected	Conflict(Conflict copyFrom)	Copy constructor.

Method Summary

Modifier and Type	Method	Description
Conflict	copy()	Creates a modifiable copy of this bean.
Conflict	setContent(String value)	Sets the body on this response.
Conflict	setContent(HttpEntity value)	Sets the body on this response.
Conflict	setHeader2(String name, Object value)	Sets a header on this response.
Conflict	setHeaders(List<Header> values)	Sets the specified headers on this response.
Conflict	setHeaders(HeaderList value)	Sets the specified headers on this response.
Conflict	setHeaders2(Header... values)	Sets multiple headers on this response.
Conflict	setLocale2(Locale value)	Sets the locale used to retrieve reason phrases.
Conflict	setMessage(String message, Object... args)	Sets the detail message on this exception.
Conflict	setProtocolVersion(ProtocolVersion value)	Sets the protocol version on the status line.
Conflict	setReasonPhrase2(String value)	Sets the reason phrase on the status line.
Conflict	setReasonPhraseCatalog(ReasonPhraseCatalog value)	Sets the reason phrase catalog used to retrieve reason phrases.
Conflict	setStatusCode2(int code)	Same as BasicHttpException.setStatusCode(int) but returns this object.
Conflict	setStatusLine(BasicStatusLine value)	Sets the protocol version on the status line.
Conflict	unmodifiable()	Returns an unmodifiable snapshot of this bean.

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

addHeader, addHeader, assertStatusCode, containsHeader, equals, freeze, getAllHeaders, getEntity, getFirstHeader, getFullStackMessage, getHeaders, getHeaders, getLastHeader, getLocale, getMessage, getParams, getProtocolVersion, getRootCause, getStatusLine, hashCode, headerIterator, headerIterator, isUnmodifiable, modify, removeHeader, removeHeaders, setEntity, setHeader, setHeader, setHeaders, setLocale, setParams, setReasonPhrase, setStatusCode, setStatusLine, setStatusLine, setStatusLine, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

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

Reason phrase

See Also:

• Constant Field Values

INSTANCE

public static final Conflict INSTANCE

Reusable unmodifiable instance

Constructor Details

Conflict

public Conflict()

Constructor.

Conflict

public Conflict(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.

Conflict

public Conflict(String msg,
 Object... args)

Constructor.

Parameters:

msg - The message. Can be null, in which case the reason phrase is used as the message.

args - Optional String.format-style arguments in the message.

Conflict

public Conflict(Throwable cause)

Constructor.

Parameters:

cause - The cause. Can be null, in which case the reason phrase is used as the message and no cause is chained.

Conflict

public Conflict(Throwable cause,
 String msg,
 Object... args)

Constructor.

Parameters:

cause - The caused-by exception. Can be null (no cause is chained).

msg - The message. Can be null, in which case the cause's message is used, or the reason phrase if the cause is also null or has no message.

args - The message arguments.

Conflict

protected Conflict(Conflict copyFrom)

Copy constructor.

Parameters:

copyFrom - The bean to copy. Must not be null.

Method Details

copy

public Conflict copy()

Creates a modifiable copy of this bean.

Returns:

A new modifiable bean.

setContent

public Conflict setContent(HttpEntity value)

Description copied from class: BasicHttpException

Sets the body on this response.

Overrides:

setContent in class BasicHttpException

Parameters:

value - The body on this response. Can be null to unset the property.

Returns:

This object.

setContent

public Conflict setContent(String value)

Description copied from class: BasicHttpException

Sets the body on this response.

Overrides:

setContent in class BasicHttpException

Parameters:

value - The body on this response. Can be null (treated as an empty string).

Returns:

This object.

setHeader2

public Conflict setHeader2(String name,
 Object value)

Description copied from class: BasicHttpException

Sets a header on this response.

Overrides:

setHeader2 in class BasicHttpException

Parameters:

name - The header name.

value - The header value.

Returns:

This object.

setHeaders

public Conflict setHeaders(HeaderList value)

Description copied from class: BasicHttpException

Sets the specified headers on this response.

Overrides:

setHeaders in class BasicHttpException

Parameters:

value - The new value. Must not be null.

Returns:

This object.

setHeaders

public Conflict setHeaders(List<Header> values)

Description copied from class: BasicHttpException

Sets the specified headers on this response.

Overrides:

setHeaders in class BasicHttpException

Parameters:

values - The headers to set. null values are ignored.

Returns:

This object.

setHeaders2

public Conflict setHeaders2(Header... values)

Description copied from class: BasicHttpException

Sets multiple headers on this response.

Overrides:

setHeaders2 in class BasicHttpException

Parameters:

values - The headers to add.

Returns:

This object.

setLocale2

public Conflict setLocale2(Locale value)

Description copied from class: BasicHttpException

Sets the locale used to retrieve reason phrases.

If not specified, uses Locale.getDefault().

Overrides:

setLocale2 in class BasicHttpException

Parameters:

value - The new value. Can be null. The effect is implementation-dependent, depending on the configured ReasonPhraseCatalog (e.g. ignored by EnglishReasonPhraseCatalog).

Returns:

This object.

setMessage

public Conflict setMessage(String message,
 Object... args)

Description copied from class: BasicRuntimeException

Sets the detail message on this exception.

Overrides:

setMessage in class BasicHttpException

Parameters:

message - The message.

args - The message args.

Returns:

This object.

setProtocolVersion

public Conflict setProtocolVersion(ProtocolVersion value)

Description copied from class: BasicHttpException

Sets the protocol version on the status line.

If not specified, "HTTP/1.1" will be used.

Overrides:

setProtocolVersion in class BasicHttpException

Parameters:

value - The new value. Can be null, in which case the default protocol version is cleared and BasicStatusLine.getProtocolVersion() returns null.

Returns:

This object.

setReasonPhrase2

public Conflict setReasonPhrase2(String value)

Description copied from class: BasicHttpException

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 BasicHttpException

Parameters:

value - The new value. Can be null to fall back to the reason phrase catalog.

Returns:

This object.

setReasonPhraseCatalog

public Conflict setReasonPhraseCatalog(ReasonPhraseCatalog value)

Description copied from class: BasicHttpException

Sets the reason phrase catalog used to retrieve reason phrases.

If not specified, uses EnglishReasonPhraseCatalog.

Overrides:

setReasonPhraseCatalog in class BasicHttpException

Parameters:

value - The new value. Can be null to fall back to EnglishReasonPhraseCatalog.INSTANCE.

Returns:

This object.

setStatusCode2

public Conflict setStatusCode2(int code)
                        throws IllegalStateException

Description copied from class: BasicHttpException

Same as BasicHttpException.setStatusCode(int) but returns this object.

Overrides:

setStatusCode2 in class BasicHttpException

Parameters:

code - The new status code.

Returns:

This object.

Throws:

IllegalStateException - If status code could not be set.

setStatusLine

public Conflict setStatusLine(BasicStatusLine value)

Description copied from class: BasicHttpException

Sets the protocol version on the status line.

If not specified, "HTTP/1.1" will be used.

Overrides:

setStatusLine in class BasicHttpException

Parameters:

value - The new value. Must not be null.

Returns:

This object.

unmodifiable

public Conflict unmodifiable()

Description copied from class: BasicHttpException

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

Overrides:

unmodifiable in class BasicHttpException

Returns:

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