1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
// 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 {
class TestAffiliationFetcherFactory;
// 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);
// Sets the |factory| to be used by Create() to construct AffiliationFetcher
// instances. To be used only for testing.
//
// The caller must ensure that the |factory| outlives all potential Create()
// calls. The caller may pass in NULL to resume using the default factory.
static void SetFactoryForTesting(TestAffiliationFetcherFactory* factory);
// 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_;
std::unique_ptr<net::URLFetcher> fetcher_;
DISALLOW_COPY_AND_ASSIGN(AffiliationFetcher);
};
} // namespace password_manager
#endif // COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_FETCHER_H_
|
