Package com.google.inject

Class ConfigurationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.google.inject.ConfigurationException

public final class ConfigurationException
extends java.lang.RuntimeException

Thrown when a programming error such as a misplaced annotation, illegal binding, or unsupported scope is found. Clients should catch this exception, log it, and stop execution.

Since:

2.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
ConfigurationException(java.lang.Iterable<Message> messages)	Creates a ConfigurationException containing messages.

Method Summary

Modifier and Type	Method	Description
java.util.Collection<Message>	getErrorMessages()	Returns messages for the errors that caused this exception.
java.lang.String	getMessage()
<E> E	getPartialValue()	Returns a value that was only partially computed due to this exception.
ConfigurationException	withPartialValue(java.lang.Object partialValue)	Returns a copy of this configuration exception with the specified partial value.

Methods inherited from class java.lang.Object

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

Methods inherited from class java.lang.Throwable

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

Constructor Detail

ConfigurationException

public ConfigurationException(java.lang.Iterable<Message> messages)

Creates a ConfigurationException containing messages.

Method Detail

withPartialValue

public ConfigurationException withPartialValue(java.lang.Object partialValue)

Returns a copy of this configuration exception with the specified partial value.

getErrorMessages

public java.util.Collection<Message> getErrorMessages()

Returns messages for the errors that caused this exception.

getPartialValue

public <E> E getPartialValue()

Returns a value that was only partially computed due to this exception. The caller can use this while collecting additional configuration problems.

Returns:

the partial value, or null if none was set. The type of the partial value is specified by the throwing method.

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable