[chrome.dial] Adds chrome.dial.fetchDeviceDecription API.

chrome/browser/extensions/api/dial/device_description_fetcher.h

+// Copyright (c) 2017 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_EXTENSIONS_API_DIAL_DEVICE_DESCRIPTION_FETCHER_H_
+#define CHROME_BROWSER_EXTENSIONS_API_DIAL_DEVICE_DESCRIPTION_FETCHER_H_
+
+#include <memory>
+#include <string>
+
+#include "base/callback.h"
+#include "net/url_request/url_fetcher_delegate.h"
+#include "url/gurl.h"
+
+class Profile;
+
+namespace net {
+class URLFetcher;
+}
+
+namespace extensions {
+namespace api {
+namespace dial {
+
+struct DialDeviceDescriptionData;
+
+// Used to make a single HTTP GET request with |device_description_url| to fetch
+// a uPnP device description from a DIAL device.  If successful, |success_cb| is
+// invoked with the result; otherwise, |error_cb| is invoked with an error
+// reason.  This class is not thread safe and must be used on the UI thread.
+class DeviceDescriptionFetcher : public net::URLFetcherDelegate {
+ public:
+  // Used to identify the net::URLFetcher instance for tests.
+  static constexpr int kURLFetcherIDForTest = 1;
+
+  // |profile| is unowned; the caller must ensure that this object does not
+  // outlive it.
+  DeviceDescriptionFetcher(
+      const GURL& device_description_url,
+      Profile* profile,
+      base::OnceCallback<void(const DialDeviceDescriptionData&)> success_cb,
+      base::OnceCallback<void(const std::string&)> error_cb);
+
+  ~DeviceDescriptionFetcher() override;
+
+  void Start();
+
+ private:
+  // net::URLFetcherDelegate implementation.
+  void OnURLFetchComplete(const net::URLFetcher* source) override;
+  void OnURLFetchDownloadProgress(const net::URLFetcher* source,
+                                  int64_t current,
+                                  int64_t total,
+                                  int64_t current_network_bytes) override;
+  void OnURLFetchUploadProgress(const net::URLFetcher* source,
+                                int64_t current,
+                                int64_t total) override;
+
+  // Runs |error_cb_| with |message| and clears it.
+  void ReportError(const std::string& message);
+
+  const GURL device_description_url_;
+  Profile* const profile_;
+  base::OnceCallback<void(const DialDeviceDescriptionData&)> success_cb_;
+  base::OnceCallback<void(const std::string&)> error_cb_;
+  std::unique_ptr<net::URLFetcher> fetcher_;
+};
+
+}  // namespace dial
+}  // namespace api
+}  // namespace extensions
+
+#endif  // CHROME_BROWSER_EXTENSIONS_API_DIAL_DEVICE_DESCRIPTION_FETCHER_H_