Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(435)

Unified Diff: components/password_manager/core/browser/affiliation_service.h

Issue 2953443002: Revert of Reland: Move the files related to Android <-> Web credentials to a separate folder. (Closed)
Patch Set: Created 3 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: components/password_manager/core/browser/affiliation_service.h
diff --git a/components/password_manager/core/browser/affiliation_service.h b/components/password_manager/core/browser/affiliation_service.h
new file mode 100644
index 0000000000000000000000000000000000000000..db90a022a3fb8536972dd773f4827b7cb554b79a
--- /dev/null
+++ b/components/password_manager/core/browser/affiliation_service.h
@@ -0,0 +1,172 @@
+// Copyright 2015 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_SERVICE_H_
+#define COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_SERVICE_H_
+
+#include <string>
+
+#include "base/callback.h"
+#include "base/macros.h"
+#include "base/memory/ref_counted.h"
+#include "base/memory/weak_ptr.h"
+#include "base/threading/thread_checker.h"
+#include "components/keyed_service/core/keyed_service.h"
+#include "components/password_manager/core/browser/affiliation_utils.h"
+
+namespace base {
+class FilePath;
+class SingleThreadTaskRunner;
+} // namespace base
+
+namespace net {
+class URLRequestContextGetter;
+} // namespace net
+
+namespace password_manager {
+
+class AffiliationBackend;
+
+// A service that can be used to query the list of facets that are affiliated
+// with a given facet, i.e., facets that belong to the same logical application.
+// See affiliation_utils.h for details of what this means.
+//
+// The service must be accessed from the UI thread, and it can be utilized in
+// two ways:
+//
+// 1.) On-demand fetching: For the one-off query that wishes to learn
+// affiliations of facet X when (potentially) issuing an on-demand
+// network request to the Affiliation API containing the URI of facet X
+// is acceptable from the privacy and/or performance perspective.
+//
+// This mode of operation is achieved by invoking GetAffiliations() with
+// StrategyOnCacheMiss::FETCH_OVER_NETWORK.
+//
+// 2.) Proactive fetching: For the compound query that is concerned with
+// checking, over time, whether or not each element in a sequence of
+// facets, W_1, W_2, ..., W_n, is affiliated with a fixed facet Y; and
+// when it is desired, for privacy and/or performance reasons, that only
+// facet Y be looked up against the Affiliation API and that subsequent
+// requests regarding each W_i not trigger additional requests.
+//
+// This mode of operation can be useful when, for example, the password
+// manager has credentials stored for facet Y and wishes to check, for
+// each visited web site W_i, whether these credentials should be offered
+// to be autofilled onto W_i.
+//
+// Example code:
+//
+// class ExampleAffiliatedCredentialFiller
+// : public base::SupportsWeakPtr<...> {
+// public:
+// ExampleAffiliatedCredentialFiller(AffiliationService* service,
+// const FacetURI& y)
+// : service_(service), y_(y) {
+// cancel_handle_ = service_->Prefetch(y_, base::Time::Max());
+// }
+//
+// ~ExampleAffiliatedCredentialFiller() { cancel_handle_.Run(); }
+//
+// void ShouldFillInto(const FacetURI& wi, FillDelegate* delegate) {
+// service_->GetAffiliations(wi, StrategyOnCacheMiss::FAIL,
+// base::Bind(
+// &ExampleAffiliatedCredentialFiller::OnAffiliationResult,
+// AsWeakPtr(),
+// delegate));
+// }
+//
+// void OnAffiliationResult(FillDelegate* delegate,
+// const AffiliatedFacets& results,
+// bool success) {
+// if (success && std::count(results.begin(), results.end(), y_))
+// delegate->FillCredentialsFor(y_);
+// }
+//
+// private:
+// AffiliationService* service_;
+// const FacetURI& y_;
+// CancelPrefetchingHandle cancel_handle_;
+// };
+class AffiliationService : public KeyedService {
+ public:
+ typedef base::Callback<void(const AffiliatedFacets& /* results */,
+ bool /* success */)> ResultCallback;
+
+ // Controls whether to send a network request or fail on a cache miss.
+ enum class StrategyOnCacheMiss { FETCH_OVER_NETWORK, FAIL };
+
+ // The |backend_task_runner| should be a task runner corresponding to a thread
+ // that can take blocking I/O, and is normally Chrome's DB thread.
+ AffiliationService(
+ scoped_refptr<base::SingleThreadTaskRunner> backend_task_runner);
+ ~AffiliationService() override;
+
+ // Initializes the service by creating its backend and transferring it to the
+ // thread corresponding to |backend_task_runner_|.
+ void Initialize(net::URLRequestContextGetter* request_context_getter,
+ const base::FilePath& db_path);
+
+ // Looks up facets affiliated with the facet identified by |facet_uri|, and
+ // invokes |result_callback| with the results.
+ //
+ // If the local cache contains fresh affiliation information for |facet_uri|,
+ // the request will be served from cache. Otherwise, |cache_miss_policy|
+ // controls whether to issue an on-demand network request, or to fail the
+ // request without fetching.
+ virtual void GetAffiliations(const FacetURI& facet_uri,
+ StrategyOnCacheMiss cache_miss_strategy,
+ const ResultCallback& result_callback);
+
+ // Prefetches affiliation information for the facet identified by |facet_uri|,
+ // and keeps the information fresh by periodic re-fetches (as needed) until
+ // the clock strikes |keep_fresh_until| (exclusive), until a matching call to
+ // CancelPrefetch(), or until Chrome is shut down, whichever is sooner. It is
+ // a supported use-case to pass base::Time::Max() as |keep_fresh_until|.
+ //
+ // Canceling can be useful when a password is deleted, so that resources are
+ // no longer wasted on repeatedly refreshing affiliation information. Note
+ // that canceling will not blow away data already stored in the cache unless
+ // it becomes stale.
+ virtual void Prefetch(const FacetURI& facet_uri,
+ const base::Time& keep_fresh_until);
+
+ // Cancels the corresponding prefetch command, i.e., the one issued for the
+ // same |facet_uri| and with the same |keep_fresh_until|.
+ virtual void CancelPrefetch(const FacetURI& facet_uri,
+ const base::Time& keep_fresh_until);
+
+ // Wipes results of on-demand fetches and expired prefetches from the cache,
+ // but retains information corresponding to facets that are being kept fresh.
+ // As no required data is deleted, there will be no network requests directly
+ // triggered by this call.
+ //
+ // The second version will only potentially remove data corresponding to the
+ // given |facet_uri|, but still only as long as the data is no longer needed.
+ virtual void TrimCache();
+ virtual void TrimCacheForFacet(const FacetURI& facet_uri);
+
+ // Posts a task to the |backend_task_runner| to delete the cache database file
+ // at |db_path|, and all auxiliary files. The database must be closed before
+ // calling this.
+ static void DeleteCache(const base::FilePath& db_path,
+ base::SingleThreadTaskRunner* backend_task_runner);
+
+ private:
+ // The backend, owned by this AffiliationService instance, but living on the
+ // DB thread. It will be deleted asynchronously during shutdown on the DB
+ // thread, so it will outlive |this| along with all its in-flight tasks.
+ AffiliationBackend* backend_;
+
+ // TaskRunner to be used to run the |backend_| (usually the DB thread).
+ scoped_refptr<base::SingleThreadTaskRunner> backend_task_runner_;
+
+ base::ThreadChecker thread_checker_;
+ base::WeakPtrFactory<AffiliationService> weak_ptr_factory_;
+
+ DISALLOW_COPY_AND_ASSIGN(AffiliationService);
+};
+
+} // namespace password_manager
+
+#endif // COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_AFFILIATION_SERVICE_H_

Powered by Google App Engine
This is Rietveld 408576698