| // 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 analysis_server.src.provisional.completion.completion_core; |
| |
| import 'dart:async'; |
| |
| import 'package:analysis_server/plugin/protocol/protocol.dart'; |
| import 'package:analysis_server/src/services/search/search_engine.dart'; |
| import 'package:analyzer/file_system/file_system.dart'; |
| import 'package:analyzer/src/generated/engine.dart' show AnalysisContext; |
| import 'package:analyzer/src/generated/source.dart'; |
| |
| /** |
| * An empty list returned by [CompletionContributor]s |
| * when they have no suggestions to contribute. |
| */ |
| const EMPTY_LIST = const <CompletionSuggestion>[]; |
| |
| /** |
| * An object used to instantiate a [CompletionContributor] instance |
| * for each 'completion.getSuggestions' request. |
| * Contributors should *not* be cached between requests. |
| */ |
| typedef CompletionContributor CompletionContributorFactory(); |
| |
| /** |
| * [AbortCompletion] is thrown when the current completion request |
| * should be aborted because either |
| * the source changed since the request was made, or |
| * a new completion request was received. |
| */ |
| class AbortCompletion {} |
| |
| /** |
| * An object used to produce completions at a specific location within a file. |
| * |
| * Clients may implement this class when implementing plugins. |
| */ |
| abstract class CompletionContributor { |
| /** |
| * Return a [Future] that completes with a list of suggestions |
| * for the given completion [request]. This will |
| * throw [AbortCompletion] if the completion request has been aborted. |
| */ |
| Future<List<CompletionSuggestion>> computeSuggestions( |
| CompletionRequest request); |
| } |
| |
| /** |
| * The information about a requested list of completions. |
| * |
| * Clients may not extend, implement or mix-in this class. |
| */ |
| abstract class CompletionRequest { |
| /** |
| * Return the analysis context in which the completion is being requested. |
| */ |
| AnalysisContext get context; |
| |
| /** |
| * Return the offset within the source at which the completion is being |
| * requested. |
| */ |
| int get offset; |
| |
| /** |
| * Return the resource provider associated with this request. |
| */ |
| ResourceProvider get resourceProvider; |
| |
| /** |
| * Return the search engine. |
| */ |
| SearchEngine get searchEngine; |
| |
| /** |
| * Return the source in which the completion is being requested. |
| */ |
| Source get source; |
| |
| /** |
| * Throw [AbortCompletion] if the completion request has been aborted. |
| */ |
| void checkAborted(); |
| } |