Initial implementation for 'analysis.setSubscriptions' API.

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.
@@ skipping 347 matching lines @@
   /**
    * Validate that the datum is a map from strings to strings, and return it.
    */
   Map<String, String> asStringMap() {
     if (!isStringMap) {
       throw new RequestFailure(new Response.invalidParameter(request, path,
           "be a string map"));
     }
     return datum;
   }
+
+  /**
+   * Determine if the datum is a map whose values are all string lists.
+   *
+   * Note: we can safely assume that the keys are all strings, since JSON maps
+   * cannot have any other key type.
+   */
+  bool isStringListMap() {
+    if (datum is! Map) {
+      return false;
+    }
+    for (var value in datum.values) {
+      if (value is! List) {
+        return false;
+      }
+      for (var listItem in value) {
+        if (listItem is! String) {
+          return false;
+        }
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Validate that the datum is a map from strings to string listss, and return
+   * it.
+   */
+  Map<String, List<String>> asStringListMap() {
+    if (!isStringListMap()) {
+      throw new RequestFailure(new Response.invalidParameter(request, path,
+          "be a string list map"));
+    }
+    return datum;
+  }
 }
 
 /**
  * Instances of the class [Response] represent a response to a request.
  */
 class Response {
   /**
    * The name of the JSON attribute containing the id of the request for which
    * this is a response.
    */
@@ skipping 81 matching lines @@
   Response.unknownRequest(Request request)
     : this(request.id, new RequestError(-7, 'Unknown request'));
 
   Response.contextAlreadyExists(Request request)
     : this(request.id, new RequestError(-8, 'Context already exists'));
 
   Response.unsupportedFeature(String requestId, String message)
     : this(requestId, new RequestError(-9, message));
 
   /**
+   * Initialize a newly created instance to represent an error condition caused
+   * by a `analysis.setSubscriptions` [request] that includes an unknown
+   * analysis service name.
+   */
+  Response.unknownAnalysisService(Request request, String name)
+    : this(request.id, new RequestError(-10, 'Unknown analysis service: "$name"'));
+
+  /**
    * Initialize a newly created instance based upon the given JSON data
    */
   factory Response.fromJson(Map<String, Object> json) {
     try {
       Object id = json[Response.ID];
       if (id is! String) {
         return null;
       }
       Object error = json[Response.ERROR];
       Object result = json[Response.RESULT];
@@ skipping 319 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);
 }