Summary: Ctors | Methods | Inherited Methods | [Expand All]

Also: SpringCore

public abstract class

NestedRuntimeException

extends RuntimeException

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	java.lang.RuntimeException
			↳	org.springframework.core.NestedRuntimeException

Known Direct Subclasses

AopConfigException, AopInvocationException, BeansException, BshScriptUtils.BshExecutionException, ConversionException, DataAccessException, EjbAccessException, HandlerMethodInvocationException, HttpMessageConversionException, JRubyScriptUtils.JRubyExecutionException, JmsException, JmxException, JndiLookupFailureException, JobMethodInvocationFailedException, MailException, and 8 others.

Known Indirect Subclasses

ApplicationContextException, BadSqlGrammarException, BeanCreationException, BeanCreationNotAllowedException, BeanCurrentlyInCreationException, BeanDefinitionParsingException, BeanDefinitionStoreException, BeanDefinitionValidationException, BeanExpressionException, BeanInitializationException, BeanInstantiationException, BeanIsAbstractException, BeanIsNotAFactoryException, BeanNotOfRequiredTypeException, BootstrapException, and 131 others.

ApplicationContextException	Exception thrown during application context initialization.
BadSqlGrammarException	Exception thrown when SQL specified is invalid.
BeanCreationException	Exception thrown when a BeanFactory encounters an error when attempting to create a bean from a bean definition.
BeanCreationNotAllowedException	Exception thrown in case of a bean being requested despite bean creation currently not being allowed (for example, during the shutdown phase of a bean factory).
BeanCurrentlyInCreationException	Exception thrown in case of a reference to a bean that's currently in creation.
BeanDefinitionParsingException	Exception thrown when a bean definition reader encounters an error during the parsing process.
BeanDefinitionStoreException	Exception thrown when a BeanFactory encounters an invalid bean definition: e.g.
BeanDefinitionValidationException	Exception thrown when the validation of a bean definition failed.
BeanExpressionException	Exception that indicates an expression evaluation attempt having failed.
BeanInitializationException	Exception that a bean implementation is suggested to throw if its own factory-aware initialization code fails.
BeanInstantiationException	Exception thrown when instantiation of a bean failed.
BeanIsAbstractException	Exception thrown when a bean instance has been requested for a bean definition which has been marked as abstract.
BeanIsNotAFactoryException	Exception thrown when a bean is not a factory, but a user tries to get at the factory for the given bean name.
BeanNotOfRequiredTypeException	Thrown when a bean doesn't match the expected type.
BootstrapException	Exception thrown if a bean factory could not be loaded by a bootstrap class.
CannotAcquireLockException	Exception thrown on failure to aquire a lock during an update, for example during a "select for update" statement.
CannotCreateRecordException	Exception thrown when the creating of a CCI Record failed for connector-internal reasons.
CannotCreateTransactionException	Exception thrown when a transaction can't be created using an underlying transaction API such as JTA.
CannotGetCciConnectionException	Fatal exception thrown when we can't connect to an EIS using CCI.
CannotGetJdbcConnectionException	Fatal exception thrown when we can't connect to an RDBMS using JDBC.
CannotLoadBeanClassException	Exception thrown when the BeanFactory cannot load the specified class of a given bean.
CannotSerializeTransactionException	Exception thrown on failure to complete a transaction in serialized mode due to update conflicts.
CastorMappingException	Exception thrown by `CastorMarshaller` whenever it encounters a mapping problem.
CciOperationNotSupportedException	Exception thrown when the connector doesn't support a specific CCI operation.
CleanupFailureDataAccessException	Exception thrown when we couldn't cleanup after a data access operation, but the actual operation went OK.
ConcurrencyFailureException	Exception thrown on concurrency failure.
ConversionFailedException	Exception to be thrown when an actual type conversion attempt fails.
ConversionNotSupportedException	Exception thrown when no suitable editor or converter can be found for a bean property.
ConverterNotFoundException	Thrown when a suitable converter could not be found in a conversion service.
DataAccessResourceFailureException	Data access exception thrown when a resource fails completely: for example, if we can't connect to a database using JDBC.
DataIntegrityViolationException	Exception thrown when an attempt to insert or update data results in violation of an integrity constraint.
DataRetrievalFailureException	Exception thrown if certain expected data could not be retrieved, e.g.
DataSourceLookupFailureException	Exception to be thrown by a DataSourceLookup implementation, indicating that the specified DataSource could not be obtained.
DeadlockLoserDataAccessException	Generic exception thrown when the current process was a deadlock loser, and its transaction rolled back.
DestinationResolutionException	Thrown by a DestinationResolver when it cannot resolve a destination name.
DuplicateKeyException	Exception thrown when an attempt to insert or update data results in violation of an primary key or unique constraint.
EmptyResultDataAccessException	Data access exception thrown when a result was expected to have at least one row (or element) but zero rows (or elements) were actually returned.
FactoryBeanNotInitializedException	Exception to be thrown from a FactoryBean's `getObject()` method if the bean is not fully initialized yet, for example because it is involved in a circular reference.
FatalBeanException	Thrown on an unrecoverable problem encountered in the beans packages or sub-packages, e.g.
HeuristicCompletionException	Exception that represents a transaction failure caused by a heuristic decision on the side of the transaction coordinator.
HibernateJdbcException	Hibernate-specific subclass of UncategorizedDataAccessException, for JDBC exceptions that Hibernate wrapped.
HibernateObjectRetrievalFailureException	Hibernate-specific subclass of ObjectRetrievalFailureException.
HibernateOptimisticLockingFailureException	Hibernate-specific subclass of ObjectOptimisticLockingFailureException.
HibernateQueryException	Hibernate-specific subclass of InvalidDataAccessResourceUsageException, thrown on invalid HQL query syntax.
HibernateSystemException	Hibernate-specific subclass of UncategorizedDataAccessException, for Hibernate system errors that do not match any concrete `org.springframework.dao` exceptions.
HttpClientErrorException	Exception thrown when an HTTP 4xx is received.
HttpMessageNotReadableException	Thrown by `HttpMessageConverter` implementations when the `read` method fails.
HttpMessageNotWritableException	Thrown by `HttpMessageConverter` implementations when the org.springframework.http.converter.HttpMessageConverter#write(Object, org.springframework.http.HttpOutputMessage) write method fails.
HttpServerErrorException	Exception thrown when an HTTP 5xx is received.
HttpStatusCodeException	Abstract base class for exceptions based on an `HttpStatus`.
IllegalStateException	Runtime exception mirroring the JMS IllegalStateException.
IllegalTransactionStateException	Exception thrown when the existence or non-existence of a transaction amounts to an illegal state according to the transaction propagation behavior that applies.
IncorrectResultSetColumnCountException	Data access exception thrown when a result set did not have the correct column count, for example when expecting a single column but getting 0 or more than 1 columns.
IncorrectResultSizeDataAccessException	Data access exception thrown when a result was not of the expected size, for example when expecting a single row but getting 0 or more than 1 rows.
IncorrectUpdateSemanticsDataAccessException	Data access exception thrown when something unintended appears to have happened with an update, but the transaction hasn't already been rolled back.
InvalidClientIDException	Runtime exception mirroring the JMS InvalidClientIDException.
InvalidDataAccessApiUsageException	Exception thrown on incorrect usage of the API, such as failing to "compile" a query object that needed compilation before execution.
InvalidDataAccessResourceUsageException	Root for exceptions thrown when we use a data access resource incorrectly.
InvalidDestinationException	Runtime exception mirroring the JMS InvalidDestinationException.
InvalidIsolationLevelException	Exception that gets thrown when an invalid isolation level is specified, i.e.
InvalidMetadataException	Thrown by the `JmxAttributeSource` when it encounters incorrect metadata on a managed resource or one of its methods.
InvalidPropertyException	Exception thrown when referring to an invalid bean property.
InvalidResultSetAccessException	Exception thrown when a ResultSet has been accessed in an invalid fashion.
InvalidSelectorException	Runtime exception mirroring the JMS InvalidSelectorException.
InvalidTimeoutException	Exception that gets thrown when an invalid timeout is specified, that is, the specified timeout valid is out of range or the transaction manager implementation doesn't support timeouts.
InvocationFailureException	Thrown when an invocation on an MBean resource failed with an exception (either a reflection exception or an exception thrown by the target method itself).
JaxRpcSoapFaultException	This class is deprecated. in favor of JAX-WS support in `org.springframework.remoting.jaxws`
JaxWsSoapFaultException	Spring SoapFaultException adapter for the JAX-WS javax.xml.ws.soap.SOAPFaultException class.
JdbcUpdateAffectedIncorrectNumberOfRowsException	Exception thrown when a JDBC update affects an unexpected number of rows.
JdoObjectRetrievalFailureException	JDO-specific subclass of ObjectRetrievalFailureException.
JdoOptimisticLockingFailureException	JDO-specific subclass of ObjectOptimisticLockingFailureException.
JdoResourceFailureException	JDO-specific subclass of DataAccessResourceFailureException.
JdoSystemException	JDO-specific subclass of UncategorizedDataAccessException, for JDO system errors that do not match any concrete `org.springframework.dao` exceptions.
JdoUsageException	JDO-specific subclass of InvalidDataAccessApiUsageException.
JmsSecurityException	Runtime exception mirroring the JMS JMSSecurityException.
JpaObjectRetrievalFailureException	JPA-specific subclass of ObjectRetrievalFailureException.
JpaOptimisticLockingFailureException	JPA-specific subclass of ObjectOptimisticLockingFailureException.
JpaSystemException	JPA-specific subclass of UncategorizedDataAccessException, for JPA system errors that do not match any concrete `org.springframework.dao` exceptions.
ListenerExecutionFailedException	Exception to be thrown when the execution of a listener method failed.
LobRetrievalFailureException	Exception to be thrown when a LOB could not be retrieved.
MBeanConnectFailureException	Thrown when an invocation failed because of an I/O problem on the MBeanServerConnection.
MBeanExportException	Exception thrown in case of failure when exporting an MBean.
MBeanInfoRetrievalException	Thrown if an exception is encountered when trying to retrieve MBean metadata.
MBeanServerNotFoundException	Exception thrown when we cannot locate an instance of an `MBeanServer`, or when more than one instance is found.
MailAuthenticationException	Exception thrown on failed authentication.
MailParseException	Exception thrown if illegal message properties are encountered.
MailPreparationException	Exception to be thrown by user code if a mail cannot be prepared properly, for example when a Velocity template cannot be rendered for the mail text.
MailSendException	Exception thrown when a mail sending error is encountered.
MarshallingException	Base class for exception thrown when a marshalling or unmarshalling error occurs.
MarshallingFailureException	Exception thrown on marshalling failure.
MaxUploadSizeExceededException	MultipartException subclass thrown when an upload exceeds the maximum upload size allowed.
MessageConversionException	Thrown by `MessageConverter` implementations when the conversion of an object to/from a javax.jms.Message fails.
MessageEOFException	Runtime exception mirroring the JMS MessageEOFException.
MessageFormatException	Runtime exception mirroring the JMS MessageFormatException.
MessageNotReadableException	Runtime exception mirroring the JMS MessageNotReadableException.
MessageNotWriteableException	Runtime exception mirroring the JMS MessageNotWriteableException.
MethodInvocationException	Thrown when a bean property getter or setter method throws an exception, analogous to an InvocationTargetException.
NestedTransactionNotSupportedException	Exception thrown when attempting to work with a nested transaction but nested transactions are not supported by the underlying backend.
NoSuchBeanDefinitionException	Exception thrown when a BeanFactory is asked for a bean instance name for which it cannot find a definition.
NoTransactionException	Exception thrown when an operation is attempted that relies on an existing transaction (such as setting rollback status) and there is no existing transaction.
NonTransientDataAccessException	Root of the hierarchy of data access exceptions that are considered non-transient - where a retry of the same operation would fail unless the cause of the Exception is corrected.
NonTransientDataAccessResourceException	Data access exception thrown when a resource fails completely and the failure is permanent.
NotAnAtAspectException	Extension of AopConfigException thrown when trying to perform an advisor generation operation on a class that is not an AspectJ annotation-style aspect.
NotReadablePropertyException	Exception thrown on an attempt to get the value of a property that isn't readable, because there's no getter method.
NotWritablePropertyException	Exception thrown on an attempt to set the value of a property that is not writable (typically because there is no setter method).
NullValueInNestedPathException	Exception thrown when navigation of a valid nested property path encounters a NullPointerException.
ObjectOptimisticLockingFailureException	Exception thrown on an optimistic locking violation for a mapped object.
ObjectRetrievalFailureException	Exception thrown if a mapped object could not be retrieved via its identifier.
OptimisticLockingFailureException	Exception thrown on an optimistic locking violation.
PermissionDeniedDataAccessException	Exception thrown when the underlying resource denied a permission to access a specific element, such as a specific database table.
PessimisticLockingFailureException	Exception thrown on a pessimistic locking violation.
PropertyAccessException	Superclass for exceptions related to a property access, such as type mismatch or invocation target exception.
PropertyBatchUpdateException	Combined exception, composed of individual PropertyAccessException instances.
RecordTypeNotSupportedException	Exception thrown when the creating of a CCI Record failed because the connector doesn't support the desired CCI Record type.
RecoverableDataAccessException	Data access exception thrown when a previously failed operation might be able to succeed if the application performs some recovery steps and retries the entire transaction or in the case of a distributed transaction, the transaction branch.
RemoteConnectFailureException	RemoteAccessException subclass to be thrown when no connection could be established with a remote service.
RemoteInvocationFailureException	RemoteAccessException subclass to be thrown when the execution of the target method failed on the server side, for example when a method was not found on the target object.
RemoteLookupFailureException	RemoteAccessException subclass to be thrown in case of a lookup failure, typically if the lookup happens on demand for each method invocation.
RemoteProxyFailureException	RemoteAccessException subclass to be thrown in case of a failure within the client-side proxy for a remote service, for example when a method was not found on the underlying RMI stub.
ResourceAccessException	Exception thrown when an I/O error occurs.
ResourceAllocationException	Runtime exception mirroring the JMS ResourceAllocationException.
SQLWarningException	Exception thrown when we're not ignoring java.sql.SQLWarning SQLWarnings.
SoapFaultException	RemoteInvocationFailureException subclass that provides the details of a SOAP fault.
SqlXmlFeatureNotImplementedException	Exception thrown when the underlying implementation does not support the requested feature of the API.
SynchedLocalTransactionFailedException	Exception thrown when a synchronized local transaction failed to complete (after the main transaction has already completed).
TransactionInProgressException	Runtime exception mirroring the JMS TransactionInProgressException.
TransactionRolledBackException	Runtime exception mirroring the JMS TransactionRolledBackException.
TransactionSuspensionNotSupportedException	Exception thrown when attempting to suspend an existing transaction but transaction suspension is not supported by the underlying backend.
TransactionSystemException	Exception thrown when a general transaction system error is encountered, like on commit or rollback.
TransactionTimedOutException	Exception to be thrown when a transaction has timed out.
TransactionUsageException	Superclass for exceptions caused by inappropriate usage of a Spring transaction API.
TransientDataAccessException	Root of the hierarchy of data access exceptions that are considered transient - where a previously failed operation might be able to succeed when the operation is retried without any intervention by application-level functionality.
TransientDataAccessResourceException	Data access exception thrown when a resource fails temporarily and the operation can be retried.
TypeMismatchDataAccessException	Exception thrown on mismatch between Java type and database type: for example on an attempt to set an object of the wrong type in an RDBMS column.
TypeMismatchException	Exception thrown on a type mismatch when trying to set a bean property.
UnableToRegisterMBeanException	Exception thrown when we are unable to register an MBean, for example because of a naming conflict.
UnableToSendNotificationException	Thrown when a JMX javax.management.Notification is unable to be sent.
UncategorizedDataAccessException	Normal superclass when we can't distinguish anything more specific than "something went wrong with the underlying resource": for example, a SQLException from JDBC we can't pinpoint more precisely.
UncategorizedJmsException	JmsException to be thrown when no other matching subclass found.
UncategorizedMappingException	Exception that indicates that the cause cannot be distinguished further.
UncategorizedSQLException	Exception thrown when we can't classify a SQLException into one of our generic data access exceptions.
UnexpectedRollbackException	Thrown when an attempt to commit a transaction resulted in an unexpected rollback.
UnmarshallingFailureException	Exception thrown on unmarshalling failure.
UnsatisfiedDependencyException	Exception thrown when a bean depends on other beans or simple properties that were not specified in the bean factory definition, although dependency checking was enabled.
ValidationFailureException	Exception thrown on marshalling validation failure.
XmlBeanDefinitionStoreException	XML-specific BeanDefinitionStoreException subclass that wraps a org.xml.sax.SAXException, typically a org.xml.sax.SAXParseException which contains information about the error location.

