summaryrefslogtreecommitdiffstats
path: root/content/browser/in_process_webkit/dom_storage_context.h
diff options
context:
space:
mode:
Diffstat (limited to 'content/browser/in_process_webkit/dom_storage_context.h')
-rw-r--r--content/browser/in_process_webkit/dom_storage_context.h157
1 files changed, 157 insertions, 0 deletions
diff --git a/content/browser/in_process_webkit/dom_storage_context.h b/content/browser/in_process_webkit/dom_storage_context.h
new file mode 100644
index 0000000..6810453
--- /dev/null
+++ b/content/browser/in_process_webkit/dom_storage_context.h
@@ -0,0 +1,157 @@
+// Copyright (c) 2010 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 CONTENT_BROWSER_IN_PROCESS_WEBKIT_DOM_STORAGE_CONTEXT_H_
+#define CONTENT_BROWSER_IN_PROCESS_WEBKIT_DOM_STORAGE_CONTEXT_H_
+#pragma once
+
+#include <map>
+#include <set>
+
+#include "base/file_path.h"
+#include "base/string16.h"
+#include "base/time.h"
+
+class DOMStorageArea;
+class DOMStorageMessageFilter;
+class DOMStorageNamespace;
+class WebKitContext;
+
+// This is owned by WebKitContext and is all the dom storage information that's
+// shared by all the DOMStorageMessageFilters that share the same profile. The
+// specifics of responsibilities are fairly well documented here and in
+// StorageNamespace and StorageArea. Everything is only to be accessed on the
+// WebKit thread unless noted otherwise.
+//
+// NOTE: Virtual methods facilitate mocking functions for testing.
+class DOMStorageContext {
+ public:
+ explicit DOMStorageContext(WebKitContext* webkit_context);
+ virtual ~DOMStorageContext();
+
+ // Invalid storage id. No storage session will ever report this value.
+ // Used in DOMStorageMessageFilter::OnStorageAreaId when coping with
+ // interactions with non-existent storage sessions.
+ static const int64 kInvalidStorageId = -1;
+
+ // Allocate a new storage area id. Only call on the WebKit thread.
+ int64 AllocateStorageAreaId();
+
+ // Allocate a new session storage id. Only call on the UI or IO thread.
+ int64 AllocateSessionStorageNamespaceId();
+
+ // Clones a session storage namespace and returns the cloned namespaces' id.
+ // Only call on the IO thread.
+ int64 CloneSessionStorage(int64 original_id);
+
+ // Various storage area methods. The storage area is owned by one of the
+ // namespaces that's owned by this class.
+ void RegisterStorageArea(DOMStorageArea* storage_area);
+ void UnregisterStorageArea(DOMStorageArea* storage_area);
+ DOMStorageArea* GetStorageArea(int64 id);
+
+ // Called on WebKit thread when a session storage namespace can be deleted.
+ void DeleteSessionStorageNamespace(int64 namespace_id);
+
+ // Get a namespace from an id. What's returned is owned by this class. If
+ // allocation_allowed is true, then this function will create the storage
+ // namespace if it hasn't been already.
+ DOMStorageNamespace* GetStorageNamespace(int64 id, bool allocation_allowed);
+
+ // Sometimes an event from one DOM storage message filter requires
+ // communication to all of them.
+ typedef std::set<DOMStorageMessageFilter*> MessageFilterSet;
+ void RegisterMessageFilter(DOMStorageMessageFilter* message_filter);
+ void UnregisterMessageFilter(DOMStorageMessageFilter* MessageFilter);
+ const MessageFilterSet* GetMessageFilterSet() const;
+
+ // Tells storage namespaces to purge any memory they do not need.
+ virtual void PurgeMemory();
+
+ // Delete any local storage files that have been touched since the cutoff
+ // date that's supplied.
+ void DeleteDataModifiedSince(const base::Time& cutoff,
+ const char* url_scheme_to_be_skipped,
+ const std::vector<string16>& protected_origins);
+
+ // Deletes a single local storage file.
+ void DeleteLocalStorageFile(const FilePath& file_path);
+
+ // Deletes the local storage file for the given origin.
+ void DeleteLocalStorageForOrigin(const string16& origin_id);
+
+ // Deletes all local storage files.
+ void DeleteAllLocalStorageFiles();
+
+ // The local storage directory.
+ static const FilePath::CharType kLocalStorageDirectory[];
+
+ // The local storage file extension.
+ static const FilePath::CharType kLocalStorageExtension[];
+
+ // Get the file name of the local storage file for the given origin.
+ FilePath GetLocalStorageFilePath(const string16& origin_id) const;
+
+ void set_clear_local_state_on_exit_(bool clear_local_state) {
+ clear_local_state_on_exit_ = clear_local_state;
+ }
+
+#ifdef UNIT_TEST
+ // For unit tests allow to override the |data_path_|.
+ void set_data_path(const FilePath& data_path) { data_path_ = data_path; }
+#endif
+
+ private:
+ // Get the local storage instance. The object is owned by this class.
+ DOMStorageNamespace* CreateLocalStorage();
+
+ // Get a new session storage namespace. The object is owned by this class.
+ DOMStorageNamespace* CreateSessionStorage(int64 namespace_id);
+
+ // Used internally to register storage namespaces we create.
+ void RegisterStorageNamespace(DOMStorageNamespace* storage_namespace);
+
+ // The WebKit thread half of CloneSessionStorage above. Static because
+ // DOMStorageContext isn't ref counted thus we can't use a runnable method.
+ // That said, we know this is safe because this class is destroyed on the
+ // WebKit thread, so there's no way it could be destroyed before this is run.
+ static void CompleteCloningSessionStorage(DOMStorageContext* context,
+ int64 existing_id, int64 clone_id);
+
+ // The last used storage_area_id and storage_namespace_id's. For the storage
+ // namespaces, IDs allocated on the UI thread are positive and count up while
+ // IDs allocated on the IO thread are negative and count down. This allows us
+ // to allocate unique IDs on both without any locking. All storage area ids
+ // are allocated on the WebKit thread.
+ int64 last_storage_area_id_;
+ int64 last_session_storage_namespace_id_on_ui_thread_;
+ int64 last_session_storage_namespace_id_on_io_thread_;
+
+ // True if the destructor should delete its files.
+ bool clear_local_state_on_exit_;
+
+ // Path where the profile data is stored.
+ // TODO(pastarmovj): Keep in mind that unlike indexed db data_path_ variable
+ // this one still has to point to the upper level dir because of the
+ // MigrateLocalStorageDirectory function. Once this function disappears we can
+ // make it point directly to the dom storage path.
+ FilePath data_path_;
+
+ // All the DOMStorageMessageFilters that are attached to us. ONLY USE ON THE
+ // IO THREAD!
+ MessageFilterSet message_filter_set_;
+
+ // Maps ids to StorageAreas. We do NOT own these objects. StorageNamespace
+ // (which does own them) will notify us when we should remove the entries.
+ typedef std::map<int64, DOMStorageArea*> StorageAreaMap;
+ StorageAreaMap storage_area_map_;
+
+ // Maps ids to StorageNamespaces. We own these objects.
+ typedef std::map<int64, DOMStorageNamespace*> StorageNamespaceMap;
+ StorageNamespaceMap storage_namespace_map_;
+
+ DISALLOW_IMPLICIT_CONSTRUCTORS(DOMStorageContext);
+};
+
+#endif // CONTENT_BROWSER_IN_PROCESS_WEBKIT_DOM_STORAGE_CONTEXT_H_