Index: components/password_manager/core/browser/affiliation_fetcher.h |
diff --git a/components/password_manager/core/browser/affiliation_fetcher.h b/components/password_manager/core/browser/affiliation_fetcher.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..5bda532ccb3464a051141f522c87459cd85f2cff |
--- /dev/null |
+++ b/components/password_manager/core/browser/affiliation_fetcher.h |
@@ -0,0 +1,90 @@ |
+// 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_ |