New analyzer_experimental 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 'java_core.dart';
 import 'sdk.dart' show DartSdk;
 import 'engine.dart' show AnalysisContext;
 /**
  * Instances of the class `SourceFactory` resolve possibly relative URI's against an existing
  * [Source].
  *
@@ skipping 117 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
    * `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) {
+    if (containedUri == null) {
+      return null;
+    }
     try {
       return resolveUri2(containingSource, parseUriWithException(containedUri));
     } on URISyntaxException catch (exception) {
       return null;
     }
   }
 
   /**
    * Return an absolute URI that represents the given source.
    *
@@ skipping 10 matching lines @@
     return null;
   }
 
   /**
    * Set the contents of the given source to the given contents. This has the effect of overriding
    * the default contents of the source. If the contents are `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
+   * @return `true` if the new cached contents are different from the old, else `false`
    */
-  void setContents(Source source, String contents) {
-    _contentCache.setContents(source, contents);
-  }
+  bool setContents(Source source, String contents) => _contentCache.setContents(source, contents);
 
   /**
    * Set the analysis context that this source factory is associated with to the given context.
    *
    * <b>Note:</b> This method should only be invoked by
    * [AnalysisContextImpl#setSourceFactory] and is only public out of
    * necessity.
    *
    * @param context the analysis context that this source factory is associated with
    */
@@ skipping 231 matching lines @@
    * @param modificationTime the time at which the contents were last set
    */
   void accept2(String contents, int modificationTime);
 }
 /**
  * The enumeration `SourceKind` defines the different kinds of sources that are known to the
  * analysis engine.
  *
  * @coverage dart.engine.source
  */
-class SourceKind implements Comparable<SourceKind> {
+class SourceKind implements Enum<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.
    */
@@ skipping 21 matching lines @@
   int compareTo(SourceKind other) => ordinal - other.ordinal;
   int get hashCode => ordinal;
   String toString() => name;
 }
 /**
  * The enumeration `UriKind` defines the different kinds of URI's that are known to the
  * analysis engine. These are used to keep track of the kind of URI associated with a given source.
  *
  * @coverage dart.engine.source
  */
-class UriKind implements Comparable<UriKind> {
+class UriKind implements Enum<UriKind> {
 
   /**
    * A 'dart:' URI.
    */
   static final UriKind DART_URI = new UriKind('DART_URI', 0, 0x64);
 
   /**
    * A 'file:' URI.
    */
   static final UriKind FILE_URI = new UriKind('FILE_URI', 1, 0x66);
@@ skipping 394 matching lines @@
    */
   int getModificationStamp(Source source) => _stampMap[source];
 
   /**
    * Set the contents of the given source to the given contents. This has the effect of overriding
    * the default contents of the source. If the contents are `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
+   * @return `true` if the new cached contents are different than the old, else `false`
    */
-  void setContents(Source source, String contents) {
+  bool setContents(Source source, String contents) {
     if (contents == null) {
-      _contentMap.remove(source);
       _stampMap.remove(source);
+      return _contentMap.remove(source) != null;
     } else {
-      _contentMap[source] = contents;
       _stampMap[source] = JavaSystem.currentTimeMillis();
+      String originalContents = javaMapPut(_contentMap, source, contents);
+      return contents != originalContents;
     }
   }
 }