New analyzer snapshot.

pkg/analyzer/lib/src/generated/error.dart

 // This code was auto-generated, is not intended to be edited, and is subject to
 // significant change. Please see the README file for more information.
 
 library engine.error;
 
 import 'java_core.dart';
 import 'source.dart';
 import 'scanner.dart' show Token;
 import 'ast.dart' show ASTNode;
 import 'element.dart' show Element;
@@ skipping 25 matching lines @@
   /**
    * The severity representing an error.
    */
   static final ErrorSeverity ERROR = new ErrorSeverity('ERROR', 3, "E", "error");
 
   static final List<ErrorSeverity> values = [NONE, INFO, WARNING, ERROR];
 
   /**
    * The name of the severity used when producing machine output.
    */
-  String machineCode;
+  final String machineCode;
 
   /**
    * The name of the severity used when producing readable output.
    */
-  String displayName;
+  final String displayName;
 
   /**
    * Initialize a newly created severity with the given names.
    *
    * @param machineCode the name of the severity used when producing machine output
    * @param displayName the name of the severity used when producing readable output
    */
-  ErrorSeverity(String name, int ordinal, String machineCode, String displayName) : super(name, ordinal) {
-    this.machineCode = machineCode;
-    this.displayName = displayName;
-  }
+  ErrorSeverity(String name, int ordinal, this.machineCode, this.displayName) : super(name, ordinal);
 
   /**
    * Return the severity constant that represents the greatest severity.
    *
    * @param severity the severity being compared against
    * @return the most sever of this or the given severity
    */
   ErrorSeverity max(ErrorSeverity severity) => this.ordinal >= severity.ordinal ? this : severity;
 }
 
@@ skipping 42 matching lines @@
 }
 
 /**
  * Instances of the class `BooleanErrorListener` implement a listener that keeps track of
  * whether an error has been reported to it.
  */
 class BooleanErrorListener implements AnalysisErrorListener {
   /**
    * A flag indicating whether an error has been reported to this listener.
    */
-  bool errorReported = false;
+  bool _errorReported = false;
+
+  /**
+   * Return `true` if an error has been reported to this listener.
+   *
+   * @return `true` if an error has been reported to this listener
+   */
+  bool get errorReported => _errorReported;
 
   void onError(AnalysisError error) {
-    errorReported = true;
+    _errorReported = true;
   }
 }
 
 /**
  * Instances of the class `ErrorReporter` wrap an error listener with utility methods used to
  * create the errors being reported.
  *
  * @coverage dart.engine.error
  */
 class ErrorReporter {
@@ skipping 136 matching lines @@
     if (errorSeverity1 == errorSeverity2) {
       return errorType1.compareTo(errorType2);
     } else {
       return errorSeverity2.compareTo(errorSeverity1);
     }
   };
 
   /**
    * The error code associated with the error.
    */
-  ErrorCode errorCode;
+  final ErrorCode errorCode;
 
   /**
    * The localized error message.
    */
-  String message;
+  String _message;
 
   /**
    * The correction to be displayed for this error, or `null` if there is no correction
    * information for this error.
    */
-  String correction;
+  String _correction;
 
   /**
    * The source in which the error occurred, or `null` if unknown.
    */
   Source source;
 
   /**
    * The character offset from the beginning of the source (zero based) where the error occurred.
    */
-  int offset = 0;
+  int _offset = 0;
 
   /**
    * The number of characters from the offset to the end of the source which encompasses the
    * compilation error.
    */
-  int length = 0;
+  int _length = 0;
 
   /**
    * A flag indicating whether this error can be shown to be a non-issue because of the result of
    * type propagation.
    */
   bool isStaticOnly = false;
 
   /**
    * Initialize a newly created analysis error for the specified source. The error has no location
    * information.
    *
    * @param source the source for which the exception occurred
    * @param errorCode the error code to be associated with this error
    * @param arguments the arguments used to build the error message
    */
