org.apache.solr.common

Class SolrException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.solr.common.SolrException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BaseCloudSolrClient.RouteException, BaseHttpSolrClient.RemoteSolrException, NonExistentCoreException, ZooKeeperException

public class SolrException
extends RuntimeException

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SolrException.ErrorCode This list of valid HTTP Status error codes that Solr may return in the case of a "Server Side" error.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ERROR_CLASS
static Set<String>	ignorePatterns Deprecated. use ErrorLogMuter in Solr test-framework.
protected NamedList<String>	metadata
static String	ROOT_ERROR_CLASS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SolrException(int code, String msg, Throwable th) Constructor that can set arbitrary http status code.
	SolrException(SolrException.ErrorCode code, String msg)
	SolrException(SolrException.ErrorCode code, String msg, Throwable th)
	SolrException(SolrException.ErrorCode code, Throwable th)

Method Summary

Modifier and Type	Method and Description
int	code() The HTTP Status code associated with this Exception.
static String	doIgnore(Throwable t, String stacktrace) Deprecated. use ErrorLogMuter in Solr test-framework.
NamedList<String>	getMetadata()
String	getMetadata(String key)
static Throwable	getRootCause(Throwable t)
String	getRootThrowable()
String	getThrowable()
void	log(org.slf4j.Logger log) Deprecated. Use the Logger directly
static void	log(org.slf4j.Logger log, String msg) Deprecated. Use the Logger directly
static void	log(org.slf4j.Logger log, String msg, Throwable e) Deprecated. Use the Logger directly
static void	log(org.slf4j.Logger log, Throwable e) Deprecated. Use the Logger directly
void	logDebugWithMdc(org.slf4j.Logger logger, String msg)
void	logInfoWithMdc(org.slf4j.Logger logger, String msg)
void	logWarnWithMdc(org.slf4j.Logger logger, String msg)
void	setMetadata(NamedList<String> metadata)
void	setMetadata(String key, String value)
static String	toStr(Throwable e) Deprecated. use Throwable.printStackTrace() directly

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

ROOT_ERROR_CLASS

public static final String ROOT_ERROR_CLASS

See Also:

Constant Field Values

ERROR_CLASS

public static final String ERROR_CLASS

See Also:

Constant Field Values

metadata

protected NamedList<String> metadata

ignorePatterns

@Deprecated
public static Set<String> ignorePatterns

Deprecated. use ErrorLogMuter in Solr test-framework.

For test code: If non-null, prevents calls to log(org.slf4j.Logger) from logging any msg or exception (stack trace) that matches an included regular expressions. A is recommended.

Constructor Detail

SolrException

public SolrException(SolrException.ErrorCode code,
                     String msg)

SolrException

public SolrException(SolrException.ErrorCode code,
                     String msg,
                     Throwable th)

SolrException

public SolrException(SolrException.ErrorCode code,
                     Throwable th)

SolrException

protected SolrException(int code,
                        String msg,
                        Throwable th)

Constructor that can set arbitrary http status code. Not for use in Solr, but may be used by clients in subclasses to capture errors returned by the servlet container or other HTTP proxies.

Method Detail

code

public int code()

The HTTP Status code associated with this Exception. For SolrExceptions thrown by Solr "Server Side", this should valid SolrException.ErrorCode, however client side exceptions may contain an arbitrary error code based on the behavior of the Servlet Container hosting Solr, or any HTTP Proxies that may exist between the client and the server.

Returns:

The HTTP Status code associated with this Exception

setMetadata

public void setMetadata(NamedList<String> metadata)

getMetadata

public NamedList<String> getMetadata()

getMetadata

public String getMetadata(String key)

setMetadata

public void setMetadata(String key,
                        String value)

getThrowable

public String getThrowable()

getRootThrowable

public String getRootThrowable()

log

@Deprecated
public void log(org.slf4j.Logger log)

Deprecated. Use the Logger directly

This method was initially created to aid in testing situations that were known to cause ERRORs. It should no longer be used by any new code.

See Also:

ignorePatterns

log

@Deprecated
public static void log(org.slf4j.Logger log,
                                   Throwable e)

Deprecated. Use the Logger directly

This method was initially created to aid in testing situations that were known to cause ERRORs. It should no longer be used by any new code.

See Also:

ignorePatterns

log

@Deprecated
public static void log(org.slf4j.Logger log,
                                   String msg,
                                   Throwable e)

Deprecated. Use the Logger directly

This method was initially created to aid in testing situations that were known to cause ERRORs. It should no longer be used by any new code.

See Also:

ignorePatterns

log

@Deprecated
public static void log(org.slf4j.Logger log,
                                   String msg)

Deprecated. Use the Logger directly

This method was initially created to aid in testing situations that were known to cause ERRORs. It should no longer be used by any new code.

See Also:

ignorePatterns

toStr

@Deprecated
public static String toStr(Throwable e)

Deprecated. use Throwable.printStackTrace() directly

This method was initially created to aid in testing situations that were known to cause ERRORs. It should no longer be used by any new code.

See Also:

ignorePatterns

doIgnore

@Deprecated
public static String doIgnore(Throwable t,
                                          String stacktrace)

Deprecated. use ErrorLogMuter in Solr test-framework.

Returns null if this exception does not match any ignore patterns; or an INFO message string to log instead if it does.

Parameters:

t - the original exception (only used for assertion checking)

stacktrace - the stringified stack trace of the exception, used for the acutal regex checking

See Also:

ignorePatterns, toStr(java.lang.Throwable)

getRootCause

public static Throwable getRootCause(Throwable t)

logInfoWithMdc

public void logInfoWithMdc(org.slf4j.Logger logger,
                           String msg)

logDebugWithMdc

public void logDebugWithMdc(org.slf4j.Logger logger,
                            String msg)

logWarnWithMdc

public void logWarnWithMdc(org.slf4j.Logger logger,
                           String msg)