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 occured. 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);
     }

Author:

crazybob@google.com (Bob Lee)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Message(List<Object> sources, String message, Throwable cause)
Message(Object source, String message)
Message(String message)
Message(String message, Throwable cause)

Method Summary

Methods

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

Methods inherited from class java.lang.Object

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

Constructor Detail

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

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