Class Overview

Handy class for wrapping runtime Exceptions with a root cause.

This class is abstract to force the programmer to extend the class. getMessage will include nested exception information; printStackTrace and other like methods will delegate to the wrapped exception, if any.

The similarity between this class and the NestedCheckedException class is unavoidable, as Java forces these two classes to have different superclasses (ah, the inflexibility of concrete inheritance!).

Summary

Public Constructors
	NestedRuntimeException(String msg) Construct a `NestedRuntimeException` with the specified detail message.
	NestedRuntimeException(String msg, Throwable cause) Construct a `NestedRuntimeException` with the specified detail message and nested exception.

Public Methods
boolean	contains(Class exType) Check whether this exception contains an exception of the given type: either it is of the given class itself or it contains a nested cause of the given type.
String	getMessage() Return the detail message, including the message from the nested exception if there is one.
Throwable	getMostSpecificCause() Retrieve the most specific cause of this exception, that is, either the innermost cause (root cause) or this exception itself.
Throwable	getRootCause() Retrieve the innermost cause of this exception, if any.

[Expand]

Inherited Methods

From class java.lang.Throwable

From class java.lang.Object

Public Constructors

public NestedRuntimeException (String msg)

Also: SpringCore

Construct a NestedRuntimeException with the specified detail message.

