Package com.google.inject.spi

Class Message

java.lang.Object

com.google.inject.spi.Message

All Implemented Interfaces:

Element, Serializable

public final class Message
extends Object
implements Serializable, Element

An error message and the context in which it occurred. Messages are usually created internally by Guice and its extensions. Messages can be created explicitly in a module using addError() statements:

     try {
       bindPropertiesFromFile();
     } catch (IOException e) {
       addError(e);
     }

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
Message(com.google.inject.internal.ErrorId errorId, List<Object> sources, String message, Throwable cause)
Message(com.google.inject.internal.GuiceInternal internalOnly, com.google.inject.internal.ErrorId errorId, ErrorDetail<?> errorDetail)
Message(Object source, String message)
Message(String message)
Message(String message, Throwable cause)
Message(List<Object> sources, String message, Throwable cause)

Method Summary

Modifier and Type	Method	Description
<T> T	acceptVisitor(ElementVisitor<T> visitor)	Accepts an element visitor.
void	applyTo(Binder binder)	Writes this module element to the given binder (optional operation).
boolean	equals(Object o)
Throwable	getCause()	Returns the throwable that caused this message, or null if this message was not caused by a throwable.
ErrorDetail<?>	getErrorDetail()	Returns details about this error message.
String	getMessage()	Gets the error message text.
String	getSource()	Returns an arbitrary object containing information about the "place" where this element was configured.
List<Object>	getSources()
int	hashCode()
String	toString()
Message	withSource(List<Object> newSources)	Returns a copy of this Message with its sources replaced.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Message

public Message(com.google.inject.internal.GuiceInternal internalOnly,
               com.google.inject.internal.ErrorId errorId,
               ErrorDetail<?> errorDetail)

Since:

5.0

Message

public Message(com.google.inject.internal.ErrorId errorId,
               List<Object> sources,
               String message,
               Throwable cause)

Since:

2.0

Message

public Message(List<Object> sources,
               String message,
               Throwable cause)

Since:

2.0

Message

public Message(String message,
               Throwable cause)

Since:

4.0

Message

public Message(Object source,
               String message)

Message

public Message(String message)

Method Detail

getErrorDetail

public ErrorDetail<?> getErrorDetail()

Returns details about this error message.

Since:

5.0

getSource

public String getSource()

Description copied from interface: Element

Returns an arbitrary object containing information about the "place" where this element was configured. Used by Guice in the production of descriptive error messages.

Tools might specially handle types they know about; StackTraceElement is a good example. Tools should simply call toString() on the source object if the type is unfamiliar.

Specified by:

getSource in interface Element

getSources

public List<Object> getSources()

Since:

2.0

getMessage

public String getMessage()

Gets the error message text.

acceptVisitor

public <T> T acceptVisitor(ElementVisitor<T> visitor)

Description copied from interface: Element

Accepts an element visitor. Invokes the visitor method specific to this element's type.

Specified by:

acceptVisitor in interface Element

Parameters:

visitor - to call back on

Since:

2.0

getCause

public Throwable getCause()

Returns the throwable that caused this message, or null if this message was not caused by a throwable.

Since:

2.0

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

applyTo

public void applyTo(Binder binder)

Description copied from interface: Element

Writes this module element to the given binder (optional operation).

Specified by:

applyTo in interface Element

Parameters:

binder - to apply configuration element to

Since:

2.0

withSource

public Message withSource(List<Object> newSources)

Returns a copy of this Message with its sources replaced.

Since:

5.0