Optimize top-level element declarations search.

pkg/analysis_server/lib/src/services/index/index_store.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 services.index_store;
 
 import 'dart:async';
 
 import 'package:analysis_server/src/services/index/index.dart';
 import 'package:analyzer/src/generated/element.dart';
@@ skipping 66 matching lines @@
    *
    * [element] - the the [Element] that has the relationship with the locations
    *    to be returned.
    * [relationship] - the [Relationship] between the given element and the
    *    locations to be returned
    */
   Future<List<Location>> getRelationships(Element element,
       Relationship relationship);
 
   /**
+   * Returns top-level [Element]s whose names satisfy to [nameFilter].
+   */
+  List<Element> getTopDeclarations(ElementNameFilter nameFilter);

[Brian Wilkerson, 2015/03/02 19:20:07]

"Top" --> "TopLevel"? I know it's longer, but I think it reads better.

[scheglov, 2015/03/02 19:55:46]

Done.

+
+  /**
    * Records that the given [element] and [location] have the given
    * [relationship].
    *
    * For example, if the [relationship] is the `is-invoked-by` relationship,
    * then [element] would be the function being invoked and [location] would be
    * the point at which it is referenced. Each element can have the same
    * relationship with multiple locations. In other words, if the following code
    * were executed
    *
    *     recordRelationship(element, isReferencedBy, location1);
    *     recordRelationship(element, isReferencedBy, location2);
    *
    * then both relationships would be maintained in the index and the result of executing
    *
    *     getRelationship(element, isReferencedBy);
    *
    * would be a list containing both `location1` and `location2`.
    *
    * [element] - the [Element] that is related to the location.
    * [relationship] - the [Relationship] between the element and the location.
    * [location] the [Location] where relationship happens.
    */
   void recordRelationship(Element element, Relationship relationship,
       Location location);
 
   /**
+   * Records the declaration of the given top-level [element].
+   */
+  void recordTopDeclaration(Element element);
+
+  /**
    * Removes from the index all of the information associated with [context].
    *
    * This method should be invoked when [context] is disposed.
    *
    * [context] - the [AnalysisContext] being removed.
    */
   void removeContext(AnalysisContext context);
 
   /**
    * Removes from the index all of the information associated with elements or
@@ skipping 16 matching lines @@
    * any other elements and a location within the given sources.
    *
    * This method should be invoked when multiple sources are no longer part of
    * the code base.
    *
    * [context] - the [AnalysisContext] in which [Source]s being removed.
    * [container] - the [SourceContainer] holding the sources being removed.
    */
   void removeSources(AnalysisContext context, SourceContainer container);
 }