OLD | NEW |
| (Empty) |
1 // Copyright (c) 2016, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 import 'dart:async'; | |
6 import 'dart:core'; | |
7 import 'dart:math' as math; | |
8 | |
9 import 'package:analysis_server/src/context_manager.dart'; | |
10 import 'package:analyzer/file_system/file_system.dart'; | |
11 import 'package:analyzer/plugin/resolver_provider.dart'; | |
12 import 'package:analyzer/src/dart/analysis/driver.dart'; | |
13 import 'package:analyzer/src/generated/engine.dart'; | |
14 import 'package:analyzer/src/generated/sdk.dart'; | |
15 import 'package:analyzer/src/generated/source.dart'; | |
16 import 'package:analyzer/src/util/glob.dart'; | |
17 import 'package:path/path.dart' as path; | |
18 import 'package:watcher/watcher.dart'; | |
19 | |
20 /** | |
21 * Implementation of [ContextManager] that supports only one [AnalysisContext]. | |
22 * So, sources from all analysis roots are added to this single context. All | |
23 * features that could otherwise cause creating additional contexts, such as | |
24 * presence of `pubspec.yaml` or `.packages` files, or analysis options files | |
25 * are ignored. | |
26 */ | |
27 class SingleContextManager implements ContextManager { | |
28 /** | |
29 * The [ResourceProvider] using which paths are converted into [Resource]s. | |
30 */ | |
31 final ResourceProvider resourceProvider; | |
32 | |
33 /** | |
34 * The context used to work with file system paths. | |
35 */ | |
36 path.Context pathContext; | |
37 | |
38 /** | |
39 * The manager used to access the SDK that should be associated with a | |
40 * particular context. | |
41 */ | |
42 final DartSdkManager sdkManager; | |
43 | |
44 /** | |
45 * A function that will return a [UriResolver] that can be used to resolve | |
46 * `package:` URIs. | |
47 */ | |
48 final ResolverProvider packageResolverProvider; | |
49 | |
50 /** | |
51 * A list of the globs used to determine which files should be analyzed. | |
52 */ | |
53 final List<Glob> analyzedFilesGlobs; | |
54 | |
55 /** | |
56 * The default options used to create new analysis contexts. | |
57 */ | |
58 final AnalysisOptionsImpl defaultContextOptions; | |
59 | |
60 /** | |
61 * The list of included paths (folders and files) most recently passed to | |
62 * [setRoots]. | |
63 */ | |
64 List<String> includedPaths = <String>[]; | |
65 | |
66 /** | |
67 * The list of excluded paths (folders and files) most recently passed to | |
68 * [setRoots]. | |
69 */ | |
70 List<String> excludedPaths = <String>[]; | |
71 | |
72 /** | |
73 * The map of package roots most recently passed to [setRoots]. | |
74 */ | |
75 Map<String, String> packageRoots = <String, String>{}; | |
76 | |
77 /** | |
78 * Same as [packageRoots], except that source folders have been normalized | |
79 * and non-folders have been removed. | |
80 */ | |
81 Map<String, String> normalizedPackageRoots = <String, String>{}; | |
82 | |
83 @override | |
84 ContextManagerCallbacks callbacks; | |
85 | |
86 /** | |
87 * The analysis driver which analyses everything. | |
88 */ | |
89 AnalysisDriver analysisDriver; | |
90 | |
91 /** | |
92 * The context in which everything is being analyzed. | |
93 */ | |
94 AnalysisContext context; | |
95 | |
96 /** | |
97 * The folder associated with the context. | |
98 */ | |
99 Folder contextFolder; | |
100 | |
101 /** | |
102 * The current watch subscriptions. | |
103 */ | |
104 Map<String, StreamSubscription<WatchEvent>> watchSubscriptions = | |
105 new Map<String, StreamSubscription<WatchEvent>>(); | |
106 | |
107 /** | |
108 * The [packageResolverProvider] must not be `null`. | |
109 */ | |
110 SingleContextManager( | |
111 this.resourceProvider, | |
112 this.sdkManager, | |
113 this.packageResolverProvider, | |
114 this.analyzedFilesGlobs, | |
115 this.defaultContextOptions) { | |
116 pathContext = resourceProvider.pathContext; | |
117 } | |
118 | |
119 @override | |
120 Iterable<AnalysisContext> get analysisContexts => | |
121 context == null ? <AnalysisContext>[] : <AnalysisContext>[context]; | |
122 | |
123 @override | |
124 Map<Folder, AnalysisDriver> get driverMap => {contextFolder: analysisDriver}; | |
125 | |
126 @override | |
127 Map<Folder, AnalysisContext> get folderMap => {contextFolder: context}; | |
128 | |
129 @override | |
130 List<AnalysisContext> contextsInAnalysisRoot(Folder analysisRoot) { | |
131 if (context == null || !includedPaths.contains(analysisRoot.path)) { | |
132 return <AnalysisContext>[]; | |
133 } | |
134 return <AnalysisContext>[context]; | |
135 } | |
136 | |
137 @override | |
138 Folder getContextFolderFor(String path) { | |
139 if (isInAnalysisRoot(path)) { | |
140 return contextFolder; | |
141 } | |
142 return null; | |
143 } | |
144 | |
145 @override | |
146 AnalysisContext getContextFor(String path) { | |
147 if (context == null) { | |
148 return null; | |
149 } else if (_isContainedIn(includedPaths, path)) { | |
150 return context; | |
151 } | |
152 return null; | |
153 } | |
154 | |
155 @override | |
156 AnalysisDriver getDriverFor(String path) { | |
157 throw new UnimplementedError( | |
158 'Unexpected invocation of getDriverFor in SingleContextManager'); | |
159 } | |
160 | |
161 @override | |
162 List<AnalysisDriver> getDriversInAnalysisRoot(Folder analysisRoot) { | |
163 throw new UnimplementedError( | |
164 'Unexpected invocation of getDriversInAnalysisRoot in SingleContextManag
er'); | |
165 } | |
166 | |
167 @override | |
168 bool isIgnored(String path) { | |
169 return !_isContainedIn(includedPaths, path) || _isExcludedPath(path); | |
170 } | |
171 | |
172 @override | |
173 bool isInAnalysisRoot(String path) { | |
174 return _isContainedIn(includedPaths, path) && | |
175 !_isContainedIn(excludedPaths, path); | |
176 } | |
177 | |
178 @override | |
179 void refresh(List<Resource> roots) { | |
180 if (context != null) { | |
181 callbacks.removeContext(contextFolder, null); | |
182 context.dispose(); | |
183 context = null; | |
184 contextFolder = null; | |
185 _cancelCurrentWatchSubscriptions(); | |
186 setRoots(includedPaths, excludedPaths, packageRoots); | |
187 } | |
188 } | |
189 | |
190 @override | |
191 void setRoots(List<String> includedPaths, List<String> excludedPaths, | |
192 Map<String, String> packageRoots) { | |
193 includedPaths = _nonOverlappingPaths(includedPaths); | |
194 excludedPaths = _nonOverlappingPaths(excludedPaths); | |
195 this.packageRoots = packageRoots; | |
196 _updateNormalizedPackageRoots(); | |
197 // Update context path. | |
198 { | |
199 String contextPath = _commonPrefix(includedPaths); | |
200 Folder contextFolder = resourceProvider.getFolder(contextPath); | |
201 if (contextFolder != this.contextFolder) { | |
202 if (context != null) { | |
203 callbacks.moveContext(this.contextFolder, contextFolder); | |
204 } | |
205 this.contextFolder = contextFolder; | |
206 } | |
207 } | |
208 // Start new watchers and cancel old ones. | |
209 { | |
210 Map<String, StreamSubscription<WatchEvent>> newSubscriptions = | |
211 new Map<String, StreamSubscription<WatchEvent>>(); | |
212 for (String includedPath in includedPaths) { | |
213 Resource resource = resourceProvider.getResource(includedPath); | |
214 if (resource is Folder) { | |
215 // Extract the existing subscription or create a new one. | |
216 StreamSubscription<WatchEvent> subscription = | |
217 watchSubscriptions.remove(includedPath); | |
218 if (subscription == null) { | |
219 subscription = resource.changes.listen(_handleWatchEvent); | |
220 } | |
221 // Remember the subscription. | |
222 newSubscriptions[includedPath] = subscription; | |
223 } | |
224 _cancelCurrentWatchSubscriptions(); | |
225 this.watchSubscriptions = newSubscriptions; | |
226 } | |
227 } | |
228 // Create or update the analysis context. | |
229 if (context == null) { | |
230 context = callbacks.addContext(contextFolder, defaultContextOptions); | |
231 ChangeSet changeSet = | |
232 _buildChangeSet(added: _includedFiles(includedPaths, excludedPaths)); | |
233 callbacks.applyChangesToContext(contextFolder, changeSet); | |
234 } else { | |
235 // TODO(brianwilkerson) Optimize this. | |
236 List<File> oldFiles = | |
237 _includedFiles(this.includedPaths, this.excludedPaths); | |
238 List<File> newFiles = _includedFiles(includedPaths, excludedPaths); | |
239 ChangeSet changeSet = _buildChangeSet( | |
240 added: _diff(newFiles, oldFiles), removed: _diff(oldFiles, newFiles)); | |
241 callbacks.applyChangesToContext(contextFolder, changeSet); | |
242 } | |
243 this.includedPaths = includedPaths; | |
244 this.excludedPaths = excludedPaths; | |
245 } | |
246 | |
247 /** | |
248 * Recursively add the given [resource] (if it's a file) or its children (if | |
249 * it's a folder) to the [addedFiles]. | |
250 */ | |
251 void _addFilesInResource( | |
252 List<File> addedFiles, Resource resource, List<String> excludedPaths) { | |
253 if (_isImplicitlyExcludedResource(resource)) { | |
254 return; | |
255 } | |
256 String path = resource.path; | |
257 if (_isEqualOrWithinAny(excludedPaths, path)) { | |
258 return; | |
259 } | |
260 if (resource is File) { | |
261 if (_matchesAnyAnalyzedFilesGlob(path) && resource.exists) { | |
262 addedFiles.add(resource); | |
263 } | |
264 } else if (resource is Folder) { | |
265 for (Resource child in _getChildrenSafe(resource)) { | |
266 _addFilesInResource(addedFiles, child, excludedPaths); | |
267 } | |
268 } | |
269 } | |
270 | |
271 ChangeSet _buildChangeSet({List<File> added, List<File> removed}) { | |
272 ChangeSet changeSet = new ChangeSet(); | |
273 if (added != null) { | |
274 for (File file in added) { | |
275 Source source = createSourceInContext(context, file); | |
276 changeSet.addedSource(source); | |
277 } | |
278 } | |
279 if (removed != null) { | |
280 for (File file in removed) { | |
281 Source source = createSourceInContext(context, file); | |
282 changeSet.removedSource(source); | |
283 } | |
284 } | |
285 return changeSet; | |
286 } | |
287 | |
288 void _cancelCurrentWatchSubscriptions() { | |
289 for (StreamSubscription<WatchEvent> subscription | |
290 in watchSubscriptions.values) { | |
291 subscription.cancel(); | |
292 } | |
293 watchSubscriptions.clear(); | |
294 } | |
295 | |
296 String _commonPrefix(List<String> paths) { | |
297 if (paths.isEmpty) { | |
298 return ''; | |
299 } | |
300 List<String> left = pathContext.split(paths[0]); | |
301 int count = left.length; | |
302 for (int i = 1; i < paths.length; i++) { | |
303 List<String> right = pathContext.split(paths[i]); | |
304 count = _commonComponents(left, count, right); | |
305 } | |
306 return pathContext.joinAll(left.sublist(0, count)); | |
307 } | |
308 | |
309 List<Resource> _existingResources(List<String> pathList) { | |
310 List<Resource> resources = <Resource>[]; | |
311 for (String path in pathList) { | |
312 Resource resource = resourceProvider.getResource(path); | |
313 if (resource is Folder) { | |
314 resources.add(resource); | |
315 } else if (!resource.exists) { | |
316 // Non-existent resources are ignored. TODO(paulberry): we should set | |
317 // up a watcher to ensure that if the resource appears later, we will | |
318 // begin analyzing it. | |
319 } else if (resource is File) { | |
320 resources.add(resource); | |
321 } else { | |
322 throw new UnimplementedError('$path is not a folder. ' | |
323 'Only support for file and folder analysis is implemented.'); | |
324 } | |
325 } | |
326 return resources; | |
327 } | |
328 | |
329 void _handleWatchEvent(WatchEvent event) { | |
330 String path = event.path; | |
331 // Ignore if excluded. | |
332 if (_isExcludedPath(path)) { | |
333 return; | |
334 } | |
335 // Ignore if not in a root. | |
336 if (!_isContainedIn(includedPaths, path)) { | |
337 return; | |
338 } | |
339 // Handle the change. | |
340 switch (event.type) { | |
341 case ChangeType.ADD: | |
342 Resource resource = resourceProvider.getResource(path); | |
343 if (resource is File) { | |
344 if (_matchesAnyAnalyzedFilesGlob(path)) { | |
345 callbacks.applyChangesToContext( | |
346 contextFolder, _buildChangeSet(added: <File>[resource])); | |
347 } | |
348 } | |
349 break; | |
350 case ChangeType.REMOVE: | |
351 List<Source> sources = context.getSourcesWithFullName(path); | |
352 if (!sources.isEmpty) { | |
353 ChangeSet changeSet = new ChangeSet(); | |
354 sources.forEach(changeSet.removedSource); | |
355 callbacks.applyChangesToContext(contextFolder, changeSet); | |
356 } | |
357 break; | |
358 case ChangeType.MODIFY: | |
359 List<Source> sources = context.getSourcesWithFullName(path); | |
360 if (!sources.isEmpty) { | |
361 ChangeSet changeSet = new ChangeSet(); | |
362 sources.forEach(changeSet.changedSource); | |
363 callbacks.applyChangesToContext(contextFolder, changeSet); | |
364 } | |
365 break; | |
366 } | |
367 } | |
368 | |
369 List<File> _includedFiles( | |
370 List<String> includedPaths, List<String> excludedPaths) { | |
371 List<Resource> includedResources = _existingResources(includedPaths); | |
372 List<File> includedFiles = <File>[]; | |
373 for (Resource resource in includedResources) { | |
374 _addFilesInResource(includedFiles, resource, excludedPaths); | |
375 } | |
376 return includedFiles; | |
377 } | |
378 | |
379 bool _isContainedIn(List<String> pathList, String path) { | |
380 for (String pathInList in pathList) { | |
381 if (_isEqualOrWithin(pathInList, path)) { | |
382 return true; | |
383 } | |
384 } | |
385 return false; | |
386 } | |
387 | |
388 bool _isEqualOrWithin(String parent, String child) { | |
389 return child == parent || pathContext.isWithin(parent, child); | |
390 } | |
391 | |
392 bool _isEqualOrWithinAny(List<String> parents, String child) { | |
393 for (String parent in parents) { | |
394 if (_isEqualOrWithin(parent, child)) { | |
395 return true; | |
396 } | |
397 } | |
398 return false; | |
399 } | |
400 | |
401 /** | |
402 * Return `true` if the given [path] should be excluded, using explicit | |
403 * or implicit rules. | |
404 */ | |
405 bool _isExcludedPath(String path) { | |
406 List<String> parts = resourceProvider.pathContext.split(path); | |
407 // Implicit rules. | |
408 for (String part in parts) { | |
409 if (part.startsWith('.')) { | |
410 return true; | |
411 } | |
412 } | |
413 // Explicitly excluded paths. | |
414 if (_isEqualOrWithinAny(excludedPaths, path)) { | |
415 return true; | |
416 } | |
417 // OK | |
418 return false; | |
419 } | |
420 | |
421 /** | |
422 * Return `true` if the given [resource] and children should be excluded | |
423 * because of some implicit exclusion rules, e.g. `.name`. | |
424 */ | |
425 bool _isImplicitlyExcludedResource(Resource resource) { | |
426 String shortName = resource.shortName; | |
427 if (shortName.startsWith('.')) { | |
428 return true; | |
429 } | |
430 return false; | |
431 } | |
432 | |
433 /** | |
434 * Return `true` if the given [path] matches one of the [analyzedFilesGlobs]. | |
435 */ | |
436 bool _matchesAnyAnalyzedFilesGlob(String path) { | |
437 for (Glob glob in analyzedFilesGlobs) { | |
438 if (glob.matches(path)) { | |
439 return true; | |
440 } | |
441 } | |
442 return false; | |
443 } | |
444 | |
445 /** | |
446 * Return a list consisting of the elements from [pathList] that describe the | |
447 * minimal set of directories that include everything in the original list of | |
448 * paths and nothing more. In particular: | |
449 * | |
450 * * if a path is in the input list multiple times it will appear at most | |
451 * once in the output list, and | |
452 * * if a directory D and a subdirectory of it are both in the input list | |
453 * then only the directory D will be in the output list. | |
454 * | |
455 * The original list is not modified. | |
456 */ | |
457 List<String> _nonOverlappingPaths(List<String> pathList) { | |
458 List<String> sortedPaths = new List<String>.from(pathList); | |
459 sortedPaths.sort((a, b) => a.length - b.length); | |
460 int pathCount = sortedPaths.length; | |
461 for (int i = pathCount - 1; i > 0; i--) { | |
462 String path = sortedPaths[i]; | |
463 for (int j = 0; j < i; j++) { | |
464 if (_isEqualOrWithin(path, sortedPaths[j])) { | |
465 sortedPaths.removeAt(i); | |
466 break; | |
467 } | |
468 } | |
469 } | |
470 return sortedPaths; | |
471 } | |
472 | |
473 /** | |
474 * Normalize all package root sources by mapping them to folders on the | |
475 * filesystem. Ignore any package root sources that aren't folders. | |
476 */ | |
477 void _updateNormalizedPackageRoots() { | |
478 normalizedPackageRoots = <String, String>{}; | |
479 packageRoots.forEach((String sourcePath, String targetPath) { | |
480 Resource resource = resourceProvider.getResource(sourcePath); | |
481 if (resource is Folder) { | |
482 normalizedPackageRoots[resource.path] = targetPath; | |
483 } | |
484 }); | |
485 } | |
486 | |
487 /** | |
488 * Create and return a source representing the given [file] within the given | |
489 * [context]. | |
490 */ | |
491 static Source createSourceInContext(AnalysisContext context, File file) { | |
492 // TODO(brianwilkerson) Optimize this, by allowing support for source | |
493 // factories to restore URI's from a file path rather than a source. | |
494 Source source = file.createSource(); | |
495 if (context == null) { | |
496 return source; | |
497 } | |
498 Uri uri = context.sourceFactory.restoreUri(source); | |
499 return file.createSource(uri); | |
500 } | |
501 | |
502 static int _commonComponents( | |
503 List<String> left, int count, List<String> right) { | |
504 int max = math.min(count, right.length); | |
505 for (int i = 0; i < max; i++) { | |
506 if (left[i] != right[i]) { | |
507 return i; | |
508 } | |
509 } | |
510 return max; | |
511 } | |
512 | |
513 /** | |
514 * Return a list of all the files in the [left] that are not in the [right]. | |
515 */ | |
516 static List<File> _diff(List<File> left, List<File> right) { | |
517 List<File> diff = new List.from(left); | |
518 for (File file in right) { | |
519 diff.remove(file); | |
520 } | |
521 return diff; | |
522 } | |
523 | |
524 static List<Resource> _getChildrenSafe(Folder folder) { | |
525 try { | |
526 return folder.getChildren(); | |
527 } on FileSystemException { | |
528 // The folder either doesn't exist or cannot be read. | |
529 // Either way, there are no children. | |
530 return const <Resource>[]; | |
531 } | |
532 } | |
533 } | |
OLD | NEW |