Add ResourceRequestInfo.

content/public/browser/resource_request_info.h

Index: content/public/browser/resource_request_info.h
===================================================================
--- content/public/browser/resource_request_info.h	(revision 0)
+++ content/public/browser/resource_request_info.h	(revision 0)
@@ -0,0 +1,86 @@
+// Copyright (c) 2012 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.
+
+#ifndef CONTENT_PUBLIC_BROWSER_RESOURCE_REQUEST_INFO_H_
+#define CONTENT_PUBLIC_BROWSER_RESOURCE_REQUEST_INFO_H_
+#pragma once
+
+#include "base/basictypes.h"
+#include "base/supports_user_data.h"
+#include "content/common/content_export.h"
+#include "third_party/WebKit/Source/WebKit/chromium/public/WebReferrerPolicy.h"
+#include "webkit/glue/resource_type.h"
+
+namespace net {
+class URLRequest;
+}
+
+namespace content {
+class ResourceContext;
+
+// Each URLRequest allocated by the ResourceDispatcherHost has a
+// ResourceRequestInfo instance associated with it.
+class ResourceRequestInfo : public base::SupportsUserData::Data {
+ public:
+  // Returns the ResourceRequestInfo associated with the given URLRequest.
+  CONTENT_EXPORT static const ResourceRequestInfo* ForRequest(
+      const net::URLRequest* request);
+
+  // Adds a new, dummy ResourceRequestInfo to the given URLRequest.
+  // NOTE: Add parameters if you need to initialize other fields.
+  CONTENT_EXPORT static void DecorateForTesting(

[darin (slow to review), 2012/03/06 18:08:23]

Maybe "Decorate" is an abnormal term here.  Previously, I just had this method
named CreateForTesting and it returned a ResourceRequestInfo instance.  However,
ResourceRequestInfo has a protected destructor.  This meant that the only thing
callers of CreateForTesting could do was to pass the result to
SupportsUserData::SetUserData since the SupportsUserData::Data class has a
public destructor.

[jam, 2012/03/06 18:48:57]

I preferred the CreateForTesting since it's easier to understand as you say. it
seems like the destructor below can be made public with not much difference,
since if it's protected it can be casted to the parent class and deleted
directly if someone wants to be malicious :)

+      net::URLRequest* request,
+      ResourceContext* context);
+
+  // Returns the associated ResourceContext.
+  virtual ResourceContext* GetContext() const = 0;
+
+  // The child process unique ID of the requestor.
+  virtual int GetChildID() const = 0;
+
+  // The IPC route identifier for this request (this identifies the RenderView
+  // or like-thing in the renderer that the request gets routed to).
+  virtual int GetRouteID() const = 0;
+
+  // The pid of the originating process, if the request is sent on behalf of a
+  // another process.  Otherwise it is 0.
+  virtual int GetOriginPID() const = 0;
+
+  // Unique identifier (within the scope of the child process) for this request.
+  virtual int GetRequestID() const = 0;
+
+  // True if GetFrameID() represents a main frame in the RenderView.
+  virtual bool IsMainFrame() const = 0;
+
+  // Frame ID that sent this resource request. -1 if unknown / invalid.
+  virtual int64 GetFrameID() const = 0;
+
+  // True if GetParentFrameID() represents a main frame in the RenderView.
+  virtual bool ParentIsMainFrame() const = 0;
+
+  // Frame ID of parent frame of frame that sent this resource request.
+  // -1 if unknown / invalid.
+  virtual int64 GetParentFrameID() const = 0;
+
+  // Returns the associated resource type.
+  virtual ResourceType::Type GetResourceType() const = 0;
+
+  // Returns the associated referrer policy.
+  virtual WebKit::WebReferrerPolicy GetReferrerPolicy() const = 0;
+
+  // When there is upload data, this is the byte count of that data. When there
+  // is no upload, this will be 0.
+  virtual uint64 GetUploadSize() const = 0;
+
+  // Returns false if there is NOT an associated render view.
+  virtual bool GetAssociatedRenderView(int* render_process_id,
+                                       int* render_view_id) const = 0;
+
+ protected:
+  virtual ~ResourceRequestInfo() {}
+};
+
+}  // namespace content
+
+#endif  // CONTENT_PUBLIC_BROWSER_RESOURCE_REQUEST_INFO_H_