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