[Media Router] Design MediaRouter interface with stub implementation.

chrome/browser/media/router/media_route_response.h

+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTE_RESPONSE_H_
+#define CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTE_RESPONSE_H_
+
+#include <string>
+
+#include "base/memory/scoped_ptr.h"
+#include "chrome/browser/media/router/media_route.h"
+
+namespace media_router {
+
+// Response to a media route request to the Media Route Provider.

[mark a. foltz, 2015/03/27 21:21:58]

Response from the media route provider to a media route request.

[imcheng, 2015/03/30 22:49:09]

Done.

+class MediaRouteResponse {
+ public:
+  // Creates a MediaRouteResponse object that indicates success.
+  // |request_id|: ID of original request.
+  // |route|: Route created.
+  static scoped_ptr<MediaRouteResponse> Success(

[mark a. foltz, 2015/03/27 21:21:58]

CreateFromRoute?

[imcheng, 2015/03/30 22:49:09]

Done.

+      const RouteRequestId& request_id,
+      const MediaRoute& route);
+  // Creates a MediaRouteResponse object that indicates failure.

[mark a. foltz, 2015/03/27 21:21:58]

A newline here would help IMO.

[imcheng, 2015/03/30 22:49:09]

Done.

+  // |request_id|: ID of original request.
+  // |error|: Failure reason.
+  static scoped_ptr<MediaRouteResponse> Error(const RouteRequestId& request_id,
+                                              const std::string& error);

[mark a. foltz, 2015/03/27 21:21:58]

CreateFromError

[imcheng, 2015/03/30 22:49:09]

Done.

+
+  ~MediaRouteResponse();
+
+  const RouteRequestId& request_id() const { return request_id_; }
+  // Returns the route created. Returns an empty route if response
+  // indicates error.
+  const MediaRoute& route() const { return route_; }
+  const std::string& error() const { return error_; }

[mark a. foltz, 2015/03/27 21:21:58]

Might mention that this returns an empty string on success.

[imcheng, 2015/03/30 22:49:09]

Done.

+
+ private:
+  MediaRouteResponse(const RouteRequestId& request_id, const MediaRoute& route);
+  MediaRouteResponse(const RouteRequestId& request_id,
+                     const std::string& error);
+
+  // ID of original request. Set in all MediaRouteResponse objects, regardless
+  // of success/failure.
+  const RouteRequestId request_id_;
+  // The route created as a result of the request. Set to a valid MediaRoute
+  // iff the response indicates success, empty MediaRoute otherwise.
+  const MediaRoute route_;
+  // Set to empty string if response indicates success, otherwise set to the
+  // failure reason.
+  const std::string error_;
+};
+
+}  // namespace media_router
+
+#endif  // CHROME_BROWSER_MEDIA_ROUTER_MEDIA_ROUTE_RESPONSE_H_