Index: components/password_manager/core/browser/android_affiliation/affiliation_service.h |
diff --git a/components/password_manager/core/browser/android_affiliation/affiliation_service.h b/components/password_manager/core/browser/android_affiliation/affiliation_service.h |
deleted file mode 100644 |
index 835cccd99a1efdd18f64e6a9ddaf8d4fecae5d3d..0000000000000000000000000000000000000000 |
--- a/components/password_manager/core/browser/android_affiliation/affiliation_service.h |
+++ /dev/null |
@@ -1,172 +0,0 @@ |
-// 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_ANDROID_AFFILIATION_AFFILIATION_SERVICE_H_ |
-#define COMPONENTS_PASSWORD_MANAGER_CORE_BROWSER_ANDROID_AFFILIATION_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/android_affiliation/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_ANDROID_AFFILIATION_AFFILIATION_SERVICE_H_ |