Module org.elasticsearch.server

Package org.elasticsearch

Class ElasticsearchException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.elasticsearch.ElasticsearchException

All Implemented Interfaces:

Serializable, Writeable, ToXContent, ToXContentFragment

Direct Known Subclasses:

AggregationExecutionException, AggregationInitializationException, AliasFilterParsingException, BlobStoreException, BroadcastShardOperationFailedException, CancellableThreads.ExecutionCancelledException, CircuitBreakingException, ClusterBlockException, CoordinationStateRejectedException, DelayRecoveryException, ElasticsearchGenerationException, ElasticsearchParseException, ElasticsearchStatusException, ElasticsearchTimeoutException, EngineException, FailedNodeException, FailedToCommitClusterStateException, GeneralScriptException, HttpException, IllegalIndexShardStateException, IncompatibleClusterStateVersionException, IndexClosedException, IndexCreationException, IndexPrimaryShardNotAllocatedException, IndexShardRecoveryException, IndexShardRestoreException, IndexShardSnapshotException, IndexTemplateMissingException, IngestProcessorException, InvalidAggregationPathException, InvalidAliasNameException, InvalidIndexNameException, InvalidIndexTemplateException, MapperException, MasterNotDiscoveredException, NodeClosedException, NodeHealthCheckFailureException, NoNodeAvailableException, NoSeedNodeLeftException, NoShardAvailableActionException, NotMasterException, NotSerializableExceptionWrapper, ParsingException, PrimaryMissingActionException, ProcessClusterEventTimeoutException, QueryShardException, RecoverFilesRecoveryException, RecoveryFailedException, ReplicationOperation.RetryOnPrimaryException, RepositoryException, ResourceAlreadyExistsException, ResourceNotFoundException, RetentionLeaseInvalidRetainingSeqNoException, RoutingException, RoutingMissingException, ScriptException, SearchContextMissingException, SearchException, SearchPhaseExecutionException, SearchSourceBuilderException, SettingsException, ShardLockObtainFailedException, ShardStateAction.NoLongerPrimaryShardException, SnapshotException, SnapshotInProgressException, TaskCancelledException, TcpTransport.HttpRequestOnTransportException, TimestampParsingException, TranslogCorruptedException, TranslogException, TransportException, TransportReplicationAction.RetryOnReplicaException, TypeMissingException, UnavailableShardsException, UncategorizedExecutionException, VersionConflictException, VersionMismatchException

public class ElasticsearchException
extends RuntimeException
implements ToXContentFragment, Writeable

A base class for all elasticsearch exceptions.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static final String	REST_EXCEPTION_SKIP_CAUSE	Passed in the ToXContent.Params of generateThrowableXContent(XContentBuilder, Params, Throwable) to control if the caused_by element should render.
static final String	REST_EXCEPTION_SKIP_STACK_TRACE	Passed in the ToXContent.Params of generateThrowableXContent(XContentBuilder, Params, Throwable) to control if the stack_trace element should render.
static final boolean	REST_EXCEPTION_SKIP_STACK_TRACE_DEFAULT
static final String	STACK_TRACE

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
ElasticsearchException(String msg, Object... args)	Construct a ElasticsearchException with the specified detail message.
ElasticsearchException(String msg, Throwable cause, Object... args)	Construct a ElasticsearchException with the specified detail message and nested exception.
ElasticsearchException(Throwable cause)	Construct a ElasticsearchException with the specified cause exception.
ElasticsearchException(StreamInput in)

Method Summary

