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 and Description
ConfigurationException(Iterable<Message> messages) Creates a ConfigurationException containing messages.

Method Summary

Methods

Modifier and Type	Method and 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

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurationException

public ConfigurationException(Iterable<Message> messages)

Creates a ConfigurationException containing messages.

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 class Throwable