Use a service to create device management backends.

chrome/browser/policy/device_management_service.h

+// Copyright (c) 2010 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_POLICY_DEVICE_MANAGEMENT_SERVICE_H_
+#define CHROME_BROWSER_POLICY_DEVICE_MANAGEMENT_SERVICE_H_
+#pragma once
+
+#include <deque>
+#include <map>
+#include <string>
+
+#include "base/basictypes.h"
+#include "chrome/browser/policy/device_management_backend.h"
+#include "chrome/common/net/url_fetcher.h"
+#include "googleurl/src/gurl.h"
+
+class Profile;
+class URLRequestContextGetter;
+
+namespace policy {
+
+class DeviceManagementBackendImpl;
+
+// The device management service is responsible for everything related to
+// communication with the device management server. It creates the backends
+// objects that the device management policy provider and friends use to issue
+// requests.
+class DeviceManagementService : public URLFetcher::Delegate {
+ public:
+  // Describes a device management job handled by the service.
+  class DeviceManagementJob {
+   public:
+    virtual ~DeviceManagementJob() {}
+
+    // Handles the URL request response.
+    virtual void HandleResponse(const URLRequestStatus& status,
+                        int response_code,
+                        const ResponseCookies& cookies,
+                        const std::string& data) = 0;
+
+    // Gets the URL to contact.
+    virtual GURL GetURL(const std::string& server_url) = 0;
+
+    // Configures the fetcher, setting up payload and headers.
+    virtual void ConfigureRequest(URLFetcher* fetcher) = 0;
+  };
+
+  explicit DeviceManagementService(const std::string& server_url);
+  virtual ~DeviceManagementService();
+
+  // Constructs a device management backend for use by client code. Ownership of
+  // the returned backend object is transferred to the caller.
+  DeviceManagementBackend* CreateBackend();
+
+  // Provides the backend with a request context so it can make actual network
+  // requests. This will also fire any requests queued earlier.
+  void Initialize(URLRequestContextGetter* request_context_getter);
+
+  // Makes the service stop all requests and drop the reference to the request
+  // context.
+  void Shutdown();
+
+  // Adds a job. Caller must make sure the job pointer stays valid until the job
+  // completes or gets cancelled via RemoveJob().
+  void AddJob(DeviceManagementJob* job);
+
+  // Removes a job. The job will be removed and won't receive a completion
+  // callback.
+  void RemoveJob(DeviceManagementJob* job);
+
+ private:
+  typedef std::map<const URLFetcher*, DeviceManagementJob*> JobFetcherMap;
+  typedef std::deque<DeviceManagementJob*> JobQueue;
+
+  // Starts the given job.
+  void StartJob(DeviceManagementJob* job);
+
+  // URLFetcher::Delegate override.
+  virtual void OnURLFetchComplete(const URLFetcher* source,
+                                  const GURL& url,
+                                  const URLRequestStatus& status,
+                                  int response_code,
+                                  const ResponseCookies& cookies,
+                                  const std::string& data);
+
+  // Server at which to contact the service.
+  const std::string server_url_;
+
+  // The request context we use.
+  scoped_refptr<URLRequestContextGetter> request_context_getter_;
+
+  // The jobs we currently have in flight.
+  JobFetcherMap pending_jobs_;
+
+  // Jobs that are registered, but not started yet.
+  JobQueue queued_jobs_;
+
+  DISALLOW_COPY_AND_ASSIGN(DeviceManagementService);
+};
+
+}  // namespace policy
+
+#endif  // CHROME_BROWSER_POLICY_DEVICE_MANAGEMENT_SERVICE_H_