OLD | NEW |
---|---|
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 5 #ifndef CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
6 #define CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 6 #define CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
7 | 7 |
8 #include "content/common/content_export.h" | 8 #include "content/common/content_export.h" |
9 #include "content/public/common/permission_status.mojom.h" | 9 #include "content/public/common/permission_status.mojom.h" |
10 | 10 |
11 class GURL; | 11 class GURL; |
12 | 12 |
13 namespace content { | 13 namespace content { |
14 enum class PermissionType; | 14 enum class PermissionType; |
15 class RenderFrameHost; | 15 class RenderFrameHost; |
16 | 16 |
17 // This class allows the content layer to manipulate permissions. It has to be | 17 // This class allows the content layer to manipulate permissions. It has to be |
18 // implemented by the embedder which ultimately handles the permission | 18 // implemented by the embedder which ultimately handles the permission |
19 // management for the content layer. | 19 // management for the content layer. |
20 class CONTENT_EXPORT PermissionManager { | 20 class CONTENT_EXPORT PermissionManager { |
21 public: | 21 public: |
22 virtual ~PermissionManager() = default; | 22 virtual ~PermissionManager() = default; |
23 using RequestCallback = base::Callback<void(PermissionStatus)>; | |
24 using BatchRequestCallback = | |
mlamouri (slow - plz ping)
2015/08/21 10:24:41
nit: I'm not sure which one I prefer between Batch
Lalit Maganti
2015/08/21 12:56:00
I really don't like either of them. I'd rather try
| |
25 base::Callback<void(const std::vector<PermissionStatus>&)>; | |
23 | 26 |
24 // Requests a permission on behalf of a frame identified by render_frame_host. | 27 // Requests a permission on behalf of a frame identified by render_frame_host. |
25 // The |request_id| is an identifier that can later be used if the request is | 28 // The |request_id| is an identifier that can later be used if the request is |
26 // cancelled (see CancelPermissionRequest). | 29 // cancelled (see CancelPermissionRequest). |
27 // When the permission request is handled, whether it failed, timed out or | 30 // When the permission request is handled, whether it failed, timed out or |
28 // succeeded, the |callback| will be run. | 31 // succeeded, the |callback| will be run. |
29 virtual void RequestPermission( | 32 virtual void RequestPermission( |
30 PermissionType permission, | 33 PermissionType permission, |
31 RenderFrameHost* render_frame_host, | 34 RenderFrameHost* render_frame_host, |
32 int request_id, | 35 int request_id, |
33 const GURL& requesting_origin, | 36 const GURL& requesting_origin, |
34 bool user_gesture, | 37 bool user_gesture, |
35 const base::Callback<void(PermissionStatus)>& callback) = 0; | 38 const RequestCallback& callback) = 0; |
39 | |
40 // Requests multiple permissions on behalf of a frame identified by | |
41 // render_frame_host. | |
42 // The |request_id| is an identifier that can later be used if the request is | |
43 // cancelled (see CancelPermissionRequest). | |
44 // When the permission request is handled, whether it failed, timed out or | |
45 // succeeded, the |callback| will be run. | |
46 virtual void RequestPermission( | |
47 const std::vector<PermissionType>& permission, | |
48 RenderFrameHost* render_frame_host, | |
49 int request_id, | |
50 const GURL& requesting_origin, | |
51 bool user_gesture, | |
52 const BatchRequestCallback& callback) = 0; | |
36 | 53 |
37 // Cancels a previously requested permission. The given parameter must match | 54 // Cancels a previously requested permission. The given parameter must match |
38 // the ones passed to the RequestPermission call. | 55 // the ones passed to a RequestPermission call. |
39 virtual void CancelPermissionRequest(PermissionType permission, | 56 virtual void CancelPermissionRequest(RenderFrameHost* render_frame_host, |
40 RenderFrameHost* render_frame_host, | 57 int request_id) = 0; |
41 int request_id, | |
42 const GURL& requesting_origin) = 0; | |
43 | 58 |
44 // Returns the permission status of a given requesting_origin/embedding_origin | 59 // Returns the permission status of a given requesting_origin/embedding_origin |
45 // tuple. This is not taking a RenderFrameHost because the call might happen | 60 // tuple. This is not taking a RenderFrameHost because the call might happen |
46 // outside of a frame context. | 61 // outside of a frame context. |
47 virtual PermissionStatus GetPermissionStatus( | 62 virtual PermissionStatus GetPermissionStatus( |
48 PermissionType permission, | 63 PermissionType permission, |
49 const GURL& requesting_origin, | 64 const GURL& requesting_origin, |
50 const GURL& embedding_origin) = 0; | 65 const GURL& embedding_origin) = 0; |
51 | 66 |
52 // Sets the permission back to its default for the requesting_origin/ | 67 // Sets the permission back to its default for the requesting_origin/ |
(...skipping 19 matching lines...) Expand all Loading... | |
72 | 87 |
73 // Unregisters from permission status change notifications. | 88 // Unregisters from permission status change notifications. |
74 // The |subscription_id| must match the value returned by the | 89 // The |subscription_id| must match the value returned by the |
75 // SubscribePermissionStatusChange call. | 90 // SubscribePermissionStatusChange call. |
76 virtual void UnsubscribePermissionStatusChange(int subscription_id) = 0; | 91 virtual void UnsubscribePermissionStatusChange(int subscription_id) = 0; |
77 }; | 92 }; |
78 | 93 |
79 } // namespace content | 94 } // namespace content |
80 | 95 |
81 #endif // CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ | 96 #endif // CONTENT_PUBLIC_BROWSER_PERMISSION_MANAGER_H_ |
OLD | NEW |