OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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 NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ | 5 #ifndef NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ |
6 #define NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ | 6 #define NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/basictypes.h" | 10 #include "base/basictypes.h" |
(...skipping 14 matching lines...) Expand all Loading... |
25 public: | 25 public: |
26 // TODO(shalev): Move this to URLRequestJobFactoryImpl. | 26 // TODO(shalev): Move this to URLRequestJobFactoryImpl. |
27 class NET_EXPORT ProtocolHandler { | 27 class NET_EXPORT ProtocolHandler { |
28 public: | 28 public: |
29 virtual ~ProtocolHandler(); | 29 virtual ~ProtocolHandler(); |
30 | 30 |
31 virtual URLRequestJob* MaybeCreateJob( | 31 virtual URLRequestJob* MaybeCreateJob( |
32 URLRequest* request, NetworkDelegate* network_delegate) const = 0; | 32 URLRequest* request, NetworkDelegate* network_delegate) const = 0; |
33 }; | 33 }; |
34 | 34 |
35 // TODO(shalev): Move this to URLRequestJobFactoryImpl. | |
36 class NET_EXPORT Interceptor { | |
37 public: | |
38 virtual ~Interceptor(); | |
39 | |
40 // Called for every request made. Should return a new job to handle the | |
41 // request if it should be intercepted, or NULL to allow the request to | |
42 // be handled in the normal manner. | |
43 virtual URLRequestJob* MaybeIntercept( | |
44 URLRequest* request, NetworkDelegate* network_delegate) const = 0; | |
45 | |
46 // Called after having received a redirect response, but prior to the | |
47 // the request delegate being informed of the redirect. Can return a new | |
48 // job to replace the existing job if it should be intercepted, or NULL | |
49 // to allow the normal handling to continue. If a new job is provided, | |
50 // the delegate never sees the original redirect response, instead the | |
51 // response produced by the intercept job will be returned. | |
52 virtual URLRequestJob* MaybeInterceptRedirect( | |
53 const GURL& location, | |
54 URLRequest* request, | |
55 NetworkDelegate* network_delegate) const = 0; | |
56 | |
57 // Called after having received a final response, but prior to the | |
58 // the request delegate being informed of the response. This is also | |
59 // called when there is no server response at all to allow interception | |
60 // on DNS or network errors. Can return a new job to replace the existing | |
61 // job if it should be intercepted, or NULL to allow the normal handling to | |
62 // continue. If a new job is provided, the delegate never sees the original | |
63 // response, instead the response produced by the intercept job will be | |
64 // returned. | |
65 virtual URLRequestJob* MaybeInterceptResponse( | |
66 URLRequest* request, NetworkDelegate* network_delegate) const = 0; | |
67 | |
68 // Returns true if this interceptor handles requests for URLs with the | |
69 // given protocol. Returning false does not imply that this interceptor | |
70 // can't or won't handle requests with the given protocol. | |
71 virtual bool WillHandleProtocol(const std::string& protocol) const; | |
72 }; | |
73 | |
74 URLRequestJobFactory(); | 35 URLRequestJobFactory(); |
75 virtual ~URLRequestJobFactory(); | 36 virtual ~URLRequestJobFactory(); |
76 | 37 |
77 // TODO(shalev): Remove this from the interface. | |
78 // Sets the ProtocolHandler for a scheme. Returns true on success, false on | |
79 // failure (a ProtocolHandler already exists for |scheme|). On success, | |
80 // URLRequestJobFactory takes ownership of |protocol_handler|. | |
81 virtual bool SetProtocolHandler(const std::string& scheme, | |
82 ProtocolHandler* protocol_handler) = 0; | |
83 | |
84 // TODO(shalev): Remove this from the interface. | |
85 // Takes ownership of |interceptor|. Adds it to the end of the Interceptor | |
86 // list. | |
87 virtual void AddInterceptor(Interceptor* interceptor) = 0; | |
88 | |
89 // TODO(shalev): Consolidate MaybeCreateJobWithInterceptor and | |
90 // MaybeCreateJobWithProtocolHandler into a single method. | |
91 virtual URLRequestJob* MaybeCreateJobWithInterceptor( | |
92 URLRequest* request, NetworkDelegate* network_delegate) const = 0; | |
93 | |
94 virtual URLRequestJob* MaybeCreateJobWithProtocolHandler( | 38 virtual URLRequestJob* MaybeCreateJobWithProtocolHandler( |
95 const std::string& scheme, | 39 const std::string& scheme, |
96 URLRequest* request, | 40 URLRequest* request, |
97 NetworkDelegate* network_delegate) const = 0; | 41 NetworkDelegate* network_delegate) const = 0; |
98 | 42 |
99 virtual URLRequestJob* MaybeInterceptRedirect( | |
100 const GURL& location, | |
101 URLRequest* request, | |
102 NetworkDelegate* network_delegate) const = 0; | |
103 | |
104 virtual URLRequestJob* MaybeInterceptResponse( | |
105 URLRequest* request, NetworkDelegate* network_delegate) const = 0; | |
106 | |
107 virtual bool IsHandledProtocol(const std::string& scheme) const = 0; | 43 virtual bool IsHandledProtocol(const std::string& scheme) const = 0; |
108 | 44 |
109 virtual bool IsHandledURL(const GURL& url) const = 0; | 45 virtual bool IsHandledURL(const GURL& url) const = 0; |
110 | 46 |
111 private: | 47 private: |
112 DISALLOW_COPY_AND_ASSIGN(URLRequestJobFactory); | 48 DISALLOW_COPY_AND_ASSIGN(URLRequestJobFactory); |
113 }; | 49 }; |
114 | 50 |
115 } // namespace net | 51 } // namespace net |
116 | 52 |
117 #endif // NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ | 53 #endif // NET_URL_REQUEST_URL_REQUEST_JOB_FACTORY_H_ |
OLD | NEW |