Add AnalysisContext.onResultInvalidated(descriptor).

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

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library analyzer.src.generated.engine;
 
 import 'dart:async';
 import 'dart:collection';
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ skipping 502 matching lines @@
    */
   bool isServerLibrary(Source librarySource);
 
   /**
    * Return the stream that is notified when a new value for the given
    * [descriptor] is computed.
    */
   Stream<ComputedResult> onResultComputed(ResultDescriptor descriptor);
 
   /**
+   * Return the stream that is notified when a result with the given
+   * [descriptor] is invalidated.
+   */
+  Stream<InvalidatedResult> onResultInvalidated(ResultDescriptor descriptor);
+
+  /**
    * Parse the content of the given [source] to produce an AST structure. The
    * resulting AST structure may or may not be resolved, and may have a slightly
    * different structure depending upon whether it is resolved.
    *
    * Throws an [AnalysisException] if the analysis could not be performed
    *
    * <b>Note:</b> This method cannot be used in an async environment.
    */
   CompilationUnit parseCompilationUnit(Source source);
 
@@ skipping 1519 matching lines @@
    */
   void test_flushAstStructures(Source source);
 
   /**
    * Visit all entries of the content cache.
    */
   void visitContentCache(ContentCacheVisitor visitor);
 }
 
 /**
+ * [InvalidatedResult] describes an invalidated result.
+ */
+class InvalidatedResult<V> {

[Brian Wilkerson, 2016/03/08 17:54:31]

Maybe rename to InvalidatedResultEvent?

[scheglov, 2016/03/08 18:24:44]

Done.

+  /**
+   * The target in which the result was invalidated.
+   */
+  final CacheEntry entry;

[Brian Wilkerson, 2016/03/08 17:54:31]

I really don't want CacheEntry to be part of the public API. What information
from it are you expecting to need? Is it just the target, as implied by the
comment?

[scheglov, 2016/03/08 18:24:45]

I changed the set of fields to be like in ComputedResult, so now it does not
expose CacheEntry.

+
+  /**
+   * The descriptor of the result which was invalidated.
+   */
+  final ResultDescriptor<V> descriptor;
+
+  /**
+   * The value of the result which was invalidated.

[Brian Wilkerson, 2016/03/08 17:54:31]

"which was" --> "before it was"?

[scheglov, 2016/03/08 18:24:44]

Done.

+   */
+  final V value;
+
+  InvalidatedResult(this.entry, this.descriptor, this.value);
+
+  @override
+  String toString() => '$descriptor of ${entry.target}';

[Brian Wilkerson, 2016/03/08 17:54:31]

"'$d" --> "'Invalidated $d"? Otherwise it's too close to ComputedResult.
Speaking of which, maybe this object should contain a computed result and a
value instead of the current properties.

[scheglov, 2016/03/08 18:24:44]

Done.

+}
+
+/**
  * An object that can be used to receive information about errors within the
  * analysis engine. Implementations usually write this information to a file,
  * but can also record the information for later use (such as during testing) or
  * even ignore the information.
  */
 abstract class Logger {
   /**
    * A logger that ignores all logging.
    */
   static final Logger NULL = new NullLogger();
@@ skipping 407 matching lines @@
    * The data that was created from the source.
    */
   final E data;
 
   /**
    * Initialize a newly created holder to associate the given [data] with the
    * given [modificationTime].
    */
   TimestampedData(this.modificationTime, this.data);
 }