Add AffiliationFetcher to fetch authoritative affiliation information regarding facets.

components/password_manager/core/browser/affiliation_fetcher.h

+// Copyright 2014 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 COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_FETCHER_H_
+#define COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_FETCHER_H_
+
+#include <vector>
+
+#include "base/macros.h"
+#include "base/memory/ref_counted.h"
+#include "components/password_manager/core/browser/affiliation_fetcher_delegate.h"
+#include "components/password_manager/core/browser/affiliation_utils.h"
+#include "net/url_request/url_fetcher_delegate.h"
+
+class GURL;
+
+namespace net {
+class URLRequestContextGetter;
+}  // namespace net
+
+namespace password_manager {
+
+// Fetches authoritative information regarding which facets are affiliated with
+// each other, that is, which facets belong to the same logical application.
+// See affiliation_utils.h for a definition of what this means.
+//
+// An instance is good for exactly one fetch, and may be used from any thread
+// that runs a message loop (i.e. not a worker pool thread).
+class AffiliationFetcher : net::URLFetcherDelegate {
+ public:
+  ~AffiliationFetcher() override;
+
+  // Constructs a fetcher to retrieve affiliations for each facet in |facet_ids|
+  // using the specified |request_context_getter|, and will provide the results
+  // to the |delegate| on the same thread that creates the instance.
+  static AffiliationFetcher* Create(
+      net::URLRequestContextGetter* request_context_getter,
+      const std::vector<FacetURI>& facet_uris,
+      AffiliationFetcherDelegate* delegate);
+
+  // Actually starts the request, and will call the delegate with the results on
+  // the same thread when done. If |this| is destroyed before completion, the
+  // in-flight request is cancelled, and the delegate will not be called.
+  // Further details:
+  //   * No cookies are sent/saved with the request.
+  //   * In case of network/server errors, the request will not be retried.
+  //   * Results are guaranteed to be always fresh and will never be cached.
+  virtual void StartRequest();
+
+  const std::vector<FacetURI>& requested_facet_uris() const {
+    return requested_facet_uris_;
+  }
+
+  AffiliationFetcherDelegate* delegate() const { return delegate_; }
+
+ protected:
+  AffiliationFetcher(net::URLRequestContextGetter* request_context_getter,
+                     const std::vector<FacetURI>& facet_uris,
+                     AffiliationFetcherDelegate* delegate);
+
+ private:
+  // Builds the URL for the Affiliation API's lookup method.
+  GURL BuildQueryURL() const;
+
+  // Prepares and returns the serialized protocol buffer message that will be
+  // the payload of the POST request.
+  std::string PreparePayload() const;
+
+  // Parses and validates the response protocol buffer message for a list of
+  // equivalence classes, stores them into |result| and returns true on success.
+  // Returns false if the response was gravely ill-formed or self-inconsistent.
+  // Unknown kinds of facet URIs and new protocol buffer fields will be ignored.
+  bool ParseResponse(AffiliationFetcherDelegate::Result* result) const;
+
+  // net::URLFetcherDelegate:
+  void OnURLFetchComplete(const net::URLFetcher* source) override;
+
+  const scoped_refptr<net::URLRequestContextGetter> request_context_getter_;
+  const std::vector<FacetURI> requested_facet_uris_;
+  AffiliationFetcherDelegate* const delegate_;
+
+  scoped_ptr<net::URLFetcher> fetcher_;
+
+  DISALLOW_COPY_AND_ASSIGN(AffiliationFetcher);
+};
+
+}  // namespace password_manager
+
+#endif  // COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_FETCHER_H_