Parameters

msg	the detail message

public NestedRuntimeException (String msg, Throwable cause)

Also: SpringCore

Construct a NestedRuntimeException with the specified detail message and nested exception.

Parameters

msg	the detail message
cause	the nested exception

Public Methods

public boolean contains (Class exType)

Also: SpringCore

Check whether this exception contains an exception of the given type: either it is of the given class itself or it contains a nested cause of the given type.

Parameters

exType	the exception type to look for

Returns

whether there is a nested exception of the specified type

public String getMessage ()

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

public Throwable getMostSpecificCause ()

Also: SpringCore

Retrieve the most specific cause of this exception, that is, either the innermost cause (root cause) or this exception itself.

Differs from getRootCause() in that it falls back to the present exception if there is no root cause.

Returns

the most specific cause (never null)

public Throwable getRootCause ()

Also: SpringCore

Retrieve the innermost cause of this exception, if any.

Returns

the innermost exception, or null if none

Interfaces

Classes

Exceptions

NestedRuntimeException

Class Overview

See Also

Summary

Public Constructors

public NestedRuntimeException (String msg)

Parameters

public NestedRuntimeException (String msg, Throwable cause)

Parameters

Public Methods

public boolean contains (Class exType)

Parameters

Returns

public String getMessage ()

public Throwable getMostSpecificCause ()

Returns

public Throwable getRootCause ()

Returns