OLD | NEW |
---|---|
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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 CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ | 5 #ifndef CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ |
6 #define CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ | 6 #define CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/macros.h" | 10 #include "base/macros.h" |
11 #include "chrome/browser/shell_integration.h" | 11 #include "chrome/browser/shell_integration.h" |
12 #include "content/public/browser/web_contents.h" | |
12 #include "ui/base/page_transition_types.h" | 13 #include "ui/base/page_transition_types.h" |
13 | 14 |
15 | |
alexmos
2016/12/01 19:21:14
nit: no blank line
davidsac (gone - try alexmos)
2016/12/12 19:15:47
Done.
| |
14 class GURL; | 16 class GURL; |
15 class PrefRegistrySimple; | 17 class PrefRegistrySimple; |
16 | 18 |
17 namespace base { | 19 namespace base { |
18 class DictionaryValue; | 20 class DictionaryValue; |
19 } | 21 } |
20 | 22 |
21 class ExternalProtocolHandler { | 23 class ExternalProtocolHandler { |
22 public: | 24 public: |
23 enum BlockState { | 25 enum BlockState { |
(...skipping 10 matching lines...) Expand all Loading... | |
34 const shell_integration::DefaultWebClientWorkerCallback& callback, | 36 const shell_integration::DefaultWebClientWorkerCallback& callback, |
35 const std::string& protocol) = 0; | 37 const std::string& protocol) = 0; |
36 virtual BlockState GetBlockState(const std::string& scheme) = 0; | 38 virtual BlockState GetBlockState(const std::string& scheme) = 0; |
37 virtual void BlockRequest() = 0; | 39 virtual void BlockRequest() = 0; |
38 virtual void RunExternalProtocolDialog( | 40 virtual void RunExternalProtocolDialog( |
39 const GURL& url, | 41 const GURL& url, |
40 int render_process_host_id, | 42 int render_process_host_id, |
41 int routing_id, | 43 int routing_id, |
42 ui::PageTransition page_transition, | 44 ui::PageTransition page_transition, |
43 bool has_user_gesture) = 0; | 45 bool has_user_gesture) = 0; |
44 virtual void LaunchUrlWithoutSecurityCheck(const GURL& url) = 0; | 46 virtual void LaunchUrlWithoutSecurityCheck( |
47 const GURL& url, | |
48 content::WebContents* web_contents) = 0; | |
45 virtual void FinishedProcessingCheck() = 0; | 49 virtual void FinishedProcessingCheck() = 0; |
46 virtual ~Delegate() {} | 50 virtual ~Delegate() {} |
47 }; | 51 }; |
48 | 52 |
49 // Returns whether we should block a given scheme. | 53 // Returns whether we should block a given scheme. |
50 static BlockState GetBlockState(const std::string& scheme); | 54 static BlockState GetBlockState(const std::string& scheme); |
51 | 55 |
52 // Sets whether we should block a given scheme. | 56 // Sets whether we should block a given scheme. |
53 static void SetBlockState(const std::string& scheme, BlockState state); | 57 static void SetBlockState(const std::string& scheme, BlockState state); |
54 | 58 |
55 // Checks to see if the protocol is allowed, if it is whitelisted, | 59 // Checks to see if the protocol is allowed, if it is whitelisted, |
56 // the application associated with the protocol is launched on the io thread, | 60 // the application associated with the protocol is launched on the io thread, |
57 // if it is blacklisted, returns silently. Otherwise, an | 61 // if it is blacklisted, returns silently. Otherwise, an |
58 // ExternalProtocolDialog is created asking the user. If the user accepts, | 62 // ExternalProtocolDialog is created asking the user. If the user accepts, |
59 // LaunchUrlWithoutSecurityCheck is called on the io thread and the | 63 // LaunchUrlWithoutSecurityCheck is called on the io thread and the |
60 // application is launched. | 64 // application is launched. |
61 // Must run on the UI thread. | 65 // Must run on the UI thread. |
62 // Allowing use of a delegate to facilitate unit testing. | 66 // Allowing use of a delegate to facilitate unit testing. |
63 static void LaunchUrlWithDelegate(const GURL& url, | 67 static void LaunchUrlWithDelegate(const GURL& url, |
64 int render_process_host_id, | 68 int render_process_host_id, |
65 int tab_contents_id, | 69 int tab_contents_id, |
66 ui::PageTransition page_transition, | 70 ui::PageTransition page_transition, |
67 bool has_user_gesture, | 71 bool has_user_gesture, |
68 Delegate* delegate); | 72 Delegate* delegate); |
69 | 73 |
70 // Starts a url using the external protocol handler with the help | 74 // Starts a url using the external protocol handler with the help |
71 // of shellexecute. Should only be called if the protocol is whitelisted | 75 // of shellexecute. Should only be called if the protocol is whitelisted |
72 // (checked in LaunchUrl) or if the user explicitly allows it. (By selecting | 76 // (checked in LaunchUrl) or if the user explicitly allows it. (By selecting |
73 // "Launch Application" in an ExternalProtocolDialog.) It is assumed that the | 77 // "Launch Application" in an ExternalProtocolDialog.) It is assumed that the |
alexmos
2016/12/01 19:21:14
Side note: it would probably be good to (manually)
davidsac (gone - try alexmos)
2016/12/12 19:15:47
Done.
| |
74 // url has already been escaped, which happens in LaunchUrl. | 78 // url has already been escaped, which happens in LaunchUrl. |
75 // NOTE: You should Not call this function directly unless you are sure the | 79 // NOTE: You should Not call this function directly unless you are sure the |
76 // url you have has been checked against the blacklist, and has been escaped. | 80 // url you have has been checked against the blacklist, and has been escaped. |
77 // All calls to this function should originate in some way from LaunchUrl. | 81 // All calls to this function should originate in some way from LaunchUrl. |
78 static void LaunchUrlWithoutSecurityCheck(const GURL& url, | 82 static void LaunchUrlWithoutSecurityCheck(const GURL& url, |
79 int render_process_host_id, | 83 content::WebContents* web_contents); |
80 int tab_contents_id); | |
81 | 84 |
82 // Allows LaunchUrl to proceed with launching an external protocol handler. | 85 // Allows LaunchUrl to proceed with launching an external protocol handler. |
83 // This is typically triggered by a user gesture, but is also called for | 86 // This is typically triggered by a user gesture, but is also called for |
84 // each extension API function. Note that each call to LaunchUrl resets | 87 // each extension API function. Note that each call to LaunchUrl resets |
85 // the state to false (not allowed). | 88 // the state to false (not allowed). |
86 static void PermitLaunchUrl(); | 89 static void PermitLaunchUrl(); |
87 | 90 |
88 // Prepopulates the dictionary with known protocols to deny or allow, if | 91 // Prepopulates the dictionary with known protocols to deny or allow, if |
89 // preferences for them do not already exist. | 92 // preferences for them do not already exist. |
90 static void PrepopulateDictionary(base::DictionaryValue* win_pref); | 93 static void PrepopulateDictionary(base::DictionaryValue* win_pref); |
(...skipping 19 matching lines...) Expand all Loading... | |
110 int render_process_host_id, | 113 int render_process_host_id, |
111 int routing_id, | 114 int routing_id, |
112 ui::PageTransition page_transition, | 115 ui::PageTransition page_transition, |
113 bool has_user_gesture); | 116 bool has_user_gesture); |
114 | 117 |
115 private: | 118 private: |
116 DISALLOW_COPY_AND_ASSIGN(ExternalProtocolHandler); | 119 DISALLOW_COPY_AND_ASSIGN(ExternalProtocolHandler); |
117 }; | 120 }; |
118 | 121 |
119 #endif // CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ | 122 #endif // CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ |
OLD | NEW |