Data Reduction Proxy Interstitials

components/data_reduction_proxy/content/browser/data_reduction_proxy_resource_throttle.h

+// Copyright 2014 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 COMPONENTS_DATA_REDUCTION_PROXY_CONTENT_BROWSER_DATA_REDUCTION_PROXY_RESOURCE_THROTTLE_H_
+#define COMPONENTS_DATA_REDUCTION_PROXY_CONTENT_BROWSER_DATA_REDUCTION_PROXY_RESOURCE_THROTTLE_H_
+
+#include "base/memory/ref_counted.h"
+#include "base/memory/weak_ptr.h"
+#include "components/data_reduction_proxy/content/browser/data_reduction_proxy_ui_manager.h"
+#include "content/public/browser/resource_throttle.h"
+#include "content/public/common/resource_type.h"
+#include "url/gurl.h"
+
+namespace net {
+class URLRequest;
+}
+
+namespace data_reduction_proxy {
+
+class DataReductionProxyParams;
+class DataReductionProxyUIManager;
+class DataReductionProxyUIService;
+
+// Gets notified at various points during the process of loading a resource.
+// Defers the resource load when the data reduction proxy is not going to be
+// used. Resumes or cancels a deferred resource load via the ResourceController.
+class DataReductionProxyResourceThrottle
+    : public content::ResourceThrottle,
+      public base::SupportsWeakPtr<DataReductionProxyResourceThrottle> {
+ public:
+  // Constructs a DataReductionProxyResourceThrottle object with the given
+  // request, resource type, ui service, and params.
+  DataReductionProxyResourceThrottle(
+      const net::URLRequest* request,
+      content::ResourceType resource_type,
+      const DataReductionProxyUIService* ui_service,
+      const DataReductionProxyParams* params);
+
+  virtual ~DataReductionProxyResourceThrottle();
+
+  // Overrides content::ResourceThrottle.
+  void WillStartUsingNetwork(bool* defer) override;
+  void WillRedirectRequest(const GURL& new_url, bool* defer) override;
+  void WillProcessResponse(bool* defer) override;
+  const char* GetNameForLogging() const override;
+
+ private:
+  enum State {

[bengr, 2014/12/29 18:45:41]

Please add a comment that describes these states.

[megjablon, 2014/12/30 23:40:00]

Done.

+    NOT_BYPASSED,
+    LOCAL_BYPASS,
+    REMOTE_BYPASS,
+  };
+
+  // Creates a bypass resource and calls StartDisplayingBlockingPage on the UI
+  // thread. Sets defer to true. A bypass resource is a structure used to pass
+  // parameters between the IO and UI thread when interacting with the blocking
+  // page. Virtual for testing.
+  virtual void DisplayBlockingPage(bool* defer);
+
+  // Called on the IO thread when the user has decided to proceed with the
+  // current request, or go back.
+  void OnBlockingPageComplete(bool proceed);
+
+  // Starts displaying the data reduction proxy interstitial page if it is not
+  // prerendering. Called on the UI thread.

[bengr, 2014/12/29 18:45:41]

"Must only be called on the UI thread." Also add descriptions of the parameters.

[megjablon, 2014/12/30 23:40:00]

Done.

+  static void StartDisplayingBlockingPage(

[bengr, 2014/12/29 18:45:41]

static members should be declared before non-static ones.

[megjablon, 2014/12/30 23:39:59]

Done.

+      const base::WeakPtr<DataReductionProxyResourceThrottle>& throttle,
+      scoped_refptr<DataReductionProxyUIManager> ui_manager,
+      const DataReductionProxyUIManager::BypassResource& resource);
+
+  // The bypass state of this.
+  State state_;
+
+  // Must outlive |this|.
+  const net::URLRequest* request_;
+
+  // Holds the UI manager that shows intersitials. Must outlive |this|.
+  const DataReductionProxyUIService* ui_service_;
+
+  // Must outlive |this|.
+  const DataReductionProxyParams* params_;
+
+  const bool is_subresource_;
+
+  DISALLOW_COPY_AND_ASSIGN(DataReductionProxyResourceThrottle);
+};
+
+}  // namespace data_reduction_proxy
+
+#endif  // COMPONENTS_DATA_REDUCTION_PROXY_CONTENT_BROWSER_DATA_REDUCTION_PROXY_RESOURCE_THROTTLE_H_