Line | Source Code | Coverage |
---|
1 | /**************************************************************************** | - |
2 | ** | - |
3 | ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). | - |
4 | ** Contact: http://www.qt-project.org/legal | - |
5 | ** | - |
6 | ** This file is part of the QtNetwork module of the Qt Toolkit. | - |
7 | ** | - |
8 | ** $QT_BEGIN_LICENSE:LGPL$ | - |
9 | ** Commercial License Usage | - |
10 | ** Licensees holding valid commercial Qt licenses may use this file in | - |
11 | ** accordance with the commercial license agreement provided with the | - |
12 | ** Software or, alternatively, in accordance with the terms contained in | - |
13 | ** a written agreement between you and Digia. For licensing terms and | - |
14 | ** conditions see http://qt.digia.com/licensing. For further information | - |
15 | ** use the contact form at http://qt.digia.com/contact-us. | - |
16 | ** | - |
17 | ** GNU Lesser General Public License Usage | - |
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - |
19 | ** General Public License version 2.1 as published by the Free Software | - |
20 | ** Foundation and appearing in the file LICENSE.LGPL included in the | - |
21 | ** packaging of this file. Please review the following information to | - |
22 | ** ensure the GNU Lesser General Public License version 2.1 requirements | - |
23 | ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - |
24 | ** | - |
25 | ** In addition, as a special exception, Digia gives you certain additional | - |
26 | ** rights. These rights are described in the Digia Qt LGPL Exception | - |
27 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - |
28 | ** | - |
29 | ** GNU General Public License Usage | - |
30 | ** Alternatively, this file may be used under the terms of the GNU | - |
31 | ** General Public License version 3.0 as published by the Free Software | - |
32 | ** Foundation and appearing in the file LICENSE.GPL included in the | - |
33 | ** packaging of this file. Please review the following information to | - |
34 | ** ensure the GNU General Public License version 3.0 requirements will be | - |
35 | ** met: http://www.gnu.org/copyleft/gpl.html. | - |
36 | ** | - |
37 | ** | - |
38 | ** $QT_END_LICENSE$ | - |
39 | ** | - |
40 | ****************************************************************************/ | - |
41 | | - |
42 | | - |
43 | /*! | - |
44 | \class QNetworkProxy | - |
45 | | - |
46 | \since 4.1 | - |
47 | | - |
48 | \brief The QNetworkProxy class provides a network layer proxy. | - |
49 | | - |
50 | \reentrant | - |
51 | \ingroup network | - |
52 | \ingroup shared | - |
53 | \inmodule QtNetwork | - |
54 | | - |
55 | QNetworkProxy provides the method for configuring network layer | - |
56 | proxy support to the Qt network classes. The currently supported | - |
57 | classes are QAbstractSocket, QTcpSocket, QUdpSocket, QTcpServer | - |
58 | and QNetworkAccessManager. The proxy support is designed to | - |
59 | be as transparent as possible. This means that existing | - |
60 | network-enabled applications that you have written should | - |
61 | automatically support network proxy using the following code. | - |
62 | | - |
63 | \snippet code/src_network_kernel_qnetworkproxy.cpp 0 | - |
64 | | - |
65 | An alternative to setting an application wide proxy is to specify | - |
66 | the proxy for individual sockets using QAbstractSocket::setProxy() | - |
67 | and QTcpServer::setProxy(). In this way, it is possible to disable | - |
68 | the use of a proxy for specific sockets using the following code: | - |
69 | | - |
70 | \snippet code/src_network_kernel_qnetworkproxy.cpp 1 | - |
71 | | - |
72 | Network proxy is not used if the address used in \l | - |
73 | {QAbstractSocket::connectToHost()}{connectToHost()}, \l | - |
74 | {QUdpSocket::bind()}{bind()} or \l | - |
75 | {QTcpServer::listen()}{listen()} is equivalent to | - |
76 | QHostAddress::LocalHost or QHostAddress::LocalHostIPv6. | - |
77 | | - |
78 | Each type of proxy support has certain restrictions associated with it. | - |
79 | You should read the \l{ProxyType} documentation carefully before | - |
80 | selecting a proxy type to use. | - |
81 | | - |
82 | \note Changes made to currently connected sockets do not take effect. | - |
83 | If you need to change a connected socket, you should reconnect it. | - |
84 | | - |
85 | \section1 SOCKS5 | - |
86 | | - |
87 | The SOCKS5 support in Qt 4 is based on \l{http://www.rfc-editor.org/rfc/rfc1928.txt}{RFC 1928} and \l{http://www.rfc-editor.org/rfc/rfc1929.txt}{RFC 1929}. | - |
88 | The supported authentication methods are no authentication and | - |
89 | username/password authentication. Both IPv4 and IPv6 are | - |
90 | supported. Domain names are resolved through the SOCKS5 server if | - |
91 | the QNetworkProxy::HostNameLookupCapability is enabled, otherwise | - |
92 | they are resolved locally and the IP address is sent to the | - |
93 | server. There are several things to remember when using SOCKS5 | - |
94 | with QUdpSocket and QTcpServer: | - |
95 | | - |
96 | With QUdpSocket, a call to \l {QUdpSocket::bind()}{bind()} may fail | - |
97 | with a timeout error. If a port number other than 0 is passed to | - |
98 | \l {QUdpSocket::bind()}{bind()}, it is not guaranteed that it is the | - |
99 | specified port that will be used. | - |
100 | Use \l{QUdpSocket::localPort()}{localPort()} and | - |
101 | \l{QUdpSocket::localAddress()}{localAddress()} to get the actual | - |
102 | address and port number in use. Because proxied UDP goes through | - |
103 | two UDP connections, it is more likely that packets will be dropped. | - |
104 | | - |
105 | With QTcpServer a call to \l{QTcpServer::listen()}{listen()} may | - |
106 | fail with a timeout error. If a port number other than 0 is passed | - |
107 | to \l{QTcpServer::listen()}{listen()}, then it is not guaranteed | - |
108 | that it is the specified port that will be used. | - |
109 | Use \l{QTcpServer::serverPort()}{serverPort()} and | - |
110 | \l{QTcpServer::serverAddress()}{serverAddress()} to get the actual | - |
111 | address and port used to listen for connections. SOCKS5 only supports | - |
112 | one accepted connection per call to \l{QTcpServer::listen()}{listen()}, | - |
113 | and each call is likely to result in a different | - |
114 | \l{QTcpServer::serverPort()}{serverPort()} being used. | - |
115 | | - |
116 | \sa QAbstractSocket, QTcpServer | - |
117 | */ | - |
118 | | - |
119 | /*! | - |
120 | \enum QNetworkProxy::ProxyType | - |
121 | | - |
122 | This enum describes the types of network proxying provided in Qt. | - |
123 | | - |
124 | There are two types of proxies that Qt understands: | - |
125 | transparent proxies and caching proxies. The first group consists | - |
126 | of proxies that can handle any arbitrary data transfer, while the | - |
127 | second can only handle specific requests. The caching proxies only | - |
128 | make sense for the specific classes where they can be used. | - |
129 | | - |
130 | \value NoProxy No proxying is used | - |
131 | \value DefaultProxy Proxy is determined based on the application proxy set using setApplicationProxy() | - |
132 | \value Socks5Proxy \l Socks5 proxying is used | - |
133 | \value HttpProxy HTTP transparent proxying is used | - |
134 | \value HttpCachingProxy Proxying for HTTP requests only | - |
135 | \value FtpCachingProxy Proxying for FTP requests only | - |
136 | | - |
137 | The table below lists different proxy types and their | - |
138 | capabilities. Since each proxy type has different capabilities, it | - |
139 | is important to understand them before choosing a proxy type. | - |
140 | | - |
141 | \table | - |
142 | \header | - |
143 | \li Proxy type | - |
144 | \li Description | - |
145 | \li Default capabilities | - |
146 | | - |
147 | \row | - |
148 | \li SOCKS 5 | - |
149 | \li Generic proxy for any kind of connection. Supports TCP, | - |
150 | UDP, binding to a port (incoming connections) and | - |
151 | authentication. | - |
152 | \li TunnelingCapability, ListeningCapability, | - |
153 | UdpTunnelingCapability, HostNameLookupCapability | - |
154 | | - |
155 | \row | - |
156 | \li HTTP | - |
157 | \li Implemented using the "CONNECT" command, supports only | - |
158 | outgoing TCP connections; supports authentication. | - |
159 | \li TunnelingCapability, CachingCapability, HostNameLookupCapability | - |
160 | | - |
161 | \row | - |
162 | \li Caching-only HTTP | - |
163 | \li Implemented using normal HTTP commands, it is useful only | - |
164 | in the context of HTTP requests (see QNetworkAccessManager) | - |
165 | \li CachingCapability, HostNameLookupCapability | - |
166 | | - |
167 | \row | - |
168 | \li Caching FTP | - |
169 | \li Implemented using an FTP proxy, it is useful only in the | - |
170 | context of FTP requests (see QNetworkAccessManager) | - |
171 | \li CachingCapability, HostNameLookupCapability | - |
172 | | - |
173 | \endtable | - |
174 | | - |
175 | Also note that you shouldn't set the application default proxy | - |
176 | (setApplicationProxy()) to a proxy that doesn't have the | - |
177 | TunnelingCapability capability. If you do, QTcpSocket will not | - |
178 | know how to open connections. | - |
179 | | - |
180 | \sa setType(), type(), capabilities(), setCapabilities() | - |
181 | */ | - |
182 | | - |
183 | /*! | - |
184 | \enum QNetworkProxy::Capability | - |
185 | \since 4.5 | - |
186 | | - |
187 | These flags indicate the capabilities that a given proxy server | - |
188 | supports. | - |
189 | | - |
190 | QNetworkProxy sets different capabilities by default when the | - |
191 | object is created (see QNetworkProxy::ProxyType for a list of the | - |
192 | defaults). However, it is possible to change the capabitilies | - |
193 | after the object has been created with setCapabilities(). | - |
194 | | - |
195 | The capabilities that QNetworkProxy supports are: | - |
196 | | - |
197 | \value TunnelingCapability Ability to open transparent, tunneled | - |
198 | TCP connections to a remote host. The proxy server relays the | - |
199 | transmission verbatim from one side to the other and does no | - |
200 | caching. | - |
201 | | - |
202 | \value ListeningCapability Ability to create a listening socket | - |
203 | and wait for an incoming TCP connection from a remote host. | - |
204 | | - |
205 | \value UdpTunnelingCapability Ability to relay UDP datagrams via | - |
206 | the proxy server to and from a remote host. | - |
207 | | - |
208 | \value CachingCapability Ability to cache the contents of the | - |
209 | transfer. This capability is specific to each protocol and proxy | - |
210 | type. For example, HTTP proxies can cache the contents of web data | - |
211 | transferred with "GET" commands. | - |
212 | | - |
213 | \value HostNameLookupCapability Ability to connect to perform the | - |
214 | lookup on a remote host name and connect to it, as opposed to | - |
215 | requiring the application to perform the name lookup and request | - |
216 | connection to IP addresses only. | - |
217 | */ | - |
218 | | - |
219 | #include "qnetworkproxy.h" | - |
220 | | - |
221 | #ifndef QT_NO_NETWORKPROXY | - |
222 | | - |
223 | #include "private/qnetworkproxy_p.h" | - |
224 | #include "private/qnetworkrequest_p.h" | - |
225 | #include "private/qsocks5socketengine_p.h" | - |
226 | #include "private/qhttpsocketengine_p.h" | - |
227 | #include "qauthenticator.h" | - |
228 | #include "qdebug.h" | - |
229 | #include "qhash.h" | - |
230 | #include "qmutex.h" | - |
231 | #include "qstringlist.h" | - |
232 | #include "qurl.h" | - |
233 | | - |
234 | #ifndef QT_NO_BEARERMANAGEMENT | - |
235 | #include <QtNetwork/QNetworkConfiguration> | - |
236 | #endif | - |
237 | | - |
238 | QT_BEGIN_NAMESPACE | - |
239 | | - |
240 | class QSocks5SocketEngineHandler; | - |
241 | class QHttpSocketEngineHandler; | - |
242 | | - |
243 | class QGlobalNetworkProxy | - |
244 | { | - |
245 | public: | - |
246 | QGlobalNetworkProxy() | - |
247 | : mutex(QMutex::Recursive) | - |
248 | , applicationLevelProxy(0) | - |
249 | , applicationLevelProxyFactory(0) | - |
250 | #ifndef QT_NO_SOCKS5 | - |
251 | , socks5SocketEngineHandler(0) | - |
252 | #endif | - |
253 | #ifndef QT_NO_HTTP | - |
254 | , httpSocketEngineHandler(0) | - |
255 | #endif | - |
256 | { | - |
257 | #ifdef QT_USE_SYSTEM_PROXIES | - |
258 | setApplicationProxyFactory(new QSystemConfigurationProxyFactory); | - |
259 | #endif | - |
260 | #ifndef QT_NO_SOCKS5 | - |
261 | socks5SocketEngineHandler = new QSocks5SocketEngineHandler(); executed (the execution status of this line is deduced): socks5SocketEngineHandler = new QSocks5SocketEngineHandler(); | - |
262 | #endif | - |
263 | #ifndef QT_NO_HTTP | - |
264 | httpSocketEngineHandler = new QHttpSocketEngineHandler(); executed (the execution status of this line is deduced): httpSocketEngineHandler = new QHttpSocketEngineHandler(); | - |
265 | #endif | - |
266 | } executed: } Execution Count:23 | 23 |
267 | | - |
268 | ~QGlobalNetworkProxy() | - |
269 | { | - |
270 | delete applicationLevelProxy; executed (the execution status of this line is deduced): delete applicationLevelProxy; | - |
271 | delete applicationLevelProxyFactory; executed (the execution status of this line is deduced): delete applicationLevelProxyFactory; | - |
272 | #ifndef QT_NO_SOCKS5 | - |
273 | delete socks5SocketEngineHandler; executed (the execution status of this line is deduced): delete socks5SocketEngineHandler; | - |
274 | #endif | - |
275 | #ifndef QT_NO_HTTP | - |
276 | delete httpSocketEngineHandler; executed (the execution status of this line is deduced): delete httpSocketEngineHandler; | - |
277 | #endif | - |
278 | } executed: } Execution Count:23 | 23 |
279 | | - |
280 | void setApplicationProxy(const QNetworkProxy &proxy) | - |
281 | { | - |
282 | QMutexLocker lock(&mutex); executed (the execution status of this line is deduced): QMutexLocker lock(&mutex); | - |
283 | if (!applicationLevelProxy) evaluated: !applicationLevelProxy yes Evaluation Count:3 | yes Evaluation Count:373 |
| 3-373 |
284 | applicationLevelProxy = new QNetworkProxy; executed: applicationLevelProxy = new QNetworkProxy; Execution Count:3 | 3 |
285 | *applicationLevelProxy = proxy; executed (the execution status of this line is deduced): *applicationLevelProxy = proxy; | - |
286 | delete applicationLevelProxyFactory; executed (the execution status of this line is deduced): delete applicationLevelProxyFactory; | - |
287 | applicationLevelProxyFactory = 0; executed (the execution status of this line is deduced): applicationLevelProxyFactory = 0; | - |
288 | } executed: } Execution Count:376 | 376 |
289 | | - |
290 | void setApplicationProxyFactory(QNetworkProxyFactory *factory) | - |
291 | { | - |
292 | QMutexLocker lock(&mutex); executed (the execution status of this line is deduced): QMutexLocker lock(&mutex); | - |
293 | if (factory == applicationLevelProxyFactory) partially evaluated: factory == applicationLevelProxyFactory no Evaluation Count:0 | yes Evaluation Count:8 |
| 0-8 |
294 | return; | 0 |
295 | if (applicationLevelProxy) evaluated: applicationLevelProxy yes Evaluation Count:7 | yes Evaluation Count:1 |
| 1-7 |
296 | *applicationLevelProxy = QNetworkProxy(); executed: *applicationLevelProxy = QNetworkProxy(); Execution Count:7 | 7 |
297 | delete applicationLevelProxyFactory; executed (the execution status of this line is deduced): delete applicationLevelProxyFactory; | - |
298 | applicationLevelProxyFactory = factory; executed (the execution status of this line is deduced): applicationLevelProxyFactory = factory; | - |
299 | } executed: } Execution Count:8 | 8 |
300 | | - |
301 | QNetworkProxy applicationProxy() | - |
302 | { | - |
303 | return proxyForQuery(QNetworkProxyQuery()).first(); executed: return proxyForQuery(QNetworkProxyQuery()).first(); Execution Count:856 | 856 |
304 | } | - |
305 | | - |
306 | QList<QNetworkProxy> proxyForQuery(const QNetworkProxyQuery &query); | - |
307 | | - |
308 | private: | - |
309 | QMutex mutex; | - |
310 | QNetworkProxy *applicationLevelProxy; | - |
311 | QNetworkProxyFactory *applicationLevelProxyFactory; | - |
312 | #ifndef QT_NO_SOCKS5 | - |
313 | QSocks5SocketEngineHandler *socks5SocketEngineHandler; | - |
314 | #endif | - |
315 | #ifndef QT_NO_HTTP | - |
316 | QHttpSocketEngineHandler *httpSocketEngineHandler; | - |
317 | #endif | - |
318 | }; | - |
319 | | - |
320 | QList<QNetworkProxy> QGlobalNetworkProxy::proxyForQuery(const QNetworkProxyQuery &query) | - |
321 | { | - |
322 | QMutexLocker locker(&mutex); executed (the execution status of this line is deduced): QMutexLocker locker(&mutex); | - |
323 | | - |
324 | QList<QNetworkProxy> result; executed (the execution status of this line is deduced): QList<QNetworkProxy> result; | - |
325 | | - |
326 | // don't look for proxies for a local connection | - |
327 | QHostAddress parsed; executed (the execution status of this line is deduced): QHostAddress parsed; | - |
328 | QString hostname = query.url().host(); executed (the execution status of this line is deduced): QString hostname = query.url().host(); | - |
329 | if (hostname == QLatin1String("localhost") evaluated: hostname == QLatin1String("localhost") yes Evaluation Count:1133 | yes Evaluation Count:2452 |
| 1133-2452 |
330 | || hostname.startsWith(QLatin1String("localhost.")) partially evaluated: hostname.startsWith(QLatin1String("localhost.")) no Evaluation Count:0 | yes Evaluation Count:2452 |
| 0-2452 |
331 | || (parsed.setAddress(hostname) evaluated: parsed.setAddress(hostname) yes Evaluation Count:371 | yes Evaluation Count:2081 |
| 371-2081 |
332 | && (parsed.isLoopback()))) { evaluated: (parsed.isLoopback()) yes Evaluation Count:319 | yes Evaluation Count:52 |
| 52-319 |
333 | result << QNetworkProxy(QNetworkProxy::NoProxy); executed (the execution status of this line is deduced): result << QNetworkProxy(QNetworkProxy::NoProxy); | - |
334 | return result; executed: return result; Execution Count:1452 | 1452 |
335 | } | - |
336 | | - |
337 | if (!applicationLevelProxyFactory) { evaluated: !applicationLevelProxyFactory yes Evaluation Count:2126 | yes Evaluation Count:7 |
| 7-2126 |
338 | if (applicationLevelProxy evaluated: applicationLevelProxy yes Evaluation Count:389 | yes Evaluation Count:1737 |
| 389-1737 |
339 | && applicationLevelProxy->type() != QNetworkProxy::DefaultProxy) partially evaluated: applicationLevelProxy->type() != QNetworkProxy::DefaultProxy yes Evaluation Count:389 | no Evaluation Count:0 |
| 0-389 |
340 | result << *applicationLevelProxy; executed: result << *applicationLevelProxy; Execution Count:389 | 389 |
341 | else | - |
342 | result << QNetworkProxy(QNetworkProxy::NoProxy); executed: result << QNetworkProxy(QNetworkProxy::NoProxy); Execution Count:1737 | 1737 |
343 | return result; executed: return result; Execution Count:2126 | 2126 |
344 | } | - |
345 | | - |
346 | // we have a factory | - |
347 | result = applicationLevelProxyFactory->queryProxy(query); executed (the execution status of this line is deduced): result = applicationLevelProxyFactory->queryProxy(query); | - |
348 | if (result.isEmpty()) { partially evaluated: result.isEmpty() no Evaluation Count:0 | yes Evaluation Count:7 |
| 0-7 |
349 | qWarning("QNetworkProxyFactory: factory %p has returned an empty result set", never executed (the execution status of this line is deduced): QMessageLogger("kernel/qnetworkproxy.cpp", 349, __PRETTY_FUNCTION__).warning("QNetworkProxyFactory: factory %p has returned an empty result set", | - |
350 | applicationLevelProxyFactory); never executed (the execution status of this line is deduced): applicationLevelProxyFactory); | - |
351 | result << QNetworkProxy(QNetworkProxy::NoProxy); never executed (the execution status of this line is deduced): result << QNetworkProxy(QNetworkProxy::NoProxy); | - |
352 | } | 0 |
353 | return result; executed: return result; Execution Count:7 | 7 |
354 | } | - |
355 | | - |
356 | Q_GLOBAL_STATIC(QGlobalNetworkProxy, globalNetworkProxy) never executed: delete x; executed: return thisGlobalStatic.pointer.load(); Execution Count:30971 partially evaluated: !thisGlobalStatic.pointer.testAndSetOrdered(0, x) no Evaluation Count:0 | yes Evaluation Count:23 |
evaluated: !thisGlobalStatic.pointer.load() yes Evaluation Count:23 | yes Evaluation Count:30948 |
partially evaluated: !thisGlobalStatic.destroyed yes Evaluation Count:23 | no Evaluation Count:0 |
| 0-30971 |
357 | | - |
358 | namespace { | - |
359 | template<bool> struct StaticAssertTest; | - |
360 | template<> struct StaticAssertTest<true> { enum { Value = 1 }; }; | - |
361 | } | - |
362 | | - |
363 | static inline void qt_noop_with_arg(int) {} | - |
364 | #define q_static_assert(expr) qt_noop_with_arg(sizeof(StaticAssertTest< expr >::Value)) | - |
365 | | - |
366 | static QNetworkProxy::Capabilities defaultCapabilitiesForType(QNetworkProxy::ProxyType type) | - |
367 | { | - |
368 | q_static_assert(int(QNetworkProxy::DefaultProxy) == 0); executed (the execution status of this line is deduced): qt_noop_with_arg(sizeof(StaticAssertTest< int(QNetworkProxy::DefaultProxy) == 0 >::Value)); | - |
369 | q_static_assert(int(QNetworkProxy::FtpCachingProxy) == 5); executed (the execution status of this line is deduced): qt_noop_with_arg(sizeof(StaticAssertTest< int(QNetworkProxy::FtpCachingProxy) == 5 >::Value)); | - |
370 | static const int defaults[] = | - |
371 | { | - |
372 | /* [QNetworkProxy::DefaultProxy] = */ | - |
373 | (int(QNetworkProxy::ListeningCapability) | | - |
374 | int(QNetworkProxy::TunnelingCapability) | | - |
375 | int(QNetworkProxy::UdpTunnelingCapability)), | - |
376 | /* [QNetworkProxy::Socks5Proxy] = */ | - |
377 | (int(QNetworkProxy::TunnelingCapability) | | - |
378 | int(QNetworkProxy::ListeningCapability) | | - |
379 | int(QNetworkProxy::UdpTunnelingCapability) | | - |
380 | int(QNetworkProxy::HostNameLookupCapability)), | - |
381 | // it's weird to talk about the proxy capabilities of a "not proxy"... | - |
382 | /* [QNetworkProxy::NoProxy] = */ | - |
383 | (int(QNetworkProxy::ListeningCapability) | | - |
384 | int(QNetworkProxy::TunnelingCapability) | | - |
385 | int(QNetworkProxy::UdpTunnelingCapability)), | - |
386 | /* [QNetworkProxy::HttpProxy] = */ | - |
387 | (int(QNetworkProxy::TunnelingCapability) | | - |
388 | int(QNetworkProxy::CachingCapability) | | - |
389 | int(QNetworkProxy::HostNameLookupCapability)), | - |
390 | /* [QNetworkProxy::HttpCachingProxy] = */ | - |
391 | (int(QNetworkProxy::CachingCapability) | | - |
392 | int(QNetworkProxy::HostNameLookupCapability)), | - |
393 | /* [QNetworkProxy::FtpCachingProxy] = */ | - |
394 | (int(QNetworkProxy::CachingCapability) | | - |
395 | int(QNetworkProxy::HostNameLookupCapability)), | - |
396 | }; | - |
397 | | - |
398 | if (int(type) < 0 || int(type) > int(QNetworkProxy::FtpCachingProxy)) partially evaluated: int(type) < 0 no Evaluation Count:0 | yes Evaluation Count:5987 |
partially evaluated: int(type) > int(QNetworkProxy::FtpCachingProxy) no Evaluation Count:0 | yes Evaluation Count:5987 |
| 0-5987 |
399 | type = QNetworkProxy::DefaultProxy; never executed: type = QNetworkProxy::DefaultProxy; | 0 |
400 | return QNetworkProxy::Capabilities(defaults[int(type)]); executed: return QNetworkProxy::Capabilities(defaults[int(type)]); Execution Count:5987 | 5987 |
401 | } | - |
402 | | - |
403 | class QNetworkProxyPrivate: public QSharedData | - |
404 | { | - |
405 | public: | - |
406 | QString hostName; | - |
407 | QString user; | - |
408 | QString password; | - |
409 | QNetworkProxy::Capabilities capabilities; | - |
410 | quint16 port; | - |
411 | QNetworkProxy::ProxyType type; | - |
412 | bool capabilitiesSet; | - |
413 | QNetworkHeadersPrivate headers; | - |
414 | | - |
415 | inline QNetworkProxyPrivate(QNetworkProxy::ProxyType t = QNetworkProxy::DefaultProxy, | - |
416 | const QString &h = QString(), quint16 p = 0, | - |
417 | const QString &u = QString(), const QString &pw = QString()) | - |
418 | : hostName(h), | - |
419 | user(u), | - |
420 | password(pw), | - |
421 | capabilities(defaultCapabilitiesForType(t)), | - |
422 | port(p), | - |
423 | type(t), | - |
424 | capabilitiesSet(false) | - |
425 | { } executed: } Execution Count:5982 | 5982 |
426 | | - |
427 | inline bool operator==(const QNetworkProxyPrivate &other) const | - |
428 | { | - |
429 | return type == other.type && executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
430 | port == other.port && executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
431 | hostName == other.hostName && executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
432 | user == other.user && executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
433 | password == other.password && executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
434 | capabilities == other.capabilities; executed: return type == other.type && port == other.port && hostName == other.hostName && user == other.user && password == other.password && capabilities == other.capabilities; Execution Count:1 | 1 |
435 | } | - |
436 | }; | - |
437 | | - |
438 | template<> void QSharedDataPointer<QNetworkProxyPrivate>::detach() | - |
439 | { | - |
440 | if (d && d->ref.load() == 1) evaluated: d yes Evaluation Count:181 | yes Evaluation Count:1 |
evaluated: d->ref.load() == 1 yes Evaluation Count:98 | yes Evaluation Count:83 |
| 1-181 |
441 | return; executed: return; Execution Count:98 | 98 |
442 | QNetworkProxyPrivate *x = (d ? new QNetworkProxyPrivate(*d) evaluated: d yes Evaluation Count:83 | yes Evaluation Count:1 |
| 1-83 |
443 | : new QNetworkProxyPrivate); executed (the execution status of this line is deduced): : new QNetworkProxyPrivate); | - |
444 | x->ref.ref(); executed (the execution status of this line is deduced): x->ref.ref(); | - |
445 | if (d && !d->ref.deref()) evaluated: d yes Evaluation Count:83 | yes Evaluation Count:1 |
partially evaluated: !d->ref.deref() no Evaluation Count:0 | yes Evaluation Count:83 |
| 0-83 |
446 | delete d; never executed: delete d; | 0 |
447 | d = x; executed (the execution status of this line is deduced): d = x; | - |
448 | } executed: } Execution Count:84 | 84 |
449 | | - |
450 | /*! | - |
451 | Constructs a QNetworkProxy with DefaultProxy type; the proxy type is | - |
452 | determined by applicationProxy(), which defaults to NoProxy. | - |
453 | | - |
454 | \sa setType(), setApplicationProxy() | - |
455 | */ | - |
456 | QNetworkProxy::QNetworkProxy() | - |
457 | : d(0) | - |
458 | { | - |
459 | // make sure we have QGlobalNetworkProxy singleton created, otherwise | - |
460 | // you don't have any socket engine handler created when directly setting | - |
461 | // a proxy to a socket | - |
462 | globalNetworkProxy(); executed (the execution status of this line is deduced): globalNetworkProxy(); | - |
463 | } executed: } Execution Count:17052 | 17052 |
464 | | - |
465 | /*! | - |
466 | Constructs a QNetworkProxy with \a type, \a hostName, \a port, | - |
467 | \a user and \a password. | - |
468 | | - |
469 | The default capabilities for proxy type \a type are set automatically. | - |
470 | | - |
471 | \sa capabilities() | - |
472 | */ | - |
473 | QNetworkProxy::QNetworkProxy(ProxyType type, const QString &hostName, quint16 port, | - |
474 | const QString &user, const QString &password) | - |
475 | : d(new QNetworkProxyPrivate(type, hostName, port, user, password)) | - |
476 | { | - |
477 | // make sure we have QGlobalNetworkProxy singleton created, otherwise | - |
478 | // you don't have any socket engine handler created when directly setting | - |
479 | // a proxy to a socket | - |
480 | globalNetworkProxy(); executed (the execution status of this line is deduced): globalNetworkProxy(); | - |
481 | } executed: } Execution Count:5981 | 5981 |
482 | | - |
483 | /*! | - |
484 | Constructs a copy of \a other. | - |
485 | */ | - |
486 | QNetworkProxy::QNetworkProxy(const QNetworkProxy &other) | - |
487 | : d(other.d) | - |
488 | { | - |
489 | } executed: } Execution Count:10367 | 10367 |
490 | | - |
491 | /*! | - |
492 | Destroys the QNetworkProxy object. | - |
493 | */ | - |
494 | QNetworkProxy::~QNetworkProxy() | - |
495 | { | - |
496 | // QSharedDataPointer takes care of deleting for us | - |
497 | } | - |
498 | | - |
499 | /*! | - |
500 | \since 4.4 | - |
501 | | - |
502 | Compares the value of this network proxy to \a other and returns true | - |
503 | if they are equal (same proxy type, server as well as username and password) | - |
504 | */ | - |
505 | bool QNetworkProxy::operator==(const QNetworkProxy &other) const | - |
506 | { | - |
507 | return d == other.d || (d && other.d && *d == *other.d); executed: return d == other.d || (d && other.d && *d == *other.d); Execution Count:72 | 72 |
508 | } | - |
509 | | - |
510 | /*! | - |
511 | \fn bool QNetworkProxy::operator!=(const QNetworkProxy &other) const | - |
512 | \since 4.4 | - |
513 | | - |
514 | Compares the value of this network proxy to \a other and returns true | - |
515 | if they differ. | - |
516 | \*/ | - |
517 | | - |
518 | /*! | - |
519 | \since 4.2 | - |
520 | | - |
521 | Assigns the value of the network proxy \a other to this network proxy. | - |
522 | */ | - |
523 | QNetworkProxy &QNetworkProxy::operator=(const QNetworkProxy &other) | - |
524 | { | - |
525 | d = other.d; executed (the execution status of this line is deduced): d = other.d; | - |
526 | return *this; executed: return *this; Execution Count:14812 | 14812 |
527 | } | - |
528 | | - |
529 | /*! | - |
530 | \fn void QNetworkProxy::swap(QNetworkProxy &other) | - |
531 | \since 5.0 | - |
532 | | - |
533 | Swaps this network proxy instance with \a other. This function is | - |
534 | very fast and never fails. | - |
535 | */ | - |
536 | | - |
537 | /*! | - |
538 | Sets the proxy type for this instance to be \a type. | - |
539 | | - |
540 | Note that changing the type of a proxy does not change | - |
541 | the set of capabilities this QNetworkProxy object holds if any | - |
542 | capabilities have been set with setCapabilities(). | - |
543 | | - |
544 | \sa type(), setCapabilities() | - |
545 | */ | - |
546 | void QNetworkProxy::setType(QNetworkProxy::ProxyType type) | - |
547 | { | - |
548 | d->type = type; executed (the execution status of this line is deduced): d->type = type; | - |
549 | if (!d->capabilitiesSet) evaluated: !d->capabilitiesSet yes Evaluation Count:5 | yes Evaluation Count:1 |
| 1-5 |
550 | d->capabilities = defaultCapabilitiesForType(type); executed: d->capabilities = defaultCapabilitiesForType(type); Execution Count:5 | 5 |
551 | } executed: } Execution Count:6 | 6 |
552 | | - |
553 | /*! | - |
554 | Returns the proxy type for this instance. | - |
555 | | - |
556 | \sa setType() | - |
557 | */ | - |
558 | QNetworkProxy::ProxyType QNetworkProxy::type() const | - |
559 | { | - |
560 | return d ? d->type : DefaultProxy; executed: return d ? d->type : DefaultProxy; Execution Count:32038 | 32038 |
561 | } | - |
562 | | - |
563 | /*! | - |
564 | \since 4.5 | - |
565 | | - |
566 | Sets the capabilities of this proxy to \a capabilities. | - |
567 | | - |
568 | \sa setType(), capabilities() | - |
569 | */ | - |
570 | void QNetworkProxy::setCapabilities(Capabilities capabilities) | - |
571 | { | - |
572 | d->capabilities = capabilities; executed (the execution status of this line is deduced): d->capabilities = capabilities; | - |
573 | d->capabilitiesSet = true; executed (the execution status of this line is deduced): d->capabilitiesSet = true; | - |
574 | } executed: } Execution Count:1 | 1 |
575 | | - |
576 | /*! | - |
577 | \since 4.5 | - |
578 | | - |
579 | Returns the capabilities of this proxy server. | - |
580 | | - |
581 | \sa setCapabilities(), type() | - |
582 | */ | - |
583 | QNetworkProxy::Capabilities QNetworkProxy::capabilities() const | - |
584 | { | - |
585 | return d ? d->capabilities : defaultCapabilitiesForType(DefaultProxy); executed: return d ? d->capabilities : defaultCapabilitiesForType(DefaultProxy); Execution Count:7082 | 7082 |
586 | } | - |
587 | | - |
588 | /*! | - |
589 | \since 4.4 | - |
590 | | - |
591 | Returns true if this proxy supports the | - |
592 | QNetworkProxy::CachingCapability capability. | - |
593 | | - |
594 | In Qt 4.4, the capability was tied to the proxy type, but since Qt | - |
595 | 4.5 it is possible to remove the capability of caching from a | - |
596 | proxy by calling setCapabilities(). | - |
597 | | - |
598 | \sa capabilities(), type(), isTransparentProxy() | - |
599 | */ | - |
600 | bool QNetworkProxy::isCachingProxy() const | - |
601 | { | - |
602 | return capabilities() & CachingCapability; never executed: return capabilities() & CachingCapability; | 0 |
603 | } | - |
604 | | - |
605 | /*! | - |
606 | \since 4.4 | - |
607 | | - |
608 | Returns true if this proxy supports transparent tunneling of TCP | - |
609 | connections. This matches the QNetworkProxy::TunnelingCapability | - |
610 | capability. | - |
611 | | - |
612 | In Qt 4.4, the capability was tied to the proxy type, but since Qt | - |
613 | 4.5 it is possible to remove the capability of caching from a | - |
614 | proxy by calling setCapabilities(). | - |
615 | | - |
616 | \sa capabilities(), type(), isCachingProxy() | - |
617 | */ | - |
618 | bool QNetworkProxy::isTransparentProxy() const | - |
619 | { | - |
620 | return capabilities() & TunnelingCapability; executed: return capabilities() & TunnelingCapability; Execution Count:660 | 660 |
621 | } | - |
622 | | - |
623 | /*! | - |
624 | Sets the user name for proxy authentication to be \a user. | - |
625 | | - |
626 | \sa user(), setPassword(), password() | - |
627 | */ | - |
628 | void QNetworkProxy::setUser(const QString &user) | - |
629 | { | - |
630 | d->user = user; executed (the execution status of this line is deduced): d->user = user; | - |
631 | } executed: } Execution Count:130 | 130 |
632 | | - |
633 | /*! | - |
634 | Returns the user name used for authentication. | - |
635 | | - |
636 | \sa setUser(), setPassword(), password() | - |
637 | */ | - |
638 | QString QNetworkProxy::user() const | - |
639 | { | - |
640 | return d ? d->user : QString(); executed: return d ? d->user : QString(); Execution Count:1102 | 1102 |
641 | } | - |
642 | | - |
643 | /*! | - |
644 | Sets the password for proxy authentication to be \a password. | - |
645 | | - |
646 | \sa user(), setUser(), password() | - |
647 | */ | - |
648 | void QNetworkProxy::setPassword(const QString &password) | - |
649 | { | - |
650 | d->password = password; executed (the execution status of this line is deduced): d->password = password; | - |
651 | } executed: } Execution Count:21 | 21 |
652 | | - |
653 | /*! | - |
654 | Returns the password used for authentication. | - |
655 | | - |
656 | \sa user(), setPassword(), setUser() | - |
657 | */ | - |
658 | QString QNetworkProxy::password() const | - |
659 | { | - |
660 | return d ? d->password : QString(); executed: return d ? d->password : QString(); Execution Count:224 | 224 |
661 | } | - |
662 | | - |
663 | /*! | - |
664 | Sets the host name of the proxy host to be \a hostName. | - |
665 | | - |
666 | \sa hostName(), setPort(), port() | - |
667 | */ | - |
668 | void QNetworkProxy::setHostName(const QString &hostName) | - |
669 | { | - |
670 | d->hostName = hostName; never executed (the execution status of this line is deduced): d->hostName = hostName; | - |
671 | } | 0 |
672 | | - |
673 | /*! | - |
674 | Returns the host name of the proxy host. | - |
675 | | - |
676 | \sa setHostName(), setPort(), port() | - |
677 | */ | - |
678 | QString QNetworkProxy::hostName() const | - |
679 | { | - |
680 | return d ? d->hostName : QString(); executed: return d ? d->hostName : QString(); Execution Count:723 | 723 |
681 | } | - |
682 | | - |
683 | /*! | - |
684 | Sets the port of the proxy host to be \a port. | - |
685 | | - |
686 | \sa hostName(), setHostName(), port() | - |
687 | */ | - |
688 | void QNetworkProxy::setPort(quint16 port) | - |
689 | { | - |
690 | d->port = port; executed (the execution status of this line is deduced): d->port = port; | - |
691 | } executed: } Execution Count:2 | 2 |
692 | | - |
693 | /*! | - |
694 | Returns the port of the proxy host. | - |
695 | | - |
696 | \sa setHostName(), setPort(), hostName() | - |
697 | */ | - |
698 | quint16 QNetworkProxy::port() const | - |
699 | { | - |
700 | return d ? d->port : 0; executed: return d ? d->port : 0; Execution Count:632 | 632 |
701 | } | - |
702 | | - |
703 | /*! | - |
704 | Sets the application level network proxying to be \a networkProxy. | - |
705 | | - |
706 | If a QAbstractSocket or QTcpSocket has the | - |
707 | QNetworkProxy::DefaultProxy type, then the QNetworkProxy set with | - |
708 | this function is used. If you want more flexibility in determining | - |
709 | which proxy is used, use the QNetworkProxyFactory class. | - |
710 | | - |
711 | Setting a default proxy value with this function will override the | - |
712 | application proxy factory set with | - |
713 | QNetworkProxyFactory::setApplicationProxyFactory. | - |
714 | | - |
715 | \sa QNetworkProxyFactory, applicationProxy(), QAbstractSocket::setProxy(), QTcpServer::setProxy() | - |
716 | */ | - |
717 | void QNetworkProxy::setApplicationProxy(const QNetworkProxy &networkProxy) | - |
718 | { | - |
719 | if (globalNetworkProxy()) { partially evaluated: globalNetworkProxy() yes Evaluation Count:376 | no Evaluation Count:0 |
| 0-376 |
720 | // don't accept setting the proxy to DefaultProxy | - |
721 | if (networkProxy.type() == DefaultProxy) evaluated: networkProxy.type() == DefaultProxy yes Evaluation Count:253 | yes Evaluation Count:123 |
| 123-253 |
722 | globalNetworkProxy()->setApplicationProxy(QNetworkProxy::NoProxy); executed: globalNetworkProxy()->setApplicationProxy(QNetworkProxy::NoProxy); Execution Count:253 | 253 |
723 | else | - |
724 | globalNetworkProxy()->setApplicationProxy(networkProxy); executed: globalNetworkProxy()->setApplicationProxy(networkProxy); Execution Count:123 | 123 |
725 | } | - |
726 | } executed: } Execution Count:376 | 376 |
727 | | - |
728 | /*! | - |
729 | Returns the application level network proxying. | - |
730 | | - |
731 | If a QAbstractSocket or QTcpSocket has the | - |
732 | QNetworkProxy::DefaultProxy type, then the QNetworkProxy returned | - |
733 | by this function is used. | - |
734 | | - |
735 | \sa QNetworkProxyFactory, setApplicationProxy(), QAbstractSocket::proxy(), QTcpServer::proxy() | - |
736 | */ | - |
737 | QNetworkProxy QNetworkProxy::applicationProxy() | - |
738 | { | - |
739 | if (globalNetworkProxy()) partially evaluated: globalNetworkProxy() yes Evaluation Count:856 | no Evaluation Count:0 |
| 0-856 |
740 | return globalNetworkProxy()->applicationProxy(); executed: return globalNetworkProxy()->applicationProxy(); Execution Count:856 | 856 |
741 | return QNetworkProxy(); never executed: return QNetworkProxy(); | 0 |
742 | } | - |
743 | | - |
744 | /*! | - |
745 | \since 5.0 | - |
746 | Returns the value of the known network header \a header if it is | - |
747 | in use for this proxy. If it is not present, returns QVariant() | - |
748 | (i.e., an invalid variant). | - |
749 | | - |
750 | \sa QNetworkRequest::KnownHeaders, rawHeader(), setHeader() | - |
751 | */ | - |
752 | QVariant QNetworkProxy::header(QNetworkRequest::KnownHeaders header) const | - |
753 | { | - |
754 | if (d->type != HttpProxy && d->type != HttpCachingProxy) never evaluated: d->type != HttpProxy never evaluated: d->type != HttpCachingProxy | 0 |
755 | return QVariant(); never executed: return QVariant(); | 0 |
756 | return d->headers.cookedHeaders.value(header); never executed: return d->headers.cookedHeaders.value(header); | 0 |
757 | } | - |
758 | | - |
759 | /*! | - |
760 | \since 5.0 | - |
761 | Sets the value of the known header \a header to be \a value, | - |
762 | overriding any previously set headers. This operation also sets | - |
763 | the equivalent raw HTTP header. | - |
764 | | - |
765 | If the proxy is not of type HttpProxy or HttpCachingProxy this has no | - |
766 | effect. | - |
767 | | - |
768 | \sa QNetworkRequest::KnownHeaders, setRawHeader(), header() | - |
769 | */ | - |
770 | void QNetworkProxy::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value) | - |
771 | { | - |
772 | if (d->type == HttpProxy || d->type == HttpCachingProxy) never evaluated: d->type == HttpProxy never evaluated: d->type == HttpCachingProxy | 0 |
773 | d->headers.setCookedHeader(header, value); never executed: d->headers.setCookedHeader(header, value); | 0 |
774 | } | 0 |
775 | | - |
776 | /*! | - |
777 | \since 5.0 | - |
778 | Returns true if the raw header \a headerName is in use for this | - |
779 | proxy. Returns false if the proxy is not of type HttpProxy or | - |
780 | HttpCachingProxy. | - |
781 | | - |
782 | \sa rawHeader(), setRawHeader() | - |
783 | */ | - |
784 | bool QNetworkProxy::hasRawHeader(const QByteArray &headerName) const | - |
785 | { | - |
786 | if (d->type != HttpProxy && d->type != HttpCachingProxy) partially evaluated: d->type != HttpProxy no Evaluation Count:0 | yes Evaluation Count:25 |
never evaluated: d->type != HttpCachingProxy | 0-25 |
787 | return false; never executed: return false; | 0 |
788 | return d->headers.findRawHeader(headerName) != d->headers.rawHeaders.constEnd(); executed: return d->headers.findRawHeader(headerName) != d->headers.rawHeaders.constEnd(); Execution Count:25 | 25 |
789 | } | - |
790 | | - |
791 | /*! | - |
792 | \since 5.0 | - |
793 | Returns the raw form of header \a headerName. If no such header is | - |
794 | present or the proxy is not of type HttpProxy or HttpCachingProxy, | - |
795 | an empty QByteArray is returned, which may be indistinguishable | - |
796 | from a header that is present but has no content (use hasRawHeader() | - |
797 | to find out if the header exists or not). | - |
798 | | - |
799 | Raw headers can be set with setRawHeader() or with setHeader(). | - |
800 | | - |
801 | \sa header(), setRawHeader() | - |
802 | */ | - |
803 | QByteArray QNetworkProxy::rawHeader(const QByteArray &headerName) const | - |
804 | { | - |
805 | if (d->type != HttpProxy && d->type != HttpCachingProxy) partially evaluated: d->type != HttpProxy no Evaluation Count:0 | yes Evaluation Count:12 |
never evaluated: d->type != HttpCachingProxy | 0-12 |
806 | return QByteArray(); never executed: return QByteArray(); | 0 |
807 | QNetworkHeadersPrivate::RawHeadersList::ConstIterator it = executed (the execution status of this line is deduced): QNetworkHeadersPrivate::RawHeadersList::ConstIterator it = | - |
808 | d->headers.findRawHeader(headerName); executed (the execution status of this line is deduced): d->headers.findRawHeader(headerName); | - |
809 | if (it != d->headers.rawHeaders.constEnd()) partially evaluated: it != d->headers.rawHeaders.constEnd() yes Evaluation Count:12 | no Evaluation Count:0 |
| 0-12 |
810 | return it->second; executed: return it->second; Execution Count:12 | 12 |
811 | return QByteArray(); never executed: return QByteArray(); | 0 |
812 | } | - |
813 | | - |
814 | /*! | - |
815 | \since 5.0 | - |
816 | Returns a list of all raw headers that are set in this network | - |
817 | proxy. The list is in the order that the headers were set. | - |
818 | | - |
819 | If the proxy is not of type HttpProxy or HttpCachingProxy an empty | - |
820 | QList is returned. | - |
821 | | - |
822 | \sa hasRawHeader(), rawHeader() | - |
823 | */ | - |
824 | QList<QByteArray> QNetworkProxy::rawHeaderList() const | - |
825 | { | - |
826 | if (d->type != HttpProxy && d->type != HttpCachingProxy) partially evaluated: d->type != HttpProxy no Evaluation Count:0 | yes Evaluation Count:25 |
never evaluated: d->type != HttpCachingProxy | 0-25 |
827 | return QList<QByteArray>(); never executed: return QList<QByteArray>(); | 0 |
828 | return d->headers.rawHeadersKeys(); executed: return d->headers.rawHeadersKeys(); Execution Count:25 | 25 |
829 | } | - |
830 | | - |
831 | /*! | - |
832 | \since 5.0 | - |
833 | Sets the header \a headerName to be of value \a headerValue. If \a | - |
834 | headerName corresponds to a known header (see | - |
835 | QNetworkRequest::KnownHeaders), the raw format will be parsed and | - |
836 | the corresponding "cooked" header will be set as well. | - |
837 | | - |
838 | For example: | - |
839 | \snippet code/src_network_access_qnetworkrequest.cpp 0 | - |
840 | | - |
841 | will also set the known header LastModifiedHeader to be the | - |
842 | QDateTime object of the parsed date. | - |
843 | | - |
844 | Note: setting the same header twice overrides the previous | - |
845 | setting. To accomplish the behaviour of multiple HTTP headers of | - |
846 | the same name, you should concatenate the two values, separating | - |
847 | them with a comma (",") and set one single raw header. | - |
848 | | - |
849 | If the proxy is not of type HttpProxy or HttpCachingProxy this has no | - |
850 | effect. | - |
851 | | - |
852 | \sa QNetworkRequest::KnownHeaders, setHeader(), hasRawHeader(), rawHeader() | - |
853 | */ | - |
854 | void QNetworkProxy::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue) | - |
855 | { | - |
856 | if (d->type == HttpProxy || d->type == HttpCachingProxy) partially evaluated: d->type == HttpProxy yes Evaluation Count:5 | no Evaluation Count:0 |
never evaluated: d->type == HttpCachingProxy | 0-5 |
857 | d->headers.setRawHeader(headerName, headerValue); executed: d->headers.setRawHeader(headerName, headerValue); Execution Count:5 | 5 |
858 | } executed: } Execution Count:5 | 5 |
859 | | - |
860 | class QNetworkProxyQueryPrivate: public QSharedData | - |
861 | { | - |
862 | public: | - |
863 | inline QNetworkProxyQueryPrivate() | - |
864 | : localPort(-1), type(QNetworkProxyQuery::TcpSocket) | - |
865 | { } executed: } Execution Count:2951 | 2951 |
866 | | - |
867 | bool operator==(const QNetworkProxyQueryPrivate &other) const | - |
868 | { | - |
869 | return type == other.type && executed: return type == other.type && localPort == other.localPort && remote == other.remote; Execution Count:26 | 26 |
870 | localPort == other.localPort && executed: return type == other.type && localPort == other.localPort && remote == other.remote; Execution Count:26 | 26 |
871 | remote == other.remote; executed: return type == other.type && localPort == other.localPort && remote == other.remote; Execution Count:26 | 26 |
872 | } | - |
873 | | - |
874 | QUrl remote; | - |
875 | int localPort; | - |
876 | QNetworkProxyQuery::QueryType type; | - |
877 | #ifndef QT_NO_BEARERMANAGEMENT | - |
878 | QNetworkConfiguration config; | - |
879 | #endif | - |
880 | }; | - |
881 | | - |
882 | template<> void QSharedDataPointer<QNetworkProxyQueryPrivate>::detach() | - |
883 | { | - |
884 | if (d && d->ref.load() == 1) evaluated: d yes Evaluation Count:6813 | yes Evaluation Count:2951 |
partially evaluated: d->ref.load() == 1 yes Evaluation Count:6813 | no Evaluation Count:0 |
| 0-6813 |
885 | return; executed: return; Execution Count:6813 | 6813 |
886 | QNetworkProxyQueryPrivate *x = (d ? new QNetworkProxyQueryPrivate(*d) partially evaluated: d no Evaluation Count:0 | yes Evaluation Count:2951 |
| 0-2951 |
887 | : new QNetworkProxyQueryPrivate); executed (the execution status of this line is deduced): : new QNetworkProxyQueryPrivate); | - |
888 | x->ref.ref(); executed (the execution status of this line is deduced): x->ref.ref(); | - |
889 | if (d && !d->ref.deref()) partially evaluated: d no Evaluation Count:0 | yes Evaluation Count:2951 |
never evaluated: !d->ref.deref() | 0-2951 |
890 | delete d; never executed: delete d; | 0 |
891 | d = x; executed (the execution status of this line is deduced): d = x; | - |
892 | } executed: } Execution Count:2951 | 2951 |
893 | | - |
894 | /*! | - |
895 | \class QNetworkProxyQuery | - |
896 | \since 4.5 | - |
897 | \ingroup shared | - |
898 | \inmodule QtNetwork | - |
899 | \brief The QNetworkProxyQuery class is used to query the proxy | - |
900 | settings for a socket. | - |
901 | | - |
902 | QNetworkProxyQuery holds the details of a socket being created or | - |
903 | request being made. It is used by QNetworkProxy and | - |
904 | QNetworkProxyFactory to allow applications to have a more | - |
905 | fine-grained control over which proxy servers are used, depending | - |
906 | on the details of the query. This allows an application to apply | - |
907 | different settings, according to the protocol or destination | - |
908 | hostname, for instance. | - |
909 | | - |
910 | QNetworkProxyQuery supports the following criteria for selecting | - |
911 | the proxy: | - |
912 | | - |
913 | \list | - |
914 | \li the type of query | - |
915 | \li the local port number to use | - |
916 | \li the destination host name | - |
917 | \li the destination port number | - |
918 | \li the protocol name, such as "http" or "ftp" | - |
919 | \li the URL being requested | - |
920 | \endlist | - |
921 | | - |
922 | The destination host name is the host in the connection in the | - |
923 | case of outgoing connection sockets. It is the \c hostName | - |
924 | parameter passed to QTcpSocket::connectToHost() or the host | - |
925 | component of a URL requested with QNetworkRequest. | - |
926 | | - |
927 | The destination port number is the requested port to connect to in | - |
928 | the case of outgoing sockets, while the local port number is the | - |
929 | port the socket wishes to use locally before attempting the | - |
930 | external connection. In most cases, the local port number is used | - |
931 | by listening sockets only (QTcpSocket) or by datagram sockets | - |
932 | (QUdpSocket). | - |
933 | | - |
934 | The protocol name is an arbitrary string that indicates the type | - |
935 | of connection being attempted. For example, it can match the | - |
936 | scheme of a URL, like "http", "https" and "ftp". In most cases, | - |
937 | the proxy selection will not change depending on the protocol, but | - |
938 | this information is provided in case a better choice can be made, | - |
939 | like choosing an caching HTTP proxy for HTTP-based connections, | - |
940 | but a more powerful SOCKSv5 proxy for all others. | - |
941 | | - |
942 | The network configuration specifies which configuration to use, | - |
943 | when bearer management is used. For example on a mobile phone | - |
944 | the proxy settings are likely to be different for the cellular | - |
945 | network vs WLAN. | - |
946 | | - |
947 | Some of the criteria may not make sense in all of the types of | - |
948 | query. The following table lists the criteria that are most | - |
949 | commonly used, according to the type of query. | - |
950 | | - |
951 | \table | - |
952 | \header | - |
953 | \li Query type | - |
954 | \li Description | - |
955 | | - |
956 | \row | - |
957 | \li TcpSocket | - |
958 | \li Normal sockets requesting a connection to a remote server, | - |
959 | like QTcpSocket. The peer hostname and peer port match the | - |
960 | values passed to QTcpSocket::connectToHost(). The local port | - |
961 | is usually -1, indicating the socket has no preference in | - |
962 | which port should be used. The URL component is not used. | - |
963 | | - |
964 | \row | - |
965 | \li UdpSocket | - |
966 | \li Datagram-based sockets, which can both send and | - |
967 | receive. The local port, remote host or remote port fields | - |
968 | can all be used or be left unused, depending on the | - |
969 | characteristics of the socket. The URL component is not used. | - |
970 | | - |
971 | \row | - |
972 | \li TcpServer | - |
973 | \li Passive server sockets that listen on a port and await | - |
974 | incoming connections from the network. Normally, only the | - |
975 | local port is used, but the remote address could be used in | - |
976 | specific circumstances, for example to indicate which remote | - |
977 | host a connection is expected from. The URL component is not used. | - |
978 | | - |
979 | \row | - |
980 | \li UrlRequest | - |
981 | \li A more high-level request, such as those coming from | - |
982 | QNetworkAccessManager. These requests will inevitably use an | - |
983 | outgoing TCP socket, but the this query type is provided to | - |
984 | indicate that more detailed information is present in the URL | - |
985 | component. For ease of implementation, the URL's host and | - |
986 | port are set as the destination address. | - |
987 | \endtable | - |
988 | | - |
989 | It should be noted that any of the criteria may be missing or | - |
990 | unknown (an empty QString for the hostname or protocol name, -1 | - |
991 | for the port numbers). If that happens, the functions executing | - |
992 | the query should make their best guess or apply some | - |
993 | implementation-defined default values. | - |
994 | | - |
995 | \sa QNetworkProxy, QNetworkProxyFactory, QNetworkAccessManager, | - |
996 | QAbstractSocket::setProxy() | - |
997 | */ | - |
998 | | - |
999 | /*! | - |
1000 | \enum QNetworkProxyQuery::QueryType | - |
1001 | | - |
1002 | Describes the type of one QNetworkProxyQuery query. | - |
1003 | | - |
1004 | \value TcpSocket a normal, outgoing TCP socket | - |
1005 | \value UdpSocket a datagram-based UDP socket, which could send | - |
1006 | to multiple destinations | - |
1007 | \value TcpServer a TCP server that listens for incoming | - |
1008 | connections from the network | - |
1009 | \value UrlRequest a more complex request which involves loading | - |
1010 | of a URL | - |
1011 | | - |
1012 | \sa queryType(), setQueryType() | - |
1013 | */ | - |
1014 | | - |
1015 | /*! | - |
1016 | Constructs a default QNetworkProxyQuery object. By default, the | - |
1017 | query type will be QNetworkProxyQuery::TcpSocket. | - |
1018 | */ | - |
1019 | QNetworkProxyQuery::QNetworkProxyQuery() | - |
1020 | { | - |
1021 | } | - |
1022 | | - |
1023 | /*! | - |
1024 | Constructs a QNetworkProxyQuery with the URL \a requestUrl and | - |
1025 | sets the query type to \a queryType. | - |
1026 | | - |
1027 | \sa protocolTag(), peerHostName(), peerPort() | - |
1028 | */ | - |
1029 | QNetworkProxyQuery::QNetworkProxyQuery(const QUrl &requestUrl, QueryType queryType) | - |
1030 | { | - |
1031 | d->remote = requestUrl; executed (the execution status of this line is deduced): d->remote = requestUrl; | - |
1032 | d->type = queryType; executed (the execution status of this line is deduced): d->type = queryType; | - |
1033 | } executed: } Execution Count:746 | 746 |
1034 | | - |
1035 | /*! | - |
1036 | Constructs a QNetworkProxyQuery of type \a queryType and sets the | - |
1037 | protocol tag to be \a protocolTag. This constructor is suitable | - |
1038 | for QNetworkProxyQuery::TcpSocket queries, because it sets the | - |
1039 | peer hostname to \a hostname and the peer's port number to \a | - |
1040 | port. | - |
1041 | */ | - |
1042 | QNetworkProxyQuery::QNetworkProxyQuery(const QString &hostname, int port, | - |
1043 | const QString &protocolTag, | - |
1044 | QueryType queryType) | - |
1045 | { | - |
1046 | d->remote.setScheme(protocolTag); executed (the execution status of this line is deduced): d->remote.setScheme(protocolTag); | - |
1047 | d->remote.setHost(hostname); executed (the execution status of this line is deduced): d->remote.setHost(hostname); | - |
1048 | d->remote.setPort(port); executed (the execution status of this line is deduced): d->remote.setPort(port); | - |
1049 | d->type = queryType; executed (the execution status of this line is deduced): d->type = queryType; | - |
1050 | } executed: } Execution Count:1657 | 1657 |
1051 | | - |
1052 | /*! | - |
1053 | Constructs a QNetworkProxyQuery of type \a queryType and sets the | - |
1054 | protocol tag to be \a protocolTag. This constructor is suitable | - |
1055 | for QNetworkProxyQuery::TcpSocket queries because it sets the | - |
1056 | local port number to \a bindPort. | - |
1057 | | - |
1058 | Note that \a bindPort is of type quint16 to indicate the exact | - |
1059 | port number that is requested. The value of -1 (unknown) is not | - |
1060 | allowed in this context. | - |
1061 | | - |
1062 | \sa localPort() | - |
1063 | */ | - |
1064 | QNetworkProxyQuery::QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag, | - |
1065 | QueryType queryType) | - |
1066 | { | - |
1067 | d->remote.setScheme(protocolTag); executed (the execution status of this line is deduced): d->remote.setScheme(protocolTag); | - |
1068 | d->localPort = bindPort; executed (the execution status of this line is deduced): d->localPort = bindPort; | - |
1069 | d->type = queryType; executed (the execution status of this line is deduced): d->type = queryType; | - |
1070 | } executed: } Execution Count:438 | 438 |
1071 | | - |
1072 | #ifndef QT_NO_BEARERMANAGEMENT | - |
1073 | /*! | - |
1074 | Constructs a QNetworkProxyQuery with the URL \a requestUrl and | - |
1075 | sets the query type to \a queryType. The specified \a networkConfiguration | - |
1076 | is used to resolve the proxy settings. | - |
1077 | | - |
1078 | \sa protocolTag(), peerHostName(), peerPort(), networkConfiguration() | - |
1079 | */ | - |
1080 | QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkConfiguration &networkConfiguration, | - |
1081 | const QUrl &requestUrl, QueryType queryType) | - |
1082 | { | - |
1083 | d->config = networkConfiguration; executed (the execution status of this line is deduced): d->config = networkConfiguration; | - |
1084 | d->remote = requestUrl; executed (the execution status of this line is deduced): d->remote = requestUrl; | - |
1085 | d->type = queryType; executed (the execution status of this line is deduced): d->type = queryType; | - |
1086 | } executed: } Execution Count:110 | 110 |
1087 | | - |
1088 | /*! | - |
1089 | Constructs a QNetworkProxyQuery of type \a queryType and sets the | - |
1090 | protocol tag to be \a protocolTag. This constructor is suitable | - |
1091 | for QNetworkProxyQuery::TcpSocket queries, because it sets the | - |
1092 | peer hostname to \a hostname and the peer's port number to \a | - |
1093 | port. The specified \a networkConfiguration | - |
1094 | is used to resolve the proxy settings. | - |
1095 | | - |
1096 | \sa networkConfiguration() | - |
1097 | */ | - |
1098 | QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkConfiguration &networkConfiguration, | - |
1099 | const QString &hostname, int port, | - |
1100 | const QString &protocolTag, | - |
1101 | QueryType queryType) | - |
1102 | { | - |
1103 | d->config = networkConfiguration; never executed (the execution status of this line is deduced): d->config = networkConfiguration; | - |
1104 | d->remote.setScheme(protocolTag); never executed (the execution status of this line is deduced): d->remote.setScheme(protocolTag); | - |
1105 | d->remote.setHost(hostname); never executed (the execution status of this line is deduced): d->remote.setHost(hostname); | - |
1106 | d->remote.setPort(port); never executed (the execution status of this line is deduced): d->remote.setPort(port); | - |
1107 | d->type = queryType; never executed (the execution status of this line is deduced): d->type = queryType; | - |
1108 | } | 0 |
1109 | | - |
1110 | /*! | - |
1111 | Constructs a QNetworkProxyQuery of type \a queryType and sets the | - |
1112 | protocol tag to be \a protocolTag. This constructor is suitable | - |
1113 | for QNetworkProxyQuery::TcpSocket queries because it sets the | - |
1114 | local port number to \a bindPort. The specified \a networkConfiguration | - |
1115 | is used to resolve the proxy settings. | - |
1116 | | - |
1117 | Note that \a bindPort is of type quint16 to indicate the exact | - |
1118 | port number that is requested. The value of -1 (unknown) is not | - |
1119 | allowed in this context. | - |
1120 | | - |
1121 | \sa localPort(), networkConfiguration() | - |
1122 | */ | - |
1123 | QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkConfiguration &networkConfiguration, | - |
1124 | quint16 bindPort, const QString &protocolTag, | - |
1125 | QueryType queryType) | - |
1126 | { | - |
1127 | d->config = networkConfiguration; never executed (the execution status of this line is deduced): d->config = networkConfiguration; | - |
1128 | d->remote.setScheme(protocolTag); never executed (the execution status of this line is deduced): d->remote.setScheme(protocolTag); | - |
1129 | d->localPort = bindPort; never executed (the execution status of this line is deduced): d->localPort = bindPort; | - |
1130 | d->type = queryType; never executed (the execution status of this line is deduced): d->type = queryType; | - |
1131 | } | 0 |
1132 | #endif | - |
1133 | | - |
1134 | /*! | - |
1135 | Constructs a QNetworkProxyQuery object that is a copy of \a other. | - |
1136 | */ | - |
1137 | QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other) | - |
1138 | : d(other.d) | - |
1139 | { | - |
1140 | } | 0 |
1141 | | - |
1142 | /*! | - |
1143 | Destroys this QNetworkProxyQuery object. | - |
1144 | */ | - |
1145 | QNetworkProxyQuery::~QNetworkProxyQuery() | - |
1146 | { | - |
1147 | // QSharedDataPointer automatically deletes | - |
1148 | } | - |
1149 | | - |
1150 | /*! | - |
1151 | Copies the contents of \a other. | - |
1152 | */ | - |
1153 | QNetworkProxyQuery &QNetworkProxyQuery::operator=(const QNetworkProxyQuery &other) | - |
1154 | { | - |
1155 | d = other.d; executed (the execution status of this line is deduced): d = other.d; | - |
1156 | return *this; executed: return *this; Execution Count:80 | 80 |
1157 | } | - |
1158 | | - |
1159 | /*! | - |
1160 | \fn void QNetworkProxyQuery::swap(QNetworkProxyQuery &other) | - |
1161 | \since 5.0 | - |
1162 | | - |
1163 | Swaps this network proxy query instance with \a other. This | - |
1164 | function is very fast and never fails. | - |
1165 | */ | - |
1166 | | - |
1167 | /*! | - |
1168 | Returns true if this QNetworkProxyQuery object contains the same | - |
1169 | data as \a other. | - |
1170 | */ | - |
1171 | bool QNetworkProxyQuery::operator==(const QNetworkProxyQuery &other) const | - |
1172 | { | - |
1173 | return d == other.d || (d && other.d && *d == *other.d); executed: return d == other.d || (d && other.d && *d == *other.d); Execution Count:26 | 26 |
1174 | } | - |
1175 | | - |
1176 | /*! | - |
1177 | \fn bool QNetworkProxyQuery::operator!=(const QNetworkProxyQuery &other) const | - |
1178 | | - |
1179 | Returns true if this QNetworkProxyQuery object does not contain | - |
1180 | the same data as \a other. | - |
1181 | */ | - |
1182 | | - |
1183 | /*! | - |
1184 | Returns the query type. | - |
1185 | */ | - |
1186 | QNetworkProxyQuery::QueryType QNetworkProxyQuery::queryType() const | - |
1187 | { | - |
1188 | return d ? d->type : TcpSocket; never executed: return d ? d->type : TcpSocket; | 0 |
1189 | } | - |
1190 | | - |
1191 | /*! | - |
1192 | Sets the query type of this object to be \a type. | - |
1193 | */ | - |
1194 | void QNetworkProxyQuery::setQueryType(QueryType type) | - |
1195 | { | - |
1196 | d->type = type; never executed (the execution status of this line is deduced): d->type = type; | - |
1197 | } | 0 |
1198 | | - |
1199 | /*! | - |
1200 | Returns the port number for the outgoing request or -1 if the port | - |
1201 | number is not known. | - |
1202 | | - |
1203 | If the query type is QNetworkProxyQuery::UrlRequest, this function | - |
1204 | returns the port number of the URL being requested. In general, | - |
1205 | frameworks will fill in the port number from their default values. | - |
1206 | | - |
1207 | \sa peerHostName(), localPort(), setPeerPort() | - |
1208 | */ | - |
1209 | int QNetworkProxyQuery::peerPort() const | - |
1210 | { | - |
1211 | return d ? d->remote.port() : -1; never executed: return d ? d->remote.port() : -1; | 0 |
1212 | } | - |
1213 | | - |
1214 | /*! | - |
1215 | Sets the requested port number for the outgoing connection to be | - |
1216 | \a port. Valid values are 1 to 65535, or -1 to indicate that the | - |
1217 | remote port number is unknown. | - |
1218 | | - |
1219 | The peer port number can also be used to indicate the expected | - |
1220 | port number of an incoming connection in the case of | - |
1221 | QNetworkProxyQuery::UdpSocket or QNetworkProxyQuery::TcpServer | - |
1222 | query types. | - |
1223 | | - |
1224 | \sa peerPort(), setPeerHostName(), setLocalPort() | - |
1225 | */ | - |
1226 | void QNetworkProxyQuery::setPeerPort(int port) | - |
1227 | { | - |
1228 | d->remote.setPort(port); never executed (the execution status of this line is deduced): d->remote.setPort(port); | - |
1229 | } | 0 |
1230 | | - |
1231 | /*! | - |
1232 | Returns the host name or IP address being of the outgoing | - |
1233 | connection being requested, or an empty string if the remote | - |
1234 | hostname is not known. | - |
1235 | | - |
1236 | If the query type is QNetworkProxyQuery::UrlRequest, this function | - |
1237 | returns the host component of the URL being requested. | - |
1238 | | - |
1239 | \sa peerPort(), localPort(), setPeerHostName() | - |
1240 | */ | - |
1241 | QString QNetworkProxyQuery::peerHostName() const | - |
1242 | { | - |
1243 | return d ? d->remote.host() : QString(); executed: return d ? d->remote.host() : QString(); Execution Count:41 | 41 |
1244 | } | - |
1245 | | - |
1246 | /*! | - |
1247 | Sets the hostname of the outgoing connection being requested to \a | - |
1248 | hostname. An empty hostname can be used to indicate that the | - |
1249 | remote host is unknown. | - |
1250 | | - |
1251 | The peer host name can also be used to indicate the expected | - |
1252 | source address of an incoming connection in the case of | - |
1253 | QNetworkProxyQuery::UdpSocket or QNetworkProxyQuery::TcpServer | - |
1254 | query types. | - |
1255 | | - |
1256 | \sa peerHostName(), setPeerPort(), setLocalPort() | - |
1257 | */ | - |
1258 | void QNetworkProxyQuery::setPeerHostName(const QString &hostname) | - |
1259 | { | - |
1260 | d->remote.setHost(hostname); never executed (the execution status of this line is deduced): d->remote.setHost(hostname); | - |
1261 | } | 0 |
1262 | | - |
1263 | /*! | - |
1264 | Returns the port number of the socket that will accept incoming | - |
1265 | packets from remote servers or -1 if the port is not known. | - |
1266 | | - |
1267 | \sa peerPort(), peerHostName(), setLocalPort() | - |
1268 | */ | - |
1269 | int QNetworkProxyQuery::localPort() const | - |
1270 | { | - |
1271 | return d ? d->localPort : -1; never executed: return d ? d->localPort : -1; | 0 |
1272 | } | - |
1273 | | - |
1274 | /*! | - |
1275 | Sets the port number that the socket wishes to use locally to | - |
1276 | accept incoming packets from remote servers to \a port. The local | - |
1277 | port is most often used with the QNetworkProxyQuery::TcpServer | - |
1278 | and QNetworkProxyQuery::UdpSocket query types. | - |
1279 | | - |
1280 | Valid values are 0 to 65535 (with 0 indicating that any port | - |
1281 | number will be acceptable) or -1, which means the local port | - |
1282 | number is unknown or not applicable. | - |
1283 | | - |
1284 | In some circumstances, for special protocols, it's the local port | - |
1285 | number can also be used with a query of type | - |
1286 | QNetworkProxyQuery::TcpSocket. When that happens, the socket is | - |
1287 | indicating it wishes to use the port number \a port when | - |
1288 | connecting to a remote host. | - |
1289 | | - |
1290 | \sa localPort(), setPeerPort(), setPeerHostName() | - |
1291 | */ | - |
1292 | void QNetworkProxyQuery::setLocalPort(int port) | - |
1293 | { | - |
1294 | d->localPort = port; never executed (the execution status of this line is deduced): d->localPort = port; | - |
1295 | } | 0 |
1296 | | - |
1297 | /*! | - |
1298 | Returns the protocol tag for this QNetworkProxyQuery object, or an | - |
1299 | empty QString in case the protocol tag is unknown. | - |
1300 | | - |
1301 | In the case of queries of type QNetworkProxyQuery::UrlRequest, | - |
1302 | this function returns the value of the scheme component of the | - |
1303 | URL. | - |
1304 | | - |
1305 | \sa setProtocolTag(), url() | - |
1306 | */ | - |
1307 | QString QNetworkProxyQuery::protocolTag() const | - |
1308 | { | - |
1309 | return d ? d->remote.scheme() : QString(); executed: return d ? d->remote.scheme() : QString(); Execution Count:32 | 32 |
1310 | } | - |
1311 | | - |
1312 | /*! | - |
1313 | Sets the protocol tag for this QNetworkProxyQuery object to be \a | - |
1314 | protocolTag. | - |
1315 | | - |
1316 | The protocol tag is an arbitrary string that indicates which | - |
1317 | protocol is being talked over the socket, such as "http", "xmpp", | - |
1318 | "telnet", etc. The protocol tag is used by the backend to | - |
1319 | return a request that is more specific to the protocol in | - |
1320 | question: for example, a HTTP connection could be use a caching | - |
1321 | HTTP proxy server, while all other connections use a more powerful | - |
1322 | SOCKSv5 proxy server. | - |
1323 | | - |
1324 | \sa protocolTag() | - |
1325 | */ | - |
1326 | void QNetworkProxyQuery::setProtocolTag(const QString &protocolTag) | - |
1327 | { | - |
1328 | d->remote.setScheme(protocolTag); never executed (the execution status of this line is deduced): d->remote.setScheme(protocolTag); | - |
1329 | } | 0 |
1330 | | - |
1331 | /*! | - |
1332 | Returns the URL component of this QNetworkProxyQuery object in | - |
1333 | case of a query of type QNetworkProxyQuery::UrlRequest. | - |
1334 | | - |
1335 | \sa setUrl() | - |
1336 | */ | - |
1337 | QUrl QNetworkProxyQuery::url() const | - |
1338 | { | - |
1339 | return d ? d->remote : QUrl(); executed: return d ? d->remote : QUrl(); Execution Count:3585 | 3585 |
1340 | } | - |
1341 | | - |
1342 | /*! | - |
1343 | Sets the URL component of this QNetworkProxyQuery object to be \a | - |
1344 | url. Setting the URL will also set the protocol tag, the remote | - |
1345 | host name and port number. This is done so as to facilitate the | - |
1346 | implementation of the code that determines the proxy server to be | - |
1347 | used. | - |
1348 | | - |
1349 | \sa url(), peerHostName(), peerPort() | - |
1350 | */ | - |
1351 | void QNetworkProxyQuery::setUrl(const QUrl &url) | - |
1352 | { | - |
1353 | d->remote = url; never executed (the execution status of this line is deduced): d->remote = url; | - |
1354 | } | 0 |
1355 | | - |
1356 | #ifndef QT_NO_BEARERMANAGEMENT | - |
1357 | /*! | - |
1358 | Returns the network configuration component of the query. | - |
1359 | | - |
1360 | \sa setNetworkConfiguration() | - |
1361 | */ | - |
1362 | QNetworkConfiguration QNetworkProxyQuery::networkConfiguration() const | - |
1363 | { | - |
1364 | return d ? d->config : QNetworkConfiguration(); never executed: return d ? d->config : QNetworkConfiguration(); | 0 |
1365 | } | - |
1366 | | - |
1367 | /*! | - |
1368 | Sets the network configuration component of this QNetworkProxyQuery | - |
1369 | object to be \a networkConfiguration. The network configuration can | - |
1370 | be used to return different proxy settings based on the network in | - |
1371 | use, for example WLAN vs cellular networks on a mobile phone. | - |
1372 | | - |
1373 | In the case of "user choice" or "service network" configurations, | - |
1374 | you should first start the QNetworkSession and obtain the active | - |
1375 | configuration from its properties. | - |
1376 | | - |
1377 | \sa networkConfiguration() | - |
1378 | */ | - |
1379 | void QNetworkProxyQuery::setNetworkConfiguration(const QNetworkConfiguration &networkConfiguration) | - |
1380 | { | - |
1381 | d->config = networkConfiguration; never executed (the execution status of this line is deduced): d->config = networkConfiguration; | - |
1382 | } | 0 |
1383 | #endif | - |
1384 | | - |
1385 | /*! | - |
1386 | \class QNetworkProxyFactory | - |
1387 | \brief The QNetworkProxyFactory class provides fine-grained proxy selection. | - |
1388 | \since 4.5 | - |
1389 | | - |
1390 | \ingroup network | - |
1391 | \inmodule QtNetwork | - |
1392 | | - |
1393 | QNetworkProxyFactory is an extension to QNetworkProxy, allowing | - |
1394 | applications to have a more fine-grained control over which proxy | - |
1395 | servers are used, depending on the socket requesting the | - |
1396 | proxy. This allows an application to apply different settings, | - |
1397 | according to the protocol or destination hostname, for instance. | - |
1398 | | - |
1399 | QNetworkProxyFactory can be set globally for an application, in | - |
1400 | which case it will override any global proxies set with | - |
1401 | QNetworkProxy::setApplicationProxy(). If set globally, any sockets | - |
1402 | created with Qt will query the factory to determine the proxy to | - |
1403 | be used. | - |
1404 | | - |
1405 | A factory can also be set in certain frameworks that support | - |
1406 | multiple connections, such as QNetworkAccessManager. When set on | - |
1407 | such object, the factory will be queried for sockets created by | - |
1408 | that framework only. | - |
1409 | | - |
1410 | \section1 System Proxies | - |
1411 | | - |
1412 | You can configure a factory to use the system proxy's settings. | - |
1413 | Call the setUseSystemConfiguration() function with true to enable | - |
1414 | this behavior, or false to disable it. | - |
1415 | | - |
1416 | Similarly, you can use a factory to make queries directly to the | - |
1417 | system proxy by calling its systemProxyForQuery() function. | - |
1418 | | - |
1419 | \warning Depending on the configuration of the user's system, the | - |
1420 | use of system proxy features on certain platforms may be subject | - |
1421 | to limitations. The systemProxyForQuery() documentation contains a | - |
1422 | list of these limitations for those platforms that are affected. | - |
1423 | */ | - |
1424 | | - |
1425 | /*! | - |
1426 | Creates a QNetworkProxyFactory object. | - |
1427 | | - |
1428 | Since QNetworkProxyFactory is an abstract class, you cannot create | - |
1429 | objects of type QNetworkProxyFactory directly. | - |
1430 | */ | - |
1431 | QNetworkProxyFactory::QNetworkProxyFactory() | - |
1432 | { | - |
1433 | } | - |
1434 | | - |
1435 | /*! | - |
1436 | Destroys the QNetworkProxyFactory object. | - |
1437 | */ | - |
1438 | QNetworkProxyFactory::~QNetworkProxyFactory() | - |
1439 | { | - |
1440 | } | - |
1441 | | - |
1442 | | - |
1443 | /*! | - |
1444 | \since 4.6 | - |
1445 | | - |
1446 | Enables the use of the platform-specific proxy settings, and only those. | - |
1447 | See systemProxyForQuery() for more information. | - |
1448 | | - |
1449 | Internally, this method (when called with \a enable set to true) | - |
1450 | sets an application-wide proxy factory. For this reason, this method | - |
1451 | is mutually exclusive with setApplicationProxyFactory(): calling | - |
1452 | setApplicationProxyFactory() overrides the use of the system-wide proxy, | - |
1453 | and calling setUseSystemConfiguration() overrides any | - |
1454 | application proxy or proxy factory that was previously set. | - |
1455 | | - |
1456 | \note See the systemProxyForQuery() documentation for a list of | - |
1457 | limitations related to the use of system proxies. | - |
1458 | */ | - |
1459 | void QNetworkProxyFactory::setUseSystemConfiguration(bool enable) | - |
1460 | { | - |
1461 | if (enable) { | 0 |
1462 | setApplicationProxyFactory(new QSystemConfigurationProxyFactory); never executed (the execution status of this line is deduced): setApplicationProxyFactory(new QSystemConfigurationProxyFactory); | - |
1463 | } else { | 0 |
1464 | setApplicationProxyFactory(0); never executed (the execution status of this line is deduced): setApplicationProxyFactory(0); | - |
1465 | } | 0 |
1466 | } | - |
1467 | | - |
1468 | /*! | - |
1469 | Sets the application-wide proxy factory to be \a factory. This | - |
1470 | function will take ownership of that object and will delete it | - |
1471 | when necessary. | - |
1472 | | - |
1473 | The application-wide proxy is used as a last-resort when all other | - |
1474 | proxy selection requests returned QNetworkProxy::DefaultProxy. For | - |
1475 | example, QTcpSocket objects can have a proxy set with | - |
1476 | QTcpSocket::setProxy, but if none is set, the proxy factory class | - |
1477 | set with this function will be queried. | - |
1478 | | - |
1479 | If you set a proxy factory with this function, any application | - |
1480 | level proxies set with QNetworkProxy::setApplicationProxy will be | - |
1481 | overridden. | - |
1482 | | - |
1483 | \sa QNetworkProxy::setApplicationProxy(), | - |
1484 | QAbstractSocket::proxy(), QAbstractSocket::setProxy() | - |
1485 | */ | - |
1486 | void QNetworkProxyFactory::setApplicationProxyFactory(QNetworkProxyFactory *factory) | - |
1487 | { | - |
1488 | if (globalNetworkProxy()) partially evaluated: globalNetworkProxy() yes Evaluation Count:8 | no Evaluation Count:0 |
| 0-8 |
1489 | globalNetworkProxy()->setApplicationProxyFactory(factory); executed: globalNetworkProxy()->setApplicationProxyFactory(factory); Execution Count:8 | 8 |
1490 | } executed: } Execution Count:8 | 8 |
1491 | | - |
1492 | /*! | - |
1493 | \fn QList<QNetworkProxy> QNetworkProxyFactory::queryProxy(const QNetworkProxyQuery &query) | - |
1494 | | - |
1495 | This function takes the query request, \a query, | - |
1496 | examines the details of the type of socket or request and returns | - |
1497 | a list of QNetworkProxy objects that indicate the proxy servers to | - |
1498 | be used, in order of preference. | - |
1499 | | - |
1500 | When reimplementing this class, take care to return at least one | - |
1501 | element. | - |
1502 | | - |
1503 | If you cannot determine a better proxy alternative, use | - |
1504 | QNetworkProxy::DefaultProxy, which tells the code querying for a | - |
1505 | proxy to use a higher alternative. For example, if this factory is | - |
1506 | set to a QNetworkAccessManager object, DefaultProxy will tell it | - |
1507 | to query the application-level proxy settings. | - |
1508 | | - |
1509 | If this factory is set as the application proxy factory, | - |
1510 | DefaultProxy and NoProxy will have the same meaning. | - |
1511 | */ | - |
1512 | | - |
1513 | /*! | - |
1514 | \fn QList<QNetworkProxy> QNetworkProxyFactory::systemProxyForQuery(const QNetworkProxyQuery &query) | - |
1515 | | - |
1516 | This function takes the query request, \a query, | - |
1517 | examines the details of the type of socket or request and returns | - |
1518 | a list of QNetworkProxy objects that indicate the proxy servers to | - |
1519 | be used, in order of preference. | - |
1520 | | - |
1521 | This function can be used to determine the platform-specific proxy | - |
1522 | settings. This function will use the libraries provided by the | - |
1523 | operating system to determine the proxy for a given connection, if | - |
1524 | such libraries exist. If they don't, this function will just return a | - |
1525 | QNetworkProxy of type QNetworkProxy::NoProxy. | - |
1526 | | - |
1527 | On Windows, this function will use the WinHTTP DLL functions. Despite | - |
1528 | its name, Microsoft suggests using it for all applications that | - |
1529 | require network connections, not just HTTP. This will respect the | - |
1530 | proxy settings set on the registry with the proxycfg.exe tool. If | - |
1531 | those settings are not found, this function will attempt to obtain | - |
1532 | Internet Explorer's settings and use them. | - |
1533 | | - |
1534 | On MacOS X, this function will obtain the proxy settings using the | - |
1535 | SystemConfiguration framework from Apple. It will apply the FTP, | - |
1536 | HTTP and HTTPS proxy configurations for queries that contain the | - |
1537 | protocol tag "ftp", "http" and "https", respectively. If the SOCKS | - |
1538 | proxy is enabled in that configuration, this function will use the | - |
1539 | SOCKS server for all queries. If SOCKS isn't enabled, it will use | - |
1540 | the HTTPS proxy for all TcpSocket and UrlRequest queries. | - |
1541 | | - |
1542 | On BlackBerry, this function obtains proxy settings for the default | - |
1543 | configuration using system configuration. The type will be set based on | - |
1544 | protocol tag "http", "https", "ftp", respectively. By default, it | - |
1545 | assumes http type. Proxy username and password are also set during | - |
1546 | the query using system configuration. | - |
1547 | | - |
1548 | On other systems, this function will pick up proxy settings from | - |
1549 | the "http_proxy" environment variable. This variable must be a URL | - |
1550 | using one of the following schemes: "http", "socks5" or "socks5h". | - |
1551 | | - |
1552 | \section1 Limitations | - |
1553 | | - |
1554 | These are the limitations for the current version of this | - |
1555 | function. Future versions of Qt may lift some of the limitations | - |
1556 | listed here. | - |
1557 | | - |
1558 | \list | - |
1559 | \li On MacOS X, this function will ignore the Proxy Auto Configuration | - |
1560 | settings, since it cannot execute the associated ECMAScript code. | - |
1561 | | - |
1562 | \li On Windows platforms, this function may take several seconds to | - |
1563 | execute depending on the configuration of the user's system. | - |
1564 | | - |
1565 | \li On BlackBerry, only UrlRequest queries are supported. SOCKS is | - |
1566 | not supported. The proxy credentials are only retrieved for the | - |
1567 | default configuration. | - |
1568 | \endlist | - |
1569 | */ | - |
1570 | | - |
1571 | /*! | - |
1572 | This function takes the query request, \a query, | - |
1573 | examines the details of the type of socket or request and returns | - |
1574 | a list of QNetworkProxy objects that indicate the proxy servers to | - |
1575 | be used, in order of preference. | - |
1576 | */ | - |
1577 | QList<QNetworkProxy> QNetworkProxyFactory::proxyForQuery(const QNetworkProxyQuery &query) | - |
1578 | { | - |
1579 | if (!globalNetworkProxy()) partially evaluated: !globalNetworkProxy() no Evaluation Count:0 | yes Evaluation Count:2729 |
| 0-2729 |
1580 | return QList<QNetworkProxy>() << QNetworkProxy(QNetworkProxy::NoProxy); never executed: return QList<QNetworkProxy>() << QNetworkProxy(QNetworkProxy::NoProxy); | 0 |
1581 | return globalNetworkProxy()->proxyForQuery(query); executed: return globalNetworkProxy()->proxyForQuery(query); Execution Count:2729 | 2729 |
1582 | } | - |
1583 | | - |
1584 | #ifndef QT_NO_DEBUG_STREAM | - |
1585 | /*! | - |
1586 | \since 5.0 | - |
1587 | Outputs a QNetworkProxy details to a debug stream | - |
1588 | */ | - |
1589 | QDebug operator<<(QDebug debug, const QNetworkProxy &proxy) | - |
1590 | { | - |
1591 | QNetworkProxy::ProxyType type = proxy.type(); executed (the execution status of this line is deduced): QNetworkProxy::ProxyType type = proxy.type(); | - |
1592 | switch (type) { | - |
1593 | case QNetworkProxy::NoProxy: | - |
1594 | debug << "NoProxy "; executed (the execution status of this line is deduced): debug << "NoProxy "; | - |
1595 | break; executed: break; Execution Count:25 | 25 |
1596 | case QNetworkProxy::DefaultProxy: | - |
1597 | debug << "DefaultProxy "; never executed (the execution status of this line is deduced): debug << "DefaultProxy "; | - |
1598 | break; | 0 |
1599 | case QNetworkProxy::Socks5Proxy: | - |
1600 | debug << "Socks5Proxy "; never executed (the execution status of this line is deduced): debug << "Socks5Proxy "; | - |
1601 | break; | 0 |
1602 | case QNetworkProxy::HttpProxy: | - |
1603 | debug << "HttpProxy "; never executed (the execution status of this line is deduced): debug << "HttpProxy "; | - |
1604 | break; | 0 |
1605 | case QNetworkProxy::HttpCachingProxy: | - |
1606 | debug << "HttpCachingProxy "; never executed (the execution status of this line is deduced): debug << "HttpCachingProxy "; | - |
1607 | break; | 0 |
1608 | case QNetworkProxy::FtpCachingProxy: | - |
1609 | debug << "FtpCachingProxy "; never executed (the execution status of this line is deduced): debug << "FtpCachingProxy "; | - |
1610 | break; | 0 |
1611 | default: | - |
1612 | debug << "Unknown proxy " << int(type); never executed (the execution status of this line is deduced): debug << "Unknown proxy " << int(type); | - |
1613 | break; | 0 |
1614 | } | - |
1615 | debug << "\"" << proxy.hostName() << ":" << proxy.port() << "\" "; executed (the execution status of this line is deduced): debug << "\"" << proxy.hostName() << ":" << proxy.port() << "\" "; | - |
1616 | QNetworkProxy::Capabilities caps = proxy.capabilities(); executed (the execution status of this line is deduced): QNetworkProxy::Capabilities caps = proxy.capabilities(); | - |
1617 | QStringList scaps; executed (the execution status of this line is deduced): QStringList scaps; | - |
1618 | if (caps & QNetworkProxy::TunnelingCapability) partially evaluated: caps & QNetworkProxy::TunnelingCapability yes Evaluation Count:25 | no Evaluation Count:0 |
| 0-25 |
1619 | scaps << QStringLiteral("Tunnel"); executed: scaps << QString::fromUtf8("" "Tunnel" "", sizeof("Tunnel") - 1); Execution Count:25 | 25 |
1620 | if (caps & QNetworkProxy::ListeningCapability) partially evaluated: caps & QNetworkProxy::ListeningCapability yes Evaluation Count:25 | no Evaluation Count:0 |
| 0-25 |
1621 | scaps << QStringLiteral("Listen"); executed: scaps << QString::fromUtf8("" "Listen" "", sizeof("Listen") - 1); Execution Count:25 | 25 |
1622 | if (caps & QNetworkProxy::UdpTunnelingCapability) partially evaluated: caps & QNetworkProxy::UdpTunnelingCapability yes Evaluation Count:25 | no Evaluation Count:0 |
| 0-25 |
1623 | scaps << QStringLiteral("UDP"); executed: scaps << QString::fromUtf8("" "UDP" "", sizeof("UDP") - 1); Execution Count:25 | 25 |
1624 | if (caps & QNetworkProxy::CachingCapability) partially evaluated: caps & QNetworkProxy::CachingCapability no Evaluation Count:0 | yes Evaluation Count:25 |
| 0-25 |
1625 | scaps << QStringLiteral("Caching"); never executed: scaps << QString::fromUtf8("" "Caching" "", sizeof("Caching") - 1); | 0 |
1626 | if (caps & QNetworkProxy::HostNameLookupCapability) partially evaluated: caps & QNetworkProxy::HostNameLookupCapability no Evaluation Count:0 | yes Evaluation Count:25 |
| 0-25 |
1627 | scaps << QStringLiteral("NameLookup"); never executed: scaps << QString::fromUtf8("" "NameLookup" "", sizeof("NameLookup") - 1); | 0 |
1628 | debug << "[" << scaps.join(QLatin1Char(' ')) << "]"; executed (the execution status of this line is deduced): debug << "[" << scaps.join(QLatin1Char(' ')) << "]"; | - |
1629 | return debug; executed: return debug; Execution Count:25 | 25 |
1630 | } | - |
1631 | #endif | - |
1632 | | - |
1633 | QT_END_NAMESPACE | - |
1634 | | - |
1635 | #endif // QT_NO_NETWORKPROXY | - |
1636 | | - |
| | |