| // This code was auto-generated, is not intended to be edited, and is subject to |
| // significant change. Please see the README file for more information. |
| |
| library engine; |
| |
| import 'dart:collection' show HasNextIterator; |
| import 'dart:uri' show Uri; |
| import 'java_core.dart'; |
| import 'java_engine.dart'; |
| import 'instrumentation.dart'; |
| import 'error.dart'; |
| import 'source.dart'; |
| import 'scanner.dart' show Token, CharBufferScanner, StringScanner; |
| import 'ast.dart'; |
| import 'parser.dart' show Parser; |
| import 'sdk.dart' show DartSdk; |
| import 'element.dart'; |
| import 'resolver.dart'; |
| import 'html.dart' show XmlTagNode, XmlAttributeNode, RecursiveXmlVisitor, HtmlScanner, HtmlScanResult, HtmlParser, HtmlParseResult, HtmlUnit; |
| |
| /** |
| * The unique instance of the class {@code AnalysisEngine} serves as the entry point for the |
| * functionality provided by the analysis engine. |
| * @coverage dart.engine |
| */ |
| class AnalysisEngine { |
| /** |
| * The suffix used for Dart source files. |
| */ |
| static String SUFFIX_DART = "dart"; |
| /** |
| * The short suffix used for HTML files. |
| */ |
| static String SUFFIX_HTM = "htm"; |
| /** |
| * The long suffix used for HTML files. |
| */ |
| static String SUFFIX_HTML = "html"; |
| /** |
| * The unique instance of this class. |
| */ |
| static AnalysisEngine _UniqueInstance = new AnalysisEngine(); |
| /** |
| * Return the unique instance of this class. |
| * @return the unique instance of this class |
| */ |
| static AnalysisEngine get instance => _UniqueInstance; |
| /** |
| * Return {@code true} if the given file name is assumed to contain Dart source code. |
| * @param fileName the name of the file being tested |
| * @return {@code true} if the given file name is assumed to contain Dart source code |
| */ |
| static bool isDartFileName(String fileName) { |
| if (fileName == null) { |
| return false; |
| } |
| return javaStringEqualsIgnoreCase(FileNameUtilities.getExtension(fileName), SUFFIX_DART); |
| } |
| /** |
| * Return {@code true} if the given file name is assumed to contain HTML. |
| * @param fileName the name of the file being tested |
| * @return {@code true} if the given file name is assumed to contain HTML |
| */ |
| static bool isHtmlFileName(String fileName) { |
| if (fileName == null) { |
| return false; |
| } |
| String extension = FileNameUtilities.getExtension(fileName); |
| return javaStringEqualsIgnoreCase(extension, SUFFIX_HTML) || javaStringEqualsIgnoreCase(extension, SUFFIX_HTM); |
| } |
| /** |
| * The logger that should receive information about errors within the analysis engine. |
| */ |
| Logger _logger = Logger.NULL; |
| /** |
| * Prevent the creation of instances of this class. |
| */ |
| AnalysisEngine() : super() { |
| } |
| /** |
| * Create a new context in which analysis can be performed. |
| * @return the analysis context that was created |
| */ |
| AnalysisContext createAnalysisContext() { |
| if (Instrumentation.isNullLogger()) { |
| return new DelegatingAnalysisContextImpl(); |
| } else { |
| return new InstrumentedAnalysisContextImpl.con1(new DelegatingAnalysisContextImpl()); |
| } |
| } |
| /** |
| * Return the logger that should receive information about errors within the analysis engine. |
| * @return the logger that should receive information about errors within the analysis engine |
| */ |
| Logger get logger => _logger; |
| /** |
| * Set the logger that should receive information about errors within the analysis engine to the |
| * given logger. |
| * @param logger the logger that should receive information about errors within the analysis |
| * engine |
| */ |
| void set logger(Logger logger2) { |
| this._logger = logger2 == null ? Logger.NULL : logger2; |
| } |
| } |
| /** |
| * The interface {@code AnalysisContext} defines the behavior of objects that represent a context in |
| * which a single analysis can be performed and incrementally maintained. The context includes such |
| * information as the version of the SDK being analyzed against as well as the package-root used to |
| * resolve 'package:' URI's. (Both of which are known indirectly through the {@link SourceFactorysource factory}.) |
| * <p> |
| * An analysis context also represents the state of the analysis, which includes knowing which |
| * sources have been included in the analysis (either directly or indirectly) and the results of the |
| * analysis. Sources must be added and removed from the context using the method{@link #applyChanges(ChangeSet)}, which is also used to notify the context when sources have been |
| * modified and, consequently, previously known results might have been invalidated. |
| * <p> |
| * There are two ways to access the results of the analysis. The most common is to use one of the |
| * 'get' methods to access the results. The 'get' methods have the advantage that they will always |
| * return quickly, but have the disadvantage that if the results are not currently available they |
| * will return either nothing or in some cases an incomplete result. The second way to access |
| * results is by using one of the 'compute' methods. The 'compute' methods will always attempt to |
| * compute the requested results but might block the caller for a significant period of time. |
| * <p> |
| * When results have been invalidated, have never been computed (as is the case for newly added |
| * sources), or have been removed from the cache, they are <b>not</b> automatically recreated. They |
| * will only be recreated if one of the 'compute' methods is invoked. |
| * <p> |
| * However, this is not always acceptable. Some clients need to keep the analysis results |
| * up-to-date. For such clients there is a mechanism that allows them to incrementally perform |
| * needed analysis and get notified of the consequent changes to the analysis results. This |
| * mechanism is realized by the method {@link #performAnalysisTask()}. |
| * <p> |
| * Analysis engine allows for having more than one context. This can be used, for example, to |
| * perform one analysis based on the state of files on disk and a separate analysis based on the |
| * state of those files in open editors. It can also be used to perform an analysis based on a |
| * proposed future state, such as the state after a refactoring. |
| */ |
| abstract class AnalysisContext { |
| /** |
| * Apply the changes specified by the given change set to this context. Any analysis results that |
| * have been invalidated by these changes will be removed. |
| * @param changeSet a description of the changes that are to be applied |
| */ |
| void applyChanges(ChangeSet changeSet); |
| /** |
| * Return the documentation comment for the given element as it appears in the original source |
| * (complete with the beginning and ending delimiters), or {@code null} if the element does not |
| * have a documentation comment associated with it. This can be a long-running operation if the |
| * information needed to access the comment is not cached. |
| * @param element the element whose documentation comment is to be returned |
| * @return the element's documentation comment |
| * @throws AnalysisException if the documentation comment could not be determined because the |
| * analysis could not be performed |
| */ |
| String computeDocumentationComment(Element element); |
| /** |
| * Return an array containing all of the errors associated with the given source. If the errors |
| * are not already known then the source will be analyzed in order to determine the errors |
| * associated with it. |
| * @param source the source whose errors are to be returned |
| * @return all of the errors associated with the given source |
| * @throws AnalysisException if the errors could not be determined because the analysis could not |
| * be performed |
| * @see #getErrors(Source) |
| */ |
| List<AnalysisError> computeErrors(Source source); |
| /** |
| * Return the element model corresponding to the HTML file defined by the given source. If the |
| * element model does not yet exist it will be created. The process of creating an element model |
| * for an HTML file can long-running, depending on the size of the file and the number of |
| * libraries that are defined in it (via script tags) that also need to have a model built for |
| * them. |
| * @param source the source defining the HTML file whose element model is to be returned |
| * @return the element model corresponding to the HTML file defined by the given source |
| * @throws AnalysisException if the element model could not be determined because the analysis |
| * could not be performed |
| * @see #getHtmlElement(Source) |
| */ |
| HtmlElement computeHtmlElement(Source source); |
| /** |
| * Return the kind of the given source, computing it's kind if it is not already known. Return{@link SourceKind#UNKNOWN} if the source is not contained in this context. |
| * @param source the source whose kind is to be returned |
| * @return the kind of the given source |
| * @see #getKindOf(Source) |
| */ |
| SourceKind computeKindOf(Source source); |
| /** |
| * Return the element model corresponding to the library defined by the given source. If the |
| * element model does not yet exist it will be created. The process of creating an element model |
| * for a library can long-running, depending on the size of the library and the number of |
| * libraries that are imported into it that also need to have a model built for them. |
| * @param source the source defining the library whose element model is to be returned |
| * @return the element model corresponding to the library defined by the given source |
| * @throws AnalysisException if the element model could not be determined because the analysis |
| * could not be performed |
| * @see #getLibraryElement(Source) |
| */ |
| LibraryElement computeLibraryElement(Source source); |
| /** |
| * Return the line information for the given source, or {@code null} if the source is not of a |
| * recognized kind (neither a Dart nor HTML file). If the line information was not previously |
| * known it will be created. The line information is used to map offsets from the beginning of the |
| * source to line and column pairs. |
| * @param source the source whose line information is to be returned |
| * @return the line information for the given source |
| * @throws AnalysisException if the line information could not be determined because the analysis |
| * could not be performed |
| * @see #getLineInfo(Source) |
| */ |
| LineInfo computeLineInfo(Source source); |
| /** |
| * Create a new context in which analysis can be performed. Any sources in the specified container |
| * will be removed from this context and added to the newly created context. |
| * @param container the container containing sources that should be removed from this context and |
| * added to the returned context |
| * @return the analysis context that was created |
| */ |
| AnalysisContext extractContext(SourceContainer container); |
| /** |
| * Return the element referenced by the given location, or {@code null} if the element is not |
| * immediately available or if there is no element with the given location. The latter condition |
| * can occur, for example, if the location describes an element from a different context or if the |
| * element has been removed from this context as a result of some change since it was originally |
| * obtained. |
| * @param location the reference describing the element to be returned |
| * @return the element referenced by the given location |
| */ |
| Element getElement(ElementLocation location); |
| /** |
| * Return an analysis error info containing the array of all of the errors and the line info |
| * associated with the given source. The array of errors will be empty if the source is not known |
| * to this context or if there are no errors in the source. The errors contained in the array can |
| * be incomplete. |
| * @param source the source whose errors are to be returned |
| * @return all of the errors associated with the given source and the line info |
| * @see #computeErrors(Source) |
| */ |
| AnalysisErrorInfo getErrors(Source source); |
| /** |
| * Return the element model corresponding to the HTML file defined by the given source, or{@code null} if the source does not represent an HTML file, the element representing the file |
| * has not yet been created, or the analysis of the HTML file failed for some reason. |
| * @param source the source defining the HTML file whose element model is to be returned |
| * @return the element model corresponding to the HTML file defined by the given source |
| * @see #computeHtmlElement(Source) |
| */ |
| HtmlElement getHtmlElement(Source source); |
| /** |
| * Return the sources for the HTML files that reference the given compilation unit. If the source |
| * does not represent a Dart source or is not known to this context, the returned array will be |
| * empty. The contents of the array can be incomplete. |
| * @param source the source referenced by the returned HTML files |
| * @return the sources for the HTML files that reference the given compilation unit |
| */ |
| List<Source> getHtmlFilesReferencing(Source source); |
| /** |
| * Return an array containing all of the sources known to this context that represent HTML files. |
| * The contents of the array can be incomplete. |
| * @return the sources known to this context that represent HTML files |
| */ |
| List<Source> get htmlSources; |
| /** |
| * Return the kind of the given source, or {@code null} if the kind is not known to this context. |
| * @param source the source whose kind is to be returned |
| * @return the kind of the given source |
| * @see #computeKindOf(Source) |
| */ |
| SourceKind getKindOf(Source source); |
| /** |
| * Return an array containing all of the sources known to this context that represent the defining |
| * compilation unit of a library that can be run within a browser. The sources that are returned |
| * represent libraries that have a 'main' method and are either referenced by an HTML file or |
| * import, directly or indirectly, a client-only library. The contents of the array can be |
| * incomplete. |
| * @return the sources known to this context that represent the defining compilation unit of a |
| * library that can be run within a browser |
| */ |
| List<Source> get launchableClientLibrarySources; |
| /** |
| * Return an array containing all of the sources known to this context that represent the defining |
| * compilation unit of a library that can be run outside of a browser. The contents of the array |
| * can be incomplete. |
| * @return the sources known to this context that represent the defining compilation unit of a |
| * library that can be run outside of a browser |
| */ |
| List<Source> get launchableServerLibrarySources; |
| /** |
| * Return the sources for the defining compilation units of any libraries of which the given |
| * source is a part. The array will normally contain a single library because most Dart sources |
| * are only included in a single library, but it is possible to have a part that is contained in |
| * multiple identically named libraries. If the source represents the defining compilation unit of |
| * a library, then the returned array will contain the given source as its only element. If the |
| * source does not represent a Dart source or is not known to this context, the returned array |
| * will be empty. The contents of the array can be incomplete. |
| * @param source the source contained in the returned libraries |
| * @return the sources for the libraries containing the given source |
| */ |
| List<Source> getLibrariesContaining(Source source); |
| /** |
| * Return the element model corresponding to the library defined by the given source, or{@code null} if the element model does not currently exist or if the library cannot be analyzed |
| * for some reason. |
| * @param source the source defining the library whose element model is to be returned |
| * @return the element model corresponding to the library defined by the given source |
| */ |
| LibraryElement getLibraryElement(Source source); |
| /** |
| * Return an array containing all of the sources known to this context that represent the defining |
| * compilation unit of a library. The contents of the array can be incomplete. |
| * @return the sources known to this context that represent the defining compilation unit of a |
| * library |
| */ |
| List<Source> get librarySources; |
| /** |
| * Return the line information for the given source, or {@code null} if the line information is |
| * not known. The line information is used to map offsets from the beginning of the source to line |
| * and column pairs. |
| * @param source the source whose line information is to be returned |
| * @return the line information for the given source |
| * @see #computeLineInfo(Source) |
| */ |
| LineInfo getLineInfo(Source source); |
| /** |
| * Return a fully resolved AST for a single compilation unit within the given library, or{@code null} if the resolved AST is not already computed. |
| * @param unitSource the source of the compilation unit |
| * @param library the library containing the compilation unit |
| * @return a fully resolved AST for the compilation unit |
| * @see #resolveCompilationUnit(Source,LibraryElement) |
| */ |
| CompilationUnit getResolvedCompilationUnit(Source unitSource, LibraryElement library); |
| /** |
| * Return a fully resolved AST for a single compilation unit within the given library, or{@code null} if the resolved AST is not already computed. |
| * @param unitSource the source of the compilation unit |
| * @param librarySource the source of the defining compilation unit of the library containing the |
| * compilation unit |
| * @return a fully resolved AST for the compilation unit |
| * @see #resolveCompilationUnit(Source,Source) |
| */ |
| CompilationUnit getResolvedCompilationUnit2(Source unitSource, Source librarySource); |
| /** |
| * Return the source factory used to create the sources that can be analyzed in this context. |
| * @return the source factory used to create the sources that can be analyzed in this context |
| */ |
| SourceFactory get sourceFactory; |
| /** |
| * Return {@code true} if the given source is known to be the defining compilation unit of a |
| * library that can be run on a client (references 'dart:html', either directly or indirectly). |
| * <p> |
| * <b>Note:</b> In addition to the expected case of returning {@code false} if the source is known |
| * to be a library that cannot be run on a client, this method will also return {@code false} if |
| * the source is not known to be a library or if we do not know whether it can be run on a client. |
| * @param librarySource the source being tested |
| * @return {@code true} if the given source is known to be a library that can be run on a client |
| */ |
| bool isClientLibrary(Source librarySource); |
| /** |
| * Return {@code true} if the given source is known to be the defining compilation unit of a |
| * library that can be run on the server (does not reference 'dart:html', either directly or |
| * indirectly). |
| * <p> |
| * <b>Note:</b> In addition to the expected case of returning {@code false} if the source is known |
| * to be a library that cannot be run on the server, this method will also return {@code false} if |
| * the source is not known to be a library or if we do not know whether it can be run on the |
| * server. |
| * @param librarySource the source being tested |
| * @return {@code true} if the given source is known to be a library that can be run on the server |
| */ |
| bool isServerLibrary(Source librarySource); |
| /** |
| * Add the sources contained in the specified context to this context's collection of sources. |
| * This method is called when an existing context's pubspec has been removed, and the contained |
| * sources should be reanalyzed as part of this context. |
| * @param context the context being merged |
| */ |
| void mergeContext(AnalysisContext context); |
| /** |
| * Parse a single 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. |
| * @param source the source to be parsed |
| * @return the AST structure representing the content of the source |
| * @throws AnalysisException if the analysis could not be performed |
| */ |
| CompilationUnit parseCompilationUnit(Source source); |
| /** |
| * Parse a single HTML source to produce an AST structure. The resulting HTML AST structure may or |
| * may not be resolved, and may have a slightly different structure depending upon whether it is |
| * resolved. |
| * @param source the HTML source to be parsed |
| * @return the parse result (not {@code null}) |
| * @throws AnalysisException if the analysis could not be performed |
| */ |
| HtmlUnit parseHtmlUnit(Source source); |
| /** |
| * Perform the next unit of work required to keep the analysis results up-to-date and return |
| * information about the consequent changes to the analysis results. If there were no results the |
| * returned array will be empty. If there are no more units of work required, then this method |
| * returns {@code null}. This method can be long running. |
| * @return an array containing notices of changes to the analysis results |
| */ |
| List<ChangeNotice> performAnalysisTask(); |
| /** |
| * Parse and resolve a single source within the given context to produce a fully resolved AST. |
| * @param unitSource the source to be parsed and resolved |
| * @param library the library containing the source to be resolved |
| * @return the result of resolving the AST structure representing the content of the source in the |
| * context of the given library |
| * @throws AnalysisException if the analysis could not be performed |
| * @see #getResolvedCompilationUnit(Source,LibraryElement) |
| */ |
| CompilationUnit resolveCompilationUnit(Source unitSource, LibraryElement library); |
| /** |
| * Parse and resolve a single source within the given context to produce a fully resolved AST. |
| * @param unitSource the source to be parsed and resolved |
| * @param librarySource the source of the defining compilation unit of the library containing the |
| * source to be resolved |
| * @return the result of resolving the AST structure representing the content of the source in the |
| * context of the given library |
| * @throws AnalysisException if the analysis could not be performed |
| * @see #getResolvedCompilationUnit(Source,Source) |
| */ |
| CompilationUnit resolveCompilationUnit2(Source unitSource, Source librarySource); |
| /** |
| * Parse and resolve a single source within the given context to produce a fully resolved AST. |
| * @param htmlSource the source to be parsed and resolved |
| * @return the result of resolving the AST structure representing the content of the source |
| * @throws AnalysisException if the analysis could not be performed |
| */ |
| HtmlUnit resolveHtmlUnit(Source htmlSource); |
| /** |
| * Set the contents of the given source to the given contents and mark the source as having |
| * changed. This has the effect of overriding the default contents of the source. If the contents |
| * are {@code null} the override is removed so that the default contents will be returned. |
| * @param source the source whose contents are being overridden |
| * @param contents the new contents of the source |
| */ |
| void setContents(Source source, String contents); |
| /** |
| * Set the source factory used to create the sources that can be analyzed in this context to the |
| * given source factory. Clients can safely assume that all analysis results have been |
| * invalidated. |
| * @param factory the source factory used to create the sources that can be analyzed in this |
| * context |
| */ |
| void set sourceFactory(SourceFactory factory); |
| /** |
| * Given a collection of sources with content that has changed, return an {@link Iterable}identifying the sources that need to be resolved. |
| * @param changedSources an array of sources (not {@code null}, contains no {@code null}s) |
| * @return An iterable returning the sources to be resolved |
| */ |
| Iterable<Source> sourcesToResolve(List<Source> changedSources); |
| } |
| /** |
| * The interface {@code AnalysisErrorInfo} contains the analysis errors and line information for the |
| * errors. |
| */ |
| abstract class AnalysisErrorInfo { |
| /** |
| * Return the errors that as a result of the analysis, or {@code null} if there were no errors. |
| * @return the errors as a result of the analysis |
| */ |
| List<AnalysisError> get errors; |
| /** |
| * Return the line information associated with the errors, or {@code null} if there were no |
| * errors. |
| * @return the line information associated with the errors |
| */ |
| LineInfo get lineInfo; |
| } |
| /** |
| * Instances of the class {@code AnalysisException} represent an exception that occurred during the |
| * analysis of one or more sources. |
| * @coverage dart.engine |
| */ |
| class AnalysisException extends JavaException { |
| /** |
| * Initialize a newly created exception. |
| */ |
| AnalysisException() : super() { |
| _jtd_constructor_125_impl(); |
| } |
| _jtd_constructor_125_impl() { |
| } |
| /** |
| * Initialize a newly created exception to have the given message. |
| * @param message the message associated with the exception |
| */ |
| AnalysisException.con1(String message) : super(message) { |
| _jtd_constructor_126_impl(message); |
| } |
| _jtd_constructor_126_impl(String message) { |
| } |
| /** |
| * Initialize a newly created exception to have the given message and cause. |
| * @param message the message associated with the exception |
| * @param cause the underlying exception that caused this exception |
| */ |
| AnalysisException.con2(String message, Exception cause) : super(message, cause) { |
| _jtd_constructor_127_impl(message, cause); |
| } |
| _jtd_constructor_127_impl(String message, Exception cause) { |
| } |
| /** |
| * Initialize a newly created exception to have the given cause. |
| * @param cause the underlying exception that caused this exception |
| */ |
| AnalysisException.con3(Exception cause) : super.withCause(cause) { |
| _jtd_constructor_128_impl(cause); |
| } |
| _jtd_constructor_128_impl(Exception cause) { |
| } |
| } |
| /** |
| * The interface {@code ChangeNotice} defines the behavior of objects that represent a change to the |
| * analysis results associated with a given source. |
| * @coverage dart.engine |
| */ |
| abstract class ChangeNotice implements AnalysisErrorInfo { |
| /** |
| * Return the fully resolved AST that changed as a result of the analysis, or {@code null} if the |
| * AST was not changed. |
| * @return the fully resolved AST that changed as a result of the analysis |
| */ |
| CompilationUnit get compilationUnit; |
| /** |
| * Return the source for which the result is being reported. |
| * @return the source for which the result is being reported |
| */ |
| Source get source; |
| } |
| /** |
| * Instances of the class {@code ChangeSet} indicate what sources have been added, changed, or |
| * removed. |
| * @coverage dart.engine |
| */ |
| class ChangeSet { |
| /** |
| * A list containing the sources that have been added. |
| */ |
| List<Source> _added2 = new List<Source>(); |
| /** |
| * A list containing the sources that have been changed. |
| */ |
| List<Source> _changed2 = new List<Source>(); |
| /** |
| * A list containing the sources that have been removed. |
| */ |
| List<Source> _removed2 = new List<Source>(); |
| /** |
| * A list containing the source containers specifying additional sources that have been removed. |
| */ |
| List<SourceContainer> _removedContainers = new List<SourceContainer>(); |
| /** |
| * Initialize a newly created change set to be empty. |
| */ |
| ChangeSet() : super() { |
| } |
| /** |
| * Record that the specified source has been added and that it's content is the default contents |
| * of the source. |
| * @param source the source that was added |
| */ |
| void added(Source source) { |
| _added2.add(source); |
| } |
| /** |
| * Record that the specified source has been changed and that it's content is the default contents |
| * of the source. |
| * @param source the source that was changed |
| */ |
| void changed(Source source) { |
| _changed2.add(source); |
| } |
| /** |
| * Return a collection of the sources that have been added. |
| * @return a collection of the sources that have been added |
| */ |
| List<Source> get added3 => _added2; |
| /** |
| * Return a collection of sources that have been changed. |
| * @return a collection of sources that have been changed |
| */ |
| List<Source> get changed3 => _changed2; |
| /** |
| * Return a list containing the sources that were removed. |
| * @return a list containing the sources that were removed |
| */ |
| List<Source> get removed => _removed2; |
| /** |
| * Return a list containing the source containers that were removed. |
| * @return a list containing the source containers that were removed |
| */ |
| List<SourceContainer> get removedContainers => _removedContainers; |
| /** |
| * Return {@code true} if this change set does not contain any changes. |
| * @return {@code true} if this change set does not contain any changes |
| */ |
| bool isEmpty() => _added2.isEmpty && _changed2.isEmpty && _removed2.isEmpty && _removedContainers.isEmpty; |
| /** |
| * Record that the specified source has been removed. |
| * @param source the source that was removed |
| */ |
| void removed3(Source source) { |
| if (source != null) { |
| _removed2.add(source); |
| } |
| } |
| /** |
| * Record that the specified source container has been removed. |
| * @param container the source container that was removed |
| */ |
| void removedContainer(SourceContainer container) { |
| if (container != null) { |
| _removedContainers.add(container); |
| } |
| } |
| } |
| /** |
| * The interface {@code DartEntry} defines the behavior of objects that maintain the information |
| * cached by an analysis context about an individual Dart file. |
| * @coverage dart.engine |
| */ |
| abstract class DartEntry implements SourceEntry { |
| /** |
| * The data descriptor representing the library element for the library. This data is only |
| * available for Dart files that are the defining compilation unit of a library. |
| */ |
| static DataDescriptor<LibraryElement> ELEMENT = new DataDescriptor<LibraryElement>("DartEntry.ELEMENT"); |
| /** |
| * The data descriptor representing the list of included parts. This data is only available for |
| * Dart files that are the defining compilation unit of a library. |
| */ |
| static DataDescriptor<List<Source>> INCLUDED_PARTS = new DataDescriptor<List<Source>>("DartEntry.INCLUDED_PARTS"); |
| /** |
| * The data descriptor representing the client flag. This data is only available for Dart files |
| * that are the defining compilation unit of a library. |
| */ |
| static DataDescriptor<bool> IS_CLIENT = new DataDescriptor<bool>("DartEntry.IS_CLIENT"); |
| /** |
| * The data descriptor representing the launchable flag. This data is only available for Dart |
| * files that are the defining compilation unit of a library. |
| */ |
| static DataDescriptor<bool> IS_LAUNCHABLE = new DataDescriptor<bool>("DartEntry.IS_LAUNCHABLE"); |
| /** |
| * The data descriptor representing the errors resulting from parsing the source. |
| */ |
| static DataDescriptor<List<AnalysisError>> PARSE_ERRORS = new DataDescriptor<List<AnalysisError>>("DartEntry.PARSE_ERRORS"); |
| /** |
| * The data descriptor representing the parsed AST structure. |
| */ |
| static DataDescriptor<CompilationUnit> PARSED_UNIT = new DataDescriptor<CompilationUnit>("DartEntry.PARSED_UNIT"); |
| /** |
| * The data descriptor representing the public namespace of the library. This data is only |
| * available for Dart files that are the defining compilation unit of a library. |
| */ |
| static DataDescriptor<Namespace> PUBLIC_NAMESPACE = new DataDescriptor<Namespace>("DartEntry.PUBLIC_NAMESPACE"); |
| /** |
| * The data descriptor representing the errors resulting from resolving the source. |
| */ |
| static DataDescriptor<List<AnalysisError>> RESOLUTION_ERRORS = new DataDescriptor<List<AnalysisError>>("DartEntry.RESOLUTION_ERRORS"); |
| /** |
| * The data descriptor representing the resolved AST structure. |
| */ |
| static DataDescriptor<CompilationUnit> RESOLVED_UNIT = new DataDescriptor<CompilationUnit>("DartEntry.RESOLVED_UNIT"); |
| /** |
| * The data descriptor representing the source kind. |
| */ |
| static DataDescriptor<SourceKind> SOURCE_KIND = new DataDescriptor<SourceKind>("DartEntry.SOURCE_KIND"); |
| /** |
| * Return all of the errors associated with the compilation unit that are currently cached. |
| * @return all of the errors associated with the compilation unit |
| */ |
| List<AnalysisError> get allErrors; |
| /** |
| * Return a valid parsed compilation unit, either an unresolved AST structure or the result of |
| * resolving the AST structure in the context of some library, or {@code null} if there is no |
| * parsed compilation unit available. |
| * @return a valid parsed compilation unit |
| */ |
| CompilationUnit get anyParsedCompilationUnit; |
| /** |
| * Return the result of resolving the compilation unit as part of any library, or {@code null} if |
| * there is no cached resolved compilation unit. |
| * @return any resolved compilation unit |
| */ |
| CompilationUnit get anyResolvedCompilationUnit; |
| /** |
| * Return the state of the data represented by the given descriptor in the context of the given |
| * library. |
| * @param descriptor the descriptor representing the data whose state is to be returned |
| * @param librarySource the source of the defining compilation unit of the library that is the |
| * context for the data |
| * @return the value of the data represented by the given descriptor and library |
| */ |
| CacheState getState2(DataDescriptor<Object> descriptor, Source librarySource); |
| /** |
| * Return the value of the data represented by the given descriptor in the context of the given |
| * library, or {@code null} if the data represented by the descriptor is not in the cache. |
| * @param descriptor the descriptor representing which data is to be returned |
| * @param librarySource the source of the defining compilation unit of the library that is the |
| * context for the data |
| * @return the value of the data represented by the given descriptor and library |
| */ |
| Object getValue2(DataDescriptor descriptor, Source librarySource); |
| DartEntryImpl get writableCopy; |
| } |
| /** |
| * Instances of the class {@code DartEntryImpl} implement a {@link DartEntry}. |
| * @coverage dart.engine |
| */ |
| class DartEntryImpl extends SourceEntryImpl implements DartEntry { |
| /** |
| * The state of the cached source kind. |
| */ |
| CacheState _sourceKindState = CacheState.INVALID; |
| /** |
| * The kind of this source. |
| */ |
| SourceKind _sourceKind = SourceKind.UNKNOWN; |
| /** |
| * The state of the cached parsed compilation unit. |
| */ |
| CacheState _parsedUnitState = CacheState.INVALID; |
| /** |
| * The parsed compilation unit, or {@code null} if the parsed compilation unit is not currently |
| * cached. |
| */ |
| CompilationUnit _parsedUnit; |
| /** |
| * The state of the cached parse errors. |
| */ |
| CacheState _parseErrorsState = CacheState.INVALID; |
| /** |
| * The errors produced while scanning and parsing the compilation unit, or {@code null} if the |
| * errors are not currently cached. |
| */ |
| List<AnalysisError> _parseErrors = AnalysisError.NO_ERRORS; |
| /** |
| * The state of the cached list of included parts. |
| */ |
| CacheState _includedPartsState = CacheState.INVALID; |
| /** |
| * The list of parts included in the library, or {@code null} if the list is not currently cached. |
| * The list will be empty if the Dart file is a part rather than a library. |
| */ |
| List<Source> _includedParts = Source.EMPTY_ARRAY; |
| /** |
| * The source for the defining compilation unit of the library that contains this unit, or{@code null} if this unit is contained in multiple libraries. (If this unit is the defining |
| * compilation unit for it's library, then this will be the source for this unit.) |
| */ |
| Source _librarySource; |
| /** |
| * The information known as a result of resolving this compilation unit as part of the library |
| * that contains this unit, or {@code null} if this unit is contained in multiple libraries. |
| */ |
| DartEntryImpl_ResolutionState _resolutionState = new DartEntryImpl_ResolutionState(); |
| /** |
| * A table mapping the sources of the libraries containing this compilation unit to the |
| * information known as a result of resolving this compilation unit as part of the library, or{@code null} if this unit is contained in a single library. |
| */ |
| Map<Source, DartEntryImpl_ResolutionState> _resolutionMap; |
| /** |
| * The state of the cached library element. |
| */ |
| CacheState _elementState = CacheState.INVALID; |
| /** |
| * The element representing the library, or {@code null} if the element is not currently cached. |
| */ |
| LibraryElement _element; |
| /** |
| * The state of the cached public namespace. |
| */ |
| CacheState _publicNamespaceState = CacheState.INVALID; |
| /** |
| * The public namespace of the library, or {@code null} if the namespace is not currently cached. |
| */ |
| Namespace _publicNamespace; |
| /** |
| * The state of the cached client/ server flag. |
| */ |
| CacheState _clientServerState = CacheState.INVALID; |
| /** |
| * The state of the cached launchable flag. |
| */ |
| CacheState _launchableState = CacheState.INVALID; |
| /** |
| * An integer holding bit masks such as {@link #LAUNCHABLE} and {@link #CLIENT_CODE}. |
| */ |
| int _bitmask = 0; |
| /** |
| * Mask indicating that this library is launchable: that the file has a main method. |
| */ |
| static int _LAUNCHABLE = 1 << 1; |
| /** |
| * Mask indicating that the library is client code: that the library depends on the html library. |
| * If the library is not "client code", then it is referenced as "server code". |
| */ |
| static int _CLIENT_CODE = 1 << 2; |
| /** |
| * Initialize a newly created cache entry to be empty. |
| */ |
| DartEntryImpl() : super() { |
| } |
| /** |
| * Record the fact that we are about to parse the compilation unit by marking the results of |
| * parsing as being in progress. |
| */ |
| void aboutToParse() { |
| setState(SourceEntry.LINE_INFO, CacheState.IN_PROCESS); |
| _parsedUnitState = CacheState.IN_PROCESS; |
| _parseErrorsState = CacheState.IN_PROCESS; |
| } |
| List<AnalysisError> get allErrors { |
| List<AnalysisError> errors = new List<AnalysisError>(); |
| for (AnalysisError error in _parseErrors) { |
| errors.add(error); |
| } |
| if (_resolutionMap == null) { |
| for (AnalysisError error in _resolutionState._resolutionErrors) { |
| errors.add(error); |
| } |
| } else { |
| for (DartEntryImpl_ResolutionState state in _resolutionMap.values) { |
| for (AnalysisError error in state._resolutionErrors) { |
| errors.add(error); |
| } |
| } |
| } |
| if (errors.length == 0) { |
| return AnalysisError.NO_ERRORS; |
| } |
| return new List.from(errors); |
| } |
| CompilationUnit get anyParsedCompilationUnit { |
| if (identical(_parsedUnitState, CacheState.VALID)) { |
| return _parsedUnit; |
| } |
| if (_resolutionMap == null) { |
| return _resolutionState._resolvedUnit; |
| } else { |
| for (DartEntryImpl_ResolutionState state in _resolutionMap.values) { |
| if (identical(state._resolvedUnitState, CacheState.VALID)) { |
| return state._resolvedUnit; |
| } |
| } |
| } |
| return null; |
| } |
| CompilationUnit get anyResolvedCompilationUnit { |
| for (DartEntryImpl_ResolutionState state in _resolutionMap.values) { |
| if (identical(state._resolvedUnitState, CacheState.VALID)) { |
| return state._resolvedUnit; |
| } |
| } |
| return null; |
| } |
| SourceKind get kind => _sourceKind; |
| CacheState getState(DataDescriptor<Object> descriptor) { |
| if (identical(descriptor, DartEntry.ELEMENT)) { |
| return _elementState; |
| } else if (identical(descriptor, DartEntry.INCLUDED_PARTS)) { |
| return _includedPartsState; |
| } else if (identical(descriptor, DartEntry.IS_CLIENT)) { |
| return _clientServerState; |
| } else if (identical(descriptor, DartEntry.IS_LAUNCHABLE)) { |
| return _launchableState; |
| } else if (identical(descriptor, DartEntry.PARSE_ERRORS)) { |
| return _parseErrorsState; |
| } else if (identical(descriptor, DartEntry.PARSED_UNIT)) { |
| return _parsedUnitState; |
| } else if (identical(descriptor, DartEntry.PUBLIC_NAMESPACE)) { |
| return _publicNamespaceState; |
| } else if (identical(descriptor, DartEntry.SOURCE_KIND)) { |
| return _sourceKindState; |
| } else { |
| return super.getState(descriptor); |
| } |
| } |
| CacheState getState2(DataDescriptor<Object> descriptor, Source librarySource) { |
| if (identical(descriptor, DartEntry.RESOLUTION_ERRORS)) { |
| if (_resolutionMap == null) { |
| return _resolutionState._resolutionErrorsState; |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource]; |
| if (state != null) { |
| return state._resolutionErrorsState; |
| } |
| } |
| } else if (identical(descriptor, DartEntry.RESOLVED_UNIT)) { |
| if (_resolutionMap == null) { |
| return _resolutionState._resolvedUnitState; |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource]; |
| if (state != null) { |
| return state._resolvedUnitState; |
| } |
| } |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| return CacheState.INVALID; |
| } |
| Object getValue(DataDescriptor descriptor) { |
| if (identical(descriptor, DartEntry.ELEMENT)) { |
| return _element as Object; |
| } else if (identical(descriptor, DartEntry.INCLUDED_PARTS)) { |
| return _includedParts as Object; |
| } else if (identical(descriptor, DartEntry.IS_CLIENT)) { |
| return ((_bitmask & _CLIENT_CODE) != 0 ? true : false) as Object; |
| } else if (identical(descriptor, DartEntry.IS_LAUNCHABLE)) { |
| return ((_bitmask & _LAUNCHABLE) != 0 ? true : false) as Object; |
| } else if (identical(descriptor, DartEntry.PARSE_ERRORS)) { |
| return _parseErrors as Object; |
| } else if (identical(descriptor, DartEntry.PARSED_UNIT)) { |
| return _parsedUnit as Object; |
| } else if (identical(descriptor, DartEntry.PUBLIC_NAMESPACE)) { |
| return _publicNamespace as Object; |
| } else if (identical(descriptor, DartEntry.SOURCE_KIND)) { |
| return _sourceKind as Object; |
| } |
| return super.getValue(descriptor); |
| } |
| Object getValue2(DataDescriptor descriptor, Source librarySource2) { |
| if (identical(descriptor, DartEntry.RESOLUTION_ERRORS)) { |
| if (_resolutionMap == null) { |
| if (librarySource2 == this._librarySource) { |
| return _resolutionState._resolutionErrors as Object; |
| } else { |
| return AnalysisError.NO_ERRORS as Object; |
| } |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource2]; |
| if (state != null) { |
| return state._resolutionErrors as Object; |
| } |
| } |
| } else if (identical(descriptor, DartEntry.RESOLVED_UNIT)) { |
| if (_resolutionMap == null) { |
| if (librarySource2 == this._librarySource) { |
| return _resolutionState._resolvedUnit as Object; |
| } else { |
| return null; |
| } |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource2]; |
| if (state != null) { |
| return state._resolvedUnit as Object; |
| } |
| } |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| return null; |
| } |
| DartEntryImpl get writableCopy { |
| DartEntryImpl copy = new DartEntryImpl(); |
| copy.copyFrom(this); |
| return copy; |
| } |
| /** |
| * Invalidate all of the resolution information associated with the compilation unit. |
| */ |
| void invalidateAllResolutionInformation() { |
| if (_resolutionMap == null) { |
| _resolutionState.invalidateAllResolutionInformation(); |
| } else { |
| for (DartEntryImpl_ResolutionState state in _resolutionMap.values) { |
| state.invalidateAllResolutionInformation(); |
| } |
| } |
| _elementState = CacheState.INVALID; |
| _element = null; |
| _publicNamespaceState = CacheState.INVALID; |
| _publicNamespace = null; |
| _launchableState = CacheState.INVALID; |
| _clientServerState = CacheState.INVALID; |
| _bitmask = 0; |
| } |
| /** |
| * Remove any resolution information associated with this compilation unit being part of the given |
| * library, presumably because it is no longer part of the library. |
| * @param librarySource the source of the defining compilation unit of the library that used to |
| * contain this part but no longer does |
| */ |
| void removeResolution(Source librarySource2) { |
| if (_resolutionMap == null) { |
| if (librarySource2 == this._librarySource) { |
| _resolutionState.invalidateAllResolutionInformation(); |
| this._librarySource = null; |
| } |
| } else { |
| _resolutionMap.remove(librarySource2); |
| if (_resolutionMap.length == 1) { |
| MapEntry<Source, DartEntryImpl_ResolutionState> entry = new JavaIterator(getMapEntrySet(_resolutionMap)).next(); |
| this._librarySource = entry.getKey(); |
| _resolutionState = entry.getValue(); |
| _resolutionMap = null; |
| } |
| } |
| } |
| /** |
| * Set the results of parsing the compilation unit at the given time to the given values. |
| * @param modificationStamp the earliest time at which the source was last modified before the |
| * parsing was started |
| * @param lineInfo the line information resulting from parsing the compilation unit |
| * @param unit the AST structure resulting from parsing the compilation unit |
| * @param errors the parse errors resulting from parsing the compilation unit |
| */ |
| void setParseResults(int modificationStamp, LineInfo lineInfo, CompilationUnit unit, List<AnalysisError> errors) { |
| if (getState(SourceEntry.LINE_INFO) != CacheState.VALID) { |
| setValue(SourceEntry.LINE_INFO, lineInfo); |
| } |
| if (_parsedUnitState != CacheState.VALID) { |
| _parsedUnit = unit; |
| } |
| if (_parseErrorsState != CacheState.VALID) { |
| _parseErrors = errors == null ? AnalysisError.NO_ERRORS : errors; |
| } |
| } |
| void setState(DataDescriptor<Object> descriptor, CacheState state) { |
| if (identical(descriptor, DartEntry.ELEMENT)) { |
| _element = updatedValue(state, _element, null); |
| _elementState = state; |
| } else if (identical(descriptor, DartEntry.INCLUDED_PARTS)) { |
| _includedParts = updatedValue(state, _includedParts, Source.EMPTY_ARRAY); |
| _includedPartsState = state; |
| } else if (identical(descriptor, DartEntry.IS_CLIENT)) { |
| _bitmask = updatedValue2(state, _bitmask, _CLIENT_CODE); |
| _clientServerState = state; |
| } else if (identical(descriptor, DartEntry.IS_LAUNCHABLE)) { |
| _bitmask = updatedValue2(state, _bitmask, _LAUNCHABLE); |
| _launchableState = state; |
| } else if (identical(descriptor, DartEntry.PARSE_ERRORS)) { |
| _parseErrors = updatedValue(state, _parseErrors, AnalysisError.NO_ERRORS); |
| _parseErrorsState = state; |
| } else if (identical(descriptor, DartEntry.PARSED_UNIT)) { |
| _parsedUnit = updatedValue(state, _parsedUnit, null); |
| _parsedUnitState = state; |
| } else if (identical(descriptor, DartEntry.PUBLIC_NAMESPACE)) { |
| _publicNamespace = updatedValue(state, _publicNamespace, null); |
| _publicNamespaceState = state; |
| } else if (identical(descriptor, DartEntry.SOURCE_KIND)) { |
| _sourceKind = updatedValue(state, _sourceKind, SourceKind.UNKNOWN); |
| _sourceKindState = state; |
| } else { |
| super.setState(descriptor, state); |
| } |
| } |
| /** |
| * Set the state of the data represented by the given descriptor in the context of the given |
| * library to the given state. |
| * @param descriptor the descriptor representing the data whose state is to be set |
| * @param librarySource the source of the defining compilation unit of the library that is the |
| * context for the data |
| * @param state the new state of the data represented by the given descriptor |
| */ |
| void setState2(DataDescriptor<Object> descriptor, Source librarySource2, CacheState state) { |
| if (_resolutionMap == null && this._librarySource != librarySource2) { |
| _resolutionMap = new Map<Source, DartEntryImpl_ResolutionState>(); |
| _resolutionMap[this._librarySource] = _resolutionState; |
| this._librarySource = null; |
| _resolutionState = null; |
| } |
| if (identical(descriptor, DartEntry.RESOLUTION_ERRORS)) { |
| if (_resolutionMap == null) { |
| _resolutionState._resolutionErrors = updatedValue(state, _resolutionState._resolutionErrors, AnalysisError.NO_ERRORS); |
| _resolutionState._resolutionErrorsState = state; |
| } else { |
| DartEntryImpl_ResolutionState resolutionState = _resolutionMap[librarySource2]; |
| if (resolutionState == null) { |
| resolutionState = new DartEntryImpl_ResolutionState(); |
| _resolutionMap[librarySource2] = resolutionState; |
| } |
| resolutionState._resolutionErrors = updatedValue(state, resolutionState._resolutionErrors, AnalysisError.NO_ERRORS); |
| resolutionState._resolutionErrorsState = state; |
| } |
| } else if (identical(descriptor, DartEntry.RESOLVED_UNIT)) { |
| if (_resolutionMap == null) { |
| _resolutionState._resolvedUnit = updatedValue(state, _resolutionState._resolvedUnit, null); |
| _resolutionState._resolvedUnitState = state; |
| } else { |
| DartEntryImpl_ResolutionState resolutionState = _resolutionMap[librarySource2]; |
| if (resolutionState == null) { |
| resolutionState = new DartEntryImpl_ResolutionState(); |
| _resolutionMap[librarySource2] = resolutionState; |
| } |
| resolutionState._resolvedUnit = updatedValue(state, resolutionState._resolvedUnit, null); |
| resolutionState._resolvedUnitState = state; |
| } |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| } |
| void setValue(DataDescriptor descriptor, Object value) { |
| if (identical(descriptor, DartEntry.ELEMENT)) { |
| _element = value as LibraryElement; |
| _elementState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.INCLUDED_PARTS)) { |
| _includedParts = value == null ? Source.EMPTY_ARRAY : (value as List<Source>); |
| _includedPartsState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.IS_CLIENT)) { |
| if (((value as bool))) { |
| _bitmask |= _CLIENT_CODE; |
| } else { |
| _bitmask &= ~_CLIENT_CODE; |
| } |
| _clientServerState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.IS_LAUNCHABLE)) { |
| if (((value as bool))) { |
| _bitmask |= _LAUNCHABLE; |
| } else { |
| _bitmask &= ~_LAUNCHABLE; |
| } |
| _launchableState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.PARSE_ERRORS)) { |
| _parseErrors = value == null ? AnalysisError.NO_ERRORS : (value as List<AnalysisError>); |
| _parseErrorsState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.PARSED_UNIT)) { |
| _parsedUnit = value as CompilationUnit; |
| _parsedUnitState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.PUBLIC_NAMESPACE)) { |
| _publicNamespace = value as Namespace; |
| _publicNamespaceState = CacheState.VALID; |
| } else if (identical(descriptor, DartEntry.SOURCE_KIND)) { |
| _sourceKind = value as SourceKind; |
| _sourceKindState = CacheState.VALID; |
| } else { |
| super.setValue(descriptor, value); |
| } |
| } |
| /** |
| * Set the value of the data represented by the given descriptor in the context of the given |
| * library to the given value, and set the state of that data to {@link CacheState#VALID}. |
| * @param descriptor the descriptor representing which data is to have its value set |
| * @param librarySource the source of the defining compilation unit of the library that is the |
| * context for the data |
| * @param value the new value of the data represented by the given descriptor and library |
| */ |
| void setValue2(DataDescriptor descriptor, Source librarySource2, Object value) { |
| if (_resolutionMap == null) { |
| if (this._librarySource == null) { |
| this._librarySource = librarySource2; |
| } else if (librarySource2 != this._librarySource) { |
| _resolutionMap = new Map<Source, DartEntryImpl_ResolutionState>(); |
| _resolutionMap[this._librarySource] = _resolutionState; |
| this._librarySource = null; |
| _resolutionState = null; |
| } |
| } |
| if (identical(descriptor, DartEntry.RESOLUTION_ERRORS)) { |
| if (_resolutionMap == null) { |
| _resolutionState._resolutionErrors = value == null ? AnalysisError.NO_ERRORS : (value as List<AnalysisError>); |
| _resolutionState._resolutionErrorsState = CacheState.VALID; |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource2]; |
| if (state != null) { |
| state._resolutionErrors = value == null ? AnalysisError.NO_ERRORS : (value as List<AnalysisError>); |
| state._resolutionErrorsState = CacheState.VALID; |
| } |
| } |
| } else if (identical(descriptor, DartEntry.RESOLVED_UNIT)) { |
| if (_resolutionMap == null) { |
| _resolutionState._resolvedUnit = value as CompilationUnit; |
| _resolutionState._resolvedUnitState = CacheState.VALID; |
| } else { |
| DartEntryImpl_ResolutionState state = _resolutionMap[librarySource2]; |
| if (state != null) { |
| state._resolvedUnit = value as CompilationUnit; |
| state._resolvedUnitState = CacheState.VALID; |
| } |
| } |
| } |
| } |
| void copyFrom(SourceEntryImpl entry) { |
| super.copyFrom(entry); |
| DartEntryImpl other = entry as DartEntryImpl; |
| _sourceKindState = other._sourceKindState; |
| _sourceKind = other._sourceKind; |
| _parsedUnitState = other._parsedUnitState; |
| _parsedUnit = other._parsedUnit; |
| _parseErrorsState = other._parseErrorsState; |
| _parseErrors = other._parseErrors; |
| _includedPartsState = other._includedPartsState; |
| _includedParts = other._includedParts; |
| if (other._resolutionMap == null) { |
| _librarySource = other._librarySource; |
| DartEntryImpl_ResolutionState newState = new DartEntryImpl_ResolutionState(); |
| newState.copyFrom(_resolutionState); |
| _resolutionState = newState; |
| } else { |
| _resolutionMap = new Map<Source, DartEntryImpl_ResolutionState>(); |
| for (MapEntry<Source, DartEntryImpl_ResolutionState> mapEntry in getMapEntrySet(other._resolutionMap)) { |
| DartEntryImpl_ResolutionState newState = new DartEntryImpl_ResolutionState(); |
| newState.copyFrom(mapEntry.getValue()); |
| _resolutionMap[mapEntry.getKey()] = newState; |
| } |
| } |
| _elementState = other._elementState; |
| _element = other._element; |
| _publicNamespaceState = other._publicNamespaceState; |
| _publicNamespace = other._publicNamespace; |
| _clientServerState = other._clientServerState; |
| _launchableState = other._launchableState; |
| _bitmask = other._bitmask; |
| } |
| /** |
| * Given that one of the flags is being transitioned to the given state, return the value of the |
| * flags that should be kept in the cache. |
| * @param state the state to which the data is being transitioned |
| * @param currentValue the value of the flags before the transition |
| * @param bitMask the mask used to access the bit whose state is being set |
| * @return the value of the data that should be kept in the cache |
| */ |
| int updatedValue2(CacheState state, int currentValue, int bitMask) { |
| if (identical(state, CacheState.VALID)) { |
| throw new IllegalArgumentException("Use setValue() to set the state to VALID"); |
| } else if (identical(state, CacheState.IN_PROCESS)) { |
| return currentValue; |
| } |
| return currentValue &= ~bitMask; |
| } |
| } |
| /** |
| * Instances of the class {@code ResolutionState} represent the information produced by resolving |
| * a compilation unit as part of a specific library. |
| */ |
| class DartEntryImpl_ResolutionState { |
| /** |
| * The state of the cached resolved compilation unit. |
| */ |
| CacheState _resolvedUnitState = CacheState.INVALID; |
| /** |
| * The resolved compilation unit, or {@code null} if the resolved compilation unit is not |
| * currently cached. |
| */ |
| CompilationUnit _resolvedUnit; |
| /** |
| * The state of the cached resolution errors. |
| */ |
| CacheState _resolutionErrorsState = CacheState.INVALID; |
| /** |
| * The errors produced while resolving the compilation unit, or {@code null} if the errors are |
| * not currently cached. |
| */ |
| List<AnalysisError> _resolutionErrors = AnalysisError.NO_ERRORS; |
| /** |
| * Initialize a newly created resolution state. |
| */ |
| DartEntryImpl_ResolutionState() : super() { |
| } |
| /** |
| * Set this state to be exactly like the given state. |
| * @param other the state to be copied |
| */ |
| void copyFrom(DartEntryImpl_ResolutionState other) { |
| _resolvedUnitState = other._resolvedUnitState; |
| _resolvedUnit = other._resolvedUnit; |
| _resolutionErrorsState = other._resolutionErrorsState; |
| _resolutionErrors = other._resolutionErrors; |
| } |
| /** |
| * Invalidate all of the resolution information associated with the compilation unit. |
| */ |
| void invalidateAllResolutionInformation() { |
| _resolvedUnitState = CacheState.INVALID; |
| _resolvedUnit = null; |
| _resolutionErrorsState = CacheState.INVALID; |
| _resolutionErrors = AnalysisError.NO_ERRORS; |
| } |
| } |
| /** |
| * Instances of the class {@code DataDescriptor} are immutable constants representing data that can |
| * be stored in the cache. |
| */ |
| class DataDescriptor<E> { |
| /** |
| * The name of the descriptor, used for debugging purposes. |
| */ |
| String _name; |
| /** |
| * Initialize a newly created descriptor to have the given name. |
| * @param name the name of the descriptor |
| */ |
| DataDescriptor(String name) { |
| this._name = name; |
| } |
| String toString() => _name; |
| } |
| /** |
| * The interface {@code HtmlEntry} defines the behavior of objects that maintain the information |
| * cached by an analysis context about an individual HTML file. |
| * @coverage dart.engine |
| */ |
| abstract class HtmlEntry implements SourceEntry { |
| /** |
| * The data descriptor representing the HTML element. |
| */ |
| static DataDescriptor<HtmlElement> ELEMENT = new DataDescriptor<HtmlElement>("HtmlEntry.ELEMENT"); |
| /** |
| * The data descriptor representing the parsed AST structure. |
| */ |
| static DataDescriptor<HtmlUnit> PARSED_UNIT = new DataDescriptor<HtmlUnit>("HtmlEntry.PARSED_UNIT"); |
| /** |
| * The data descriptor representing the list of referenced libraries. |
| */ |
| static DataDescriptor<List<Source>> REFERENCED_LIBRARIES = new DataDescriptor<List<Source>>("HtmlEntry.REFERENCED_LIBRARIES"); |
| /** |
| * The data descriptor representing the errors resulting from resolving the source. |
| */ |
| static DataDescriptor<List<AnalysisError>> RESOLUTION_ERRORS = new DataDescriptor<List<AnalysisError>>("HtmlEntry.RESOLUTION_ERRORS"); |
| /** |
| * The data descriptor representing the resolved AST structure. |
| */ |
| static DataDescriptor<HtmlUnit> RESOLVED_UNIT = new DataDescriptor<HtmlUnit>("HtmlEntry.RESOLVED_UNIT"); |
| HtmlEntryImpl get writableCopy; |
| } |
| /** |
| * Instances of the class {@code HtmlEntryImpl} implement an {@link HtmlEntry}. |
| * @coverage dart.engine |
| */ |
| class HtmlEntryImpl extends SourceEntryImpl implements HtmlEntry { |
| /** |
| * The state of the cached parsed (but not resolved) HTML unit. |
| */ |
| CacheState _parsedUnitState = CacheState.INVALID; |
| /** |
| * The parsed HTML unit, or {@code null} if the parsed HTML unit is not currently cached. |
| */ |
| HtmlUnit _parsedUnit; |
| /** |
| * The state of the cached resolution errors. |
| */ |
| CacheState _resolutionErrorsState = CacheState.INVALID; |
| /** |
| * The errors produced while resolving the compilation unit, or {@code null} if the errors are not |
| * currently cached. |
| */ |
| List<AnalysisError> _resolutionErrors = AnalysisError.NO_ERRORS; |
| /** |
| * The state of the cached parsed and resolved HTML unit. |
| */ |
| CacheState _resolvedUnitState = CacheState.INVALID; |
| /** |
| * The resolved HTML unit, or {@code null} if the resolved HTML unit is not currently cached. |
| */ |
| HtmlUnit _resolvedUnit; |
| /** |
| * The state of the cached list of referenced libraries. |
| */ |
| CacheState _referencedLibrariesState = CacheState.INVALID; |
| /** |
| * The list of libraries referenced in the HTML, or {@code null} if the list is not currently |
| * cached. Note that this list does not include libraries defined directly within the HTML file. |
| */ |
| List<Source> _referencedLibraries = Source.EMPTY_ARRAY; |
| /** |
| * The state of the cached HTML element. |
| */ |
| CacheState _elementState = CacheState.INVALID; |
| /** |
| * The element representing the HTML file, or {@code null} if the element is not currently cached. |
| */ |
| HtmlElement _element; |
| /** |
| * Initialize a newly created cache entry to be empty. |
| */ |
| HtmlEntryImpl() : super() { |
| } |
| SourceKind get kind => SourceKind.HTML; |
| CacheState getState(DataDescriptor<Object> descriptor) { |
| if (identical(descriptor, HtmlEntry.ELEMENT)) { |
| return _elementState; |
| } else if (identical(descriptor, HtmlEntry.PARSED_UNIT)) { |
| return _parsedUnitState; |
| } else if (identical(descriptor, HtmlEntry.REFERENCED_LIBRARIES)) { |
| return _referencedLibrariesState; |
| } else if (identical(descriptor, HtmlEntry.RESOLUTION_ERRORS)) { |
| return _resolutionErrorsState; |
| } else if (identical(descriptor, HtmlEntry.RESOLVED_UNIT)) { |
| return _resolvedUnitState; |
| } |
| return super.getState(descriptor); |
| } |
| Object getValue(DataDescriptor descriptor) { |
| if (identical(descriptor, HtmlEntry.ELEMENT)) { |
| return _element as Object; |
| } else if (identical(descriptor, HtmlEntry.PARSED_UNIT)) { |
| return _parsedUnit as Object; |
| } else if (identical(descriptor, HtmlEntry.REFERENCED_LIBRARIES)) { |
| return _referencedLibraries as Object; |
| } else if (identical(descriptor, HtmlEntry.RESOLUTION_ERRORS)) { |
| return _resolutionErrors as Object; |
| } else if (identical(descriptor, HtmlEntry.RESOLVED_UNIT)) { |
| return _resolvedUnit as Object; |
| } |
| return super.getValue(descriptor); |
| } |
| HtmlEntryImpl get writableCopy { |
| HtmlEntryImpl copy = new HtmlEntryImpl(); |
| copy.copyFrom(this); |
| return copy; |
| } |
| void setState(DataDescriptor<Object> descriptor, CacheState state) { |
| if (identical(descriptor, HtmlEntry.ELEMENT)) { |
| _element = updatedValue(state, _element, null); |
| _elementState = state; |
| } else if (identical(descriptor, HtmlEntry.PARSED_UNIT)) { |
| _parsedUnit = updatedValue(state, _parsedUnit, null); |
| _parsedUnitState = state; |
| } else if (identical(descriptor, HtmlEntry.REFERENCED_LIBRARIES)) { |
| _referencedLibraries = updatedValue(state, _referencedLibraries, Source.EMPTY_ARRAY); |
| _referencedLibrariesState = state; |
| } else if (identical(descriptor, HtmlEntry.RESOLUTION_ERRORS)) { |
| _resolutionErrors = updatedValue(state, _resolutionErrors, AnalysisError.NO_ERRORS); |
| _resolutionErrorsState = state; |
| } else if (identical(descriptor, HtmlEntry.RESOLVED_UNIT)) { |
| _resolvedUnit = updatedValue(state, _resolvedUnit, null); |
| _resolvedUnitState = state; |
| } else { |
| super.setState(descriptor, state); |
| } |
| } |
| void setValue(DataDescriptor descriptor, Object value) { |
| if (identical(descriptor, HtmlEntry.ELEMENT)) { |
| _element = value as HtmlElement; |
| _elementState = CacheState.VALID; |
| } else if (identical(descriptor, HtmlEntry.PARSED_UNIT)) { |
| _parsedUnit = value as HtmlUnit; |
| _parsedUnitState = CacheState.VALID; |
| } else if (identical(descriptor, HtmlEntry.REFERENCED_LIBRARIES)) { |
| _referencedLibraries = value == null ? Source.EMPTY_ARRAY : (value as List<Source>); |
| _referencedLibrariesState = CacheState.VALID; |
| } else if (identical(descriptor, HtmlEntry.RESOLUTION_ERRORS)) { |
| _resolutionErrors = value as List<AnalysisError>; |
| _resolutionErrorsState = CacheState.VALID; |
| } else if (identical(descriptor, HtmlEntry.RESOLVED_UNIT)) { |
| _resolvedUnit = value as HtmlUnit; |
| _resolvedUnitState = CacheState.VALID; |
| } else { |
| super.setValue(descriptor, value); |
| } |
| } |
| void copyFrom(SourceEntryImpl entry) { |
| super.copyFrom(entry); |
| HtmlEntryImpl other = entry as HtmlEntryImpl; |
| _parsedUnitState = other._parsedUnitState; |
| _parsedUnit = other._parsedUnit; |
| _referencedLibrariesState = other._referencedLibrariesState; |
| _referencedLibraries = other._referencedLibraries; |
| _resolutionErrors = other._resolutionErrors; |
| _resolutionErrorsState = other._resolutionErrorsState; |
| _resolvedUnitState = other._resolvedUnitState; |
| _resolvedUnit = other._resolvedUnit; |
| _elementState = other._elementState; |
| _element = other._element; |
| } |
| } |
| /** |
| * The interface {@code SourceEntry} defines the behavior of objects that maintain the information |
| * cached by an analysis context about an individual source, no matter what kind of source it is. |
| * <p> |
| * Source entries should be treated as if they were immutable unless a writable copy of the entry |
| * has been obtained and has not yet been made visible to other threads. |
| * @coverage dart.engine |
| */ |
| abstract class SourceEntry { |
| /** |
| * The data descriptor representing the line information. |
| */ |
| static DataDescriptor<LineInfo> LINE_INFO = new DataDescriptor<LineInfo>("SourceEntry.LINE_INFO"); |
| /** |
| * Return the kind of the source, or {@code null} if the kind is not currently cached. |
| * @return the kind of the source |
| */ |
| SourceKind get kind; |
| /** |
| * Return the most recent time at which the state of the source matched the state represented by |
| * this entry. |
| * @return the modification time of this entry |
| */ |
| int get modificationTime; |
| /** |
| * Return the state of the data represented by the given descriptor. |
| * @param descriptor the descriptor representing the data whose state is to be returned |
| * @return the state of the data represented by the given descriptor |
| */ |
| CacheState getState(DataDescriptor<Object> descriptor); |
| /** |
| * Return the value of the data represented by the given descriptor, or {@code null} if the data |
| * represented by the descriptor is not in the cache. |
| * @param descriptor the descriptor representing which data is to be returned |
| * @return the value of the data represented by the given descriptor |
| */ |
| Object getValue(DataDescriptor descriptor); |
| /** |
| * Return a new entry that is initialized to the same state as this entry but that can be |
| * modified. |
| * @return a writable copy of this entry |
| */ |
| SourceEntryImpl get writableCopy; |
| } |
| /** |
| * Instances of the abstract class {@code SourceEntryImpl} implement the behavior common to all{@link SourceEntry source entries}. |
| * @coverage dart.engine |
| */ |
| abstract class SourceEntryImpl implements SourceEntry { |
| /** |
| * The most recent time at which the state of the source matched the state represented by this |
| * entry. |
| */ |
| int _modificationTime = 0; |
| /** |
| * The state of the cached line information. |
| */ |
| CacheState _lineInfoState = CacheState.INVALID; |
| /** |
| * The line information computed for the source, or {@code null} if the line information is not |
| * currently cached. |
| */ |
| LineInfo _lineInfo; |
| /** |
| * Initialize a newly created cache entry to be empty. |
| */ |
| SourceEntryImpl() : super() { |
| } |
| int get modificationTime => _modificationTime; |
| CacheState getState(DataDescriptor<Object> descriptor) { |
| if (identical(descriptor, SourceEntry.LINE_INFO)) { |
| return _lineInfoState; |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| } |
| Object getValue(DataDescriptor descriptor) { |
| if (identical(descriptor, SourceEntry.LINE_INFO)) { |
| return _lineInfo as Object; |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| } |
| /** |
| * Set the most recent time at which the state of the source matched the state represented by this |
| * entry to the given time. |
| * @param time the new modification time of this entry |
| */ |
| void set modificationTime(int time) { |
| _modificationTime = time; |
| } |
| /** |
| * Set the state of the data represented by the given descriptor to the given state. |
| * @param descriptor the descriptor representing the data whose state is to be set |
| * @param the new state of the data represented by the given descriptor |
| */ |
| void setState(DataDescriptor<Object> descriptor, CacheState state) { |
| if (identical(descriptor, SourceEntry.LINE_INFO)) { |
| _lineInfo = updatedValue(state, _lineInfo, null); |
| _lineInfoState = state; |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| } |
| /** |
| * Set the value of the data represented by the given descriptor to the given value. |
| * @param descriptor the descriptor representing the data whose value is to be set |
| * @param value the new value of the data represented by the given descriptor |
| */ |
| void setValue(DataDescriptor descriptor, Object value) { |
| if (identical(descriptor, SourceEntry.LINE_INFO)) { |
| _lineInfo = value as LineInfo; |
| _lineInfoState = CacheState.VALID; |
| } else { |
| throw new IllegalArgumentException("Invalid descriptor: ${descriptor}"); |
| } |
| } |
| /** |
| * Copy the information from the given cache entry. |
| * @param entry the cache entry from which information will be copied |
| */ |
| void copyFrom(SourceEntryImpl entry) { |
| _modificationTime = entry._modificationTime; |
| _lineInfoState = entry._lineInfoState; |
| _lineInfo = entry._lineInfo; |
| } |
| /** |
| * Given that some data is being transitioned to the given state, return the value that should be |
| * kept in the cache. |
| * @param state the state to which the data is being transitioned |
| * @param currentValue the value of the data before the transition |
| * @param defaultValue the value to be used if the current value is to be removed from the cache |
| * @return the value of the data that should be kept in the cache |
| */ |
| Object updatedValue(CacheState state, Object currentValue, Object defaultValue) { |
| if (identical(state, CacheState.VALID)) { |
| throw new IllegalArgumentException("Use setValue() to set the state to VALID"); |
| } else if (identical(state, CacheState.IN_PROCESS)) { |
| return currentValue; |
| } |
| return defaultValue; |
| } |
| } |
| /** |
| * Instances of the class {@code AnalysisContextImpl} implement an {@link AnalysisContext analysis |
| * context}. |
| * @coverage dart.engine |
| */ |
| class AnalysisContextImpl implements InternalAnalysisContext { |
| /** |
| * The source factory used to create the sources that can be analyzed in this context. |
| */ |
| SourceFactory _sourceFactory; |
| /** |
| * A table mapping the sources known to the context to the information known about the source. |
| */ |
| Map<Source, SourceEntry> _sourceMap = new Map<Source, SourceEntry>(); |
| /** |
| * A table mapping sources to the change notices that are waiting to be returned related to that |
| * source. |
| */ |
| Map<Source, ChangeNoticeImpl> _pendingNotices = new Map<Source, ChangeNoticeImpl>(); |
| /** |
| * A list containing the most recently accessed sources with the most recently used at the end of |
| * the list. When more sources are added than the maximum allowed then the least recently used |
| * source will be removed and will have it's cached AST structure flushed. |
| */ |
| List<Source> _recentlyUsed = new List<Source>(); |
| /** |
| * The object used to synchronize access to all of the caches. |
| */ |
| Object _cacheLock = new Object(); |
| /** |
| * The maximum number of sources for which data should be kept in the cache. |
| */ |
| static int _MAX_CACHE_SIZE = 64; |
| /** |
| * The name of the 'src' attribute in a HTML tag. |
| */ |
| static String _ATTRIBUTE_SRC = "src"; |
| /** |
| * The name of the 'script' tag in an HTML file. |
| */ |
| static String _TAG_SCRIPT = "script"; |
| /** |
| * The number of times that the flushing of information from the cache has been disabled without |
| * being re-enabled. |
| */ |
| int _cacheRemovalCount = 0; |
| /** |
| * Initialize a newly created analysis context. |
| */ |
| AnalysisContextImpl() : super() { |
| } |
| void addSourceInfo(Source source, SourceEntry info) { |
| _sourceMap[source] = info; |
| } |
| void applyChanges(ChangeSet changeSet) { |
| if (changeSet.isEmpty()) { |
| return; |
| } |
| { |
| List<Source> removedSources = new List<Source>.from(changeSet.removed); |
| for (SourceContainer container in changeSet.removedContainers) { |
| addSourcesInContainer(removedSources, container); |
| } |
| bool addedDartSource = false; |
| for (Source source in changeSet.added3) { |
| if (sourceAvailable(source)) { |
| addedDartSource = true; |
| } |
| } |
| for (Source source in changeSet.changed3) { |
| sourceChanged(source); |
| } |
| for (Source source in removedSources) { |
| sourceRemoved(source); |
| } |
| if (addedDartSource) { |
| for (MapEntry<Source, SourceEntry> mapEntry in getMapEntrySet(_sourceMap)) { |
| if (!mapEntry.getKey().isInSystemLibrary() && mapEntry.getValue() is DartEntry) { |
| ((mapEntry.getValue() as DartEntryImpl)).invalidateAllResolutionInformation(); |
| } |
| } |
| } |
| } |
| } |
| String computeDocumentationComment(Element element) { |
| if (element == null) { |
| return null; |
| } |
| Source source2 = element.source; |
| if (source2 == null) { |
| return null; |
| } |
| List<CharSequence> contentHolder = new List<CharSequence>(1); |
| try { |
| source2.getContents(new Source_ContentReceiver_5(contentHolder)); |
| } catch (exception) { |
| throw new AnalysisException.con2("Could not get contents of ${source2.fullName}", exception); |
| } |
| if (contentHolder[0] == null) { |
| return null; |
| } |
| CompilationUnit unit = parseCompilationUnit(source2); |
| if (unit == null) { |
| return null; |
| } |
| NodeLocator locator = new NodeLocator.con1(element.nameOffset); |
| ASTNode nameNode = locator.searchWithin(unit); |
| while (nameNode != null) { |
| if (nameNode is AnnotatedNode) { |
| Comment comment = ((nameNode as AnnotatedNode)).documentationComment; |
| if (comment == null) { |
| return null; |
| } |
| int offset2 = comment.offset; |
| return contentHolder[0].subSequence(offset2, offset2 + comment.length).toString(); |
| } |
| nameNode = nameNode.parent; |
| } |
| return null; |
| } |
| List<AnalysisError> computeErrors(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState parseErrorsState = dartEntry.getState(DartEntry.PARSE_ERRORS); |
| if (parseErrorsState != CacheState.VALID && parseErrorsState != CacheState.ERROR) { |
| parseCompilationUnit(source); |
| } |
| List<Source> libraries = getLibrariesContaining(source); |
| for (Source librarySource in libraries) { |
| CacheState resolutionErrorsState = dartEntry.getState2(DartEntry.RESOLUTION_ERRORS, librarySource); |
| if (resolutionErrorsState != CacheState.VALID && resolutionErrorsState != CacheState.ERROR) { |
| } |
| } |
| return dartEntry.allErrors; |
| } else if (sourceEntry is HtmlEntry) { |
| HtmlEntry htmlEntry = sourceEntry as HtmlEntry; |
| CacheState resolutionErrorsState = htmlEntry.getState(HtmlEntry.RESOLUTION_ERRORS); |
| if (resolutionErrorsState != CacheState.VALID && resolutionErrorsState != CacheState.ERROR) { |
| computeHtmlElement(source); |
| } |
| return htmlEntry.getValue(HtmlEntry.RESOLUTION_ERRORS); |
| } |
| return AnalysisError.NO_ERRORS; |
| } |
| } |
| HtmlElement computeHtmlElement(Source source) { |
| if (!AnalysisEngine.isHtmlFileName(source.shortName)) { |
| return null; |
| } |
| { |
| HtmlEntry htmlEntry = getHtmlEntry(source); |
| if (htmlEntry == null) { |
| return null; |
| } |
| HtmlElement element = htmlEntry.getValue(HtmlEntry.ELEMENT); |
| if (element == null) { |
| HtmlUnit unit = htmlEntry.getValue(HtmlEntry.RESOLVED_UNIT); |
| if (unit == null) { |
| unit = htmlEntry.getValue(HtmlEntry.PARSED_UNIT); |
| if (unit == null) { |
| unit = parseHtmlUnit(source); |
| } |
| } |
| RecordingErrorListener listener = new RecordingErrorListener(); |
| HtmlUnitBuilder builder = new HtmlUnitBuilder(this, listener); |
| element = builder.buildHtmlElement2(source, unit); |
| List<AnalysisError> resolutionErrors = listener.getErrors2(source); |
| HtmlEntryImpl htmlCopy = (htmlEntry as HtmlEntryImpl); |
| htmlCopy.setValue(HtmlEntry.RESOLVED_UNIT, unit); |
| htmlCopy.setValue(HtmlEntry.RESOLUTION_ERRORS, resolutionErrors); |
| htmlCopy.setValue(HtmlEntry.ELEMENT, element); |
| getNotice(source).setErrors(resolutionErrors, htmlCopy.getValue(SourceEntry.LINE_INFO)); |
| } |
| return element; |
| } |
| } |
| SourceKind computeKindOf(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry == null) { |
| return SourceKind.UNKNOWN; |
| } else if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState sourceKindState = dartEntry.getState(DartEntry.SOURCE_KIND); |
| if (sourceKindState != CacheState.VALID && sourceKindState != CacheState.ERROR) { |
| internalComputeKindOf(source); |
| } |
| } |
| return sourceEntry.kind; |
| } |
| } |
| LibraryElement computeLibraryElement(Source source) { |
| if (!AnalysisEngine.isDartFileName(source.shortName)) { |
| return null; |
| } |
| { |
| DartEntry dartEntry = getDartEntry(source); |
| if (dartEntry == null) { |
| return null; |
| } |
| LibraryElement element = dartEntry.getValue(DartEntry.ELEMENT); |
| if (element == null) { |
| if (computeKindOf(source) != SourceKind.LIBRARY) { |
| throw new AnalysisException.con1("Cannot compute library element for non-library: ${source.fullName}"); |
| } |
| LibraryResolver resolver = new LibraryResolver.con1(this); |
| try { |
| element = resolver.resolveLibrary(source, true); |
| if (element != null) { |
| ((dartEntry as DartEntryImpl)).setValue(DartEntry.ELEMENT, element); |
| } |
| } on AnalysisException catch (exception) { |
| AnalysisEngine.instance.logger.logError2("Could not resolve the library ${source.fullName}", exception); |
| } |
| } |
| return element; |
| } |
| } |
| LineInfo computeLineInfo(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry == null) { |
| return null; |
| } |
| LineInfo lineInfo = sourceEntry.getValue(SourceEntry.LINE_INFO); |
| if (lineInfo == null) { |
| if (sourceEntry is HtmlEntry) { |
| parseHtmlUnit(source); |
| lineInfo = sourceEntry.getValue(SourceEntry.LINE_INFO); |
| } else if (sourceEntry is DartEntry) { |
| parseCompilationUnit(source); |
| lineInfo = sourceEntry.getValue(SourceEntry.LINE_INFO); |
| } |
| } |
| return lineInfo; |
| } |
| } |
| CompilationUnit computeResolvableCompilationUnit(Source source) { |
| { |
| DartEntry dartEntry = getDartEntry(source); |
| if (dartEntry == null) { |
| return null; |
| } |
| CompilationUnit unit = dartEntry.anyParsedCompilationUnit; |
| if (unit != null) { |
| return unit.accept(new ASTCloner()) as CompilationUnit; |
| } |
| unit = internalParseCompilationUnit(((dartEntry as DartEntryImpl)), source); |
| ((dartEntry as DartEntryImpl)).setState(DartEntry.PARSED_UNIT, CacheState.FLUSHED); |
| return unit; |
| } |
| } |
| AnalysisContext extractContext(SourceContainer container) => extractContextInto(container, (AnalysisEngine.instance.createAnalysisContext() as AnalysisContextImpl)); |
| InternalAnalysisContext extractContextInto(SourceContainer container, InternalAnalysisContext newContext) { |
| List<Source> sourcesToRemove = new List<Source>(); |
| { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| Source source = entry.getKey(); |
| if (container.contains(source)) { |
| sourcesToRemove.add(source); |
| newContext.addSourceInfo(source, entry.getValue().writableCopy); |
| } |
| } |
| } |
| return newContext; |
| } |
| Element getElement(ElementLocation location) { |
| List<String> components2 = ((location as ElementLocationImpl)).components; |
| ElementImpl element; |
| { |
| Source librarySource = _sourceFactory.fromEncoding(components2[0]); |
| try { |
| element = computeLibraryElement(librarySource) as ElementImpl; |
| } on AnalysisException catch (exception) { |
| return null; |
| } |
| } |
| for (int i = 1; i < components2.length; i++) { |
| if (element == null) { |
| return null; |
| } |
| element = element.getChild(components2[i]); |
| } |
| return element; |
| } |
| AnalysisErrorInfo getErrors(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| return new AnalysisErrorInfoImpl(dartEntry.allErrors, dartEntry.getValue(SourceEntry.LINE_INFO)); |
| } else if (sourceEntry is HtmlEntry) { |
| HtmlEntry htmlEntry = sourceEntry as HtmlEntry; |
| return new AnalysisErrorInfoImpl(htmlEntry.getValue(HtmlEntry.RESOLUTION_ERRORS), htmlEntry.getValue(SourceEntry.LINE_INFO)); |
| } |
| return new AnalysisErrorInfoImpl(AnalysisError.NO_ERRORS, sourceEntry.getValue(SourceEntry.LINE_INFO)); |
| } |
| } |
| HtmlElement getHtmlElement(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry is HtmlEntry) { |
| return ((sourceEntry as HtmlEntry)).getValue(HtmlEntry.ELEMENT); |
| } |
| return null; |
| } |
| } |
| List<Source> getHtmlFilesReferencing(Source source) { |
| { |
| List<Source> htmlSources = new List<Source>(); |
| while (true) { |
| if (getKindOf(source) == SourceKind.LIBRARY) { |
| } else if (getKindOf(source) == SourceKind.PART) { |
| List<Source> librarySources = getLibrariesContaining(source); |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| if (identical(entry.getValue().kind, SourceKind.HTML)) { |
| List<Source> referencedLibraries = ((entry.getValue() as HtmlEntry)).getValue(HtmlEntry.REFERENCED_LIBRARIES); |
| if (containsAny(referencedLibraries, librarySources)) { |
| htmlSources.add(entry.getKey()); |
| } |
| } |
| } |
| } |
| break; |
| } |
| if (htmlSources.isEmpty) { |
| return Source.EMPTY_ARRAY; |
| } |
| return new List.from(htmlSources); |
| } |
| } |
| List<Source> get htmlSources => getSources(SourceKind.HTML); |
| SourceKind getKindOf(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry == null) { |
| return SourceKind.UNKNOWN; |
| } |
| return sourceEntry.kind; |
| } |
| } |
| List<Source> get launchableClientLibrarySources { |
| List<Source> sources = new List<Source>(); |
| { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| Source source = entry.getKey(); |
| SourceEntry sourceEntry = entry.getValue(); |
| if (identical(sourceEntry.kind, SourceKind.LIBRARY) && !source.isInSystemLibrary()) { |
| sources.add(source); |
| } |
| } |
| } |
| return new List.from(sources); |
| } |
| List<Source> get launchableServerLibrarySources { |
| List<Source> sources = new List<Source>(); |
| { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| Source source = entry.getKey(); |
| SourceEntry sourceEntry = entry.getValue(); |
| if (identical(sourceEntry.kind, SourceKind.LIBRARY) && !source.isInSystemLibrary()) { |
| sources.add(source); |
| } |
| } |
| } |
| return new List.from(sources); |
| } |
| List<Source> getLibrariesContaining(Source source) { |
| { |
| List<Source> librarySources = new List<Source>(); |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| if (identical(entry.getValue().kind, SourceKind.LIBRARY)) { |
| if (contains(((entry.getValue() as DartEntry)).getValue(DartEntry.INCLUDED_PARTS), source)) { |
| librarySources.add(entry.getKey()); |
| } |
| } |
| } |
| if (librarySources.isEmpty) { |
| return Source.EMPTY_ARRAY; |
| } |
| return new List.from(librarySources); |
| } |
| } |
| LibraryElement getLibraryElement(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry is DartEntry) { |
| return ((sourceEntry as DartEntry)).getValue(DartEntry.ELEMENT); |
| } |
| return null; |
| } |
| } |
| List<Source> get librarySources => getSources(SourceKind.LIBRARY); |
| LineInfo getLineInfo(Source source) { |
| { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry != null) { |
| return sourceEntry.getValue(SourceEntry.LINE_INFO); |
| } |
| return null; |
| } |
| } |
| Namespace getPublicNamespace(LibraryElement library) { |
| Source source2 = library.definingCompilationUnit.source; |
| { |
| DartEntry dartEntry = getDartEntry(source2); |
| if (dartEntry == null) { |
| return null; |
| } |
| Namespace namespace = dartEntry.getValue(DartEntry.PUBLIC_NAMESPACE); |
| if (namespace == null) { |
| NamespaceBuilder builder = new NamespaceBuilder(); |
| namespace = builder.createPublicNamespace(library); |
| ((dartEntry as DartEntryImpl)).setValue(DartEntry.PUBLIC_NAMESPACE, namespace); |
| } |
| return namespace; |
| } |
| } |
| Namespace getPublicNamespace2(Source source) { |
| { |
| DartEntry dartEntry = getDartEntry(source); |
| if (dartEntry == null) { |
| return null; |
| } |
| Namespace namespace = dartEntry.getValue(DartEntry.PUBLIC_NAMESPACE); |
| if (namespace == null) { |
| LibraryElement library = computeLibraryElement(source); |
| if (library == null) { |
| return null; |
| } |
| NamespaceBuilder builder = new NamespaceBuilder(); |
| namespace = builder.createPublicNamespace(library); |
| ((dartEntry as DartEntryImpl)).setValue(DartEntry.PUBLIC_NAMESPACE, namespace); |
| } |
| return namespace; |
| } |
| } |
| CompilationUnit getResolvedCompilationUnit(Source unitSource, LibraryElement library) { |
| if (library == null) { |
| return null; |
| } |
| return getResolvedCompilationUnit2(unitSource, library.source); |
| } |
| CompilationUnit getResolvedCompilationUnit2(Source unitSource, Source librarySource) { |
| { |
| accessed(unitSource); |
| DartEntry dartEntry = getDartEntry(unitSource); |
| if (dartEntry == null) { |
| return null; |
| } |
| return dartEntry.getValue2(DartEntry.RESOLVED_UNIT, librarySource); |
| } |
| } |
| SourceFactory get sourceFactory => _sourceFactory; |
| bool isClientLibrary(Source librarySource) { |
| SourceEntry sourceEntry = getSourceEntry(librarySource); |
| if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState isClientState = dartEntry.getState(DartEntry.IS_CLIENT); |
| CacheState isLaunchableState = dartEntry.getState(DartEntry.IS_LAUNCHABLE); |
| if (identical(isClientState, CacheState.INVALID) || identical(isClientState, CacheState.ERROR) || identical(isLaunchableState, CacheState.INVALID) || identical(isLaunchableState, CacheState.ERROR)) { |
| return false; |
| } |
| return dartEntry.getValue(DartEntry.IS_CLIENT) && dartEntry.getValue(DartEntry.IS_LAUNCHABLE); |
| } |
| return false; |
| } |
| bool isServerLibrary(Source librarySource) { |
| SourceEntry sourceEntry = getSourceEntry(librarySource); |
| if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState isClientState = dartEntry.getState(DartEntry.IS_CLIENT); |
| CacheState isLaunchableState = dartEntry.getState(DartEntry.IS_LAUNCHABLE); |
| if (identical(isClientState, CacheState.INVALID) || identical(isClientState, CacheState.ERROR) || identical(isLaunchableState, CacheState.INVALID) || identical(isLaunchableState, CacheState.ERROR)) { |
| return false; |
| } |
| return !dartEntry.getValue(DartEntry.IS_CLIENT) && dartEntry.getValue(DartEntry.IS_LAUNCHABLE); |
| } |
| return false; |
| } |
| void mergeContext(AnalysisContext context) { |
| { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(((context as AnalysisContextImpl))._sourceMap)) { |
| Source newSource = entry.getKey(); |
| SourceEntry existingEntry = getSourceEntry(newSource); |
| if (existingEntry == null) { |
| _sourceMap[newSource] = entry.getValue().writableCopy; |
| } else { |
| } |
| } |
| } |
| } |
| CompilationUnit parseCompilationUnit(Source source) { |
| { |
| accessed(source); |
| DartEntry dartEntry = getDartEntry(source); |
| if (dartEntry == null) { |
| return null; |
| } |
| CompilationUnit unit = dartEntry.anyParsedCompilationUnit; |
| if (unit == null) { |
| unit = internalParseCompilationUnit((dartEntry as DartEntryImpl), source); |
| } |
| return unit; |
| } |
| } |
| HtmlUnit parseHtmlUnit(Source source) { |
| { |
| accessed(source); |
| HtmlEntry htmlEntry = getHtmlEntry(source); |
| if (htmlEntry == null) { |
| return null; |
| } |
| HtmlUnit unit = htmlEntry.getValue(HtmlEntry.RESOLVED_UNIT); |
| if (unit == null) { |
| unit = htmlEntry.getValue(HtmlEntry.PARSED_UNIT); |
| if (unit == null) { |
| HtmlParseResult result = new HtmlParser(source).parse(scanHtml(source)); |
| unit = result.htmlUnit; |
| ((htmlEntry as HtmlEntryImpl)).setValue(SourceEntry.LINE_INFO, new LineInfo(result.lineStarts)); |
| ((htmlEntry as HtmlEntryImpl)).setValue(HtmlEntry.PARSED_UNIT, unit); |
| ((htmlEntry as HtmlEntryImpl)).setValue(HtmlEntry.REFERENCED_LIBRARIES, getLibrarySources2(source, unit)); |
| } |
| } |
| return unit; |
| } |
| } |
| List<ChangeNotice> performAnalysisTask() { |
| { |
| if (!performSingleAnalysisTask() && _pendingNotices.isEmpty) { |
| return null; |
| } |
| if (_pendingNotices.isEmpty) { |
| return ChangeNoticeImpl.EMPTY_ARRAY; |
| } |
| List<ChangeNotice> notices = new List.from(_pendingNotices.values); |
| _pendingNotices.clear(); |
| return notices; |
| } |
| } |
| void recordLibraryElements(Map<Source, LibraryElement> elementMap) { |
| Source htmlSource = _sourceFactory.forUri("dart:html"); |
| { |
| for (MapEntry<Source, LibraryElement> entry in getMapEntrySet(elementMap)) { |
| Source librarySource = entry.getKey(); |
| LibraryElement library = entry.getValue(); |
| DartEntryImpl dartEntry = getDartEntry(librarySource) as DartEntryImpl; |
| if (dartEntry != null) { |
| dartEntry.setValue(DartEntry.ELEMENT, library); |
| dartEntry.setValue(DartEntry.IS_LAUNCHABLE, library.entryPoint != null); |
| dartEntry.setValue(DartEntry.IS_CLIENT, isClient(library, htmlSource, new Set<LibraryElement>())); |
| List<Source> unitSources = new List<Source>(); |
| unitSources.add(librarySource); |
| for (CompilationUnitElement part in library.parts) { |
| Source partSource = part.source; |
| unitSources.add(partSource); |
| } |
| dartEntry.setValue(DartEntry.INCLUDED_PARTS, new List.from(unitSources)); |
| } |
| } |
| } |
| } |
| void recordResolutionErrors(Source source, Source librarySource, List<AnalysisError> errors, LineInfo lineInfo) { |
| { |
| DartEntryImpl dartEntry = getDartEntry(source) as DartEntryImpl; |
| if (dartEntry != null) { |
| dartEntry.setValue(SourceEntry.LINE_INFO, lineInfo); |
| dartEntry.setValue2(DartEntry.RESOLUTION_ERRORS, librarySource, errors); |
| } |
| getNotice(source).setErrors(dartEntry.allErrors, lineInfo); |
| } |
| } |
| void recordResolvedCompilationUnit(Source source, Source librarySource, CompilationUnit unit) { |
| { |
| DartEntryImpl dartEntry = getDartEntry(source) as DartEntryImpl; |
| if (dartEntry != null) { |
| dartEntry.setValue2(DartEntry.RESOLVED_UNIT, librarySource, unit); |
| dartEntry.setState(DartEntry.PARSED_UNIT, CacheState.FLUSHED); |
| getNotice(source).compilationUnit = unit; |
| } |
| } |
| } |
| CompilationUnit resolveCompilationUnit(Source source2, LibraryElement library) { |
| if (library == null) { |
| return null; |
| } |
| return resolveCompilationUnit2(source2, library.source); |
| } |
| CompilationUnit resolveCompilationUnit2(Source unitSource, Source librarySource) { |
| { |
| accessed(unitSource); |
| DartEntry dartEntry = getDartEntry(unitSource); |
| if (dartEntry == null) { |
| return null; |
| } |
| CompilationUnit unit = dartEntry.getValue2(DartEntry.RESOLVED_UNIT, librarySource); |
| if (unit == null) { |
| disableCacheRemoval(); |
| try { |
| LibraryElement libraryElement = computeLibraryElement(librarySource); |
| unit = dartEntry.getValue2(DartEntry.RESOLVED_UNIT, librarySource); |
| if (unit == null && libraryElement != null) { |
| Source coreLibrarySource = libraryElement.context.sourceFactory.forUri(DartSdk.DART_CORE); |
| LibraryElement coreElement = computeLibraryElement(coreLibrarySource); |
| TypeProvider typeProvider = new TypeProviderImpl(coreElement); |
| CompilationUnit unitAST = computeResolvableCompilationUnit(unitSource); |
| new DeclarationResolver().resolve(unitAST, find(libraryElement, unitSource)); |
| RecordingErrorListener errorListener = new RecordingErrorListener(); |
| TypeResolverVisitor typeResolverVisitor = new TypeResolverVisitor.con2(libraryElement, unitSource, typeProvider, errorListener); |
| unitAST.accept(typeResolverVisitor); |
| ResolverVisitor resolverVisitor = new ResolverVisitor.con2(libraryElement, unitSource, typeProvider, errorListener); |
| unitAST.accept(resolverVisitor); |
| ErrorReporter errorReporter = new ErrorReporter(errorListener, unitSource); |
| ErrorVerifier errorVerifier = new ErrorVerifier(errorReporter, libraryElement, typeProvider); |
| unitAST.accept(errorVerifier); |
| ConstantVerifier constantVerifier = new ConstantVerifier(errorReporter); |
| unitAST.accept(constantVerifier); |
| unitAST.resolutionErrors = errorListener.errors; |
| ((dartEntry as DartEntryImpl)).setValue2(DartEntry.RESOLVED_UNIT, librarySource, unitAST); |
| unit = unitAST; |
| } |
| } finally { |
| enableCacheRemoval(); |
| } |
| } |
| return unit; |
| } |
| } |
| HtmlUnit resolveHtmlUnit(Source unitSource) { |
| { |
| accessed(unitSource); |
| HtmlEntry htmlEntry = getHtmlEntry(unitSource); |
| if (htmlEntry == null) { |
| return null; |
| } |
| HtmlUnit unit = htmlEntry.getValue(HtmlEntry.RESOLVED_UNIT); |
| if (unit == null) { |
| disableCacheRemoval(); |
| try { |
| computeHtmlElement(unitSource); |
| unit = htmlEntry.getValue(HtmlEntry.RESOLVED_UNIT); |
| if (unit == null) { |
| unit = parseHtmlUnit(unitSource); |
| } |
| } finally { |
| enableCacheRemoval(); |
| } |
| } |
| return unit; |
| } |
| } |
| void setContents(Source source, String contents) { |
| { |
| _sourceFactory.setContents(source, contents); |
| sourceChanged(source); |
| } |
| } |
| void set sourceFactory(SourceFactory factory) { |
| if (identical(_sourceFactory, factory)) { |
| return; |
| } else if (factory.context != null) { |
| throw new IllegalStateException("Source factories cannot be shared between contexts"); |
| } |
| { |
| if (_sourceFactory != null) { |
| _sourceFactory.context = null; |
| } |
| factory.context = this; |
| _sourceFactory = factory; |
| for (SourceEntry sourceEntry in _sourceMap.values) { |
| if (sourceEntry is HtmlEntry) { |
| ((sourceEntry as HtmlEntryImpl)).setState(HtmlEntry.RESOLVED_UNIT, CacheState.INVALID); |
| } else if (sourceEntry is DartEntry) { |
| ((sourceEntry as DartEntryImpl)).invalidateAllResolutionInformation(); |
| } |
| } |
| } |
| } |
| Iterable<Source> sourcesToResolve(List<Source> changedSources) { |
| List<Source> librarySources = new List<Source>(); |
| for (Source source in changedSources) { |
| if (identical(computeKindOf(source), SourceKind.LIBRARY)) { |
| librarySources.add(source); |
| } |
| } |
| return librarySources; |
| } |
| /** |
| * Record that the given source was just accessed for some unspecified purpose. |
| * <p> |
| * Note: This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source that was accessed |
| */ |
| void accessed(Source source) { |
| if (_recentlyUsed.contains(source)) { |
| _recentlyUsed.remove(source); |
| _recentlyUsed.add(source); |
| return; |
| } |
| if (_cacheRemovalCount == 0 && _recentlyUsed.length >= _MAX_CACHE_SIZE) { |
| Source removedSource = _recentlyUsed.removeAt(0); |
| SourceEntry sourceEntry = _sourceMap[removedSource]; |
| if (sourceEntry is HtmlEntry) { |
| ((sourceEntry as HtmlEntryImpl)).setState(HtmlEntry.PARSED_UNIT, CacheState.FLUSHED); |
| ((sourceEntry as HtmlEntryImpl)).setState(HtmlEntry.RESOLVED_UNIT, CacheState.FLUSHED); |
| } else if (sourceEntry is DartEntry) { |
| ((sourceEntry as DartEntryImpl)).setState(DartEntry.PARSED_UNIT, CacheState.FLUSHED); |
| for (Source librarySource in getLibrariesContaining(source)) { |
| ((sourceEntry as DartEntryImpl)).setState2(DartEntry.RESOLVED_UNIT, librarySource, CacheState.FLUSHED); |
| } |
| } |
| } |
| _recentlyUsed.add(source); |
| } |
| /** |
| * Add all of the sources contained in the given source container to the given list of sources. |
| * <p> |
| * Note: This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param sources the list to which sources are to be added |
| * @param container the source container containing the sources to be added to the list |
| */ |
| void addSourcesInContainer(List<Source> sources, SourceContainer container) { |
| for (Source source in _sourceMap.keys.toSet()) { |
| if (container.contains(source)) { |
| sources.add(source); |
| } |
| } |
| } |
| /** |
| * Return {@code true} if the given array of sources contains the given source. |
| * @param sources the sources being searched |
| * @param targetSource the source being searched for |
| * @return {@code true} if the given source is in the array |
| */ |
| bool contains(List<Source> sources, Source targetSource) { |
| for (Source source in sources) { |
| if (source == targetSource) { |
| return true; |
| } |
| } |
| return false; |
| } |
| /** |
| * Return {@code true} if the given array of sources contains any of the given target sources. |
| * @param sources the sources being searched |
| * @param targetSources the sources being searched for |
| * @return {@code true} if any of the given target sources are in the array |
| */ |
| bool containsAny(List<Source> sources, List<Source> targetSources) { |
| for (Source targetSource in targetSources) { |
| if (contains(sources, targetSource)) { |
| return true; |
| } |
| } |
| return false; |
| } |
| /** |
| * Create a source information object suitable for the given source. Return the source information |
| * object that was created, or {@code null} if the source should not be tracked by this context. |
| * @param source the source for which an information object is being created |
| * @return the source information object that was created |
| */ |
| SourceEntry createSourceEntry(Source source) { |
| String name = source.shortName; |
| if (AnalysisEngine.isHtmlFileName(name)) { |
| HtmlEntry htmlEntry = new HtmlEntryImpl(); |
| _sourceMap[source] = htmlEntry; |
| return htmlEntry; |
| } else if (AnalysisEngine.isDartFileName(name)) { |
| DartEntry dartEntry = new DartEntryImpl(); |
| _sourceMap[source] = dartEntry; |
| return dartEntry; |
| } |
| return null; |
| } |
| /** |
| * Disable flushing information from the cache until {@link #enableCacheRemoval()} has been |
| * called. |
| */ |
| void disableCacheRemoval() { |
| _cacheRemovalCount++; |
| } |
| /** |
| * Re-enable flushing information from the cache. |
| */ |
| void enableCacheRemoval() { |
| if (_cacheRemovalCount > 0) { |
| _cacheRemovalCount--; |
| } |
| if (_cacheRemovalCount == 0) { |
| while (_recentlyUsed.length >= _MAX_CACHE_SIZE) { |
| Source removedSource = _recentlyUsed.removeAt(0); |
| SourceEntry sourceEntry = _sourceMap[removedSource]; |
| if (sourceEntry is HtmlEntry) { |
| ((sourceEntry as HtmlEntryImpl)).setState(HtmlEntry.PARSED_UNIT, CacheState.FLUSHED); |
| ((sourceEntry as HtmlEntryImpl)).setState(HtmlEntry.RESOLVED_UNIT, CacheState.FLUSHED); |
| } else if (sourceEntry is DartEntry) { |
| ((sourceEntry as DartEntryImpl)).setState(DartEntry.PARSED_UNIT, CacheState.FLUSHED); |
| for (Source librarySource in getLibrariesContaining(removedSource)) { |
| ((sourceEntry as DartEntryImpl)).setState2(DartEntry.RESOLVED_UNIT, librarySource, CacheState.FLUSHED); |
| } |
| } |
| } |
| } |
| } |
| /** |
| * Search the compilation units that are part of the given library and return the element |
| * representing the compilation unit with the given source. Return {@code null} if there is no |
| * such compilation unit. |
| * @param libraryElement the element representing the library being searched through |
| * @param unitSource the source for the compilation unit whose element is to be returned |
| * @return the element representing the compilation unit |
| */ |
| CompilationUnitElement find(LibraryElement libraryElement, Source unitSource) { |
| CompilationUnitElement element = libraryElement.definingCompilationUnit; |
| if (element.source == unitSource) { |
| return element; |
| } |
| for (CompilationUnitElement partElement in libraryElement.parts) { |
| if (partElement.source == unitSource) { |
| return partElement; |
| } |
| } |
| return null; |
| } |
| /** |
| * Return the compilation unit information associated with the given source, or {@code null} if |
| * the source is not known to this context. This method should be used to access the compilation |
| * unit information rather than accessing the compilation unit map directly because sources in the |
| * SDK are implicitly part of every analysis context and are therefore only added to the map when |
| * first accessed. |
| * <p> |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source for which information is being sought |
| * @return the compilation unit information associated with the given source |
| */ |
| DartEntry getDartEntry(Source source) { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry == null) { |
| sourceEntry = new DartEntryImpl(); |
| _sourceMap[source] = sourceEntry; |
| return sourceEntry as DartEntry; |
| } else if (sourceEntry is DartEntry) { |
| return sourceEntry as DartEntry; |
| } |
| return null; |
| } |
| /** |
| * Return the HTML unit information associated with the given source, or {@code null} if the |
| * source is not known to this context. This method should be used to access the HTML unit |
| * information rather than accessing the HTML unit map directly because sources in the SDK are |
| * implicitly part of every analysis context and are therefore only added to the map when first |
| * accessed. |
| * <p> |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source for which information is being sought |
| * @return the HTML unit information associated with the given source |
| */ |
| HtmlEntry getHtmlEntry(Source source) { |
| SourceEntry sourceEntry = getSourceEntry(source); |
| if (sourceEntry == null) { |
| sourceEntry = new HtmlEntryImpl(); |
| _sourceMap[source] = sourceEntry; |
| return sourceEntry as HtmlEntry; |
| } else if (sourceEntry is HtmlEntry) { |
| return sourceEntry as HtmlEntry; |
| } |
| return null; |
| } |
| /** |
| * Return the sources of libraries that are referenced in the specified HTML file. |
| * @param htmlSource the source of the HTML file being analyzed |
| * @param htmlUnit the AST for the HTML file being analyzed |
| * @return the sources of libraries that are referenced in the HTML file |
| */ |
| List<Source> getLibrarySources2(Source htmlSource, HtmlUnit htmlUnit) { |
| List<Source> libraries = new List<Source>(); |
| htmlUnit.accept(new RecursiveXmlVisitor_6(this, htmlSource, libraries)); |
| if (libraries.isEmpty) { |
| return Source.EMPTY_ARRAY; |
| } |
| return new List.from(libraries); |
| } |
| /** |
| * Return a change notice for the given source, creating one if one does not already exist. |
| * @param source the source for which changes are being reported |
| * @return a change notice for the given source |
| */ |
| ChangeNoticeImpl getNotice(Source source) { |
| ChangeNoticeImpl notice = _pendingNotices[source]; |
| if (notice == null) { |
| notice = new ChangeNoticeImpl(source); |
| _pendingNotices[source] = notice; |
| } |
| return notice; |
| } |
| /** |
| * Return the source information associated with the given source, or {@code null} if the source |
| * is not known to this context. This method should be used to access the source information |
| * rather than accessing the source map directly because sources in the SDK are implicitly part of |
| * every analysis context and are therefore only added to the map when first accessed. |
| * <p> |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source for which information is being sought |
| * @return the source information associated with the given source |
| */ |
| SourceEntry getSourceEntry(Source source) { |
| SourceEntry sourceEntry = _sourceMap[source]; |
| if (sourceEntry == null) { |
| sourceEntry = createSourceEntry(source); |
| } |
| return sourceEntry; |
| } |
| /** |
| * Return an array containing all of the sources known to this context that have the given kind. |
| * @param kind the kind of sources to be returned |
| * @return all of the sources known to this context that have the given kind |
| */ |
| List<Source> getSources(SourceKind kind2) { |
| List<Source> sources = new List<Source>(); |
| { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| if (identical(entry.getValue().kind, kind2)) { |
| sources.add(entry.getKey()); |
| } |
| } |
| } |
| return new List.from(sources); |
| } |
| /** |
| * Return {@code true} if the given compilation unit has a part-of directive but no library |
| * directive. |
| * @param unit the compilation unit being tested |
| * @return {@code true} if the compilation unit has a part-of directive |
| */ |
| bool hasPartOfDirective(CompilationUnit unit) { |
| bool hasPartOf = false; |
| for (Directive directive in unit.directives) { |
| if (directive is PartOfDirective) { |
| hasPartOf = true; |
| } else if (directive is LibraryDirective) { |
| return false; |
| } |
| } |
| return hasPartOf; |
| } |
| /** |
| * Compute the kind of the given source. This method should only be invoked when the kind is not |
| * already known. |
| * @param source the source for which a kind is to be computed |
| * @return the new source info that was created to represent the source |
| */ |
| DartEntry internalComputeKindOf(Source source) { |
| try { |
| accessed(source); |
| RecordingErrorListener errorListener = new RecordingErrorListener(); |
| AnalysisContextImpl_ScanResult scanResult = internalScan(source, errorListener); |
| Parser parser = new Parser(source, errorListener); |
| CompilationUnit unit = parser.parseCompilationUnit(scanResult._token); |
| LineInfo lineInfo = new LineInfo(scanResult._lineStarts); |
| List<AnalysisError> errors = errorListener.getErrors2(source); |
| unit.parsingErrors = errors; |
| unit.lineInfo = lineInfo; |
| DartEntryImpl dartEntry = _sourceMap[source] as DartEntryImpl; |
| if (hasPartOfDirective(unit)) { |
| dartEntry.setValue(DartEntry.SOURCE_KIND, SourceKind.PART); |
| } else { |
| dartEntry.setValue(DartEntry.SOURCE_KIND, SourceKind.LIBRARY); |
| } |
| dartEntry.setValue(SourceEntry.LINE_INFO, lineInfo); |
| dartEntry.setValue(DartEntry.PARSED_UNIT, unit); |
| dartEntry.setValue(DartEntry.PARSE_ERRORS, errors); |
| return dartEntry; |
| } on AnalysisException catch (exception) { |
| DartEntryImpl dartEntry = _sourceMap[source] as DartEntryImpl; |
| dartEntry.setState(DartEntry.SOURCE_KIND, CacheState.ERROR); |
| dartEntry.setState(SourceEntry.LINE_INFO, CacheState.ERROR); |
| dartEntry.setState(DartEntry.PARSED_UNIT, CacheState.ERROR); |
| dartEntry.setState(DartEntry.PARSE_ERRORS, CacheState.ERROR); |
| return dartEntry; |
| } |
| } |
| CompilationUnit internalParseCompilationUnit(DartEntryImpl dartEntry, Source source) { |
| accessed(source); |
| RecordingErrorListener errorListener = new RecordingErrorListener(); |
| AnalysisContextImpl_ScanResult scanResult = internalScan(source, errorListener); |
| Parser parser = new Parser(source, errorListener); |
| CompilationUnit unit = parser.parseCompilationUnit(scanResult._token); |
| LineInfo lineInfo = new LineInfo(scanResult._lineStarts); |
| List<AnalysisError> errors = errorListener.getErrors2(source); |
| unit.parsingErrors = errors; |
| unit.lineInfo = lineInfo; |
| if (identical(dartEntry.getState(DartEntry.SOURCE_KIND), CacheState.INVALID)) { |
| if (hasPartOfDirective(unit)) { |
| dartEntry.setValue(DartEntry.SOURCE_KIND, SourceKind.PART); |
| } else { |
| dartEntry.setValue(DartEntry.SOURCE_KIND, SourceKind.LIBRARY); |
| } |
| } |
| dartEntry.setValue(SourceEntry.LINE_INFO, lineInfo); |
| dartEntry.setValue(DartEntry.PARSED_UNIT, unit); |
| dartEntry.setValue(DartEntry.PARSE_ERRORS, errors); |
| return unit; |
| } |
| AnalysisContextImpl_ScanResult internalScan(Source source, AnalysisErrorListener errorListener) { |
| AnalysisContextImpl_ScanResult result = new AnalysisContextImpl_ScanResult(); |
| Source_ContentReceiver receiver = new Source_ContentReceiver_7(source, errorListener, result); |
| try { |
| source.getContents(receiver); |
| } catch (exception) { |
| throw new AnalysisException.con3(exception); |
| } |
| return result; |
| } |
| /** |
| * In response to a change to at least one of the compilation units in the given library, |
| * invalidate any results that are dependent on the result of resolving that library. |
| * @param librarySource the source of the library being invalidated |
| * @param libraryEntry the cache entry for the library being invalidated |
| */ |
| void invalidateLibraryResolution(Source librarySource, DartEntryImpl libraryEntry) { |
| if (libraryEntry != null) { |
| for (Source unitSource in libraryEntry.getValue(DartEntry.INCLUDED_PARTS)) { |
| DartEntryImpl partEntry = getDartEntry(unitSource) as DartEntryImpl; |
| partEntry.invalidateAllResolutionInformation(); |
| } |
| libraryEntry.invalidateAllResolutionInformation(); |
| libraryEntry.setState(DartEntry.INCLUDED_PARTS, CacheState.INVALID); |
| } |
| } |
| /** |
| * Return {@code true} if this library is, or depends on, dart:html. |
| * @param library the library being tested |
| * @param visitedLibraries a collection of the libraries that have been visited, used to prevent |
| * infinite recursion |
| * @return {@code true} if this library is, or depends on, dart:html |
| */ |
| bool isClient(LibraryElement library, Source htmlSource, Set<LibraryElement> visitedLibraries) { |
| if (visitedLibraries.contains(library)) { |
| return false; |
| } |
| if (library.source == htmlSource) { |
| return true; |
| } |
| javaSetAdd(visitedLibraries, library); |
| for (LibraryElement imported in library.importedLibraries) { |
| if (isClient(imported, htmlSource, visitedLibraries)) { |
| return true; |
| } |
| } |
| for (LibraryElement exported in library.exportedLibraries) { |
| if (isClient(exported, htmlSource, visitedLibraries)) { |
| return true; |
| } |
| } |
| return false; |
| } |
| /** |
| * Perform a single analysis task. |
| * <p> |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @return {@code true} if work was done, implying that there might be more work to be done |
| */ |
| bool performSingleAnalysisTask() { |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| SourceEntry sourceEntry = entry.getValue(); |
| if (sourceEntry is DartEntry) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState parsedUnitState = dartEntry.getState(DartEntry.PARSED_UNIT); |
| if (identical(parsedUnitState, CacheState.INVALID)) { |
| try { |
| parseCompilationUnit(entry.getKey()); |
| } on AnalysisException catch (exception) { |
| ((dartEntry as DartEntryImpl)).setState(DartEntry.PARSED_UNIT, CacheState.ERROR); |
| AnalysisEngine.instance.logger.logError2("Could not parse ${entry.getKey().fullName}", exception); |
| } |
| return true; |
| } |
| } else if (sourceEntry is HtmlEntry) { |
| HtmlEntry htmlEntry = sourceEntry as HtmlEntry; |
| CacheState parsedUnitState = htmlEntry.getState(HtmlEntry.PARSED_UNIT); |
| if (identical(parsedUnitState, CacheState.INVALID)) { |
| try { |
| parseHtmlUnit(entry.getKey()); |
| } on AnalysisException catch (exception) { |
| ((htmlEntry as HtmlEntryImpl)).setState(HtmlEntry.PARSED_UNIT, CacheState.ERROR); |
| AnalysisEngine.instance.logger.logError2("Could not parse ${entry.getKey().fullName}", exception); |
| } |
| return true; |
| } |
| } |
| } |
| for (MapEntry<Source, SourceEntry> entry in getMapEntrySet(_sourceMap)) { |
| SourceEntry sourceEntry = entry.getValue(); |
| if (sourceEntry is DartEntry && identical(sourceEntry.kind, SourceKind.LIBRARY)) { |
| DartEntry dartEntry = sourceEntry as DartEntry; |
| CacheState elementState = dartEntry.getState(DartEntry.ELEMENT); |
| if (identical(elementState, CacheState.INVALID)) { |
| try { |
| computeLibraryElement(entry.getKey()); |
| } on AnalysisException catch (exception) { |
| ((dartEntry as DartEntryImpl)).setState(DartEntry.ELEMENT, CacheState.ERROR); |
| AnalysisEngine.instance.logger.logError2("Could not resolve ${entry.getKey().fullName}", exception); |
| } |
| return true; |
| } |
| } else if (sourceEntry is HtmlEntry) { |
| HtmlEntry htmlEntry = sourceEntry as HtmlEntry; |
| CacheState resolvedUnitState = htmlEntry.getState(HtmlEntry.RESOLVED_UNIT); |
| if (identical(resolvedUnitState, CacheState.INVALID)) { |
| try { |
| resolveHtmlUnit(entry.getKey()); |
| } on AnalysisException catch (exception) { |
| ((htmlEntry as HtmlEntryImpl)).setState(HtmlEntry.RESOLVED_UNIT, CacheState.ERROR); |
| AnalysisEngine.instance.logger.logError2("Could not resolve ${entry.getKey().fullName}", exception); |
| } |
| return true; |
| } |
| } |
| } |
| return false; |
| } |
| HtmlScanResult scanHtml(Source source) { |
| HtmlScanner scanner = new HtmlScanner(source); |
| try { |
| source.getContents(scanner); |
| } catch (exception) { |
| throw new AnalysisException.con3(exception); |
| } |
| return scanner.result; |
| } |
| /** |
| * Create an entry for the newly added source. Return {@code true} if the new source is a Dart |
| * file. |
| * <p> |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source that has been added |
| * @return {@code true} if the new source is a Dart file |
| */ |
| bool sourceAvailable(Source source) { |
| SourceEntry sourceEntry = _sourceMap[source]; |
| if (sourceEntry == null) { |
| sourceEntry = createSourceEntry(source); |
| } |
| return sourceEntry is DartEntry; |
| } |
| /** |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source that has been changed |
| */ |
| void sourceChanged(Source source) { |
| SourceEntry sourceEntry = _sourceMap[source]; |
| if (sourceEntry is HtmlEntry) { |
| HtmlEntryImpl htmlEntry = sourceEntry as HtmlEntryImpl; |
| htmlEntry.setState(HtmlEntry.ELEMENT, CacheState.INVALID); |
| htmlEntry.setState(SourceEntry.LINE_INFO, CacheState.INVALID); |
| htmlEntry.setState(HtmlEntry.PARSED_UNIT, CacheState.INVALID); |
| htmlEntry.setState(HtmlEntry.REFERENCED_LIBRARIES, CacheState.INVALID); |
| htmlEntry.setState(HtmlEntry.RESOLVED_UNIT, CacheState.INVALID); |
| } else if (sourceEntry is DartEntry) { |
| DartEntryImpl dartEntry = sourceEntry as DartEntryImpl; |
| List<Source> containingLibraries = getLibrariesContaining(source); |
| invalidateLibraryResolution(source, dartEntry); |
| dartEntry.setState(DartEntry.INCLUDED_PARTS, CacheState.INVALID); |
| dartEntry.setState(SourceEntry.LINE_INFO, CacheState.INVALID); |
| dartEntry.setState(DartEntry.PARSE_ERRORS, CacheState.INVALID); |
| dartEntry.setState(DartEntry.PARSED_UNIT, CacheState.INVALID); |
| dartEntry.setState(DartEntry.SOURCE_KIND, CacheState.INVALID); |
| for (Source librarySource in containingLibraries) { |
| DartEntryImpl libraryEntry = getDartEntry(librarySource) as DartEntryImpl; |
| invalidateLibraryResolution(librarySource, libraryEntry); |
| } |
| } |
| } |
| /** |
| * <b>Note:</b> This method must only be invoked while we are synchronized on {@link #cacheLock}. |
| * @param source the source that has been deleted |
| */ |
| void sourceRemoved(Source source) { |
| DartEntry dartEntry = getDartEntry(source); |
| if (dartEntry != null) { |
| for (Source librarySource in getLibrariesContaining(source)) { |
| DartEntryImpl libraryEntry = getDartEntry(librarySource) as DartEntryImpl; |
| invalidateLibraryResolution(librarySource, libraryEntry); |
| } |
| } |
| _sourceMap.remove(source); |
| } |
| } |
| /** |
| * Instances of the class {@code ScanResult} represent the results of scanning a source. |
| */ |
| class AnalysisContextImpl_ScanResult { |
| /** |
| * The time at which the contents of the source were last set. |
| */ |
| int _modificationTime = 0; |
| /** |
| * The first token in the token stream. |
| */ |
| Token _token; |
| /** |
| * The line start information that was produced. |
| */ |
| List<int> _lineStarts; |
| /** |
| * Initialize a newly created result object to be empty. |
| */ |
| AnalysisContextImpl_ScanResult() : super() { |
| } |
| } |
| class Source_ContentReceiver_5 implements Source_ContentReceiver { |
| List<CharSequence> contentHolder; |
| Source_ContentReceiver_5(this.contentHolder); |
| void accept(CharBuffer contents, int modificationTime) { |
| contentHolder[0] = contents; |
| } |
| void accept2(String contents, int modificationTime) { |
| contentHolder[0] = new CharSequence(contents); |
| } |
| } |
| class RecursiveXmlVisitor_6 extends RecursiveXmlVisitor<Object> { |
| final AnalysisContextImpl AnalysisContextImpl_this; |
| Source htmlSource; |
| List<Source> libraries; |
| RecursiveXmlVisitor_6(this.AnalysisContextImpl_this, this.htmlSource, this.libraries) : super(); |
| Object visitXmlTagNode(XmlTagNode node) { |
| if (javaStringEqualsIgnoreCase(node.tag.lexeme, AnalysisContextImpl._TAG_SCRIPT)) { |
| for (XmlAttributeNode attribute in node.attributes) { |
| if (javaStringEqualsIgnoreCase(attribute.name.lexeme, AnalysisContextImpl._ATTRIBUTE_SRC)) { |
| try { |
| Uri uri = new Uri.fromComponents(path: attribute.text); |
| String fileName = uri.path; |
| if (AnalysisEngine.isDartFileName(fileName)) { |
| Source librarySource = AnalysisContextImpl_this._sourceFactory.resolveUri(htmlSource, fileName); |
| if (librarySource.exists()) { |
| libraries.add(librarySource); |
| } |
| } |
| } catch (exception) { |
| AnalysisEngine.instance.logger.logError2("Invalid URL ('${attribute.text}') in script tag in '${htmlSource.fullName}'", exception); |
| } |
| } |
| } |
| } |
| return super.visitXmlTagNode(node); |
| } |
| } |
| class Source_ContentReceiver_7 implements Source_ContentReceiver { |
| Source source; |
| AnalysisErrorListener errorListener; |
| AnalysisContextImpl_ScanResult result; |
| Source_ContentReceiver_7(this.source, this.errorListener, this.result); |
| void accept(CharBuffer contents, int modificationTime2) { |
| CharBufferScanner scanner = new CharBufferScanner(source, contents, errorListener); |
| result._modificationTime = modificationTime2; |
| result._token = scanner.tokenize(); |
| result._lineStarts = scanner.lineStarts; |
| } |
| void accept2(String contents, int modificationTime2) { |
| StringScanner scanner = new StringScanner(source, contents, errorListener); |
| result._modificationTime = modificationTime2; |
| result._token = scanner.tokenize(); |
| result._lineStarts = scanner.lineStarts; |
| } |
| } |
| /** |
| * Instances of the class {@code AnalysisErrorInfoImpl} represent the analysis errors and line info |
| * associated with a source. |
| */ |
| class AnalysisErrorInfoImpl implements AnalysisErrorInfo { |
| /** |
| * The analysis errors associated with a source, or {@code null} if there are no errors. |
| */ |
| List<AnalysisError> _errors; |
| /** |
| * The line information associated with the errors, or {@code null} if there are no errors. |
| */ |
| LineInfo _lineInfo; |
| /** |
| * Initialize an newly created error info with the errors and line information |
| * @param errors the errors as a result of analysis |
| * @param lineinfo the line info for the errors |
| */ |
| AnalysisErrorInfoImpl(List<AnalysisError> errors, LineInfo lineInfo) { |
| this._errors = errors; |
| this._lineInfo = lineInfo; |
| } |
| /** |
| * Return the errors of analysis, or {@code null} if there were no errors. |
| * @return the errors as a result of the analysis |
| */ |
| List<AnalysisError> get errors => _errors; |
| /** |
| * Return the line information associated with the errors, or {@code null} if there were no |
| * errors. |
| * @return the line information associated with the errors |
| */ |
| LineInfo get lineInfo => _lineInfo; |
| } |
| /** |
| * The enumeration {@code CacheState} defines the possible states of cached data. |
| */ |
| class CacheState implements Comparable<CacheState> { |
| /** |
| * The data is not in the cache and the last time an attempt was made to compute the data an |
| * exception occurred, making it pointless to attempt. |
| * <p> |
| * Valid Transitions: |
| * <ul> |
| * <li>{@link #INVALID} if a source was modified that might cause the data to be computable</li> |
| * </ul> |
| */ |
| static final CacheState ERROR = new CacheState('ERROR', 0); |
| /** |
| * The data is not in the cache because it was flushed from the cache in order to control memory |
| * usage. If the data is recomputed, results do not need to be reported. |
| * <p> |
| * Valid Transitions: |
| * <ul> |
| * <li>{@link #IN_PROCESS} if the data is being recomputed</li> |
| * <li>{@link #INVALID} if a source was modified that causes the data to need to be recomputed</li> |
| * </ul> |
| */ |
| |