Use consistent types for leb128 decoder.
[chromium-blink-merge.git] / net / spdy / spdy_test_util_common.h
blobe91800d125a94fb93c66ad95bc6d154635b7e7fb
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_
8 #include <string>
9 #include <vector>
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"
34 class GURL;
36 namespace net {
38 class BoundNetLog;
39 class SpdySession;
40 class SpdySessionKey;
41 class SpdySessionPool;
42 class SpdyStream;
43 class SpdyStreamRequest;
45 // Default upload data used by both, mock objects and framer when creating
46 // data frames.
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
52 // SPDY.
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
80 // header values.
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
103 // the total length.
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
114 // on failure.
115 base::WeakPtr<SpdyStream> CreateStreamSynchronously(
116 SpdyStreamType type,
117 const base::WeakPtr<SpdySession>& session,
118 const GURL& url,
119 RequestPriority priority,
120 const BoundNetLog& net_log);
122 // Helper class used by some tests to release a stream as soon as it's
123 // created.
124 class StreamReleaserCallback : public TestCompletionCallbackBase {
125 public:
126 StreamReleaserCallback();
128 ~StreamReleaserCallback() override;
130 // Returns a callback that releases |request|'s stream.
131 CompletionCallback MakeCallback(SpdyStreamRequest* request);
133 private:
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 {
141 SpdyFrameType kind;
142 SpdyStreamId id;
143 SpdyStreamId assoc_id;
144 SpdyPriority priority;
145 size_t credential_slot; // SPDY3 only
146 SpdyControlFlags control_flags;
147 bool compressed;
148 SpdyRstStreamStatus status;
149 const char* data;
150 uint32 data_length;
151 SpdyDataFlags data_flags;
154 // An ECSignatureCreator that returns deterministic signatures.
155 class MockECSignatureCreator : public crypto::ECSignatureCreator {
156 public:
157 explicit MockECSignatureCreator(crypto::ECPrivateKey* key);
159 // crypto::ECSignatureCreator
160 bool Sign(const uint8* data,
161 int data_len,
162 std::vector<uint8>* signature) override;
163 bool DecodeSignature(const std::vector<uint8>& signature,
164 std::vector<uint8>* out_raw_sig) override;
166 private:
167 crypto::ECPrivateKey* key_;
169 DISALLOW_COPY_AND_ASSIGN(MockECSignatureCreator);
172 // An ECSignatureCreatorFactory creates MockECSignatureCreator.
173 class MockECSignatureCreatorFactory : public crypto::ECSignatureCreatorFactory {
174 public:
175 MockECSignatureCreatorFactory();
176 ~MockECSignatureCreatorFactory() override;
178 // crypto::ECSignatureCreatorFactory
179 crypto::ECSignatureCreator* Create(crypto::ECPrivateKey* key) override;
181 private:
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;
215 bool enable_ping;
216 bool enable_user_alternate_protocol_ports;
217 NextProto protocol;
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;
226 NetLog* net_log;
229 class SpdyURLRequestContext : public URLRequestContext {
230 public:
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_; }
238 private:
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
248 // already exist.
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 {
287 public:
288 explicit SpdySessionPoolPeer(SpdySessionPool* pool);
290 void RemoveAliases(const SpdySessionKey& key);
291 void DisableDomainAuthenticationVerification();
292 void SetEnableSendingInitialData(bool enabled);
294 private:
295 SpdySessionPool* const pool_;
297 DISALLOW_COPY_AND_ASSIGN(SpdySessionPoolPeer);
300 class SpdyTestUtil {
301 public:
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
324 // frame.
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,
342 bool compressed,
343 SpdyStreamId stream_id,
344 RequestPriority request_priority,
345 SpdyFrameType type,
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,
358 bool compressed,
359 SpdyStreamId stream_id,
360 RequestPriority request_priority,
361 SpdyFrameType type,
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
410 // for |url|.
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,
415 bool compressed,
416 SpdyStreamId stream_id,
417 RequestPriority request_priority) const;
419 SpdyFrame* ConstructSpdyGetForProxy(const char* const url,
420 bool compressed,
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,
431 bool compressed,
432 int stream_id,
433 RequestPriority request_priority,
434 bool direct) const;
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,
439 int stream_id,
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,
448 int stream_id,
449 int associated_stream_id,
450 const char* url);
451 SpdyFrame* ConstructSpdyPush(const char* const extra_headers[],
452 int extra_header_count,
453 int stream_id,
454 int associated_stream_id,
455 const char* url,
456 const char* status,
457 const char* location);
459 SpdyFrame* ConstructInitialSpdyPushFrame(scoped_ptr<SpdyHeaderBlock> headers,
460 int stream_id,
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,
472 bool compressed,
473 bool fin) const;
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,
487 int stream_id);
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,
505 int stream_id);
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,
534 bool fin);
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,
542 int stream_id);
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;
566 private:
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_;
578 } // namespace net
580 #endif // NET_SPDY_SPDY_TEST_UTIL_COMMON_H_