State-carrying context API.

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

Index: pkg/analyzer/lib/src/generated/engine.dart
diff --git a/pkg/analyzer/lib/src/generated/engine.dart b/pkg/analyzer/lib/src/generated/engine.dart
index 7ec28c5793280c0b899a70607590afc5c110eea5..9c37c3646f495da987dc541b77f89bc1f52b0b2f 100644
--- a/pkg/analyzer/lib/src/generated/engine.dart
+++ b/pkg/analyzer/lib/src/generated/engine.dart
@@ -470,6 +470,12 @@ abstract class AnalysisContext {
   String computeDocumentationComment(Element element);
 
   /**
+   * Return the stored state associated with the given object key.  In case no
+   * state has been associated with the given [key], returns `null`.
+   */
+  Object getState(Object key);
+
+  /**
    * Return a list containing all of the errors associated with the given
    * [source]. If the errors are not already known then the source will be
    * analyzed in order to determine the errors associated with it.
@@ -894,6 +900,11 @@ abstract class AnalysisContext {
   void setContents(Source source, String contents);
 
   /**
+   * Associate this [state] object with the given state [key].

[Brian Wilkerson, 2015/10/13 20:50:58]

"state [key]" --> "[key]"

Perhaps a Dart-like @see: "Use the method [getState] to retrieve the value that
was set." (and another with 'getState').

+   */
+  void setState(Object key, Object state);
+
+  /**
    * Check the cache for any invalid entries (entries whose modification time
    * does not match the modification time of the source associated with the
    * entry). Invalid entries will be marked as invalid so that the source will