Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ | 5 #ifndef CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ |
| 6 #define CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ | 6 #define CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ |
| 7 | 7 |
| 8 #include "content/common/content_export.h" | 8 #include "content/common/content_export.h" |
| 9 | 9 |
| 10 namespace net { | 10 namespace net { |
| 11 struct RedirectInfo; | 11 struct RedirectInfo; |
| 12 } | 12 } |
| 13 | 13 |
| 14 namespace content { | 14 namespace content { |
| 15 | 15 |
| 16 class AsyncRevalidationDriver; | 16 class AsyncRevalidationDriver; |
| 17 class ResourceController; | 17 class ResourceController; |
| 18 class ThrottlingResourceHandler; | 18 class ThrottlingResourceHandler; |
| 19 | 19 |
| 20 // A ResourceThrottle gets notified at various points during the process of | 20 // A ResourceThrottle gets notified at various points during the process of |
| 21 // loading a resource. At each stage, it has the opportunity to defer the | 21 // loading a resource. At each stage, it has the opportunity to defer the |
| 22 // resource load. The ResourceController interface may be used to resume a | 22 // resource load. The ResourceController interface may be used to resume a |
| 23 // deferred resource load, or it may be used to cancel a resource load at any | 23 // deferred resource load, or it may be used to cancel a resource load at any |
| 24 // time. | 24 // time. |
| 25 class CONTENT_EXPORT ResourceThrottle { | 25 class CONTENT_EXPORT ResourceThrottle { |
| 26 public: | 26 public: |
| 27 class CONTENT_EXPORT Delegate { | |
| 28 public: | |
| 29 virtual void Cancel() = 0; | |
|
jochen (gone - plz use gerrit)
2016/12/05 15:25:03
please add comments explaining the delegate and ev
tyoshino (SeeGerritForStatus)
2016/12/06 11:25:31
Done.
| |
| 30 virtual void CancelAndIgnore() = 0; | |
| 31 virtual void CancelWithError(int error_code) = 0; | |
| 32 virtual void Resume() = 0; | |
| 33 | |
| 34 protected: | |
| 35 virtual ~Delegate() {} | |
| 36 }; | |
| 37 | |
| 27 virtual ~ResourceThrottle() {} | 38 virtual ~ResourceThrottle() {} |
| 28 | 39 |
| 29 // Called before the resource request is started. | 40 // Called before the resource request is started. |
| 30 virtual void WillStartRequest(bool* defer) {} | 41 virtual void WillStartRequest(bool* defer) {} |
| 31 | 42 |
| 32 // Called when the request was redirected. |redirect_info| contains the | 43 // Called when the request was redirected. |redirect_info| contains the |
| 33 // redirect responses's HTTP status code and some information about the new | 44 // redirect responses's HTTP status code and some information about the new |
| 34 // request that will be sent if the redirect is followed, including the new | 45 // request that will be sent if the redirect is followed, including the new |
| 35 // URL and new method. | 46 // URL and new method. |
| 36 virtual void WillRedirectRequest(const net::RedirectInfo& redirect_info, | 47 virtual void WillRedirectRequest(const net::RedirectInfo& redirect_info, |
| 37 bool* defer) {} | 48 bool* defer) {} |
| 38 | 49 |
| 39 // Called when the response headers and meta data are available. | 50 // Called when the response headers and meta data are available. |
| 40 virtual void WillProcessResponse(bool* defer) {} | 51 virtual void WillProcessResponse(bool* defer) {} |
| 41 | 52 |
| 42 // Returns the name of the throttle, as a UTF-8 C-string, for logging | 53 // Returns the name of the throttle, as a UTF-8 C-string, for logging |
| 43 // purposes. nullptr is not allowed. Caller does *not* take ownership of the | 54 // purposes. nullptr is not allowed. Caller does *not* take ownership of the |
| 44 // returned string. | 55 // returned string. |
| 45 virtual const char* GetNameForLogging() const = 0; | 56 virtual const char* GetNameForLogging() const = 0; |
| 46 | 57 |
| 47 // Whether this ResourceThrottle needs to execute WillProcessResponse before | 58 // Whether this ResourceThrottle needs to execute WillProcessResponse before |
| 48 // any part of the response body is read. Normally this is false. This should | 59 // any part of the response body is read. Normally this is false. This should |
| 49 // be set to true if the ResourceThrottle wants to ensure that no part of the | 60 // be set to true if the ResourceThrottle wants to ensure that no part of the |
| 50 // response body will be cached if the request is canceled in | 61 // response body will be cached if the request is canceled in |
| 51 // WillProcessResponse. | 62 // WillProcessResponse. |
| 52 virtual bool MustProcessResponseBeforeReadingBody(); | 63 virtual bool MustProcessResponseBeforeReadingBody(); |
| 53 | 64 |
| 54 void set_controller_for_testing(ResourceController* c) { | 65 void set_delegate_for_testing(Delegate* delegate) { delegate_ = delegate; } |
| 55 controller_ = c; | |
| 56 } | |
| 57 | 66 |
| 58 protected: | 67 protected: |
| 59 ResourceThrottle() : controller_(nullptr) {} | 68 ResourceThrottle() : delegate_(nullptr) {} |
| 60 ResourceController* controller() { return controller_; } | 69 |
| 70 void Cancel(); | |
|
jochen (gone - plz use gerrit)
2016/12/05 15:25:03
please add comments here as well
tyoshino (SeeGerritForStatus)
2016/12/06 11:25:31
Done.
| |
| 71 void CancelAndIgnore(); | |
| 72 void CancelWithError(int error_code); | |
| 73 void Resume(); | |
| 61 | 74 |
| 62 private: | 75 private: |
| 63 friend class AsyncRevalidationDriver; | 76 friend class AsyncRevalidationDriver; |
| 64 friend class ThrottlingResourceHandler; | 77 friend class ThrottlingResourceHandler; |
| 65 void set_controller(ResourceController* c) { controller_ = c; } | 78 void set_delegate(Delegate* delegate) { delegate_ = delegate; } |
| 66 | 79 |
| 67 ResourceController* controller_; | 80 Delegate* delegate_; |
| 68 }; | 81 }; |
| 69 | 82 |
| 70 } // namespace content | 83 } // namespace content |
| 71 | 84 |
| 72 #endif // CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ | 85 #endif // CONTENT_PUBLIC_BROWSER_RESOURCE_THROTTLE_H_ |
| OLD | NEW |