Chromium Code Reviews| 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/09/02 11:36:41
Let's drop "Batch" has a name. It's really odd.
A
Lalit Maganti
2015/09/02 14:24:51
Done.
| |
| 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( | |
|
mlamouri (slow - plz ping)
2015/09/02 11:36:41
I would tend to say that you can add an 's' here.
Lalit Maganti
2015/09/02 14:24:51
Done.
| |
| 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 |