1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
content / browser / file_system_access / file_system_access_handle_base.h [blame]
// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CONTENT_BROWSER_FILE_SYSTEM_ACCESS_FILE_SYSTEM_ACCESS_HANDLE_BASE_H_
#define CONTENT_BROWSER_FILE_SYSTEM_ACCESS_FILE_SYSTEM_ACCESS_HANDLE_BASE_H_
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/sequence_checker.h"
#include "base/thread_annotations.h"
#include "content/browser/file_system_access/file_system_access_lock_manager.h"
#include "content/browser/file_system_access/file_system_access_manager_impl.h"
#include "content/browser/file_system_access/file_system_access_transfer_token_impl.h"
#include "content/common/content_export.h"
#include "content/public/browser/content_browser_client.h"
#include "content/public/browser/file_system_access_permission_context.h"
#include "storage/browser/file_system/file_system_url.h"
#include "third_party/blink/public/mojom/file_system_access/file_system_access_cloud_identifier.mojom.h"
#include "third_party/blink/public/mojom/file_system_access/file_system_access_error.mojom.h"
#include "third_party/blink/public/mojom/permissions/permission_status.mojom.h"
namespace storage {
class FileSystemContext;
} // namespace storage
namespace content {
class WebContents;
class FileSystemAccessSafeMoveHelper;
// Base class for File and Directory handle implementations. Holds data that is
// common to both and (will) deal with functionality that is common as well,
// such as permission requests. Instances of this class should be owned by the
// FileSystemAccessManagerImpl instance passed in to the constructor.
//
// This class is not thread safe, all methods must be called from the same
// sequence. That sequence also has to be the same sequence on which the
// FileSystemAccessPermissionContext expects to be interacted with, which
// is the UI thread.
class CONTENT_EXPORT FileSystemAccessHandleBase {
public:
using BindingContext = FileSystemAccessManagerImpl::BindingContext;
using SharedHandleState = FileSystemAccessManagerImpl::SharedHandleState;
using PermissionStatus = blink::mojom::PermissionStatus;
FileSystemAccessHandleBase(FileSystemAccessManagerImpl* manager,
const BindingContext& context,
const storage::FileSystemURL& url,
const SharedHandleState& handle_state);
FileSystemAccessHandleBase(const FileSystemAccessHandleBase&) = delete;
FileSystemAccessHandleBase& operator=(const FileSystemAccessHandleBase&) =
delete;
~FileSystemAccessHandleBase();
const storage::FileSystemURL& url() const { return url_; }
const SharedHandleState& handle_state() const { return handle_state_; }
const BindingContext& context() const { return context_; }
FileSystemAccessManagerImpl* manager() { return manager_; }
storage::FileSystemContext* file_system_context() {
return manager()->context();
}
PermissionStatus GetReadPermissionStatus();
PermissionStatus GetWritePermissionStatus();
storage::FileSystemURL GetParentURLForTesting() { return GetParentURL(); }
// Implementation for the GetPermissionStatus method in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoGetPermissionStatus(
bool writable,
base::OnceCallback<void(PermissionStatus)> callback);
// Implementation for the RequestPermission method in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoRequestPermission(
bool writable,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr,
PermissionStatus)> callback);
// TODO(crbug.com/40198034): Implement move and rename for directory handles.
// Implementation for the Move method in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoMove(mojo::PendingRemote<blink::mojom::FileSystemAccessTransferToken>
destination_directory,
const std::string& new_entry_name,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)>
callback);
// Implementation for the Rename method in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoRename(const std::string& new_entry_name,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)>
callback);
// Implementation for the Remove and RemoveEntry methods in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoRemove(const storage::FileSystemURL& url,
bool recurse,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)>
callback);
void DidTakeRemoveLock(
const storage::FileSystemURL& url,
bool recurse,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)> callback,
scoped_refptr<FileSystemAccessLockManager::LockHandle> lock);
// Implementation for the GetCloudIdentifiers method in the
// blink::mojom::FileSystemAccessFileHandle and DirectoryHandle interfaces.
void DoGetCloudIdentifiers(
FileSystemAccessPermissionContext::HandleType handle_type,
ContentBrowserClient::GetCloudIdentifiersCallback callback);
// Invokes `callback`, possibly after first requesting write permission. If
// permission isn't granted, `no_permission_callback` is invoked instead. The
// callbacks can be invoked synchronously.
template <typename CallbackArgType>
void RunWithWritePermission(
base::OnceCallback<void(CallbackArgType)> callback,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr,
CallbackArgType)> no_permission_callback,
CallbackArgType callback_arg);
protected:
virtual base::WeakPtr<FileSystemAccessHandleBase> AsWeakPtr() = 0;
SEQUENCE_CHECKER(sequence_checker_);
private:
storage::FileSystemURL GetParentURL();
void DidRequestPermission(
bool writable,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr,
PermissionStatus)> callback,
FileSystemAccessPermissionGrant::PermissionRequestOutcome outcome);
void DidResolveTokenToMove(
const std::string& new_entry_name,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)> callback,
FileSystemAccessTransferTokenImpl* resolved_token);
void PrepareForMove(
storage::FileSystemURL destination_url,
bool has_write_access_to_destination,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)>
callback);
void DidTakeMoveLocks(
storage::FileSystemURL destination_url,
bool has_transient_user_activation,
bool has_write_access_to_destination,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)> callback,
std::vector<scoped_refptr<FileSystemAccessLockManager::LockHandle>>
locks);
// Only called if the move operation is not allowed to overwrite the target.
void ConfirmMoveWillNotOverwriteDestination(
const storage::FileSystemURL& destination_url,
std::vector<scoped_refptr<FileSystemAccessLockManager::LockHandle>> locks,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)> callback,
base::File::Error result);
void DoPerformMoveOperation(
const storage::FileSystemURL& destination_url,
std::vector<scoped_refptr<FileSystemAccessLockManager::LockHandle>> locks,
bool has_transient_user_activation,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)>
callback);
void DidMove(
storage::FileSystemURL destination_url,
std::vector<scoped_refptr<FileSystemAccessLockManager::LockHandle>> locks,
std::unique_ptr<FileSystemAccessSafeMoveHelper> move_helper,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr)> callback,
blink::mojom::FileSystemAccessErrorPtr result);
bool ShouldTrackUsage(const storage::FileSystemURL& url) const {
DCHECK_CALLED_ON_VALID_SEQUENCE(sequence_checker_);
return url.type() != storage::kFileSystemTypeTemporary &&
url.type() != storage::kFileSystemTypeTest;
}
// The FileSystemAccessManagerImpl that owns this instance.
const raw_ptr<FileSystemAccessManagerImpl, DanglingUntriaged> manager_ =
nullptr;
base::WeakPtr<WebContents> web_contents_
GUARDED_BY_CONTEXT(sequence_checker_);
const BindingContext context_;
storage::FileSystemURL url_ GUARDED_BY_CONTEXT(sequence_checker_);
const SharedHandleState handle_state_;
};
template <typename CallbackArgType>
void FileSystemAccessHandleBase::RunWithWritePermission(
base::OnceCallback<void(CallbackArgType)> callback,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr,
CallbackArgType)> no_permission_callback,
CallbackArgType callback_arg) {
DCHECK_CALLED_ON_VALID_SEQUENCE(sequence_checker_);
DoRequestPermission(
/*writable=*/true,
base::BindOnce(
[](base::OnceCallback<void(CallbackArgType)> callback,
base::OnceCallback<void(blink::mojom::FileSystemAccessErrorPtr,
CallbackArgType)> no_permission_callback,
CallbackArgType callback_arg,
blink::mojom::FileSystemAccessErrorPtr result,
blink::mojom::PermissionStatus status) {
if (status == blink::mojom::PermissionStatus::GRANTED) {
std::move(callback).Run(std::move(callback_arg));
return;
}
if (result->status == blink::mojom::FileSystemAccessStatus::kOk) {
result->status =
blink::mojom::FileSystemAccessStatus::kPermissionDenied;
}
std::move(no_permission_callback)
.Run(std::move(result), std::move(callback_arg));
},
std::move(callback), std::move(no_permission_callback),
std::move(callback_arg)));
}
} // namespace content
#endif // CONTENT_BROWSER_FILE_SYSTEM_ACCESS_FILE_SYSTEM_ACCESS_HANDLE_BASE_H_