summaryrefslogtreecommitdiffstats
path: root/chrome/browser/renderer_host/resource_dispatcher_host.h
diff options
context:
space:
mode:
authorjcampan@chromium.org <jcampan@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>2008-12-20 01:18:59 +0000
committerjcampan@chromium.org <jcampan@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>2008-12-20 01:18:59 +0000
commitfe54944f6080ed9f48619899ad342924754b19a9 (patch)
tree7959716d0543c6699cd254af29ba963b48fecd69 /chrome/browser/renderer_host/resource_dispatcher_host.h
parent6995f1dfc7d50b1296221b3875d79d31a978eb6a (diff)
downloadchromium_src-fe54944f6080ed9f48619899ad342924754b19a9.zip
chromium_src-fe54944f6080ed9f48619899ad342924754b19a9.tar.gz
chromium_src-fe54944f6080ed9f48619899ad342924754b19a9.tar.bz2
This CL moves the different resource handlers from resource_dispatcher_host.cc into their own files, into a new renderer_host directory.
Their is no functionality change in this CL. The motivation for doing that was: - resource_dispatcher_host.cc has become very long and more than 1/3 of the code is for the resource handler. - having the resource handler in their own file allows having unit tests for them. BUG=none TEST=run all unit tests and UI tests. Review URL: http://codereview.chromium.org/14487 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@7336 0039d316-1c4b-4281-b951-d872f2087c98
Diffstat (limited to 'chrome/browser/renderer_host/resource_dispatcher_host.h')
-rw-r--r--chrome/browser/renderer_host/resource_dispatcher_host.h446
1 files changed, 446 insertions, 0 deletions
diff --git a/chrome/browser/renderer_host/resource_dispatcher_host.h b/chrome/browser/renderer_host/resource_dispatcher_host.h
new file mode 100644
index 0000000..f0b7f94
--- /dev/null
+++ b/chrome/browser/renderer_host/resource_dispatcher_host.h
@@ -0,0 +1,446 @@
+// Copyright (c) 2006-2008 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.
+
+// This is the browser side of the resource dispatcher, it receives requests
+// from the RenderProcessHosts, and dispatches them to URLRequests. It then
+// fowards the messages from the URLRequests back to the correct process for
+// handling.
+//
+// See http://dev.chromium.org/developers/design-documents/multi-process-resource-loading
+
+#ifndef CHROME_BROWSER_RENDERER_HOST_RESOURCE_DISPATCHER_HOST_H_
+#define CHROME_BROWSER_RENDERER_HOST_RESOURCE_DISPATCHER_HOST_H_
+
+#include <map>
+#include <string>
+
+#include "base/logging.h"
+#include "base/observer_list.h"
+#include "base/ref_counted.h"
+#include "base/timer.h"
+#include "chrome/browser/renderer_host/resource_handler.h"
+#include "chrome/common/filter_policy.h"
+#include "chrome/common/ipc_message.h"
+#include "net/url_request/url_request.h"
+#include "webkit/glue/resource_type.h"
+
+class CrossSiteResourceHandler;
+class DownloadFileManager;
+class DownloadRequestManager;
+class LoginHandler;
+class MessageLoop;
+class PluginService;
+class SafeBrowsingService;
+class SaveFileManager;
+class URLRequestContext;
+struct ViewHostMsg_Resource_Request;
+
+class ResourceDispatcherHost : public URLRequest::Delegate {
+ public:
+ // Implemented by the client of ResourceDispatcherHost to receive messages in
+ // response to a resource load. The messages are intended to be forwarded to
+ // the ResourceDispatcher in the renderer process via an IPC channel that the
+ // client manages.
+ //
+ // NOTE: This class unfortunately cannot be named 'Delegate' because that
+ // conflicts with the name of ResourceDispatcherHost's base class.
+ //
+ // If the receiver is unable to send a given message (i.e., if Send returns
+ // false), then the ResourceDispatcherHost assumes the receiver has failed,
+ // and the given request will be dropped. (This happens, for example, when a
+ // renderer crashes and the channel dies).
+ typedef IPC::Message::Sender Receiver;
+
+ // Holds the data we would like to associate with each request
+ class ExtraRequestInfo : public URLRequest::UserData {
+ friend class ResourceDispatcherHost;
+ public:
+ ExtraRequestInfo(ResourceHandler* handler,
+ int request_id,
+ int render_process_host_id,
+ int render_view_id,
+ bool mixed_content,
+ ResourceType::Type resource_type,
+ uint64 upload_size)
+ : resource_handler(handler),
+ cross_site_handler(NULL),
+ login_handler(NULL),
+ request_id(request_id),
+ render_process_host_id(render_process_host_id),
+ render_view_id(render_view_id),
+ is_download(false),
+ pause_count(0),
+ mixed_content(mixed_content),
+ resource_type(resource_type),
+ filter_policy(FilterPolicy::DONT_FILTER),
+ last_load_state(net::LOAD_STATE_IDLE),
+ pending_data_count(0),
+ upload_size(upload_size),
+ last_upload_position(0),
+ waiting_for_upload_progress_ack(false),
+ is_paused(false),
+ has_started_reading(false),
+ paused_read_bytes(0) {
+ }
+
+ // Top-level ResourceHandler servicing this request.
+ scoped_refptr<ResourceHandler> resource_handler;
+
+ // CrossSiteResourceHandler for this request, if it is a cross-site request.
+ // (NULL otherwise.) This handler is part of the chain of ResourceHandlers
+ // pointed to by resource_handler.
+ CrossSiteResourceHandler* cross_site_handler;
+
+ LoginHandler* login_handler;
+
+ int request_id;
+
+ int render_process_host_id;
+
+ int render_view_id;
+
+ int pending_data_count;
+
+ // Downloads allowed only as a top level request.
+ bool allow_download;
+
+ // Whether this is a download.
+ bool is_download;
+
+ // The number of clients that have called pause on this request.
+ int pause_count;
+
+ // Whether this request is served over HTTP and the main page was served
+ // over HTTPS.
+ bool mixed_content;
+
+ ResourceType::Type resource_type;
+
+ // Whether the content for this request should be filtered (on the renderer
+ // side) to make it more secure: images are stamped, frame content is
+ // replaced with an error message and all other resources are entirely
+ // filtered out.
+ FilterPolicy::Type filter_policy;
+
+ net::LoadState last_load_state;
+
+ uint64 upload_size;
+
+ uint64 last_upload_position;
+
+ base::TimeTicks last_upload_ticks;
+
+ bool waiting_for_upload_progress_ack;
+
+ private:
+ // Request is temporarily not handling network data. Should be used only
+ // by the ResourceDispatcherHost, not the event handlers.
+ bool is_paused;
+
+ // Whether this request has started reading any bytes from the response
+ // yet. Will be true after the first (unpaused) call to Read.
+ bool has_started_reading;
+
+ // How many bytes have been read while this request has been paused.
+ int paused_read_bytes;
+ };
+
+ class Observer {
+ public:
+ virtual void OnRequestStarted(ResourceDispatcherHost* resource_dispatcher,
+ URLRequest* request) = 0;
+ virtual void OnResponseCompleted(ResourceDispatcherHost* resource_dispatcher,
+ URLRequest* request) = 0;
+ virtual void OnReceivedRedirect(ResourceDispatcherHost* resource_dispatcher,
+ URLRequest* request,
+ const GURL& new_url) = 0;
+ };
+
+ // Uniquely identifies a URLRequest.
+ struct GlobalRequestID {
+ GlobalRequestID() : render_process_host_id(-1), request_id(-1) {
+ }
+ GlobalRequestID(int render_process_host_id, int request_id)
+ : render_process_host_id(render_process_host_id),
+ request_id(request_id) {
+ }
+
+ int render_process_host_id;
+ int request_id;
+
+ bool operator<(const GlobalRequestID& other) const {
+ if (render_process_host_id == other.render_process_host_id)
+ return request_id < other.request_id;
+ return render_process_host_id < other.render_process_host_id;
+ }
+ };
+
+ explicit ResourceDispatcherHost(MessageLoop* io_loop);
+ ~ResourceDispatcherHost();
+
+ void Initialize();
+
+ // Puts the resource dispatcher host in an inactive state (unable to begin
+ // new requests). Cancels all pending requests.
+ void Shutdown();
+
+ // Begins a resource request with the given params on behalf of the specified
+ // render view. Responses will be dispatched through the given receiver. The
+ // RenderProcessHost ID is used to lookup TabContents from routing_id's.
+ // request_context is the cookie/cache context to be used for this request.
+ //
+ // If sync_result is non-null, then a SyncLoad reply will be generated, else
+ // a normal asynchronous set of response messages will be generated.
+ //
+ void BeginRequest(Receiver* receiver,
+ HANDLE render_process_handle,
+ int render_process_host_id,
+ int render_view_id,
+ int request_id,
+ const ViewHostMsg_Resource_Request& request,
+ URLRequestContext* request_context,
+ IPC::Message* sync_result);
+
+ // Initiate a download from the browser process (as opposed to a resource
+ // request from the renderer).
+ void BeginDownload(const GURL& url,
+ const GURL& referrer,
+ int render_process_host_id,
+ int render_view_id,
+ URLRequestContext* request_context);
+
+ // Initiate a save file from the browser process (as opposed to a resource
+ // request from the renderer).
+ void BeginSaveFile(const GURL& url,
+ const GURL& referrer,
+ int render_process_host_id,
+ int render_view_id,
+ URLRequestContext* request_context);
+
+ // Cancels the given request if it still exists. We ignore cancels from the
+ // renderer in the event of a download.
+ void CancelRequest(int render_process_host_id,
+ int request_id,
+ bool from_renderer);
+
+ // Decrements the pending_data_count for the request and resumes
+ // the request if it was paused due to too many pending data
+ // messages sent.
+ void OnDataReceivedACK(int render_process_host_id, int request_id);
+
+ // Resets the waiting_for_upload_progress_ack flag.
+ void OnUploadProgressACK(int render_process_host_id, int request_id);
+
+ // Returns true if it's ok to send the data. If there are already too many
+ // data messages pending, it pauses the request and returns false. In this
+ // case the caller should not send the data.
+ bool WillSendData(int render_process_host_id, int request_id);
+
+ // Pauses or resumes network activity for a particular request.
+ void PauseRequest(int render_process_host_id, int request_id, bool pause);
+
+ // Returns the number of pending requests. This is designed for the unittests
+ int pending_requests() const {
+ return static_cast<int>(pending_requests_.size());
+ }
+
+ DownloadFileManager* download_file_manager() const {
+ return download_file_manager_;
+ }
+
+ DownloadRequestManager* download_request_manager() const {
+ return download_request_manager_.get();
+ }
+
+ SaveFileManager* save_file_manager() const {
+ return save_file_manager_;
+ }
+
+ SafeBrowsingService* safe_browsing_service() const {
+ return safe_browsing_;
+ }
+
+ MessageLoop* ui_loop() const { return ui_loop_; }
+
+ // Called when the onunload handler for a cross-site request has finished.
+ void OnClosePageACK(int render_process_host_id, int request_id);
+
+ // Force cancels any pending requests for the given process.
+ void CancelRequestsForProcess(int render_process_host_id);
+
+ // Force cancels any pending requests for the given render view. This method
+ // acts like CancelRequestsForProcess when render_view_id is -1.
+ void CancelRequestsForRenderView(int render_process_host_id,
+ int render_view_id);
+
+ // URLRequest::Delegate
+ virtual void OnReceivedRedirect(URLRequest* request,
+ const GURL& new_url);
+ virtual void OnAuthRequired(URLRequest* request,
+ net::AuthChallengeInfo* auth_info);
+ virtual void OnSSLCertificateError(URLRequest* request,
+ int cert_error,
+ net::X509Certificate* cert);
+ virtual void OnResponseStarted(URLRequest* request);
+ virtual void OnReadCompleted(URLRequest* request, int bytes_read);
+ void OnResponseCompleted(URLRequest* request);
+
+ // Helper function to get our extra data out of a request. The given request
+ // must have been one we created so that it has the proper extra data pointer.
+ static ExtraRequestInfo* ExtraInfoForRequest(URLRequest* request) {
+ ExtraRequestInfo* r = static_cast<ExtraRequestInfo*>(request->user_data());
+ DLOG_IF(WARNING, !r) << "Request doesn't seem to have our data";
+ return r;
+ }
+
+ static const ExtraRequestInfo* ExtraInfoForRequest(const URLRequest* request) {
+ const ExtraRequestInfo* r =
+ static_cast<const ExtraRequestInfo*>(request->user_data());
+ DLOG_IF(WARNING, !r) << "Request doesn't seem to have our data";
+ return r;
+ }
+
+ // Add an observer. The observer will be called on the IO thread. To
+ // observe resource events on the UI thread, subscribe to the
+ // NOTIFY_RESOURCE_* notifications of the notification service.
+ void AddObserver(Observer* obs);
+
+ // Remove an observer.
+ void RemoveObserver(Observer* obs);
+
+ // Retrieves a URLRequest. Must be called from the IO thread.
+ URLRequest* GetURLRequest(GlobalRequestID request_id) const;
+
+ // A test to determining whether a given request should be forwarded to the
+ // download thread.
+ bool ShouldDownload(const std::string& mime_type,
+ const std::string& content_disposition);
+
+ // Notify our observers that a request has been cancelled.
+ void NotifyResponseCompleted(URLRequest* request, int render_process_host_id);
+
+ void RemovePendingRequest(int render_process_host_id, int request_id);
+
+ private:
+ class ShutdownTask;
+
+ friend class ShutdownTask;
+
+ // A shutdown helper that runs on the IO thread.
+ void OnShutdown();
+
+ // Returns true if the request is paused.
+ bool PauseRequestIfNeeded(ExtraRequestInfo* info);
+
+ // Resumes the given request by calling OnResponseStarted or OnReadCompleted.
+ void ResumeRequest(const GlobalRequestID& request_id);
+
+ // Reads data from the response using our internal buffer as async IO.
+ // Returns true if data is available immediately, false otherwise. If the
+ // return value is false, we will receive a OnReadComplete() callback later.
+ bool Read(URLRequest* request, int* bytes_read);
+
+ // Internal function to finish an async IO which has completed. Returns
+ // true if there is more data to read (e.g. we haven't read EOF yet and
+ // no errors have occurred).
+ bool CompleteRead(URLRequest *, int* bytes_read);
+
+ // Internal function to finish handling the ResponseStarted message. Returns
+ // true on success.
+ bool CompleteResponseStarted(URLRequest* request);
+
+ // Cancels the given request if it still exists. We ignore cancels from the
+ // renderer in the event of a download. If |allow_delete| is true and no IO
+ // is pending, the request is removed and deleted.
+ void CancelRequest(int render_process_host_id,
+ int request_id,
+ bool from_renderer,
+ bool allow_delete);
+
+ // Helper function for regular and download requests.
+ void BeginRequestInternal(URLRequest* request, bool mixed_content);
+
+ // The list of all requests that we have pending. This list is not really
+ // optimized, and assumes that we have relatively few requests pending at once
+ // since some operations require brute-force searching of the list.
+ //
+ // It may be enhanced in the future to provide some kind of prioritization
+ // mechanism. We should also consider a hashtable or binary tree if it turns
+ // out we have a lot of things here.
+ typedef std::map<GlobalRequestID,URLRequest*> PendingRequestList;
+
+ // Deletes the pending request identified by the iterator passed in.
+ // This function will invalidate the iterator passed in. Callers should
+ // not rely on this iterator being valid on return.
+ void RemovePendingRequest(const PendingRequestList::iterator& iter);
+
+ // Notify our observers that we started receiving a response for a request.
+ void NotifyResponseStarted(URLRequest* request, int render_process_host_id);
+
+ // Notify our observers that a request has been redirected.
+ void NofityReceivedRedirect(URLRequest* request,
+ int render_process_host_id,
+ const GURL& new_url);
+
+ // Tries to handle the url with an external protocol. If the request is
+ // handled, the function returns true. False otherwise.
+ bool HandleExternalProtocol(int request_id,
+ int render_process_host_id,
+ int tab_contents_id,
+ const GURL& url,
+ ResourceType::Type resource_type,
+ ResourceHandler* handler);
+
+ void UpdateLoadStates();
+
+ void MaybeUpdateUploadProgress(ExtraRequestInfo *info, URLRequest *request);
+
+ PendingRequestList pending_requests_;
+
+ // We cache the UI message loop so we can create new UI-related objects on it.
+ MessageLoop* ui_loop_;
+
+ // We cache the IO loop to ensure that GetURLRequest is only called from the
+ // IO thread.
+ MessageLoop* io_loop_;
+
+ // A timer that periodically calls UpdateLoadStates while pending_requests_
+ // is not empty.
+ base::RepeatingTimer<ResourceDispatcherHost> update_load_states_timer_;
+
+ // We own the download file writing thread and manager
+ scoped_refptr<DownloadFileManager> download_file_manager_;
+
+ // Determines whether a download is allowed.
+ scoped_refptr<DownloadRequestManager> download_request_manager_;
+
+ // We own the save file manager.
+ scoped_refptr<SaveFileManager> save_file_manager_;
+
+ scoped_refptr<SafeBrowsingService> safe_browsing_;
+
+ // Request ID for non-renderer initiated requests. request_ids generated by
+ // the renderer process are counted up from 0, while browser created requests
+ // start at -2 and go down from there. (We need to start at -2 because -1 is
+ // used as a special value all over the resource_dispatcher_host for
+ // uninitialized variables.) This way, we no longer have the unlikely (but
+ // observed in the real world!) event where we have two requests with the same
+ // request_id_.
+ int request_id_;
+
+ // List of objects observing resource dispatching.
+ ObserverList<Observer> observer_list_;
+
+ PluginService* plugin_service_;
+
+ // For running tasks.
+ ScopedRunnableMethodFactory<ResourceDispatcherHost> method_runner_;
+
+ // True if the resource dispatcher host has been shut down.
+ bool is_shutdown_;
+
+ DISALLOW_COPY_AND_ASSIGN(ResourceDispatcherHost);
+};
+
+#endif // CHROME_BROWSER_RENDERER_HOST_RESOURCE_DISPATCHER_HOST_H_