summaryrefslogtreecommitdiffstats
path: root/chrome/browser/external_protocol_handler.h
diff options
context:
space:
mode:
authorinitial.commit <initial.commit@0039d316-1c4b-4281-b951-d872f2087c98>2008-07-26 23:55:29 +0000
committerinitial.commit <initial.commit@0039d316-1c4b-4281-b951-d872f2087c98>2008-07-26 23:55:29 +0000
commit09911bf300f1a419907a9412154760efd0b7abc3 (patch)
treef131325fb4e2ad12c6d3504ab75b16dd92facfed /chrome/browser/external_protocol_handler.h
parent586acc5fe142f498261f52c66862fa417c3d52d2 (diff)
downloadchromium_src-09911bf300f1a419907a9412154760efd0b7abc3.zip
chromium_src-09911bf300f1a419907a9412154760efd0b7abc3.tar.gz
chromium_src-09911bf300f1a419907a9412154760efd0b7abc3.tar.bz2
Add chrome to the repository.
git-svn-id: svn://svn.chromium.org/chrome/trunk/src@15 0039d316-1c4b-4281-b951-d872f2087c98
Diffstat (limited to 'chrome/browser/external_protocol_handler.h')
-rw-r--r--chrome/browser/external_protocol_handler.h78
1 files changed, 78 insertions, 0 deletions
diff --git a/chrome/browser/external_protocol_handler.h b/chrome/browser/external_protocol_handler.h
new file mode 100644
index 0000000..b595c28
--- /dev/null
+++ b/chrome/browser/external_protocol_handler.h
@@ -0,0 +1,78 @@
+// Copyright 2008, Google Inc.
+// All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+// * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+// * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+// * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+#include "chrome/common/pref_service.h"
+#include "googleurl/src/gurl.h"
+
+#ifndef CHROME_BROWSER_EXTERNAL_PROTOCOL_HANDLER_H__
+#define CHROME_BROWSER_EXTERNAL_PROTOCOL_HANDLER_H__
+
+class MessageLoop;
+
+class ExternalProtocolHandler {
+ public:
+ enum BlockState {
+ DONT_BLOCK,
+ BLOCK,
+ UNKNOWN,
+ };
+
+ // Returns whether we should block a given scheme.
+ static BlockState GetBlockState(const std::wstring& scheme);
+
+ // Checks to see if the protocol is allowed, if it is whitelisted,
+ // the application associated with the protocol is launched on the io thread,
+ // if it is blacklisted, returns silently. Otherwise, an
+ // ExternalProtocolDialog is created asking the user. If the user accepts,
+ // LaunchUrlWithoutSecurityCheck is called on the io thread and the
+ // application is launched.
+ // Must run on the UI thread.
+ static void LaunchUrl(const GURL& url, int render_process_host_id,
+ int tab_contents_id);
+
+ // Register the ExcludedSchemes preference.
+ static void RegisterPrefs(PrefService* prefs);
+
+ // Starts a url using the external protocol handler with the help
+ // of shellexecute. Should only be called if the protocol is whitelisted
+ // (checked in LaunchUrl) or if the user explicitly allows it. (By selecting
+ // "Launch Application" in an ExternalProtocolDialog.) It is assumed that the
+ // url has already been escaped, which happens in LaunchUrl.
+ // NOTE: You should Not call this function directly unless you are sure the
+ // url you have has been checked against the blacklist, and has been escaped.
+ // All calls to this function should originate in some way from LaunchUrl.
+ // Must run on the IO thread.
+ static void LaunchUrlWithoutSecurityCheck(const GURL& url);
+
+ // Prepopulates the dictionary with known protocols to deny or allow, if
+ // preferences for them do not already exist.
+ static void PrepopulateDictionary(DictionaryValue* win_pref);
+};
+
+#endif CHROME_BROWSER_EXTERNAL_PROTOCOL_HANDLER_H__