summaryrefslogtreecommitdiffstats
path: root/content/browser/browser_url_handler.h
diff options
context:
space:
mode:
authorjam@chromium.org <jam@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>2011-07-13 22:03:25 +0000
committerjam@chromium.org <jam@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>2011-07-13 22:03:25 +0000
commitb8148acb28b24d50a9fce75a6d1295270d85eb17 (patch)
treeb1c1620501ddbce5a0ea9bea9701a06dabe89938 /content/browser/browser_url_handler.h
parentf5dae026e4f245c8d40155131b8d676ed8084d37 (diff)
downloadchromium_src-b8148acb28b24d50a9fce75a6d1295270d85eb17.zip
chromium_src-b8148acb28b24d50a9fce75a6d1295270d85eb17.tar.gz
chromium_src-b8148acb28b24d50a9fce75a6d1295270d85eb17.tar.bz2
Move BrowserURLHandler to content, and keep the Chrome specific ones in Chrome.
BUG=76697 Review URL: http://codereview.chromium.org/7351020 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@92427 0039d316-1c4b-4281-b951-d872f2087c98
Diffstat (limited to 'content/browser/browser_url_handler.h')
-rw-r--r--content/browser/browser_url_handler.h71
1 files changed, 71 insertions, 0 deletions
diff --git a/content/browser/browser_url_handler.h b/content/browser/browser_url_handler.h
new file mode 100644
index 0000000..dc86a72
--- /dev/null
+++ b/content/browser/browser_url_handler.h
@@ -0,0 +1,71 @@
+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// We handle some special browser-level URLs (like "about:version")
+// before they're handed to a renderer. This lets us do the URL handling
+// on the browser side (which has access to more information than the
+// renderers do) as well as sidestep the risk of exposing data to
+// random web pages (because from the resource loader's perspective, these
+// URL schemes don't exist).
+
+#ifndef CONTENT_BROWSER_BROWSER_URL_HANDLER_H_
+#define CONTENT_BROWSER_BROWSER_URL_HANDLER_H_
+#pragma once
+
+#include <vector>
+#include <utility>
+
+#include "base/gtest_prod_util.h"
+#include "base/memory/singleton.h"
+
+class GURL;
+class Profile;
+
+// BrowserURLHandler manages the list of all special URLs and manages
+// dispatching the URL handling to registered handlers.
+class BrowserURLHandler {
+ public:
+ // The type of functions that can process a URL.
+ // If a handler handles |url|, it should :
+ // - optionally modify |url| to the URL that should be sent to the renderer
+ // If the URL is not handled by a handler, it should return false.
+ typedef bool (*URLHandler)(GURL* url, Profile* profile);
+
+ // Returns the singleton instance.
+ static BrowserURLHandler* GetInstance();
+
+ // RewriteURLIfNecessary gives all registered URLHandlers a shot at processing
+ // the given URL, and modifies it in place.
+ // If the original URL needs to be adjusted if the modified URL is redirected,
+ // this function sets |reverse_on_redirect| to true.
+ void RewriteURLIfNecessary(GURL* url, Profile* profile,
+ bool* reverse_on_redirect);
+
+ // Reverses the rewriting that was done for |original| using the new |url|.
+ bool ReverseURLRewrite(GURL* url, const GURL& original,
+ Profile* profile);
+
+ // Add the specified handler pair to the list of URL handlers.
+ void AddHandlerPair(URLHandler handler, URLHandler reverse_handler);
+
+ // Returns the null handler for use with |AddHandlerPair()|.
+ static URLHandler null_handler();
+
+ private:
+ // This object is a singleton:
+ BrowserURLHandler();
+ ~BrowserURLHandler();
+ friend struct DefaultSingletonTraits<BrowserURLHandler>;
+
+ // The list of known URLHandlers, optionally with reverse-rewriters.
+ typedef std::pair<URLHandler, URLHandler> HandlerPair;
+ std::vector<HandlerPair> url_handlers_;
+
+ FRIEND_TEST_ALL_PREFIXES(BrowserURLHandlerTest, BasicRewriteAndReverse);
+ FRIEND_TEST_ALL_PREFIXES(BrowserURLHandlerTest, NullHandlerReverse);
+
+ DISALLOW_COPY_AND_ASSIGN(BrowserURLHandler);
+};
+
+#endif // CONTENT_BROWSER_BROWSER_URL_HANDLER_H_