1 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef NET_SPDY_SPDY_TEST_UTIL_COMMON_H_
6 #define NET_SPDY_SPDY_TEST_UTIL_COMMON_H_
11 #include "base/memory/ref_counted.h"
12 #include "base/memory/scoped_ptr.h"
13 #include "crypto/ec_private_key.h"
14 #include "crypto/ec_signature_creator.h"
15 #include "net/base/completion_callback.h"
16 #include "net/base/request_priority.h"
17 #include "net/base/test_completion_callback.h"
18 #include "net/cert/cert_verifier.h"
19 #include "net/dns/mock_host_resolver.h"
20 #include "net/http/http_auth_handler_factory.h"
21 #include "net/http/http_network_session.h"
22 #include "net/http/http_response_info.h"
23 #include "net/http/http_server_properties_impl.h"
24 #include "net/http/transport_security_state.h"
25 #include "net/proxy/proxy_service.h"
26 #include "net/socket/next_proto.h"
27 #include "net/socket/socket_test_util.h"
28 #include "net/spdy/spdy_protocol.h"
29 #include "net/ssl/ssl_config_service_defaults.h"
30 #include "net/url_request/url_request_context.h"
31 #include "net/url_request/url_request_context_storage.h"
32 #include "testing/gtest/include/gtest/gtest.h"
41 class SpdySessionPool
;
43 class SpdyStreamRequest
;
45 // Default upload data used by both, mock objects and framer when creating
47 const char kDefaultURL
[] = "http://www.google.com";
48 const char kUploadData
[] = "hello!";
49 const int kUploadDataSize
= arraysize(kUploadData
)-1;
51 // SpdyNextProtos returns a vector of next protocols for negotiating
53 NextProtoVector
SpdyNextProtos();
55 // Chop a frame into an array of MockWrites.
56 // |data| is the frame to chop.
57 // |length| is the length of the frame to chop.
58 // |num_chunks| is the number of chunks to create.
59 MockWrite
* ChopWriteFrame(const char* data
, int length
, int num_chunks
);
61 // Chop a SpdyFrame into an array of MockWrites.
62 // |frame| is the frame to chop.
63 // |num_chunks| is the number of chunks to create.
64 MockWrite
* ChopWriteFrame(const SpdyFrame
& frame
, int num_chunks
);
66 // Chop a frame into an array of MockReads.
67 // |data| is the frame to chop.
68 // |length| is the length of the frame to chop.
69 // |num_chunks| is the number of chunks to create.
70 MockRead
* ChopReadFrame(const char* data
, int length
, int num_chunks
);
72 // Chop a SpdyFrame into an array of MockReads.
73 // |frame| is the frame to chop.
74 // |num_chunks| is the number of chunks to create.
75 MockRead
* ChopReadFrame(const SpdyFrame
& frame
, int num_chunks
);
77 // Adds headers and values to a map.
78 // |extra_headers| is an array of { name, value } pairs, arranged as strings
79 // where the even entries are the header names, and the odd entries are the
81 // |headers| gets filled in from |extra_headers|.
82 void AppendToHeaderBlock(const char* const extra_headers
[],
83 int extra_header_count
,
84 SpdyHeaderBlock
* headers
);
86 // Create an async MockWrite from the given SpdyFrame.
87 MockWrite
CreateMockWrite(const SpdyFrame
& req
);
89 // Create an async MockWrite from the given SpdyFrame and sequence number.
90 MockWrite
CreateMockWrite(const SpdyFrame
& req
, int seq
);
92 MockWrite
CreateMockWrite(const SpdyFrame
& req
, int seq
, IoMode mode
);
94 // Create a MockRead from the given SpdyFrame.
95 MockRead
CreateMockRead(const SpdyFrame
& resp
);
97 // Create a MockRead from the given SpdyFrame and sequence number.
98 MockRead
CreateMockRead(const SpdyFrame
& resp
, int seq
);
100 MockRead
CreateMockRead(const SpdyFrame
& resp
, int seq
, IoMode mode
);
102 // Combines the given SpdyFrames into the given char array and returns
104 int CombineFrames(const SpdyFrame
** frames
, int num_frames
,
105 char* buff
, int buff_len
);
107 // Returns the SpdyPriority embedded in the given frame. Returns true
108 // and fills in |priority| on success.
109 bool GetSpdyPriority(SpdyMajorVersion version
,
110 const SpdyFrame
& frame
,
111 SpdyPriority
* priority
);
113 // Tries to create a stream in |session| synchronously. Returns NULL
115 base::WeakPtr
<SpdyStream
> CreateStreamSynchronously(
117 const base::WeakPtr
<SpdySession
>& session
,
119 RequestPriority priority
,
120 const BoundNetLog
& net_log
);
122 // Helper class used by some tests to release a stream as soon as it's
124 class StreamReleaserCallback
: public TestCompletionCallbackBase
{
126 StreamReleaserCallback();
128 ~StreamReleaserCallback() override
;
130 // Returns a callback that releases |request|'s stream.
131 CompletionCallback
MakeCallback(SpdyStreamRequest
* request
);
134 void OnComplete(SpdyStreamRequest
* request
, int result
);
137 const size_t kSpdyCredentialSlotUnused
= 0;
139 // This struct holds information used to construct spdy control and data frames.
140 struct SpdyHeaderInfo
{
143 SpdyStreamId assoc_id
;
144 SpdyPriority priority
;
145 size_t credential_slot
; // SPDY3 only
146 SpdyControlFlags control_flags
;
148 SpdyRstStreamStatus status
;
151 SpdyDataFlags data_flags
;
154 // An ECSignatureCreator that returns deterministic signatures.
155 class MockECSignatureCreator
: public crypto::ECSignatureCreator
{
157 explicit MockECSignatureCreator(crypto::ECPrivateKey
* key
);
159 // crypto::ECSignatureCreator
160 bool Sign(const uint8
* data
,
162 std::vector
<uint8
>* signature
) override
;
163 bool DecodeSignature(const std::vector
<uint8
>& signature
,
164 std::vector
<uint8
>* out_raw_sig
) override
;
167 crypto::ECPrivateKey
* key_
;
169 DISALLOW_COPY_AND_ASSIGN(MockECSignatureCreator
);
172 // An ECSignatureCreatorFactory creates MockECSignatureCreator.
173 class MockECSignatureCreatorFactory
: public crypto::ECSignatureCreatorFactory
{
175 MockECSignatureCreatorFactory();
176 ~MockECSignatureCreatorFactory() override
;
178 // crypto::ECSignatureCreatorFactory
179 crypto::ECSignatureCreator
* Create(crypto::ECPrivateKey
* key
) override
;
182 DISALLOW_COPY_AND_ASSIGN(MockECSignatureCreatorFactory
);
185 // Helper to manage the lifetimes of the dependencies for a
186 // HttpNetworkTransaction.
187 struct SpdySessionDependencies
{
188 // Default set of dependencies -- "null" proxy service.
189 explicit SpdySessionDependencies(NextProto protocol
);
191 // Custom proxy service dependency.
192 SpdySessionDependencies(NextProto protocol
, ProxyService
* proxy_service
);
194 ~SpdySessionDependencies();
196 static HttpNetworkSession
* SpdyCreateSession(
197 SpdySessionDependencies
* session_deps
);
198 static HttpNetworkSession
* SpdyCreateSessionDeterministic(
199 SpdySessionDependencies
* session_deps
);
200 static HttpNetworkSession::Params
CreateSessionParams(
201 SpdySessionDependencies
* session_deps
);
203 // NOTE: host_resolver must be ordered before http_auth_handler_factory.
204 scoped_ptr
<MockHostResolverBase
> host_resolver
;
205 scoped_ptr
<CertVerifier
> cert_verifier
;
206 scoped_ptr
<TransportSecurityState
> transport_security_state
;
207 scoped_ptr
<ProxyService
> proxy_service
;
208 scoped_refptr
<SSLConfigService
> ssl_config_service
;
209 scoped_ptr
<MockClientSocketFactory
> socket_factory
;
210 scoped_ptr
<DeterministicMockClientSocketFactory
> deterministic_socket_factory
;
211 scoped_ptr
<HttpAuthHandlerFactory
> http_auth_handler_factory
;
212 HttpServerPropertiesImpl http_server_properties
;
213 bool enable_ip_pooling
;
214 bool enable_compression
;
216 bool enable_user_alternate_protocol_ports
;
218 size_t stream_initial_recv_window_size
;
219 SpdySession::TimeFunc time_func
;
220 NextProtoVector next_protos
;
221 std::string trusted_spdy_proxy
;
222 bool force_spdy_over_ssl
;
223 bool force_spdy_always
;
224 bool use_alternate_protocols
;
225 bool enable_websocket_over_spdy
;
229 class SpdyURLRequestContext
: public URLRequestContext
{
231 SpdyURLRequestContext(NextProto protocol
,
232 bool force_spdy_over_ssl
,
233 bool force_spdy_always
);
234 ~SpdyURLRequestContext() override
;
236 MockClientSocketFactory
& socket_factory() { return socket_factory_
; }
239 MockClientSocketFactory socket_factory_
;
240 net::URLRequestContextStorage storage_
;
243 // Equivalent to pool->GetIfExists(spdy_session_key, BoundNetLog()) != NULL.
244 bool HasSpdySession(SpdySessionPool
* pool
, const SpdySessionKey
& key
);
246 // Creates a SPDY session for the given key and puts it in the SPDY
247 // session pool in |http_session|. A SPDY session for |key| must not
249 base::WeakPtr
<SpdySession
> CreateInsecureSpdySession(
250 const scoped_refptr
<HttpNetworkSession
>& http_session
,
251 const SpdySessionKey
& key
,
252 const BoundNetLog
& net_log
);
254 // Tries to create a SPDY session for the given key but expects the
255 // attempt to fail with the given error. A SPDY session for |key| must
256 // not already exist. The session will be created but close in the
257 // next event loop iteration.
258 base::WeakPtr
<SpdySession
> TryCreateInsecureSpdySessionExpectingFailure(
259 const scoped_refptr
<HttpNetworkSession
>& http_session
,
260 const SpdySessionKey
& key
,
261 Error expected_error
,
262 const BoundNetLog
& net_log
);
264 // Like CreateInsecureSpdySession(), but uses TLS.
265 base::WeakPtr
<SpdySession
> CreateSecureSpdySession(
266 const scoped_refptr
<HttpNetworkSession
>& http_session
,
267 const SpdySessionKey
& key
,
268 const BoundNetLog
& net_log
);
270 // Creates an insecure SPDY session for the given key and puts it in
271 // |pool|. The returned session will neither receive nor send any
272 // data. A SPDY session for |key| must not already exist.
273 base::WeakPtr
<SpdySession
> CreateFakeSpdySession(SpdySessionPool
* pool
,
274 const SpdySessionKey
& key
);
276 // Tries to create an insecure SPDY session for the given key but
277 // expects the attempt to fail with the given error. The session will
278 // neither receive nor send any data. A SPDY session for |key| must
279 // not already exist. The session will be created but close in the
280 // next event loop iteration.
281 base::WeakPtr
<SpdySession
> TryCreateFakeSpdySessionExpectingFailure(
282 SpdySessionPool
* pool
,
283 const SpdySessionKey
& key
,
284 Error expected_error
);
286 class SpdySessionPoolPeer
{
288 explicit SpdySessionPoolPeer(SpdySessionPool
* pool
);
290 void RemoveAliases(const SpdySessionKey
& key
);
291 void DisableDomainAuthenticationVerification();
292 void SetEnableSendingInitialData(bool enabled
);
295 SpdySessionPool
* const pool_
;
297 DISALLOW_COPY_AND_ASSIGN(SpdySessionPoolPeer
);
302 explicit SpdyTestUtil(NextProto protocol
);
304 // Add the appropriate headers to put |url| into |block|.
305 void AddUrlToHeaderBlock(base::StringPiece url
,
306 SpdyHeaderBlock
* headers
) const;
308 scoped_ptr
<SpdyHeaderBlock
> ConstructGetHeaderBlock(
309 base::StringPiece url
) const;
310 scoped_ptr
<SpdyHeaderBlock
> ConstructGetHeaderBlockForProxy(
311 base::StringPiece url
) const;
312 scoped_ptr
<SpdyHeaderBlock
> ConstructHeadHeaderBlock(
313 base::StringPiece url
,
314 int64 content_length
) const;
315 scoped_ptr
<SpdyHeaderBlock
> ConstructPostHeaderBlock(
316 base::StringPiece url
,
317 int64 content_length
) const;
318 scoped_ptr
<SpdyHeaderBlock
> ConstructPutHeaderBlock(
319 base::StringPiece url
,
320 int64 content_length
) const;
322 // Construct a SPDY frame. If it is a SYN_STREAM or SYN_REPLY frame (as
323 // specified in header_info.kind), the provided headers are included in the
325 SpdyFrame
* ConstructSpdyFrame(
326 const SpdyHeaderInfo
& header_info
,
327 scoped_ptr
<SpdyHeaderBlock
> headers
) const;
329 // Construct a SPDY frame. If it is a SYN_STREAM or SYN_REPLY frame (as
330 // specified in header_info.kind), the headers provided in extra_headers and
331 // (if non-NULL) tail_headers are concatenated and included in the frame.
332 // (extra_headers must always be non-NULL.)
333 SpdyFrame
* ConstructSpdyFrame(const SpdyHeaderInfo
& header_info
,
334 const char* const extra_headers
[],
335 int extra_header_count
,
336 const char* const tail_headers
[],
337 int tail_header_count
) const;
339 // Construct a generic SpdyControlFrame.
340 SpdyFrame
* ConstructSpdyControlFrame(
341 scoped_ptr
<SpdyHeaderBlock
> headers
,
343 SpdyStreamId stream_id
,
344 RequestPriority request_priority
,
346 SpdyControlFlags flags
,
347 SpdyStreamId associated_stream_id
) const;
349 // Construct a generic SpdyControlFrame.
351 // Warning: extra_header_count is the number of header-value pairs in
352 // extra_headers (so half the number of elements), but tail_headers_size is
353 // the actual number of elements (both keys and values) in tail_headers.
354 // TODO(ttuttle): Fix this inconsistency.
355 SpdyFrame
* ConstructSpdyControlFrame(
356 const char* const extra_headers
[],
357 int extra_header_count
,
359 SpdyStreamId stream_id
,
360 RequestPriority request_priority
,
362 SpdyControlFlags flags
,
363 const char* const* tail_headers
,
364 int tail_headers_size
,
365 SpdyStreamId associated_stream_id
) const;
367 // Construct an expected SPDY reply string from the given headers.
368 std::string
ConstructSpdyReplyString(const SpdyHeaderBlock
& headers
) const;
370 // Construct an expected SPDY SETTINGS frame.
371 // |settings| are the settings to set.
372 // Returns the constructed frame. The caller takes ownership of the frame.
373 SpdyFrame
* ConstructSpdySettings(const SettingsMap
& settings
) const;
375 // Constructs an expected SPDY SETTINGS acknowledgement frame, if the protocol
376 // version is SPDY4 or higher, or an empty placeholder frame otherwise.
377 SpdyFrame
* ConstructSpdySettingsAck() const;
379 // Construct a SPDY PING frame.
380 // Returns the constructed frame. The caller takes ownership of the frame.
381 SpdyFrame
* ConstructSpdyPing(uint32 ping_id
, bool is_ack
) const;
383 // Construct a SPDY GOAWAY frame with last_good_stream_id = 0.
384 // Returns the constructed frame. The caller takes ownership of the frame.
385 SpdyFrame
* ConstructSpdyGoAway() const;
387 // Construct a SPDY GOAWAY frame with the specified last_good_stream_id.
388 // Returns the constructed frame. The caller takes ownership of the frame.
389 SpdyFrame
* ConstructSpdyGoAway(SpdyStreamId last_good_stream_id
) const;
391 // Construct a SPDY GOAWAY frame with the specified last_good_stream_id,
392 // status, and description. Returns the constructed frame. The caller takes
393 // ownership of the frame.
394 SpdyFrame
* ConstructSpdyGoAway(SpdyStreamId last_good_stream_id
,
395 SpdyGoAwayStatus status
,
396 const std::string
& desc
) const;
398 // Construct a SPDY WINDOW_UPDATE frame.
399 // Returns the constructed frame. The caller takes ownership of the frame.
400 SpdyFrame
* ConstructSpdyWindowUpdate(
401 SpdyStreamId stream_id
,
402 uint32 delta_window_size
) const;
404 // Construct a SPDY RST_STREAM frame.
405 // Returns the constructed frame. The caller takes ownership of the frame.
406 SpdyFrame
* ConstructSpdyRstStream(SpdyStreamId stream_id
,
407 SpdyRstStreamStatus status
) const;
409 // Constructs a standard SPDY GET SYN frame, optionally compressed
411 // |extra_headers| are the extra header-value pairs, which typically
412 // will vary the most between calls.
413 // Returns a SpdyFrame.
414 SpdyFrame
* ConstructSpdyGet(const char* const url
,
416 SpdyStreamId stream_id
,
417 RequestPriority request_priority
) const;
419 SpdyFrame
* ConstructSpdyGetForProxy(const char* const url
,
421 SpdyStreamId stream_id
,
422 RequestPriority request_priority
) const;
424 // Constructs a standard SPDY GET SYN frame, optionally compressed.
425 // |extra_headers| are the extra header-value pairs, which typically
426 // will vary the most between calls. If |direct| is false, the
427 // the full url will be used instead of simply the path.
428 // Returns a SpdyFrame.
429 SpdyFrame
* ConstructSpdyGet(const char* const extra_headers
[],
430 int extra_header_count
,
433 RequestPriority request_priority
,
436 // Constructs a standard SPDY SYN_STREAM frame for a CONNECT request.
437 SpdyFrame
* ConstructSpdyConnect(const char* const extra_headers
[],
438 int extra_header_count
,
440 RequestPriority priority
) const;
442 // Constructs a standard SPDY push SYN frame.
443 // |extra_headers| are the extra header-value pairs, which typically
444 // will vary the most between calls.
445 // Returns a SpdyFrame.
446 SpdyFrame
* ConstructSpdyPush(const char* const extra_headers
[],
447 int extra_header_count
,
449 int associated_stream_id
,
451 SpdyFrame
* ConstructSpdyPush(const char* const extra_headers
[],
452 int extra_header_count
,
454 int associated_stream_id
,
457 const char* location
);
459 SpdyFrame
* ConstructInitialSpdyPushFrame(scoped_ptr
<SpdyHeaderBlock
> headers
,
461 int associated_stream_id
);
463 SpdyFrame
* ConstructSpdyPushHeaders(int stream_id
,
464 const char* const extra_headers
[],
465 int extra_header_count
);
467 // Construct a SPDY syn (HEADERS or SYN_STREAM, depending on protocol
468 // version) carrying exactly the given headers and priority.
469 SpdyFrame
* ConstructSpdySyn(int stream_id
,
470 const SpdyHeaderBlock
& headers
,
471 RequestPriority priority
,
475 // Construct a SPDY reply (HEADERS or SYN_REPLY, depending on protocol
476 // version) carrying exactly the given headers, and the default priority
477 // (or no priority, depending on protocl version).
478 // The |headers| parameter variant is preferred.
479 SpdyFrame
* ConstructSpdyReply(int stream_id
, const SpdyHeaderBlock
& headers
);
481 // Constructs a standard SPDY SYN_REPLY frame to match the SPDY GET.
482 // |extra_headers| are the extra header-value pairs, which typically
483 // will vary the most between calls.
484 // Returns a SpdyFrame.
485 SpdyFrame
* ConstructSpdyGetSynReply(const char* const extra_headers
[],
486 int extra_header_count
,
489 // Constructs a standard SPDY SYN_REPLY frame to match the SPDY GET.
490 // |extra_headers| are the extra header-value pairs, which typically
491 // will vary the most between calls.
492 // Returns a SpdyFrame.
493 SpdyFrame
* ConstructSpdyGetSynReplyRedirect(int stream_id
);
495 // Constructs a standard SPDY SYN_REPLY frame with an Internal Server
496 // Error status code.
497 // Returns a SpdyFrame.
498 SpdyFrame
* ConstructSpdySynReplyError(int stream_id
);
500 // Constructs a standard SPDY SYN_REPLY frame with the specified status code.
501 // Returns a SpdyFrame.
502 SpdyFrame
* ConstructSpdySynReplyError(const char* const status
,
503 const char* const* const extra_headers
,
504 int extra_header_count
,
507 // Constructs a standard SPDY POST SYN frame.
508 // |extra_headers| are the extra header-value pairs, which typically
509 // will vary the most between calls.
510 // Returns a SpdyFrame.
511 SpdyFrame
* ConstructSpdyPost(const char* url
,
512 SpdyStreamId stream_id
,
513 int64 content_length
,
514 RequestPriority priority
,
515 const char* const extra_headers
[],
516 int extra_header_count
);
518 // Constructs a chunked transfer SPDY POST SYN frame.
519 // |extra_headers| are the extra header-value pairs, which typically
520 // will vary the most between calls.
521 // Returns a SpdyFrame.
522 SpdyFrame
* ConstructChunkedSpdyPost(const char* const extra_headers
[],
523 int extra_header_count
);
525 // Constructs a standard SPDY SYN_REPLY frame to match the SPDY POST.
526 // |extra_headers| are the extra header-value pairs, which typically
527 // will vary the most between calls.
528 // Returns a SpdyFrame.
529 SpdyFrame
* ConstructSpdyPostSynReply(const char* const extra_headers
[],
530 int extra_header_count
);
532 // Constructs a single SPDY data frame with the contents "hello!"
533 SpdyFrame
* ConstructSpdyBodyFrame(int stream_id
,
536 // Constructs a single SPDY data frame with the given content.
537 SpdyFrame
* ConstructSpdyBodyFrame(int stream_id
, const char* data
,
538 uint32 len
, bool fin
);
540 // Wraps |frame| in the payload of a data frame in stream |stream_id|.
541 SpdyFrame
* ConstructWrappedSpdyFrame(const scoped_ptr
<SpdyFrame
>& frame
,
544 const SpdyHeaderInfo
MakeSpdyHeader(SpdyFrameType type
);
546 // For versions below SPDY4, adds the version HTTP/1.1 header.
547 void MaybeAddVersionHeader(SpdyFrameWithNameValueBlockIR
* frame_ir
) const;
548 void MaybeAddVersionHeader(SpdyHeaderBlock
* block
) const;
550 // Maps |priority| to SPDY version priority, and sets it on |frame_ir|.
551 void SetPriority(RequestPriority priority
, SpdySynStreamIR
* frame_ir
) const;
553 NextProto
protocol() const { return protocol_
; }
554 SpdyMajorVersion
spdy_version() const { return spdy_version_
; }
555 bool is_spdy2() const { return protocol_
< kProtoSPDY3
; }
556 bool include_version_header() const { return protocol_
< kProtoSPDY4
; }
557 scoped_ptr
<SpdyFramer
> CreateFramer(bool compressed
) const;
559 const char* GetMethodKey() const;
560 const char* GetStatusKey() const;
561 const char* GetHostKey() const;
562 const char* GetSchemeKey() const;
563 const char* GetVersionKey() const;
564 const char* GetPathKey() const;
567 // |content_length| may be NULL, in which case the content-length
568 // header will be omitted.
569 scoped_ptr
<SpdyHeaderBlock
> ConstructHeaderBlock(
570 base::StringPiece method
,
571 base::StringPiece url
,
572 int64
* content_length
) const;
574 const NextProto protocol_
;
575 const SpdyMajorVersion spdy_version_
;
580 #endif // NET_SPDY_SPDY_TEST_UTIL_COMMON_H_