New Analysis Engine snapshot.

pkg/analyzer_experimental/lib/src/generated/source.dart

 // 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.source;
 
 import 'dart:uri';
 import 'java_core.dart';
+import 'sdk.dart' show DartSdk;
 import 'engine.dart' show AnalysisContext;
 
 /**
  * Instances of the class {@code SourceFactory} resolve possibly relative URI's against an existing{@link Source source}.
  * @coverage dart.engine.source
  */
 class SourceFactory {
   /**
    * The analysis context that this source factory is associated with.
    */
   AnalysisContext _context;
   /**
    * The resolvers used to resolve absolute URI's.
    */
   List<UriResolver> _resolvers;
   /**
    * A cache of content used to override the default content of a source.
    */
   ContentCache _contentCache;
   /**
    * Initialize a newly created source factory.
-   * @param contentCache the cache holding content used to override the default content of a source.
+   * @param contentCache the cache holding content used to override the default content of a source
    * @param resolvers the resolvers used to resolve absolute URI's
    */
-  SourceFactory.con1(ContentCache contentCache2, List<UriResolver> resolvers2) {
-    _jtd_constructor_306_impl(contentCache2, resolvers2);
+  SourceFactory.con1(ContentCache contentCache3, List<UriResolver> resolvers2) {
+    _jtd_constructor_332_impl(contentCache3, resolvers2);
   }
-  _jtd_constructor_306_impl(ContentCache contentCache2, List<UriResolver> resolvers2) {
-    this._contentCache = contentCache2;
+  _jtd_constructor_332_impl(ContentCache contentCache3, List<UriResolver> resolvers2) {
+    this._contentCache = contentCache3;
     this._resolvers = resolvers2;
   }
   /**
    * Initialize a newly created source factory.
    * @param resolvers the resolvers used to resolve absolute URI's
    */
   SourceFactory.con2(List<UriResolver> resolvers) {
-    _jtd_constructor_307_impl(resolvers);
+    _jtd_constructor_333_impl(resolvers);
   }
-  _jtd_constructor_307_impl(List<UriResolver> resolvers) {
-    _jtd_constructor_306_impl(new ContentCache(), resolvers);
+  _jtd_constructor_333_impl(List<UriResolver> resolvers) {
+    _jtd_constructor_332_impl(new ContentCache(), resolvers);
   }
   /**
    * Return a source object representing the given absolute URI, or {@code null} if the URI is not a
    * valid URI or if it is not an absolute URI.
    * @param absoluteUri the absolute URI to be resolved
    * @return a source object representing the absolute URI
    */
   Source forUri(String absoluteUri) {
     try {
       Uri uri = new Uri(absoluteUri);
       if (uri.isAbsolute) {
         return resolveUri2(null, uri);
       }
     } on URISyntaxException catch (exception) {
     }
     return null;
   }
   /**
    * Return a source object that is equal to the source object used to obtain the given encoding, or{@code null} if the argument is not a valid encoding.
    * @param encoding the encoding of a source object
    * @return a source object that is described by the given encoding
    * @see Source#getEncoding()
    */
   Source fromEncoding(String encoding) => forUri(encoding);
   /**
+   * Return a cache of content used to override the default content of a source.
+   * @return a cache of content used to override the default content of a source
+   */
+  ContentCache get contentCache => _contentCache;
+  /**
    * Return the analysis context that this source factory is associated with.
    * @return the analysis context that this source factory is associated with
    */
   AnalysisContext get context => _context;
   /**
+   * Return the {@link DartSdk} associated with this {@link SourceFactory}, or {@code null} if there
+   * is no such SDK.
+   * @return the {@link DartSdk} associated with this {@link SourceFactory}, or {@code null} if
+   * there is no such SDK
+   */
+  DartSdk get dartSdk {
+    for (UriResolver resolver in _resolvers) {
+      if (resolver is DartUriResolver) {
+        DartUriResolver dartUriResolver = resolver as DartUriResolver;
+        return dartUriResolver.dartSdk;
+      }
+    }
+    return null;
+  }
+  /**
    * Return a source object representing the URI that results from resolving the given (possibly
    * relative) contained URI against the URI associated with an existing source object, or{@code null} if either the contained URI is invalid or if it cannot be resolved against the
    * source object's URI.
    * @param containingSource the source containing the given URI
    * @param containedUri the (possibly relative) URI to be resolved against the containing source
    * @return the source representing the contained URI
    */
   Source resolveUri(Source containingSource, String containedUri) {
     try {
       return resolveUri2(containingSource, new Uri(containedUri));
@@ skipping 43 matching lines @@
    * Return a source object representing the URI that results from resolving the given (possibly
    * relative) contained URI against the URI associated with an existing source object, or{@code null} if either the contained URI is invalid or if it cannot be resolved against the
    * source object's URI.
    * @param containingSource the source containing the given URI
    * @param containedUri the (possibly relative) URI to be resolved against the containing source
    * @return the source representing the contained URI
    */
   Source resolveUri2(Source containingSource, Uri containedUri) {
     if (containedUri.isAbsolute) {
       for (UriResolver resolver in _resolvers) {
-        Source result = resolver.resolveAbsolute(this, containedUri);
+        Source result = resolver.resolveAbsolute(_contentCache, containedUri);
         if (result != null) {
           return result;
         }
       }
       return null;
     } else {
       return containingSource.resolveRelative(containedUri);
     }
   }
 }
 /**
  * The abstract class {@code UriResolver} defines the behavior of objects that are used to resolve
  * URI's for a source factory. Subclasses of this class are expected to resolve a single scheme of
  * absolute URI.
  * @coverage dart.engine.source
  */
 abstract class UriResolver {
   /**
    * Initialize a newly created resolver.
    */
   UriResolver() : super() {
   }
   /**
    * Resolve the given absolute URI. Return a {@link Source source} representing the file to which
    * it was resolved, or {@code null} if it could not be resolved.
+   * @param contentCache the content cache used to access the contents of the returned source
    * @param uri the URI to be resolved
    * @return a {@link Source source} representing the URI to which given URI was resolved
    */
-  Source resolveAbsolute(SourceFactory factory, Uri uri);
+  Source resolveAbsolute(ContentCache contentCache, Uri uri);
 }
 /**
  * The interface {@code Source} defines the behavior of objects representing source code that can be
  * compiled.
  * @coverage dart.engine.source
  */
 abstract class Source {
   /**
    * An empty array of sources.
    */
   static List<Source> EMPTY_ARRAY = new List<Source>(0);
   /**
    * Return {@code true} if the given object is a source that represents the same source code as
    * this source.
    * @param object the object to be compared with this object
    * @return {@code true} if the given object is a source that represents the same source code as
    * this source
    * @see Object#equals(Object)
    */
   bool operator ==(Object object);
   /**
    * Return {@code true} if this source exists.
    * @return {@code true} if this source exists
    */
   bool exists();
   /**
-   * Return the analysis context in which this source is defined.
-   * @return the analysis context in which this source is defined
-   */
-  AnalysisContext get context;
-  /**
    * Get the contents of this source and pass it to the given receiver. Exactly one of the methods
    * defined on the receiver will be invoked unless an exception is thrown. The method that will be
    * invoked depends on which of the possible representations of the contents is the most efficient.
    * Whichever method is invoked, it will be invoked before this method returns.
    * @param receiver the content receiver to which the content of this source will be passed
    * @throws Exception if the contents of this source could not be accessed
    */
   void getContents(Source_ContentReceiver receiver);
   /**
    * Return an encoded representation of this source that can be used to create a source that is
@@ skipping 29 matching lines @@
    * @return a hash code for this source
    * @see Object#hashCode()
    */
   int get hashCode;
   /**
    * Return {@code true} if this source is in one of the system libraries.
    * @return {@code true} if this is in a system library
    */
   bool isInSystemLibrary();
   /**
-   * Resolve the given URI relative to the location of this source.
-   * @param uri the URI to be resolved against this source
-   * @return a source representing the resolved URI
-   */
-  Source resolve(String uri);
-  /**
    * Resolve the relative URI against the URI associated with this source object. Return a{@link Source source} representing the URI to which it was resolved, or {@code null} if it
    * could not be resolved.
    * <p>
    * Note: This method is not intended for public use, it is only visible out of necessity. It is
    * only intended to be invoked by a {@link SourceFactory source factory}. Source factories will
    * only invoke this method if the URI is relative, so implementations of this method are not
    * required to, and generally do not, verify the argument. The result of invoking this method with
    * an absolute URI is intentionally left unspecified.
    * @param relativeUri the relative URI to be resolved against the containing source
    * @return a {@link Source source} representing the URI to which given URI was resolved
    */
   Source resolveRelative(Uri relativeUri);
 }
 /**
  * The interface {@code ContentReceiver} defines the behavior of objects that can receive the
  * content of a source.
  */
 abstract class Source_ContentReceiver {
   /**
    * Accept the contents of a source represented as a character buffer.
    * @param contents the contents of the source
+   * @param modificationTime the time at which the contents were last set
    */
-  accept(CharBuffer contents);
+  void accept(CharBuffer contents, int modificationTime);
   /**
    * Accept the contents of a source represented as a string.
    * @param contents the contents of the source
+   * @param modificationTime the time at which the contents were last set
    */
-  void accept2(String contents);
+  void accept2(String contents, int modificationTime);
 }
 /**
  * The enumeration {@code SourceKind} defines the different kinds of sources that are known to the
  * analysis engine.
  * @coverage dart.engine.source
  */
-class SourceKind {
+class SourceKind implements Comparable<SourceKind> {
   /**
    * A source containing HTML. The HTML might or might not contain Dart scripts.
    */
   static final SourceKind HTML = new SourceKind('HTML', 0);
   /**
    * A Dart compilation unit that is not a part of another library. Libraries might or might not
    * contain any directives, including a library directive.
    */
   static final SourceKind LIBRARY = new SourceKind('LIBRARY', 1);
   /**
    * A Dart compilation unit that is part of another library. Parts contain a part-of directive.
    */
   static final SourceKind PART = new SourceKind('PART', 2);
   /**
    * An unknown kind of source. Used both when it is not possible to identify the kind of a source
    * and also when the kind of a source is not known without performing a computation and the client
    * does not want to spend the time to identify the kind.
    */
   static final SourceKind UNKNOWN = new SourceKind('UNKNOWN', 3);
   static final List<SourceKind> values = [HTML, LIBRARY, PART, UNKNOWN];
   final String __name;
   final int __ordinal;
   int get ordinal => __ordinal;
   SourceKind(this.__name, this.__ordinal) {
   }
+  int compareTo(SourceKind other) => __ordinal - other.__ordinal;
   String toString() => __name;
 }
 /**
  * A source range defines an {@link Element}'s source coordinates relative to its {@link Source}.
  * @coverage dart.engine.utilities
  */
 class SourceRange {
   /**
    * The 0-based index of the first character of the source code for this element, relative to the
    * source buffer in which this element is contained.
    */
   int _offset = 0;
   /**
    * The number of characters of the source code for this element, relative to the source buffer in
    * which this element is contained.
    */
   int _length = 0;
   /**
    * Initialize a newly created source range using the given offset and the given length.
    * @param offset the given offset
    * @param length the given length
    */
   SourceRange(int offset, int length) {
     this._offset = offset;
     this._length = length;
   }
   /**
-   * @return <code>true</code> if <code>x</code> is in [offset, offset + length) interval.
+   * @return {@code true} if <code>x</code> is in [offset, offset + length) interval.
    */
   bool contains(int x) => _offset <= x && x < _offset + _length;
   /**
-   * @return <code>true</code> if <code>x</code> is in (offset, offset + length) interval.
+   * @return {@code true} if <code>x</code> is in (offset, offset + length) interval.
    */
   bool containsExclusive(int x) => _offset < x && x < _offset + _length;
   /**
-   * @return <code>true</code> if <code>otherRange</code> covers this {@link SourceRange}.
+   * @return {@code true} if <code>otherRange</code> covers this {@link SourceRange}.
    */
   bool coveredBy(SourceRange otherRange) => otherRange.covers(this);
   /**
-   * @return <code>true</code> if this {@link SourceRange} covers <code>otherRange</code>.
+   * @return {@code true} if this {@link SourceRange} covers <code>otherRange</code>.
    */
   bool covers(SourceRange otherRange) => offset <= otherRange.offset && otherRange.end <= end;
   /**
-   * @return <code>true</code> if this {@link SourceRange} ends in <code>otherRange</code>.
+   * @return {@code true} if this {@link SourceRange} ends in <code>otherRange</code>.
    */
   bool endsIn(SourceRange otherRange) {
     int thisEnd = end;
     return otherRange.contains(thisEnd);
   }
   bool operator ==(Object obj) {
     if (obj is! SourceRange) {
       return false;
     }
     SourceRange sourceRange = obj as SourceRange;
@@ skipping 21 matching lines @@
   SourceRange getMoveEnd(int delta) => new SourceRange(_offset, _length + delta);
   /**
    * Returns the 0-based index of the first character of the source code for this element, relative
    * to the source buffer in which this element is contained.
    * @return the 0-based index of the first character of the source code for this element, relative
    * to the source buffer in which this element is contained
    */
   int get offset => _offset;
   int get hashCode => 31 * _offset + _length;
   /**
-   * @return <code>true</code> if this {@link SourceRange} intersects with given.
+   * @return {@code true} if this {@link SourceRange} intersects with given.
    */
   bool intersects(SourceRange other) {
     if (other == null) {
       return false;
     }
     if (end <= other.offset) {
       return false;
     }
     if (offset >= other.end) {
       return false;
     }
     return true;
   }
   /**
-   * @return <code>true</code> if this {@link SourceRange} starts in <code>otherRange</code>.
+   * @return {@code true} if this {@link SourceRange} starts in <code>otherRange</code>.
    */
   bool startsIn(SourceRange otherRange) => otherRange.contains(_offset);
   String toString() {
     JavaStringBuilder builder = new JavaStringBuilder();
     builder.append("[offset=");
     builder.append(_offset);
     builder.append(", length=");
     builder.append(_length);
     builder.append("]");
     return builder.toString();
@@ skipping 10 matching lines @@
  */
 abstract class SourceContainer {
   /**
    * Determine if the specified source is part of the receiver's collection of sources.
    * @param source the source in question
    * @return {@code true} if the receiver contains the source, else {@code false}
    */
   bool contains(Source source);
 }
 /**
+ * Instances of the class {@code DartUriResolver} resolve {@code dart} URI's.
+ * @coverage dart.engine.source
+ */
+class DartUriResolver extends UriResolver {
+  /**
+   * The Dart SDK against which URI's are to be resolved.
+   */
+  DartSdk _sdk;
+  /**
+   * The name of the {@code dart} scheme.
+   */
+  static String _DART_SCHEME = "dart";
+  /**
+   * Return {@code true} if the given URI is a {@code dart:} URI.
+   * @param uri the URI being tested
+   * @return {@code true} if the given URI is a {@code dart:} URI
+   */
+  static bool isDartUri(Uri uri) => uri.scheme == _DART_SCHEME;
+  /**
+   * Initialize a newly created resolver to resolve Dart URI's against the given platform within the
+   * given Dart SDK.
+   * @param sdk the Dart SDK against which URI's are to be resolved
+   */
+  DartUriResolver(DartSdk sdk) {
+    this._sdk = sdk;
+  }
+  /**
+   * Return the {@link DartSdk} against which URIs are to be resolved.
+   * @return the {@link DartSdk} against which URIs are to be resolved.
+   */
+  DartSdk get dartSdk => _sdk;
+  Source resolveAbsolute(ContentCache contentCache, Uri uri) {
+    if (!isDartUri(uri)) {
+      return null;
+    }
+    return _sdk.mapDartUri(contentCache, uri.toString());
+  }
+}
+/**
  * Instances of the class {@code LineInfo} encapsulate information about line and column information
  * within a source file.
  * @coverage dart.engine.utilities
  */
 class LineInfo {
   /**
    * An array containing the offsets of the first character of each line in the source code.
    */
   List<int> _lineStarts;
   /**
@@ skipping 106 matching lines @@
   void setContents(Source source, String contents) {
     if (contents == null) {
       _contentMap.remove(source);
       _stampMap.remove(source);
     } else {
       _contentMap[source] = contents;
       _stampMap[source] = JavaSystem.currentTimeMillis();
     }
   }
 }