Implementation of 'Server Domain' in dart analysis server.

pkg/analysis_server/lib/src/protocol.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library protocol;
 
 import 'dart:convert' show JsonDecoder;
 
+/// An abstract enumeration.
+abstract class Enum2<E extends Enum2> implements Comparable<E> {
+  /// The name of this enum constant, as declared in the enum declaration.
+  final String name;
+
+  /// The position in the enum declaration.
+  final int ordinal;
+
+  const Enum2(this.name, this.ordinal);
+
+  int get hashCode => ordinal;
+
+  String toString() => name;
+
+  int compareTo(E other) => ordinal - other.ordinal;
+
+  /// Returns the enum constant with the given [name], `null` if not found.
+  static Enum2 valueOf(List<Enum2> values, String name) {
+  for (var e in values) {

[Brian Wilkerson, 2014/05/24 15:19:49]

The body of the method should be indented.

We shouldn't use the for-in loop because it's too slow compared to a simple for
loop.

'e' --> 'element'

[scheglov, 2014/05/24 15:34:42]

Done.

+    if (e.name == name) {
+      return e;
+    }
+  }
+  return null;
+  }
+}
+
+
 /**
  * Instances of the class [Request] represent a request that was received.
  */
 class Request {
   /**
    * The name of the JSON attribute containing the id of the request.
    */
   static const String ID = 'id';
 
   /**
@@ skipping 257 matching lines @@
    */
   List<String> asStringList() {
     if (!isStringList()) {
       throw new RequestFailure(new Response.invalidParameter(request, path,
           "be a list of strings"));
     }
     return datum;
   }
 
   /**
+   * Validate that the datum is a list of strings, and convert it into [Enum]s.
+   */
+  Set<Enum2> asEnumSet(List<Enum2> allValues) {
+    var values = new Set();
+    for (var name in asStringList()) {
+      var value = Enum2.valueOf(allValues, name);
+      if (value == null) {
+        throw new RequestFailure(new Response.invalidParameter(request, path,
+            "be a list of names the enumeration values $allValues"));

[Brian Wilkerson, 2014/05/24 15:19:49]

"names the enumeration values" --> "names from the list" ("enumeration" is an
implementation detail that doesn't mean anything to the user)

[scheglov, 2014/05/24 15:34:42]

Done.

+      }
+      values.add(value);
+    }
+    return values;
+  }
+
+  /**
    * Determine if the datum is a map whose values are all strings.
    *
    * Note: we can safely assume that the keys are all strings, since JSON maps
    * cannot have any other key type.
    */
   bool isStringMap() {
     if (datum is! Map) {
       return false;
     }
     for (var value in datum.values) {
@@ skipping 441 matching lines @@
   /**
    * The response to be returned as a result of the failure.
    */
   final Response response;
 
   /**
    * Initialize a newly created exception to return the given reponse.
    */
   RequestFailure(this.response);
 }