history_service.h revision 2a99a7e74a7f215066514fe81d2bfa6639d9eddd
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 52a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#ifndef CHROME_BROWSER_HISTORY_HISTORY_SERVICE_H_ 62a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#define CHROME_BROWSER_HISTORY_HISTORY_SERVICE_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <set> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/bind.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/callback.h" 142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/files/file_path.h" 152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/logging.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/ref_counted.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/scoped_ptr.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/weak_ptr.h" 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/observer_list.h" 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/string16.h" 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/threading/thread_checker.h" 222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "base/time.h" 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/common/cancelable_request.h" 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/favicon/favicon_service.h" 252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "chrome/browser/history/delete_directive_handler.h" 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/history/history_types.h" 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/profiles/profile_keyed_service.h" 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/search_engines/template_url_id.h" 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "chrome/common/cancelable_task_tracker.h" 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/common/ref_counted_util.h" 312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "components/visitedlink/browser/visitedlink_delegate.h" 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "content/public/browser/notification_observer.h" 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "content/public/browser/notification_registrar.h" 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "content/public/common/page_transition_types.h" 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "sql/init_status.h" 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "sync/api/syncable_service.h" 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ui/base/layout.h" 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(OS_ANDROID) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/history/android/android_history_provider_service.h" 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class BookmarkService; 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class GURL; 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class HistoryURLProvider; 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class PageUsageData; 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class PageUsageRequest; 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Profile; 492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct HistoryURLProviderParams; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace base { 522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class FilePath; 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Thread; 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)namespace components { 572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class VisitedLinkMaster; 582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)} // namespace components 592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace history { 622a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class HistoryBackend; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class HistoryDatabase; 652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class HistoryDBTask; 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class HistoryQueryTest; 672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class InMemoryHistoryBackend; 682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class InMemoryURLIndex; 692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class InMemoryURLIndexTest; 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class URLDatabase; 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class VisitDatabaseObserver; 722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)class VisitFilter; 732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct DownloadRow; 742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct HistoryAddPageArgs; 752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)struct HistoryDetails; 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)} // namespace history 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The history service records page titles, and visit times, as well as 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// (eventually) information about autocomplete. 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This service is thread safe. Each request callback is invoked in the 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// thread that made the request. 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class HistoryService : public CancelableRequestProvider, 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public content::NotificationObserver, 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public syncer::SyncableService, 872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public ProfileKeyedService, 882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) public components::VisitedLinkDelegate { 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Miscellaneous commonly-used types. 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef std::vector<PageUsageData*> PageUsageDataList; 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Must call Init after construction. 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit HistoryService(Profile* profile); 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The empty constructor is provided only for testing. 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HistoryService(); 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~HistoryService(); 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Initializes the history service, returning true on success. On false, do 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // not call any other functions. The given directory will be used for storing 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the history files. The BookmarkService is used when deleting URLs to 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // test if a URL is bookmarked; it may be NULL during testing. 1042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool Init(const base::FilePath& history_dir, BookmarkService* bookmark_service) { 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return Init(history_dir, bookmark_service, false); 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Triggers the backend to load if it hasn't already, and then returns whether 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // it's finished loading. 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Note: Virtual needed for mocking. 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual bool BackendLoaded(); 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the backend has finished loading. 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool backend_loaded() const { return backend_loaded_; } 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Unloads the backend without actually shutting down the history service. 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This can be used to temporarily reduce the browser process' memory 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // footprint. 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void UnloadBackend(); 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called on shutdown, this will tell the history backend to complete and 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will release pointers to it. No other functions should be called once 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // cleanup has happened that may dispatch to the history thread (because it 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will be NULL). 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In practice, this will be called by the service manager (BrowserProcess) 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // when it is being destroyed. Because that reference is being destroyed, it 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // should be impossible for anybody else to call the service, even if it is 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // still in memory (pending requests may be holding a reference to us). 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void Cleanup(); 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // RenderProcessHost pointers are used to scope page IDs (see AddPage). These 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // objects must tell us when they are being destroyed so that we can clear 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // out any cached data associated with that scope. 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The given pointer will not be dereferenced, it is only used for 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // identification purposes, hence it is a void*. 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void NotifyRenderProcessHostDestruction(const void* host); 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Triggers the backend to load if it hasn't already, and then returns the 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // in-memory URL database. The returned pointer MAY BE NULL if the in-memory 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // database has not been loaded yet. This pointer is owned by the history 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // system. Callers should not store or cache this value. 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(brettw) this should return the InMemoryHistoryBackend. 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::URLDatabase* InMemoryDatabase(); 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Following functions get URL information from in-memory database. 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // They return false if database is not available (e.g. not loaded yet) or the 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // URL does not exist. 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads the number of times the user has typed the given URL. 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool GetTypedCountForURL(const GURL& url, int* typed_count); 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads the last visit time for the given URL. 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool GetLastVisitTimeForURL(const GURL& url, base::Time* last_visit); 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads the number of times this URL has been visited. 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool GetVisitCountForURL(const GURL& url, int* visit_count); 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Return the quick history index. 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::InMemoryURLIndex* InMemoryIndex() const { 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return in_memory_url_index_.get(); 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ProfileKeyedService: 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Shutdown() OVERRIDE; 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Navigation ---------------------------------------------------------------- 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Adds the given canonical URL to history with the given time as the visit 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // time. Referrer may be the empty string. 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The supplied render process host is used to scope the given page ID. Page 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // IDs are only unique inside a given render process, so we need that to 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // differentiate them. This pointer should not be dereferenced by the history 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // system. 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The scope/ids can be NULL if there is no meaningful tracking information 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // that can be performed on the given URL. The 'page_id' should be the ID of 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the current session history entry in the given process. 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 'redirects' is an array of redirect URLs leading to this page, with the 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // page itself as the last item (so when there is no redirect, it will have 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // one entry). If there are no redirects, this array may also be empty for 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the convenience of callers. 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 'did_replace_entry' is true when the navigation entry for this page has 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // replaced the existing entry. A non-user initiated redirect causes such 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // replacement. 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // All "Add Page" functions will update the visited link database. 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPage(const GURL& url, 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Time time, 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const void* id_scope, 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32 page_id, 1975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& referrer, 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const history::RedirectList& redirects, 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) content::PageTransition transition, 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::VisitSource visit_source, 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool did_replace_entry); 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // For adding pages to history where no tracking information can be done. 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPage(const GURL& url, 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Time time, 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::VisitSource visit_source); 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // All AddPage variants end up here. 2095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPage(const history::HistoryAddPageArgs& add_page_args); 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Adds an entry for the specified url without creating a visit. This should 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // only be used when bookmarking a page, otherwise the row leaks in the 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history db (it never gets cleaned). 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPageNoVisitForBookmark(const GURL& url, const string16& title); 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sets the title for the given page. The page should be in history. If it 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is not, this operation is ignored. This call will not update the full 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // text index. The last title set when the page is indexed will be the 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // title in the full text index. 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetPageTitle(const GURL& url, const string16& title); 2215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Updates the history database with a page's ending time stamp information. 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The page can be identified by the combination of the pointer to 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // a RenderProcessHost, the page id and the url. 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The given pointer will not be dereferenced, it is only used for 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // identification purposes, hence it is a void*. 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void UpdateWithPageEndTime(const void* host, 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32 page_id, 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& url, 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Time end_ts); 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Indexing ------------------------------------------------------------------ 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Notifies history of the body text of the given recently-visited URL. 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If the URL was not visited "recently enough," the history system may 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // discard it. 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetPageContents(const GURL& url, const string16& contents); 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Querying ------------------------------------------------------------------ 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the information about the requested URL. If the URL is found, 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // success will be true and the information will be in the URLRow parameter. 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On success, the visits, if requested, will be sorted by date. If they have 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // not been requested, the pointer will be valid, but the vector will be 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // empty. 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If success is false, neither the row nor the vector will be valid. 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void( 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle, 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool, // Success flag, when false, nothing else is valid. 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const history::URLRow*, 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::VisitVector*)> QueryURLCallback; 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Queries the basic information about the URL in the history database. If 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the caller is interested in the visits (each time the URL is visited), 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // set |want_visits| to true. If these are not needed, the function will be 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // faster by setting this to false. 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryURL(const GURL& url, 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool want_visits, 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryURLCallback& callback); 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Provides the result of a query. See QueryResults in history_types.h. 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The common use will be to use QueryResults.Swap to suck the contents of 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the results out of the passed in parameter and take ownership of them. 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, history::QueryResults*)> 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QueryHistoryCallback; 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Queries all history with the given options (see QueryOptions in 2715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history_types.h). If non-empty, the full-text database will be queried with 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the given |text_query|. If empty, all results matching the given options 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will be returned. 2745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 2755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This isn't totally hooked up yet, this will query the "new" full text 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // database (see SetPageContents) which won't generally be set yet. 2775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryHistory(const string16& text_query, 2785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const history::QueryOptions& options, 2795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 2805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryHistoryCallback& callback); 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called when the results of QueryRedirectsFrom are available. 2835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The given vector will contain a list of all redirects, not counting 2845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the original page. If A redirects to B, the vector will contain only B, 2855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and A will be in 'source_url'. 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If there is no such URL in the database or the most recent visit has no 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // redirect, the vector will be empty. If the history system failed for 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // some reason, success will additionally be false. If the given page 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // has redirected to multiple destinations, this will pick a random one. 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) GURL, // from_url 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool, // success 2945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::RedirectList*)> QueryRedirectsCallback; 2955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Schedules a query for the most recent redirect coming out of the given 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // URL. See the RedirectQuerySource above, which is guaranteed to be called 2985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // if the request is not canceled. 2995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryRedirectsFrom(const GURL& from_url, 3005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryRedirectsCallback& callback); 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Schedules a query to get the most recent redirects ending at the given 3045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // URL. 3055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryRedirectsTo(const GURL& to_url, 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryRedirectsCallback& callback); 3085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback< 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void(Handle, 3115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool, // Were we able to determine the # of visits? 3125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int, // Number of visits. 3135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Time)> // Time of first visit. Only set if bool 3145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is true and int is > 0. 3155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) GetVisibleVisitCountToHostCallback; 3165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Requests the number of user-visible visits (i.e. no redirects or subframes) 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to all urls on the same scheme/host/port as |url|. This is only valid for 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // HTTP and HTTPS URLs. 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle GetVisibleVisitCountToHost( 3215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& url, 3225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GetVisibleVisitCountToHostCallback& callback); 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called when QueryTopURLsAndRedirects completes. The vector contains a list 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // of the top |result_count| URLs. For each of these URLs, there is an entry 3275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // in the map containing redirects from the URL. For example, if we have the 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // redirect chain A -> B -> C and A is a top visited URL, then A will be in 3295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the vector and "A => {B -> C}" will be in the map. 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback< 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void(Handle, 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool, // Did we get the top urls and redirects? 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<GURL>*, // List of top URLs. 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::RedirectMap*)> // Redirects for top URLs. 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QueryTopURLsAndRedirectsCallback; 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Request the top |result_count| most visited URLs and the chain of redirects 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // leading to each of these URLs. 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(Nik): remove this. Use QueryMostVisitedURLs instead. 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryTopURLsAndRedirects( 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int result_count, 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryTopURLsAndRedirectsCallback& callback); 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, history::MostVisitedURLList)> 3465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QueryMostVisitedURLsCallback; 3475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, const history::FilteredURLList&)> 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) QueryFilteredURLsCallback; 3505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Request the |result_count| most visited URLs and the chain of 3525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // redirects leading to each of these URLs. |days_back| is the 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // number of days of history to use. Used by TopSites. 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryMostVisitedURLs(int result_count, int days_back, 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryMostVisitedURLsCallback& callback); 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Request the |result_count| URLs filtered and sorted based on the |filter|. 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If |extended_info| is true, additional data will be provided in the 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // results. Computing this additional data is expensive, likely to become 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // more expensive as additional data points are added in future changes, and 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // not useful in most cases. Set |extended_info| to true only if you 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // explicitly require the additional data. 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QueryFilteredURLs( 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int result_count, 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const history::VisitFilter& filter, 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool extended_info, 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const QueryFilteredURLsCallback& callback); 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Thumbnails ---------------------------------------------------------------- 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implemented by consumers to get thumbnail data. Called when a request for 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the thumbnail data is complete. Once this callback is made, the request 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will be completed and no other calls will be made for that handle. 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This function will be called even on error conditions or if there is no 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // thumbnail for that page. In these cases, the data pointer will be NULL. 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, scoped_refptr<base::RefCountedBytes>)> 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThumbnailDataCallback; 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Requests a page thumbnail. See ThumbnailDataCallback definition above. 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle GetPageThumbnail(const GURL& page_url, 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ThumbnailDataCallback& callback); 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Database management operations -------------------------------------------- 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Delete all the information related to a single url. 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void DeleteURL(const GURL& url); 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Delete all the information related to a list of urls. (Deleting 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // URLs one by one is slow as it has to flush to disk each time.) 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void DeleteURLsForTest(const std::vector<GURL>& urls); 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Removes all visits in the selected time range (including the start time), 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // updating the URLs accordingly. This deletes the associated data, including 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the full text index. This function also deletes the associated favicons, 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // if they are no longer referenced. |callback| runs when the expiration is 4005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // complete. You may use null Time values to do an unbounded delete in 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // either direction. 4025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If |restrict_urls| is not empty, only visits to the URLs in this set are 4035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // removed. 4045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ExpireHistoryBetween(const std::set<GURL>& restrict_urls, 4052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time begin_time, 4062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time end_time, 4072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const base::Closure& callback, 4082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 4092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Removes all visits to specified URLs in specific time ranges. 4112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // This is the equivalent ExpireHistoryBetween() once for each element in the 4122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // vector. The fields of |ExpireHistoryArgs| map directly to the arguments of 4132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // of ExpireHistoryBetween(). 4142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void ExpireHistory(const std::vector<history::ExpireHistoryArgs>& expire_list, 4152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const base::Closure& callback, 4162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 4172a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4182a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Removes all visits to the given URLs in the specified time range. Calls 4192a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // ExpireHistoryBetween() to delete local visits, and handles deletion of 4202a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // synced visits if appropriate. 4212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void ExpireLocalAndRemoteHistoryBetween( 4222a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::set<GURL>& restrict_urls, 4232a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time begin_time, 4242a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time end_time, 4252a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const base::Closure& callback, 4262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 4272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 4282a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Processes the given |delete_directive| and sends it to the 4292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // SyncChangeProcessor (if it exists). Returns any error resulting 4302a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // from sending the delete directive to sync. 4312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) syncer::SyncError ProcessLocalDeleteDirective( 4322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const sync_pb::HistoryDeleteDirectiveSpecifics& delete_directive); 4335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Downloads ----------------------------------------------------------------- 4355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implemented by the caller of 'CreateDownload' below, and is called when the 4375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history service has created a new entry for a download in the history db. 4382a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) typedef base::Callback<void(int64)> DownloadCreateCallback; 4395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Begins a history request to create a new row for a download. 'info' 4412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // contains all the download's creation state, and 'callback' runs when the 4422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // history service request is complete. The callback is called on the thread 4432a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // that calls CreateDownload(). 4442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void CreateDownload( 4452a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const history::DownloadRow& info, 4462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const DownloadCreateCallback& callback); 4475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implemented by the caller of 'GetNextDownloadId' below. 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(int)> DownloadNextIdCallback; 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Runs the callback with the next available download id. The callback is 4522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // called on the thread that calls GetNextDownloadId(). 4532a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void GetNextDownloadId(const DownloadNextIdCallback& callback); 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implemented by the caller of 'QueryDownloads' below, and is called when the 4565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history service has retrieved a list of all download state. The call 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void( 4582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) scoped_ptr<std::vector<history::DownloadRow> >)> 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DownloadQueryCallback; 4605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Begins a history request to retrieve the state of all downloads in the 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history db. 'callback' runs when the history service request is complete, 4632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // at which point 'info' contains an array of history::DownloadRow, one per 4642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // download. The callback is called on the thread that calls QueryDownloads(). 4652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void QueryDownloads(const DownloadQueryCallback& callback); 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Begins a request to clean up entries that has been corrupted (because of 4685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the crash, for example). 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void CleanUpInProgressEntries(); 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called to update the history service about the current state of a download. 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This is a 'fire and forget' query, so just pass the relevant state info to 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the database with no need for a callback. 4742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void UpdateDownload(const history::DownloadRow& data); 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Permanently remove some downloads from the history system. This is a 'fire 4772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // and forget' operation. 4782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void RemoveDownloads(const std::set<int64>& db_handles); 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Visit Segments ------------------------------------------------------------ 4815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<void(Handle, std::vector<PageUsageData*>*)> 4835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SegmentQueryCallback; 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Query usage data for all visit segments since the provided time. 4865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 4875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The request is performed asynchronously and can be cancelled by using the 4885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // returned handle. 4895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The vector provided to the callback and its contents is owned by the 4915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history system. It will be deeply deleted after the callback is invoked. 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If you want to preserve any PageUsageData instance, simply remove them 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // from the vector. 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 4955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The vector contains a list of PageUsageData. Each PageUsageData ID is set 4965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to the segment ID. The URL and all the other information is set to the page 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // representing the segment. 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle QuerySegmentUsageSince(CancelableRequestConsumerBase* consumer, 4995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const base::Time from_time, 5005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int max_result_count, 5015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const SegmentQueryCallback& callback); 5025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Increases the amount of time the user actively viewed the url. 5042a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) void IncreaseSegmentDuration(const GURL& url, 5052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time time, 5062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::TimeDelta delta); 5072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 5082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Queries segments based on active time viewed. 5092a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) Handle QuerySegmentDurationSince(CancelableRequestConsumerBase* consumer, 5102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::Time from_time, 5112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int max_result_count, 5122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const SegmentQueryCallback& callback); 5135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Keyword search terms ----------------------------------------------------- 5155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sets the search terms for the specified url and keyword. url_id gives the 5175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // id of the url, keyword_id the id of the keyword and term the search term. 5185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetKeywordSearchTermsForURL(const GURL& url, 5195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) TemplateURLID keyword_id, 5205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const string16& term); 5215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Deletes all search terms for the specified keyword. 5235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void DeleteAllSearchTermsForKeyword(TemplateURLID keyword_id); 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback< 5265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void(Handle, std::vector<history::KeywordSearchTermVisit>*)> 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) GetMostRecentKeywordSearchTermsCallback; 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns up to max_count of the most recent search terms starting with the 5305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // specified text. The matching is case insensitive. The results are ordered 5315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // in descending order up to |max_count| with the most recent search term 5325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // first. 5335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle GetMostRecentKeywordSearchTerms( 5345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) TemplateURLID keyword_id, 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const string16& prefix, 5365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int max_count, 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 5385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GetMostRecentKeywordSearchTermsCallback& callback); 5395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Bookmarks ----------------------------------------------------------------- 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Notification that a URL is no longer bookmarked. 5435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void URLsNoLongerBookmarked(const std::set<GURL>& urls); 5445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Generic Stuff ------------------------------------------------------------- 5465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Schedules a HistoryDBTask for running on the history backend thread. See 5485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // HistoryDBTask for details on what this does. 5492a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual void ScheduleDBTask(history::HistoryDBTask* task, 5505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer); 5515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if top sites needs to be migrated out of history into its own 5535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // db. 5545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool needs_top_sites_migration() const { return needs_top_sites_migration_; } 5555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Adds or removes observers for the VisitDatabase. 5575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddVisitDatabaseObserver(history::VisitDatabaseObserver* observer); 5585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void RemoveVisitDatabaseObserver(history::VisitDatabaseObserver* observer); 5595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void NotifyVisitDBObserversOnAddVisit(const history::BriefVisitInfo& info); 5615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Testing ------------------------------------------------------------------- 5635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Designed for unit tests, this passes the given task on to the history 5655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // backend to be called once the history backend has terminated. This allows 5665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // callers to know when the history thread is complete and the database files 5675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // can be deleted and the next test run. Otherwise, the history thread may 5685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // still be running, causing problems in subsequent tests. 5695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 5705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // There can be only one closing task, so this will override any previously 5715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // set task. We will take ownership of the pointer and delete it when done. 5725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The task will be run on the calling thread (this function is threadsafe). 5735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetOnBackendDestroyTask(const base::Closure& task); 5745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used for unit testing and potentially importing to get known information 5765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // into the database. This assumes the URL doesn't exist in the database 5775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Calling this function many times may be slow because each call will 5795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // dispatch to the history thread and will be a separate database 5805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // transaction. If this functionality is needed for importing many URLs, 5815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // callers should use AddPagesWithDetails() instead. 5825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 5835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Note that this routine (and AddPageWithDetails()) always adds a single 5845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // visit using the |last_visit| timestamp, and a PageTransition type of LINK, 5855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // if |visit_source| != SYNCED. 5865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPageWithDetails(const GURL& url, 5875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const string16& title, 5885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int visit_count, 5895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int typed_count, 5905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Time last_visit, 5915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool hidden, 5925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::VisitSource visit_source); 5935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The same as AddPageWithDetails() but takes a vector. 5955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddPagesWithDetails(const history::URLRows& info, 5965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::VisitSource visit_source); 5975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Starts the TopSites migration in the HistoryThread. Called by the 5995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // BackendDelegate. 6005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void StartTopSitesMigration(int backend_id); 6015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called by TopSites after the thumbnails were read and it is safe 6035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to delete the thumbnails DB. 6045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void OnTopSitesReady(); 6055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if this looks like the type of URL we want to add to the 6075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // history. We filter out some URLs such as JavaScript. 6085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static bool CanAddURL(const GURL& url); 6095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::WeakPtr<HistoryService> AsWeakPtr(); 6115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // syncer::SyncableService implementation. 6132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual syncer::SyncMergeResult MergeDataAndStartSyncing( 6145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) syncer::ModelType type, 6155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const syncer::SyncDataList& initial_sync_data, 6165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<syncer::SyncChangeProcessor> sync_processor, 6175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<syncer::SyncErrorFactory> error_handler) OVERRIDE; 6185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void StopSyncing(syncer::ModelType type) OVERRIDE; 6195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual syncer::SyncDataList GetAllSyncData( 6205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) syncer::ModelType type) const OVERRIDE; 6215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual syncer::SyncError ProcessSyncChanges( 6225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const tracked_objects::Location& from_here, 6235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const syncer::SyncChangeList& change_list) OVERRIDE; 6245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) protected: 6265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // These are not currently used, hopefully we can do something in the future 6275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to ensure that the most important things happen first. 6285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enum SchedulePriority { 6295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PRIORITY_UI, // The highest priority (must respond to UI events). 6305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PRIORITY_NORMAL, // Normal stuff like adding a page. 6315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PRIORITY_LOW, // Low priority things like indexing or expiration. 6325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 6335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 6355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) class BackendDelegate; 6365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(OS_ANDROID) 6375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class AndroidHistoryProviderService; 6385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 6395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class base::RefCountedThreadSafe<HistoryService>; 6405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class BackendDelegate; 6415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class FaviconService; 6425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class history::HistoryBackend; 6435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class history::HistoryQueryTest; 6445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class HistoryOperation; 6455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class HistoryURLProvider; 6465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class HistoryURLProviderTest; 6475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class history::InMemoryURLIndexTest; 6485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename Info, typename Callback> friend class DownloadRequest; 6495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class PageUsageRequest; 6505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class RedirectRequest; 6515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class TestingProfile; 6525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Implementation of content::NotificationObserver. 6545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Observe(int type, 6555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const content::NotificationSource& source, 6565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const content::NotificationDetails& details) OVERRIDE; 6575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Implementation of components::VisitedLinkDelegate. 6592a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual void RebuildTable( 6602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const scoped_refptr<URLEnumerator>& enumerator) OVERRIDE; 6612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 6625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Low-level Init(). Same as the public version, but adds a |no_db| parameter 6635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // that is only set by unittests which causes the backend to not init its DB. 6642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) bool Init(const base::FilePath& history_dir, 6655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BookmarkService* bookmark_service, 6665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool no_db); 6675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called by the HistoryURLProvider class to schedule an autocomplete, it 6695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will be called back on the internal history thread with the history 6705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // database so it can query. See history_autocomplete.cc for a diagram. 6715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAutocomplete(HistoryURLProvider* provider, 6725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) HistoryURLProviderParams* params); 6735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Broadcasts the given notification. This is called by the backend so that 6755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the notification will be broadcast on the main thread. 6765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 6775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Compared to BroadcastNotifications(), this function does not take 6785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ownership of |details|. 6795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void BroadcastNotificationsHelper(int type, 6805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::HistoryDetails* details); 6815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Initializes the backend. 6835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void LoadBackendIfNecessary(); 6845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Notification from the backend that it has finished loading. Sends 6865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // notification (NOTIFY_HISTORY_LOADED) and sets backend_loaded_ to true. 6875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void OnDBLoaded(int backend_id); 6885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Helper function for getting URL information. 6905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads a URLRow from in-memory database. Returns false if database is not 6915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // available or the URL does not exist. 6925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool GetRowForURL(const GURL& url, history::URLRow* url_row); 6935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Favicon ------------------------------------------------------------------- 6955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // These favicon methods are exposed to the FaviconService. Instead of calling 6975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // these methods directly you should call the respective method on the 6985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FaviconService. 6995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by FaviconService to get the favicon bitmaps from the history backend 7015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which most closely match |desired_size_in_dip| x |desired_size_in_dip| and 7025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |desired_scale_factors| for |icon_types|. If |desired_size_in_dip| is 0, 7035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the largest favicon bitmap for |icon_types| is returned. The returned 7045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FaviconBitmapResults will have at most one result for each of 7055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |desired_scale_factors|. If a favicon bitmap is determined to be the best 7065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // candidate for multiple scale factors there will be less results. 7075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If |icon_types| has several types, results for only a single type will be 7085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // returned in the priority of TOUCH_PRECOMPOSED_ICON, TOUCH_ICON, and 7095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FAVICON. 7102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker::TaskId GetFavicons( 7112a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::vector<GURL>& icon_urls, 7122a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int icon_types, 7132a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int desired_size_in_dip, 7142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::vector<ui::ScaleFactor>& desired_scale_factors, 7152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const FaviconService::FaviconResultsCallback& callback, 7162a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 7175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to get favicons mapped to |page_url| for 7195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |icon_types| which most closely match |desired_size_in_dip| and 7205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |desired_scale_factors|. If |desired_size_in_dip| is 0, the largest favicon 7215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // bitmap for |icon_types| is returned. The returned FaviconBitmapResults will 7225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // have at most one result for each of |desired_scale_factors|. If a favicon 7235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // bitmap is determined to be the best candidate for multiple scale factors 7245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // there will be less results. If |icon_types| has several types, results for 7255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // only a single type will be returned in the priority of 7265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TOUCH_PRECOMPOSED_ICON, TOUCH_ICON, and FAVICON. 7272a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker::TaskId GetFaviconsForURL( 7285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& page_url, 7295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int icon_types, 7305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int desired_size_in_dip, 7312a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::vector<ui::ScaleFactor>& desired_scale_factors, 7322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const FaviconService::FaviconResultsCallback& callback, 7332a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 7345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to get the favicon bitmap which most closely 7365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // matches |desired_size_in_dip| and |desired_scale_factor| from the favicon 7375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // with |favicon_id| from the history backend. If |desired_size_in_dip| is 0, 7385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the largest favicon bitmap for |favicon_id| is returned. 7392a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker::TaskId GetFaviconForID( 7402a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) history::FaviconID favicon_id, 7412a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) int desired_size_in_dip, 7422a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) ui::ScaleFactor desired_scale_factor, 7432a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const FaviconService::FaviconResultsCallback& callback, 7442a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 7455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to replace the favicon mappings to |page_url| 7475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // for |icon_types| on the history backend. 7485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sample |icon_urls|: 7495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // { ICON_URL1 -> TOUCH_ICON, known to the database, 7505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ICON_URL2 -> TOUCH_ICON, not known to the database, 7515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ICON_URL3 -> TOUCH_PRECOMPOSED_ICON, known to the database } 7525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The new mappings are computed from |icon_urls| with these rules: 7535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 1) Any urls in |icon_urls| which are not already known to the database are 7545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // rejected. 7555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sample new mappings to |page_url|: { ICON_URL1, ICON_URL3 } 7565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 2) If |icon_types| has multiple types, the mappings are only set for the 7575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // largest icon type. 7585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sample new mappings to |page_url|: { ICON_URL3 } 7595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |icon_types| can only have multiple IconTypes if 7605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |icon_types| == TOUCH_ICON | TOUCH_PRECOMPOSED_ICON. 7615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The favicon bitmaps which most closely match |desired_size_in_dip| 7625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and |desired_scale_factors| from the favicons which were just mapped 7635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to |page_url| are returned. If |desired_size_in_dip| is 0, the 7645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // largest favicon bitmap is returned. 7652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker::TaskId UpdateFaviconMappingsAndFetch( 7665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& page_url, 7675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<GURL>& icon_urls, 7685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int icon_types, 7695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int desired_size_in_dip, 7702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::vector<ui::ScaleFactor>& desired_scale_factors, 7712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const FaviconService::FaviconResultsCallback& callback, 7722a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) CancelableTaskTracker* tracker); 7732a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 7742a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Used by FaviconService to set a favicon for |page_url| and |icon_url| with 7752a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // |pixel_size|. 7762a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Example: 7772a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // |page_url|: www.google.com 7782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 2 favicons in history for |page_url|: 7792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // www.google.com/a.ico 16x16 7802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // www.google.com/b.ico 32x32 7812a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // MergeFavicon(|page_url|, www.google.com/a.ico, ..., ..., 16x16) 7822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 7832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Merging occurs in the following manner: 7842a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 1) |page_url| is set to map to only to |icon_url|. In order to not lose 7852a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // data, favicon bitmaps mapped to |page_url| but not to |icon_url| are 7862a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // copied to the favicon at |icon_url|. 7872a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // For the example above, |page_url| will only be mapped to a.ico. 7882a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // The 32x32 favicon bitmap at b.ico is copied to a.ico 7892a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // 2) |bitmap_data| is added to the favicon at |icon_url|, overwriting any 7902a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // favicon bitmaps of |pixel_size|. 7912a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // For the example above, |bitmap_data| overwrites the 16x16 favicon 7922a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bitmap for a.ico. 7935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(pkotwicz): Remove once no longer required by sync. 7945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void MergeFavicon(const GURL& page_url, 7952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const GURL& icon_url, 7965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::IconType icon_type, 7975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<base::RefCountedMemory> bitmap_data, 7985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const gfx::Size& pixel_size); 7995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to set the favicons for a page on the history 8015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // backend. 8022a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // |favicon_bitmap_data| replaces all the favicon bitmaps mapped to 8032a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // |page_url|. 8045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |expired| and |icon_type| fields in FaviconBitmapData are ignored. 8052a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Use MergeFavicon() if |favicon_bitmap_data| is incomplete, and favicon 8062a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bitmaps in the database should be preserved if possible. For instance, 8072a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // favicon bitmaps from sync are 1x only. MergeFavicon() is used to avoid 8082a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // deleting the 2x favicon bitmap if it is present in the history backend. 8095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // See HistoryBackend::ValidateSetFaviconsParams() for more details on the 8102a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // criteria for |favicon_bitmap_data| to be valid. 8115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetFavicons( 8125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const GURL& page_url, 8135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::IconType icon_type, 8142a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const std::vector<history::FaviconBitmapData>& favicon_bitmap_data); 8155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to mark the favicon for the page as being out 8175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // of date. 8185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetFaviconsOutOfDateForPage(const GURL& page_url); 8195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService to clone favicons from one page to another, 8215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // provided that other page does not already have favicons. 8225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void CloneFavicons(const GURL& old_page_url, const GURL& new_page_url); 8235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used by the FaviconService for importing many favicons for many pages at 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // once. The pages must exist, any favicon sets for unknown pages will be 8265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // discarded. Existing favicons will not be overwritten. 8275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetImportedFavicons( 8285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<history::ImportedFaviconUsage>& favicon_usage); 8295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sets the in-memory URL database. This is called by the backend once the 8315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // database is loaded to make it available. 8325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SetInMemoryBackend(int backend_id, 8335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) history::InMemoryHistoryBackend* mem_backend); 8345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called by our BackendDelegate when there is a problem reading the database. 8365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void NotifyProfileError(int backend_id, sql::InitStatus init_status); 8375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Call to schedule a given task for running on the history thread with the 8395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // specified priority. The task will have ownership taken. 8405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleTask(SchedulePriority priority, const base::Closure& task); 8415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Schedule ------------------------------------------------------------------ 8435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 8445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Functions for scheduling operations on the history thread that have a 8455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // handle and may be cancelable. For fire-and-forget operations, see 8465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ScheduleAndForget below. 8475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, class RequestType> 8495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle Schedule(SchedulePriority priority, 8505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on the HistoryBackend. 8515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 8525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RequestType* request) { 8535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 8545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 8555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 8565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (consumer) 8575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AddRequest(request, consumer); 8585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, 8595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Bind(func, history_backend_.get(), 8605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<RequestType>(request))); 8615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return request->handle(); 8625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 8635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, class RequestType, typename ArgA> 8655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle Schedule(SchedulePriority priority, 8665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on the HistoryBackend. 8675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 8685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RequestType* request, 8695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a) { 8705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 8715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 8725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 8735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (consumer) 8745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AddRequest(request, consumer); 8755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, 8765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Bind(func, history_backend_.get(), 8775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<RequestType>(request), a)); 8785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return request->handle(); 8795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 8805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, 8825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) class RequestType, // Descendant of CancelableRequestBase. 8835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgA, 8845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgB> 8855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle Schedule(SchedulePriority priority, 8865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on the HistoryBackend. 8875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 8885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RequestType* request, 8895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 8905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b) { 8915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 8925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 8935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 8945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (consumer) 8955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AddRequest(request, consumer); 8965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, 8975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Bind(func, history_backend_.get(), 8985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<RequestType>(request), a, b)); 8995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return request->handle(); 9005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, 9035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) class RequestType, // Descendant of CancelableRequestBase. 9045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgA, 9055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgB, 9065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgC> 9075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle Schedule(SchedulePriority priority, 9085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on the HistoryBackend. 9095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 9105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RequestType* request, 9115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 9125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b, 9135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgC& c) { 9145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (consumer) 9185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AddRequest(request, consumer); 9195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, 9205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Bind(func, history_backend_.get(), 9215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<RequestType>(request), a, b, c)); 9225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return request->handle(); 9235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, 9265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) class RequestType, // Descendant of CancelableRequestBase. 9275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgA, 9285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgB, 9295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgC, 9305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgD> 9315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Handle Schedule(SchedulePriority priority, 9325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on the HistoryBackend. 9335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumerBase* consumer, 9345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RequestType* request, 9355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 9365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b, 9375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgC& c, 9385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgD& d) { 9395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (consumer) 9435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AddRequest(request, consumer); 9445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, 9455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Bind(func, history_backend_.get(), 9465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<RequestType>(request), a, b, c, d)); 9475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return request->handle(); 9485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ScheduleAndForget --------------------------------------------------------- 9515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 9525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Functions for scheduling operations on the history thread that do not need 9535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // any callbacks and are not cancelable. 9545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc> 9565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 9575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func) { // Function to call on backend. 9585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get())); 9625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, typename ArgA> 9655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 9665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on backend. 9675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a) { 9685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get(), a)); 9725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, typename ArgA, typename ArgB> 9755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 9765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on backend. 9775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 9785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b) { 9795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get(), a, b)); 9835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, typename ArgA, typename ArgB, typename ArgC> 9865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 9875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on backend. 9885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 9895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b, 9905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgC& c) { 9915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 9925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 9935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 9945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get(), a, b, c)); 9955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 9965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, 9985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgA, 9995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgB, 10005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgC, 10015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgD> 10025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 10035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on backend. 10045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 10055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b, 10065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgC& c, 10075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgD& d) { 10085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 10095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 10105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 10115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get(), 10125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) a, b, c, d)); 10135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 10145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) template<typename BackendFunc, 10165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgA, 10175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgB, 10185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgC, 10195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgD, 10205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typename ArgE> 10215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ScheduleAndForget(SchedulePriority priority, 10225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BackendFunc func, // Function to call on backend. 10235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgA& a, 10245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgB& b, 10255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgC& c, 10265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgD& d, 10275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ArgE& e) { 10285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_) << "History service being called after cleanup"; 10295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DCHECK(thread_checker_.CalledOnValidThread()); 10305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LoadBackendIfNecessary(); 10315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScheduleTask(priority, base::Bind(func, history_backend_.get(), 10325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) a, b, c, d, e)); 10335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 10345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // All vended weak pointers are invalidated in Cleanup(). 10365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::WeakPtrFactory<HistoryService> weak_ptr_factory_; 10375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::ThreadChecker thread_checker_; 10395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) content::NotificationRegistrar registrar_; 10415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Some void primitives require some internal processing in the main thread 10435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // when done. We use this internal consumer for this purpose. 10445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CancelableRequestConsumer internal_consumer_; 10455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The thread used by the history service to run complicated operations. 10475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |thread_| is NULL once |Cleanup| is NULL. 10485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) base::Thread* thread_; 10495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This class has most of the implementation and runs on the 'thread_'. 10515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // You MUST communicate with this class ONLY through the thread_'s 10525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // message_loop(). 10535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 10545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This pointer will be NULL once Cleanup() has been called, meaning no 10555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // more calls should be made to the history thread. 10565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_refptr<history::HistoryBackend> history_backend_; 10575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A cache of the user-typed URLs kept in memory that is used by the 10595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // autocomplete system. This will be NULL until the database has been created 10605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // on the background thread. 10615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(mrossetti): Consider changing ownership. See http://crbug.com/138321 10625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<history::InMemoryHistoryBackend> in_memory_backend_; 10635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The profile, may be null when testing. 10655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Profile* profile_; 10665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10672a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Used for propagating link highlighting data across renderers. May be null 10682a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // in tests. 10692a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) scoped_ptr<components::VisitedLinkMaster> visitedlink_master_; 10702a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 10715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Has the backend finished loading? The backend is loaded once Init has 10725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // completed. 10735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool backend_loaded_; 10745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The id of the current backend. This is only valid when history_backend_ 10765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is not NULL. 10775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int current_backend_id_; 10785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Cached values from Init(), used whenever we need to reload the backend. 10802a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) base::FilePath history_dir_; 10815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) BookmarkService* bookmark_service_; 10825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool no_db_; 10835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // True if needs top site migration. 10855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool needs_top_sites_migration_; 10865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The index used for quick history lookups. 10885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(mrossetti): Move in_memory_url_index out of history_service. 10895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // See http://crbug.com/138321 10905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<history::InMemoryURLIndex> in_memory_url_index_; 10915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ObserverList<history::VisitDatabaseObserver> visit_database_observers_; 10935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10942a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) history::DeleteDirectiveHandler delete_directive_handler_; 10952a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 10965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(HistoryService); 10975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 10985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10992a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#endif // CHROME_BROWSER_HISTORY_HISTORY_SERVICE_H_ 1100