Package com.google.inject
Class ConfigurationException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.lang.RuntimeException
-
- com.google.inject.ConfigurationException
-
- All Implemented Interfaces:
Serializable
public final class ConfigurationException extends 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
- Author:
- jessewilson@google.com (Jesse Wilson)
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description ConfigurationException(Iterable<Message> messages)
Creates a ConfigurationException containingmessages
.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Collection<Message>
getErrorMessages()
Returns messages for the errors that caused this exception.String
getMessage()
<E> E
getPartialValue()
Returns a value that was only partially computed due to this exception.ConfigurationException
withPartialValue(Object partialValue)
Returns a copy of this configuration exception with the specified partial value.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Method Detail
-
withPartialValue
public ConfigurationException withPartialValue(Object partialValue)
Returns a copy of this configuration exception with the specified partial value.
-
getErrorMessages
public 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 String getMessage()
- Overrides:
getMessage
in classThrowable
-
-