1// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CONTENT_PUBLIC_BROWSER_STORAGE_PARTITION_H_
6#define CONTENT_PUBLIC_BROWSER_STORAGE_PARTITION_H_
7
8#include <string>
9
10#include "base/basictypes.h"
11#include "base/callback_forward.h"
12#include "base/files/file_path.h"
13#include "base/time/time.h"
14#include "content/common/content_export.h"
15
16class GURL;
17
18namespace base {
19class Time;
20}
21
22namespace storage {
23class FileSystemContext;
24}
25
26namespace net {
27class URLRequestContextGetter;
28}
29
30namespace storage {
31class QuotaManager;
32class SpecialStoragePolicy;
33}
34
35namespace storage {
36class DatabaseTracker;
37}
38
39namespace content {
40
41class AppCacheService;
42class BrowserContext;
43class IndexedDBContext;
44class DOMStorageContext;
45class ServiceWorkerContext;
46
47// Defines what persistent state a child process can access.
48//
49// The StoragePartition defines the view each child process has of the
50// persistent state inside the BrowserContext. This is used to implement
51// isolated storage where a renderer with isolated storage cannot see
52// the cookies, localStorage, etc., that normal web renderers have access to.
53class CONTENT_EXPORT StoragePartition {
54 public:
55  virtual base::FilePath GetPath() = 0;
56  virtual net::URLRequestContextGetter* GetURLRequestContext() = 0;
57  virtual net::URLRequestContextGetter* GetMediaURLRequestContext() = 0;
58  virtual storage::QuotaManager* GetQuotaManager() = 0;
59  virtual AppCacheService* GetAppCacheService() = 0;
60  virtual storage::FileSystemContext* GetFileSystemContext() = 0;
61  virtual storage::DatabaseTracker* GetDatabaseTracker() = 0;
62  virtual DOMStorageContext* GetDOMStorageContext() = 0;
63  virtual IndexedDBContext* GetIndexedDBContext() = 0;
64  virtual ServiceWorkerContext* GetServiceWorkerContext() = 0;
65
66  static const uint32 REMOVE_DATA_MASK_APPCACHE        = 1 << 0;
67  static const uint32 REMOVE_DATA_MASK_COOKIES         = 1 << 1;
68  static const uint32 REMOVE_DATA_MASK_FILE_SYSTEMS    = 1 << 2;
69  static const uint32 REMOVE_DATA_MASK_INDEXEDDB       = 1 << 3;
70  static const uint32 REMOVE_DATA_MASK_LOCAL_STORAGE   = 1 << 4;
71  static const uint32 REMOVE_DATA_MASK_SHADER_CACHE    = 1 << 5;
72  static const uint32 REMOVE_DATA_MASK_WEBSQL          = 1 << 6;
73  static const uint32 REMOVE_DATA_MASK_WEBRTC_IDENTITY = 1 << 7;
74  static const uint32 REMOVE_DATA_MASK_SERVICE_WORKERS = 1 << 8;
75  static const uint32 REMOVE_DATA_MASK_ALL             = 0xFFFFFFFF;
76
77  // Corresponds to storage::kStorageTypeTemporary.
78  static const uint32 QUOTA_MANAGED_STORAGE_MASK_TEMPORARY  = 1 << 0;
79  // Corresponds to storage::kStorageTypePersistent.
80  static const uint32 QUOTA_MANAGED_STORAGE_MASK_PERSISTENT = 1 << 1;
81  // Corresponds to storage::kStorageTypeSyncable.
82  static const uint32 QUOTA_MANAGED_STORAGE_MASK_SYNCABLE   = 1 << 2;
83  static const uint32 QUOTA_MANAGED_STORAGE_MASK_ALL        = 0xFFFFFFFF;
84
85  // Starts an asynchronous task that does a best-effort clear the data
86  // corresponding to the given |remove_mask| and |quota_storage_remove_mask|
87  // inside this StoragePartition for the given |storage_origin|.
88  // Note session dom storage is not cleared even if you specify
89  // REMOVE_DATA_MASK_LOCAL_STORAGE.
90  // |callback| is called when data deletion is done or at least the deletion is
91  // scheduled.
92  //
93  // TODO(ajwong): Right now, the embedder may have some
94  // URLRequestContextGetter objects that the StoragePartition does not know
95  // about.  This will no longer be the case when we resolve
96  // http://crbug.com/159193. Remove |request_context_getter| when that bug
97  // is fixed.
98  virtual void ClearDataForOrigin(uint32 remove_mask,
99                                  uint32 quota_storage_remove_mask,
100                                  const GURL& storage_origin,
101                                  net::URLRequestContextGetter* rq_context,
102                                  const base::Closure& callback) = 0;
103
104  // A callback type to check if a given origin matches a storage policy.
105  // Can be passed empty/null where used, which means the origin will always
106  // match.
107  typedef base::Callback<bool(const GURL&, storage::SpecialStoragePolicy*)>
108      OriginMatcherFunction;
109
110  // Similar to ClearDataForOrigin().
111  // Deletes all data out fo the StoragePartition if |storage_origin| is NULL.
112  // |origin_matcher| is present if special storage policy is to be handled,
113  // otherwise the callback can be null (base::Callback::is_null() == true).
114  // |callback| is called when data deletion is done or at least the deletion is
115  // scheduled.
116  virtual void ClearData(uint32 remove_mask,
117                         uint32 quota_storage_remove_mask,
118                         const GURL& storage_origin,
119                         const OriginMatcherFunction& origin_matcher,
120                         const base::Time begin,
121                         const base::Time end,
122                         const base::Closure& callback) = 0;
123
124 protected:
125  virtual ~StoragePartition() {}
126};
127
128}  // namespace content
129
130#endif  // CONTENT_PUBLIC_BROWSER_STORAGE_PARTITION_H_
131