diff options
author | initial.commit <initial.commit@0039d316-1c4b-4281-b951-d872f2087c98> | 2008-07-26 23:55:29 +0000 |
---|---|---|
committer | initial.commit <initial.commit@0039d316-1c4b-4281-b951-d872f2087c98> | 2008-07-26 23:55:29 +0000 |
commit | 09911bf300f1a419907a9412154760efd0b7abc3 (patch) | |
tree | f131325fb4e2ad12c6d3504ab75b16dd92facfed /chrome/browser/external_protocol_handler.h | |
parent | 586acc5fe142f498261f52c66862fa417c3d52d2 (diff) | |
download | chromium_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.h | 78 |
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__ |