| Index: chrome/browser/history/in_memory_url_cache_database.h
|
| ===================================================================
|
| --- chrome/browser/history/in_memory_url_cache_database.h (revision 152962)
|
| +++ chrome/browser/history/in_memory_url_cache_database.h (working copy)
|
| @@ -1,218 +0,0 @@
|
| -// Copyright (c) 2012 The Chromium Authors. All rights reserved.
|
| -// Use of this source code is governed by a BSD-style license that can be
|
| -// found in the LICENSE file.
|
| -
|
| -#ifndef CHROME_BROWSER_HISTORY_IN_MEMORY_URL_CACHE_DATABASE_H_
|
| -#define CHROME_BROWSER_HISTORY_IN_MEMORY_URL_CACHE_DATABASE_H_
|
| -
|
| -#include <string>
|
| -
|
| -#include "base/basictypes.h"
|
| -#include "base/callback_forward.h"
|
| -#include "base/gtest_prod_util.h"
|
| -#include "base/memory/ref_counted.h"
|
| -#include "base/threading/sequenced_worker_pool.h"
|
| -#include "chrome/browser/history/in_memory_url_index_types.h"
|
| -#include "sql/connection.h"
|
| -#include "sql/init_status.h"
|
| -#include "sql/meta_table.h"
|
| -
|
| -class FilePath;
|
| -
|
| -namespace sql {
|
| -class Statement;
|
| -}
|
| -
|
| -namespace history {
|
| -
|
| -class InMemoryURLIndex;
|
| -class URLIndexPrivateData;
|
| -
|
| -// Supports caching and restoring of the private data of the InMemoryURLIndex.
|
| -// This class has intimate knowledge of InMemoryURLIndex's URLIndexPrivateData
|
| -// class and directly pokes data therein during cache restoration. The only
|
| -// client of this class is URLIndexPrivateData.
|
| -//
|
| -// Tables in this database:
|
| -// word - Indexed words with IDs (from word_map_ and word_list_).
|
| -// char_words - Indexed characters with IDs of words containing the
|
| -// character (from char_word_map_).
|
| -// word_history - Word IDs with the IDs of history items containing the
|
| -// word (from word_id_history_map_).
|
| -// url - URLs and page titles along with visit and other metrics
|
| -// (from the history_info_map_ and word_starts_map_).
|
| -// url_word_starts - History IDs with the starting position of each word
|
| -// found in its URL.
|
| -// title_word_starts - History IDs with the starting position of each word
|
| -// found in its page title.
|
| -//
|
| -// NOTE: The history IDs in this database for URLs are identical to those in the
|
| -// main history database.
|
| -class InMemoryURLCacheDatabase
|
| - : public base::RefCountedThreadSafe<InMemoryURLCacheDatabase> {
|
| - public:
|
| - InMemoryURLCacheDatabase();
|
| -
|
| - // Initializes the database connection. This must return true before any other
|
| - // functions on this class are called. |file_path| gives the path to where
|
| - // the cache database is located. |sequence_token| is used to coordinate all
|
| - // access to the cache database. This is normally called on the DB thread but
|
| - // may also be called in the sequenced worker pool for certain unit tests.
|
| - bool Init(const FilePath& file_path,
|
| - const base::SequencedWorkerPool::SequenceToken& sequence_token);
|
| -
|
| - // Shuts down the database connection. Posts a sequenced task that performs
|
| - // the matching ShutDownTask function below.
|
| - void Shutdown();
|
| -
|
| - // Restore the private InMemoryURLIndex |data| from the database. Returns true
|
| - // if there was data to restore and the restore was successful. It is
|
| - // considered an error and false is returned if _any_ of the restored data
|
| - // structures in the private data, except |available_words_|, are empty after
|
| - // restoration. Technically, the case where _all_ data structures are empty
|
| - // after a restore is an error only when the user's history has _not_ been
|
| - // cleared. In the case where history _has_ been cleared and the data
|
| - // structures are legitimately empty we still return a false as the cost of
|
| - // attempting to rebuild the private data from an empty history database is
|
| - // negligible.
|
| - bool RestorePrivateData(URLIndexPrivateData* data);
|
| -
|
| - // Reset the database by dropping and recreating all database tables. Return
|
| - // true if successful. Note that a failure does not close the database.
|
| - virtual bool Reset();
|
| -
|
| - // Adds information for a new |row| to the various database tables. These
|
| - // functions post a sequenced task that performs the matching '[name]Task'
|
| - // functions below. The client should wrap these functions in a transaction
|
| - // by the client by calling BeginTransaction(), whatever combination of these
|
| - // function as appropriate, and finally CommitTransaction(). The
|
| - // CommitTransaction() will notify the client if any failure occurs.
|
| - void AddHistoryToURLs(HistoryID history_id, const URLRow& row);
|
| - void AddHistoryToWordHistory(WordID word_id, HistoryID history_id);
|
| - void AddWordToWords(WordID word_id, const string16& uni_word);
|
| - void AddWordToCharWords(char16 uni_char, WordID word_id);
|
| - void AddRowWordStarts(HistoryID history_id,
|
| - const RowWordStarts& row_word_starts);
|
| -
|
| - // Deletes row information from the various database tables. These functions
|
| - // post a sequenced task that performs the matching '[name]Task' functions
|
| - // below.
|
| - void RemoveHistoryIDFromURLs(HistoryID history_id);
|
| - void RemoveHistoryIDFromWordHistory(HistoryID history_id);
|
| - void RemoveWordFromWords(WordID word_id);
|
| - void RemoveWordStarts(HistoryID history_id);
|
| -
|
| - // Wraps transactions on the database. We support nested transactions and only
|
| - // commit when the outermost one is committed (sqlite doesn't support true
|
| - // nested transactions). These functions post a sequenced task that performs
|
| - // the matching '[name]Task' functions below.
|
| - void BeginTransaction();
|
| - void CommitTransaction();
|
| -
|
| - // Completely replaces all data in the cache database with a fresh image.
|
| - // Returns true upon success. Must not be called on the main thread and and
|
| - // the caller should ensure that no other cache database update operations
|
| - // take place while this method is being performed. Returns true if the
|
| - // refresh was successful.
|
| - virtual bool Refresh(const URLIndexPrivateData& index_data);
|
| -
|
| - private:
|
| - friend class base::RefCountedThreadSafe<InMemoryURLCacheDatabase>;
|
| - friend class InMemoryURLIndexCacheTest;
|
| - friend class InMemoryURLIndexTest;
|
| - friend class InterposingCacheDatabase;
|
| - FRIEND_TEST_ALL_PREFIXES(InMemoryURLIndexTest, CacheAddRemove);
|
| -
|
| - virtual ~InMemoryURLCacheDatabase();
|
| -
|
| - // Initializes the database and returns true if successful.
|
| - bool InitDatabase();
|
| -
|
| - // Posts the given |task| for sequential execution using a pool task
|
| - // coordinated by |sequence_token_|.
|
| - void PostSequencedDBTask(const tracked_objects::Location& from_here,
|
| - const base::Closure& task);
|
| -
|
| - // Closes the database.
|
| - void ShutdownTask();
|
| -
|
| - // Makes sure the version is up-to-date, updating if necessary. Notify the
|
| - // user if the database is newer than expected.
|
| - sql::InitStatus EnsureCurrentVersion();
|
| -
|
| - // Starts a database transaction.
|
| - void BeginTransactionTask();
|
| -
|
| - // Commits the database transaction if no update operations failed after
|
| - // BeginTransactionTask() was called, otherwise rolls back the transaction.
|
| - // Sends a NOTIFICATION_IN_MEMORY_URL_CACHE_DATABASE_FAILURE notification
|
| - // if the transaction failed.
|
| - void CommitTransactionTask();
|
| -
|
| - // Returns true if all tables exist.
|
| - bool VerifyTables();
|
| -
|
| - // Creates the various tables and indexes returning true if successful.
|
| - bool CreateTables();
|
| -
|
| - // Notifies observers that a failure occurred during a database update
|
| - // operation.
|
| - void NotifyDatabaseFailure();
|
| -
|
| - // Executes |statement|, sets |update_error_| if the statement did not
|
| - // run successfully, and returns true if the statement was run successfully.
|
| - bool RunStatement(sql::Statement* statement);
|
| -
|
| - // Adds information about a new row to the various database tables.
|
| - void AddHistoryToURLsTask(HistoryID history_id, const URLRow& row);
|
| - void AddHistoryToWordHistoryTask(WordID word_id, HistoryID history_id);
|
| - // Note: AddWordToWordsTask is virtual so that it can be overridden by
|
| - // unit tests to simulate database failures.
|
| - virtual void AddWordToWordsTask(WordID word_id, const string16& uni_word);
|
| - void AddWordToCharWordsTask(char16 uni_char, WordID word_id);
|
| - void AddRowWordStartsTask(HistoryID history_id,
|
| - const RowWordStarts& row_word_starts);
|
| -
|
| - // Deletes row information from the various database tables. Returns true if
|
| - // successful.
|
| - void RemoveHistoryIDFromURLsTask(HistoryID history_id);
|
| - void RemoveHistoryIDFromWordHistoryTask(HistoryID history_id);
|
| - void RemoveWordFromWordsTask(WordID word_id);
|
| - void RemoveWordStartsTask(HistoryID history_id);
|
| -
|
| - // Completely replaces all data in the cache with a fresh image. Returns true
|
| - // if successful.
|
| - bool RefreshWords(const URLIndexPrivateData& index_data);
|
| - bool RefreshCharWords(const URLIndexPrivateData& index_data);
|
| - bool RefreshWordHistory(const URLIndexPrivateData& index_data);
|
| - bool RefreshURLs(const URLIndexPrivateData& index_data);
|
| - bool RefreshWordStarts(const URLIndexPrivateData& index_data);
|
| -
|
| - // Restores individual sections of the private data for the InMemoryURLIndex.
|
| - // Returns true if there was data to restore and the restore was successful.
|
| - bool RestoreWords(URLIndexPrivateData* index_data);
|
| - bool RestoreCharWords(URLIndexPrivateData* index_data);
|
| - bool RestoreWordHistory(URLIndexPrivateData* index_data);
|
| - bool RestoreURLs(URLIndexPrivateData* index_data);
|
| - bool RestoreWordStarts(URLIndexPrivateData* index_data);
|
| -
|
| - // Returns the database connection.
|
| - sql::Connection* get_db_for_testing() { return &db_; }
|
| -
|
| - // Sequence token for coordinating database tasks.
|
| - base::SequencedWorkerPool::SequenceToken sequence_token_;
|
| -
|
| - // The database.
|
| - sql::Connection db_;
|
| - sql::MetaTable meta_table_;
|
| - int update_error_;
|
| -
|
| - // Set to true once the shutdown process has begun.
|
| - bool shutdown_;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(InMemoryURLCacheDatabase);
|
| -};
|
| -
|
| -} // namespace history
|
| -
|
| -#endif // CHROME_BROWSER_HISTORY_IN_MEMORY_URL_CACHE_DATABASE_H_
|
|
|