-  AnalysisError.con1(Source source, ErrorCode errorCode, List<Object> arguments) {
-    this.source = source;
-    this.errorCode = errorCode;
-    this.message = JavaString.format(errorCode.message, arguments);
+  AnalysisError.con1(this.source, this.errorCode, List<Object> arguments) {
+    this._message = JavaString.format(errorCode.message, arguments);
   }
 
   /**
    * Initialize a newly created analysis error for the specified source at the given location.
    *
    * @param source the source for which the exception occurred
    * @param offset the offset of the location of the error
    * @param length the length of the location of the error
    * @param errorCode the error code to be associated with this error
    * @param arguments the arguments used to build the error message
    */
-  AnalysisError.con2(Source source, int offset, int length, ErrorCode errorCode, List<Object> arguments) {
-    this.source = source;
-    this.offset = offset;
-    this.length = length;
-    this.errorCode = errorCode;
-    this.message = JavaString.format(errorCode.message, arguments);
+  AnalysisError.con2(this.source, int offset, int length, this.errorCode, List<Object> arguments) {
+    this._offset = offset;
+    this._length = length;
+    this._message = JavaString.format(errorCode.message, arguments);
     String correctionTemplate = errorCode.correction;
     if (correctionTemplate != null) {
-      this.correction = JavaString.format(correctionTemplate, arguments);
+      this._correction = JavaString.format(correctionTemplate, arguments);
     }
   }
 
   bool operator ==(Object obj) {
     if (identical(obj, this)) {
       return true;
     }
     if (obj is! AnalysisError) {
       return false;
     }
     AnalysisError other = obj as AnalysisError;
     if (errorCode != other.errorCode) {
       return false;
     }
-    if (offset != other.offset || length != other.length) {
+    if (_offset != other._offset || _length != other._length) {
       return false;
     }
     if (isStaticOnly != other.isStaticOnly) {
       return false;
     }
-    if (message != other.message) {
+    if (_message != other._message) {
       return false;
     }
     if (source != other.source) {
       return false;
     }
     return true;
   }
 
   /**
+   * Return the correction to be displayed for this error, or `null` if there is no correction
+   * information for this error. The correction should indicate how the user can fix the error.
+   *
+   * @return the template used to create the correction to be displayed for this error
+   */
+  String get correction => _correction;
+
+  /**
+   * Return the number of characters from the offset to the end of the source which encompasses the
+   * compilation error.
+   *
+   * @return the length of the error location
+   */
+  int get length => _length;
+
+  /**
+   * Return the message to be displayed for this error. The message should indicate what is wrong
+   * and why it is wrong.
+   *
+   * @return the message to be displayed for this error
+   */
+  String get message => _message;
+
+  /**
+   * Return the character offset from the beginning of the source (zero based) where the error
+   * occurred.
+   *
+   * @return the offset to the start of the error location
+   */
+  int get offset => _offset;
+
+  /**
    * Return the value of the given property, or `null` if the given property is not defined
    * for this error.
    *
    * @param property the property whose value is to be returned
    * @return the value of the given property
    */
   Object getProperty(ErrorProperty property) => null;
 
   int get hashCode {
-    int hashCode = offset;
-    hashCode ^= (message != null) ? message.hashCode : 0;
+    int hashCode = _offset;
+    hashCode ^= (_message != null) ? _message.hashCode : 0;
     hashCode ^= (source != null) ? source.hashCode : 0;
     return hashCode;
   }
 
   String toString() {
     JavaStringBuilder builder = new JavaStringBuilder();
     builder.append((source != null) ? source.fullName : "<unknown source>");
     builder.append("(");
-    builder.append(offset);
+    builder.append(_offset);
     builder.append("..");
-    builder.append(offset + length - 1);
+    builder.append(_offset + _length - 1);
     builder.append("): ");
-    builder.append(message);
+    builder.append(_message);
     return builder.toString();
   }
 }
 
 /**
  * The enumeration `ErrorProperty` defines the properties that can be associated with an
  * [AnalysisError].
  */
 class ErrorProperty extends Enum<ErrorProperty> {
   /**
@@ skipping 219 matching lines @@
       UNDEFINED_OPERATOR,
       UNDEFINED_SETTER,
       UNNECESSARY_CAST,
       UNNECESSARY_TYPE_CHECK_FALSE,
       UNNECESSARY_TYPE_CHECK_TRUE,
       UNUSED_IMPORT];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction3;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  HintCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  HintCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  HintCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  HintCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction3 = correction;
   }
 
   String get correction => correction3;
 
   ErrorSeverity get errorSeverity => ErrorType.HINT.severity;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.HINT;
 }
 
 /**
  * The interface `ErrorCode` defines the behavior common to objects representing error codes
  * associated with [AnalysisError].
  *
  * Generally, we want to provide messages that consist of three sentences: 1. what is wrong, 2. why
  * is it wrong, and 3. how do I fix it. However, we combine the first two in the result of
  * [getMessage] and the last in the result of [getCorrection].
@@ skipping 84 matching lines @@
       HINT,
       COMPILE_TIME_ERROR,
       PUB_SUGGESTION,
       STATIC_WARNING,
       STATIC_TYPE_WARNING,
       SYNTACTIC_ERROR];
 
   /**
    * The severity of this type of error.
    */
-  ErrorSeverity severity;
+  final ErrorSeverity severity;
 
   /**
    * Initialize a newly created error type to have the given severity.
    *
    * @param severity the severity of this type of error
    */
-  ErrorType(String name, int ordinal, ErrorSeverity severity) : super(name, ordinal) {
-    this.severity = severity;
-  }
+  ErrorType(String name, int ordinal, this.severity) : super(name, ordinal);
 
   String get displayName => name.toLowerCase().replaceAll('_', ' ');
 }
 
 /**
  * The enumeration `CompileTimeErrorCode` defines the error codes used for compile time
  * errors. The convention for this class is for the name of the error code to indicate the problem
  * that caused the error to be generated and for the error message to explain what is wrong and,
  * when appropriate, how the problem can be corrected.
  *
@@ skipping 1303 matching lines @@
       UNDEFINED_NAMED_PARAMETER,
       URI_DOES_NOT_EXIST,
       URI_WITH_INTERPOLATION,
       WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR,
       WRONG_NUMBER_OF_PARAMETERS_FOR_OPERATOR_MINUS,
       WRONG_NUMBER_OF_PARAMETERS_FOR_SETTER];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction2;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  CompileTimeErrorCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  CompileTimeErrorCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  CompileTimeErrorCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  CompileTimeErrorCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction2 = correction;
   }
 
   String get correction => correction2;
 
   ErrorSeverity get errorSeverity => ErrorType.COMPILE_TIME_ERROR.severity;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.COMPILE_TIME_ERROR;
 }
 
 /**
  * The enumeration `PubSuggestionCode` defines the suggestions used for reporting deviations
  * from pub best practices. The convention for this class is for the name of the bad practice to
  * indicate the problem that caused the suggestion to be generated and for the message to explain
  * what is wrong and, when appropriate, how the situation can be corrected.
  */
 class PubSuggestionCode extends Enum<PubSuggestionCode> implements ErrorCode {
@@ skipping 21 matching lines @@
   static final PubSuggestionCode PACKAGE_IMPORT_CONTAINS_DOT_DOT = new PubSuggestionCode.con1('PACKAGE_IMPORT_CONTAINS_DOT_DOT', 2, "A package import should not contain '..'");
 
   static final List<PubSuggestionCode> values = [
       FILE_IMPORT_INSIDE_LIB_REFERENCES_FILE_OUTSIDE,
       FILE_IMPORT_OUTSIDE_LIB_REFERENCES_FILE_INSIDE,
       PACKAGE_IMPORT_CONTAINS_DOT_DOT];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction5;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  PubSuggestionCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  PubSuggestionCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  PubSuggestionCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  PubSuggestionCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction5 = correction;
   }
 
   String get correction => correction5;
 
   ErrorSeverity get errorSeverity => ErrorType.PUB_SUGGESTION.severity;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.PUB_SUGGESTION;
 }
 
 /**
  * The enumeration `StaticWarningCode` defines the error codes used for static warnings. The
  * convention for this class is for the name of the error code to indicate the problem that caused
  * the error to be generated and for the error message to explain what is wrong and, when
  * appropriate, how the problem can be corrected.
  *
  * @coverage dart.engine.error
@@ skipping 841 matching lines @@
       UNDEFINED_CLASS_BOOLEAN,
       UNDEFINED_GETTER,
       UNDEFINED_IDENTIFIER,
       UNDEFINED_NAMED_PARAMETER,
       UNDEFINED_SETTER,
       UNDEFINED_STATIC_METHOD_OR_GETTER];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction7;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  StaticWarningCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  StaticWarningCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  StaticWarningCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  StaticWarningCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction7 = correction;
   }
 
   String get correction => correction7;
 
   ErrorSeverity get errorSeverity => ErrorType.STATIC_WARNING.severity;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.STATIC_WARNING;
 }
 
 /**
  * The interface `AnalysisErrorListener` defines the behavior of objects that listen for
  * [AnalysisError] being produced by the analysis engine.
  *
  * @coverage dart.engine.error
  */
 abstract class AnalysisErrorListener {
@@ skipping 38 matching lines @@
    *
    * @param uri the URI pointing to a non-existent file
    */
   static final HtmlWarningCode URI_DOES_NOT_EXIST = new HtmlWarningCode.con1('URI_DOES_NOT_EXIST', 1, "Target of URI does not exist: '%s'");
 
   static final List<HtmlWarningCode> values = [INVALID_URI, URI_DOES_NOT_EXIST];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction4;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  HtmlWarningCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  HtmlWarningCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  HtmlWarningCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  HtmlWarningCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction4 = correction;
   }
 
   String get correction => correction4;
 
   ErrorSeverity get errorSeverity => ErrorSeverity.WARNING;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.STATIC_WARNING;
 }
 
 /**
  * The enumeration `StaticTypeWarningCode` defines the error codes used for static type
  * warnings. The convention for this class is for the name of the error code to indicate the problem
  * that caused the error to be generated and for the error message to explain what is wrong and,
  * when appropriate, how the problem can be corrected.
  *
  * @coverage dart.engine.error
@@ skipping 278 matching lines @@
       UNDEFINED_METHOD,
       UNDEFINED_OPERATOR,
       UNDEFINED_SETTER,
       UNDEFINED_SUPER_METHOD,
       UNQUALIFIED_REFERENCE_TO_NON_LOCAL_STATIC_MEMBER,
       WRONG_NUMBER_OF_TYPE_ARGUMENTS];
 
   /**
    * The template used to create the message to be displayed for this error.
    */
-  String _message;
+  final String message;
 
   /**
    * The template used to create the correction to be displayed for this error, or `null` if
    * there is no correction information for this error.
    */
   String correction6;
 
   /**
    * Initialize a newly created error code to have the given message.
    *
    * @param message the message template used to create the message to be displayed for the error
    */
-  StaticTypeWarningCode.con1(String name, int ordinal, String message) : super(name, ordinal) {
-    this._message = message;
-  }
+  StaticTypeWarningCode.con1(String name, int ordinal, this.message) : super(name, ordinal);
 
   /**
    * Initialize a newly created error code to have the given message and correction.
    *
    * @param message the template used to create the message to be displayed for the error
    * @param correction the template used to create the correction to be displayed for the error
    */
-  StaticTypeWarningCode.con2(String name, int ordinal, String message, String correction) : super(name, ordinal) {
-    this._message = message;
+  StaticTypeWarningCode.con2(String name, int ordinal, this.message, String correction) : super(name, ordinal) {
     this.correction6 = correction;
   }
 
   String get correction => correction6;
 
   ErrorSeverity get errorSeverity => ErrorType.STATIC_TYPE_WARNING.severity;
 
-  String get message => _message;
-
   ErrorType get type => ErrorType.STATIC_TYPE_WARNING;
 }