Add hook for listening to implicitly analyzed files

pkg/analyzer/lib/src/context/cache.dart

 // Copyright (c) 2015, 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.context.cache;
 
 import 'dart:async';
 import 'dart:collection';
 
 import 'package:analyzer/src/generated/engine.dart'
@@ skipping 197 matching lines @@
         }
         partition.put(entry);
         return;
       }
     }
     // TODO(brianwilkerson) Handle the case where no partition was found,
     // possibly by throwing an exception.
   }
 
   /**
-   * Remove all information related to the given [target] from this cache.
+   * Remove all information related to the given [target] from this cache and
+   * return the entry associated with the target.

[Paul Berry, 2015/07/15 19:50:01]

Let's also document the fact that we return `null` if there was no cache entry
for the target.

[Brian Wilkerson, 2015/07/15 21:23:37]

Done

    */
-  void remove(AnalysisTarget target) {
+  CacheEntry remove(AnalysisTarget target) {
     int count = _partitions.length;
     for (int i = 0; i < count; i++) {
       CachePartition partition = _partitions[i];
       if (partition.isResponsibleFor(target)) {
         if (_TRACE_CHANGES) {
           AnalysisEngine.instance.logger
               .logInformation('Removed the cache entry for $target.');
         }
-        partition.remove(target);
-        return;
+        return partition.remove(target);
       }
     }
+    return null;
   }
 
   /**
    * Return the number of targets that are mapped to cache entries.
    */
   int size() {
     int size = 0;
     int count = _partitions.length;
     for (int i = 0; i < count; i++) {
       size += _partitions[i].size();
@@ skipping 646 matching lines @@
       throw new StateError(
           'The entry for $target is already in ${entry._partition}');
     }
     entry._partition = this;
     entry.fixExceptionState();
     _targetMap[target] = entry;
     _addIfSource(target);
   }
 
   /**
-   * Remove all information related to the given [target] from this cache.
+   * Remove all information related to the given [target] from this partition
+   * and return the entry associated with the target.

[Paul Berry, 2015/07/15 19:50:01]

Similar comment here.

[Brian Wilkerson, 2015/07/15 21:23:37]

Done

    */
-  void remove(AnalysisTarget target) {
+  CacheEntry remove(AnalysisTarget target) {
     for (CacheFlushManager flushManager in _flushManagerMap.values) {
       flushManager.targetRemoved(target);
     }
     CacheEntry entry = _targetMap.remove(target);
     if (entry != null) {
       entry._invalidateAll();
     }
     _removeIfSource(target);
+    return entry;
   }
 
   /**
    * Records that a value of the result described by the given [descriptor]
    * for the given [target] was just read from the cache.
    */
   void resultAccessed(AnalysisTarget target, ResultDescriptor descriptor) {
     CacheFlushManager flushManager = _getFlushManager(descriptor);
     TargetedResult result = new TargetedResult(target, descriptor);
     flushManager.resultAccessed(result);
@@ skipping 54 matching lines @@
       _flushManagerMap[policy] = manager;
     }
     return manager;
   }
 
   bool _isPriorityAnalysisTarget(AnalysisTarget target) {
     return context.priorityTargets.contains(target);
   }
 
   /**
-   * If the given [target] is a [Source], removes it from [_sources].
+   * If the given [target] is a [Source], remove it from the list of [_sources].
    */
   void _removeIfSource(AnalysisTarget target) {
     if (target is Source) {
       _sources.remove(target);
-      {
-        String fullName = target.fullName;
-        List<Source> sources = _pathToSources[fullName];
-        if (sources != null) {
-          sources.remove(target);
-          if (sources.isEmpty) {
-            _pathToSources.remove(fullName);
-          }
+      String fullName = target.fullName;
+      List<Source> sources = _pathToSources[fullName];
+      if (sources != null) {
+        sources.remove(target);
+        if (sources.isEmpty) {
+          _pathToSources.remove(fullName);
         }
       }
     }
   }
 }
 
 /**
  * The description for a change.
  */
 class Delta {
@@ skipping 172 matching lines @@
   void resultAccessed(TargetedResult result) {}
 
   @override
   List<TargetedResult> resultStored(TargetedResult newResult, newValue) {
     return TargetedResult.EMPTY_LIST;
   }
 
   @override
   void targetRemoved(AnalysisTarget target) {}
 }