Modifier and Type	Method	Description
void	addHeader(String key, String... value)	Adds a new header with the given key.
void	addHeader(String key, List<String> value)	Adds a new header with the given key.
void	addMetadata(String key, String... values)	Adds a new piece of metadata with the given key.
void	addMetadata(String key, List<String> values)	Adds a new piece of metadata with the given key.
static ElasticsearchException	failureFromXContent(XContentParser parser)	Parses the output of generateFailureXContent(XContentBuilder, Params, Exception, boolean)
static ElasticsearchException	fromXContent(XContentParser parser)	Generate a ElasticsearchException from a XContentParser.
static void	generateFailureXContent(XContentBuilder builder, ToXContent.Params params, Exception e, boolean detailed)	Render any exception as a xcontent, encapsulated within a field or object named "error".
static void	generateThrowableXContent(XContentBuilder builder, ToXContent.Params params, Throwable t)	Static toXContent helper method that renders ElasticsearchException or Throwable instances as XContent, delegating the rendering to toXContent(XContentBuilder, Params) or innerToXContent(XContentBuilder, Params, Throwable, String, String, Map, Map, Throwable).
String	getDetailedMessage()	Return the detail message, including the message from the nested exception if there is one.
protected String	getExceptionName()
static String	getExceptionName(Throwable ex)	Returns a underscore case name for the given exception.
List<String>	getHeader(String key)	Returns the list of header values for the given key or null if no header for the given key exists.
Set<String>	getHeaderKeys()	Returns a set of all header keys on this exception
protected Map<String,List<String>>	getHeaders()
static int	getId(Class<? extends ElasticsearchException> exception)	Returns the serialization id the given exception.
Index	getIndex()
protected Map<String,List<String>>	getMetadata()
List<String>	getMetadata(String key)	Returns the list of metadata values for the given key or null if no metadata for the given key exists.
Set<String>	getMetadataKeys()	Returns a set of all metadata keys on this exception
List<String>	getResourceId()
String	getResourceType()
Throwable	getRootCause()	Retrieve the innermost cause of this exception, if none, returns the current exception.
ShardId	getShardId()
ElasticsearchException[]	guessRootCauses()	Returns the root cause of this exception or multiple if different shards caused different exceptions
static ElasticsearchException[]	guessRootCauses(Throwable t)	Returns the root cause of this exception or multiple if different shards caused different exceptions.
static ElasticsearchException	innerFromXContent(XContentParser parser, boolean parseRootCauses)
protected static void	innerToXContent(XContentBuilder builder, ToXContent.Params params, Throwable throwable, String type, String message, Map<String,List<String>> headers, Map<String,List<String>> metadata, Throwable cause)
static boolean	isRegistered(Class<? extends Throwable> exception, Version version)	Returns true iff the given class is a registered for an exception to be read.
protected void	metadataToXContent(XContentBuilder builder, ToXContent.Params params)	Renders additional per exception information into the XContent
static ElasticsearchException	readException(StreamInput input, int id)
static <T extends Throwable> T	readStackTrace(T throwable, StreamInput in)	Deserializes stacktrace elements as well as suppressed exceptions from the given output stream and adds it to the given exception.
void	setIndex(String index)
void	setIndex(Index index)
void	setResources(String type, String... id)
void	setShard(ShardId shardId)
RestStatus	status()	Returns the rest status code associated with this exception.
String	toString()
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
Throwable	unwrapCause()	Unwraps the actual cause from the exception for cases when the exception is a ElasticsearchWrapperException.
static <T extends Throwable> T	writeStackTraces(T throwable, StreamOutput out, Writeable.Writer<Throwable> exceptionWriter)	Serializes the given exceptions stacktrace elements as well as it's suppressed exceptions to the given output stream.
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.xcontent.ToXContentFragment

isFragment

Field Details

REST_EXCEPTION_SKIP_CAUSE

public static final String REST_EXCEPTION_SKIP_CAUSE

Passed in the ToXContent.Params of generateThrowableXContent(XContentBuilder, Params, Throwable) to control if the caused_by element should render. Unlike most parameters to toXContent methods this parameter is internal only and not available as a URL parameter.

See Also:

• Constant Field Values

REST_EXCEPTION_SKIP_STACK_TRACE

public static final String REST_EXCEPTION_SKIP_STACK_TRACE

Passed in the ToXContent.Params of generateThrowableXContent(XContentBuilder, Params, Throwable) to control if the stack_trace element should render. Unlike most parameters to toXContent methods this parameter is internal only and not available as a URL parameter. Use the error_trace parameter instead.

See Also:

• Constant Field Values

REST_EXCEPTION_SKIP_STACK_TRACE_DEFAULT

public static final boolean REST_EXCEPTION_SKIP_STACK_TRACE_DEFAULT

See Also:

• Constant Field Values

STACK_TRACE

public static final String STACK_TRACE

See Also:

• Constant Field Values

Constructor Details

ElasticsearchException

public ElasticsearchException(Throwable cause)

Construct a ElasticsearchException with the specified cause exception.

ElasticsearchException

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

Construct a ElasticsearchException with the specified detail message. The message can be parameterized using {} as placeholders for the given arguments

Parameters:

msg - the detail message

args - the arguments for the message

ElasticsearchException

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

Construct a ElasticsearchException with the specified detail message and nested exception. The message can be parameterized using {} as placeholders for the given arguments

Parameters:

msg - the detail message

cause - the nested exception

args - the arguments for the message

ElasticsearchException

public ElasticsearchException(StreamInput in)
                       throws IOException

Throws:

IOException

Method Details

addMetadata

public void addMetadata(String key,
 String... values)

Adds a new piece of metadata with the given key. If the provided key is already present, the corresponding metadata will be replaced

addMetadata

public void addMetadata(String key,
 List<String> values)

Adds a new piece of metadata with the given key. If the provided key is already present, the corresponding metadata will be replaced

getMetadataKeys

public Set<String> getMetadataKeys()

Returns a set of all metadata keys on this exception

getMetadata

public List<String> getMetadata(String key)

Returns the list of metadata values for the given key or null if no metadata for the given key exists.

getMetadata

protected Map<String,List<String>> getMetadata()

addHeader

public void addHeader(String key,
 List<String> value)

Adds a new header with the given key. This method will replace existing header if a header with the same key already exists

addHeader

public void addHeader(String key,
 String... value)

Adds a new header with the given key. This method will replace existing header if a header with the same key already exists

getHeaderKeys

public Set<String> getHeaderKeys()

Returns a set of all header keys on this exception

getHeader

public List<String> getHeader(String key)

Returns the list of header values for the given key or null if no header for the given key exists.

