Class Message

core/src/com/google/inject/spi/Message.java:47–181

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 com.google.inject.Binder#addError(Throwable) addError() statements: try { bindPropertiesFromFile()

 * @author crazybob@google.com (Bob Lee)
 */
public final class Message implements Serializable, Element {
  private final ErrorId errorId;
  private final ErrorDetail<?> errorDetail;

  /** @since 5.0 */
  public Message(GuiceInternal internalOnly, ErrorId errorId, ErrorDetail<?> errorDetail) {
    checkNotNull(internalOnly);
    this.errorId = errorId;
    this.errorDetail = errorDetail;
  }

  private Message(ErrorId errorId, ErrorDetail<?> errorDetail) {
    this.errorId = errorId;
    this.errorDetail = errorDetail;
  }

  /** @since 2.0 */
  public Message(ErrorId errorId, List<Object> sources, String message, Throwable cause) {
    this.errorId = errorId;
    this.errorDetail = new GenericErrorDetail(errorId, message, sources, cause);
  }

  /** @since 2.0 */
  public Message(List<Object> sources, String message, Throwable cause) {
    this(ErrorId.OTHER, sources, message, cause);
  }

  /** @since 4.0 */
  public Message(String message, Throwable cause) {
    this(ImmutableList.of(), message, cause);
  }

  public Message(Object source, String message) {
    this(ImmutableList.of(source), message, null);
  }

  public Message(String message) {
    this(ImmutableList.of(), message, null);
  }

  /**
   * Returns details about this error message.
   *
   * @since 5.0
   */
  public ErrorDetail<?> getErrorDetail() {
    return errorDetail;
  }

  @Override
  public String getSource() {
    List<Object> sources = errorDetail.getSources();
    return sources.isEmpty()
        ? SourceProvider.UNKNOWN_SOURCE.toString()
        : Errors.convert(Iterables.getLast(sources)).toString();
  }

  /** @since 2.0 */