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 #pragma once | 7 #pragma once |
8 | 8 |
9 #include <string> | 9 #include <string> |
10 | 10 |
11 #include "chrome/browser/shell_integration.h" | |
12 | |
11 class GURL; | 13 class GURL; |
12 class PrefService; | 14 class PrefService; |
13 | 15 |
14 namespace base { | 16 namespace base { |
15 class DictionaryValue; | 17 class DictionaryValue; |
16 } | 18 } |
17 | 19 |
18 class ExternalProtocolHandler { | 20 class ExternalProtocolHandler { |
19 public: | 21 public: |
20 enum BlockState { | 22 enum BlockState { |
21 DONT_BLOCK, | 23 DONT_BLOCK, |
22 BLOCK, | 24 BLOCK, |
23 UNKNOWN, | 25 UNKNOWN, |
24 }; | 26 }; |
25 | 27 |
28 // Delegate to allow unit testing to provide different behavior. | |
29 class Delegate { | |
30 public: | |
31 virtual ShellIntegration::DefaultProtocolClientWorker* CreateShellWorker( | |
32 ShellIntegration::DefaultWebClientObserver* observer, | |
33 const std::string& protocol) = 0; | |
34 virtual BlockState GetBlockState(const std::string& scheme) = 0; | |
35 virtual void BlockRequest() = 0; | |
36 virtual void RunExternalProtocolDialog(const GURL& url, | |
37 int render_process_host_id, | |
38 int routing_id) = 0; | |
39 virtual void LaunchUrlWithoutSecurityCheck(const GURL& url) = 0; | |
40 virtual void FinishedProcessingCheck() = 0; | |
41 virtual ~Delegate() {} | |
tony
2011/09/22 17:34:38
Does clang complain about this destructor? I thou
benwells
2011/09/23 00:29:51
try success on linux_clang and mac trybots, so it
| |
42 }; | |
43 | |
26 // Returns whether we should block a given scheme. | 44 // Returns whether we should block a given scheme. |
27 static BlockState GetBlockState(const std::string& scheme); | 45 static BlockState GetBlockState(const std::string& scheme); |
28 | 46 |
29 // Sets whether we should block a given scheme. | 47 // Sets whether we should block a given scheme. |
30 static void SetBlockState(const std::string& scheme, BlockState state); | 48 static void SetBlockState(const std::string& scheme, BlockState state); |
31 | 49 |
32 // Checks to see if the protocol is allowed, if it is whitelisted, | 50 // Checks to see if the protocol is allowed, if it is whitelisted, |
33 // the application associated with the protocol is launched on the io thread, | 51 // the application associated with the protocol is launched on the io thread, |
34 // if it is blacklisted, returns silently. Otherwise, an | 52 // if it is blacklisted, returns silently. Otherwise, an |
35 // ExternalProtocolDialog is created asking the user. If the user accepts, | 53 // ExternalProtocolDialog is created asking the user. If the user accepts, |
36 // LaunchUrlWithoutSecurityCheck is called on the io thread and the | 54 // LaunchUrlWithoutSecurityCheck is called on the io thread and the |
37 // application is launched. | 55 // application is launched. |
38 // Must run on the UI thread. | 56 // Must run on the UI thread. |
39 static void LaunchUrl(const GURL& url, int render_process_host_id, | 57 static void LaunchUrl(const GURL& url, int render_process_host_id, |
40 int tab_contents_id); | 58 int tab_contents_id) { |
59 LaunchUrlWithDelegate(url, render_process_host_id, tab_contents_id, NULL); | |
60 } | |
61 | |
62 // Version of LaunchUrl allowing use of a delegate to facilitate unit | |
63 // testing. | |
64 static void LaunchUrlWithDelegate(const GURL& url, int render_process_host_id, | |
65 int tab_contents_id, Delegate* delegate); | |
41 | 66 |
42 // Creates and runs a External Protocol dialog box. | 67 // Creates and runs a External Protocol dialog box. |
43 // |url| - The url of the request. | 68 // |url| - The url of the request. |
44 // |render_process_host_id| and |routing_id| are used by | 69 // |render_process_host_id| and |routing_id| are used by |
45 // tab_util::GetTabContentsByID to aquire the tab contents associated with | 70 // tab_util::GetTabContentsByID to aquire the tab contents associated with |
46 // this dialog. | 71 // this dialog. |
47 // NOTE: There is a race between the Time of Check and the Time Of Use for | 72 // NOTE: There is a race between the Time of Check and the Time Of Use for |
48 // the command line. Since the caller (web page) does not have access | 73 // the command line. Since the caller (web page) does not have access |
49 // to change the command line by itself, we do not do anything special | 74 // to change the command line by itself, we do not do anything special |
50 // to protect against this scenario. | 75 // to protect against this scenario. |
(...skipping 21 matching lines...) Expand all Loading... | |
72 static void PrepopulateDictionary(base::DictionaryValue* win_pref); | 97 static void PrepopulateDictionary(base::DictionaryValue* win_pref); |
73 | 98 |
74 // Allows LaunchUrl to proceed with launching an external protocol handler. | 99 // Allows LaunchUrl to proceed with launching an external protocol handler. |
75 // This is typically triggered by a user gesture, but is also called for | 100 // This is typically triggered by a user gesture, but is also called for |
76 // each extension API function. Note that each call to LaunchUrl resets | 101 // each extension API function. Note that each call to LaunchUrl resets |
77 // the state to false (not allowed). | 102 // the state to false (not allowed). |
78 static void PermitLaunchUrl(); | 103 static void PermitLaunchUrl(); |
79 }; | 104 }; |
80 | 105 |
81 #endif // CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ | 106 #endif // CHROME_BROWSER_EXTERNAL_PROTOCOL_EXTERNAL_PROTOCOL_HANDLER_H_ |
OLD | NEW |