getHeaders

protected Map<String,List<String>> getHeaders()

status

public RestStatus status()

Returns the rest status code associated with this exception.

unwrapCause

public Throwable unwrapCause()

Unwraps the actual cause from the exception for cases when the exception is a ElasticsearchWrapperException.

See Also:

• ExceptionsHelper.unwrapCause(Throwable)

getDetailedMessage

public String getDetailedMessage()

Return the detail message, including the message from the nested exception if there is one.

getRootCause

public Throwable getRootCause()

Retrieve the innermost cause of this exception, if none, returns the current exception.

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Throws:

IOException

readException

public static ElasticsearchException readException(StreamInput input,
 int id)
                                            throws IOException

Throws:

IOException

isRegistered

public static boolean isRegistered(Class<? extends Throwable> exception,
 Version version)

Returns true iff the given class is a registered for an exception to be read.

getId

public static int getId(Class<? extends ElasticsearchException> exception)

Returns the serialization id the given exception.

toXContent

public XContentBuilder toXContent(XContentBuilder builder,
 ToXContent.Params params)
                           throws IOException

Specified by:

toXContent in interface ToXContent

Throws:

IOException

innerToXContent

protected static void innerToXContent(XContentBuilder builder,
 ToXContent.Params params,
 Throwable throwable,
 String type,
 String message,
 Map<String,List<String>> headers,
 Map<String,List<String>> metadata,
 Throwable cause)
                               throws IOException

Throws:

IOException

metadataToXContent

protected void metadataToXContent(XContentBuilder builder,
 ToXContent.Params params)
                           throws IOException

Renders additional per exception information into the XContent

Throws:

IOException

fromXContent

public static ElasticsearchException fromXContent(XContentParser parser)
                                           throws IOException

Generate a ElasticsearchException from a XContentParser. This does not return the original exception type (ie NodeClosedException for example) but just wraps the type, the reason and the cause of the exception. It also recursively parses the tree structure of the cause, returning it as a tree structure of ElasticsearchException instances.

Throws:

IOException

innerFromXContent

public static ElasticsearchException innerFromXContent(XContentParser parser,
 boolean parseRootCauses)
                                                throws IOException

Throws:

IOException

generateThrowableXContent

public static void generateThrowableXContent(XContentBuilder builder,
 ToXContent.Params params,
 Throwable t)
                                      throws IOException

Static toXContent helper method that renders ElasticsearchException or Throwable instances as XContent, delegating the rendering to toXContent(XContentBuilder, Params) or innerToXContent(XContentBuilder, Params, Throwable, String, String, Map, Map, Throwable). This method is usually used when the Throwable is rendered as a part of another XContent object, and its result can be parsed back using the fromXContent(XContentParser) method.

Throws:

IOException

generateFailureXContent

public static void generateFailureXContent(XContentBuilder builder,
 ToXContent.Params params,
 @Nullable
 Exception e,
 boolean detailed)
                                    throws IOException

Render any exception as a xcontent, encapsulated within a field or object named "error". The level of details that are rendered depends on the value of the "detailed" parameter: when it's false only a simple message based on the type and message of the exception is rendered. When it's true all detail are provided including guesses root causes, cause and potentially stack trace. This method is usually used when the Exception is rendered as a full XContent object, and its output can be parsed by the failureFromXContent(XContentParser) method.

Throws:

IOException

failureFromXContent

public static ElasticsearchException failureFromXContent(XContentParser parser)
                                                  throws IOException

Parses the output of generateFailureXContent(XContentBuilder, Params, Exception, boolean)

Throws:

IOException

guessRootCauses

public ElasticsearchException[] guessRootCauses()

Returns the root cause of this exception or multiple if different shards caused different exceptions

guessRootCauses

public static ElasticsearchException[] guessRootCauses(Throwable t)

Returns the root cause of this exception or multiple if different shards caused different exceptions. If the given exception is not an instance of ElasticsearchException an empty array is returned.

getExceptionName

protected String getExceptionName()

getExceptionName

public static String getExceptionName(Throwable ex)

Returns a underscore case name for the given exception. This method strips Elasticsearch prefixes from exception names.

toString

public String toString()

Overrides:

toString in class Throwable

readStackTrace

public static <T extends Throwable> T readStackTrace(T throwable,
 StreamInput in)
                                              throws IOException

Deserializes stacktrace elements as well as suppressed exceptions from the given output stream and adds it to the given exception.

Throws:

IOException

writeStackTraces

public static <T extends Throwable> T writeStackTraces(T throwable,
 StreamOutput out,
 Writeable.Writer<Throwable> exceptionWriter)
                                                throws IOException

Serializes the given exceptions stacktrace elements as well as it's suppressed exceptions to the given output stream.

Throws:

IOException

getIndex

public Index getIndex()

getShardId

public ShardId getShardId()

setIndex

public void setIndex(Index index)

setIndex

public void setIndex(String index)

setShard

public void setShard(ShardId shardId)

setResources

public void setResources(String type,
 String... id)

getResourceId

public List<String> getResourceId()

getResourceType

public String getResourceType()