Add a QuicHttpStream class.

net/http/http_stream_base.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 //
 // HttpStreamBase is an interface for reading and writing data to an
 // HTTP-like stream that keeps the client agnostic of the actual underlying
 // transport layer.  This provides an abstraction for HttpStream and
 // WebSocketStream.
 
 #ifndef NET_HTTP_HTTP_STREAM_BASE_H_
@@ skipping 17 matching lines @@
 class IOBuffer;
 class SSLCertRequestInfo;
 class SSLInfo;
 
 class NET_EXPORT_PRIVATE HttpStreamBase {
  public:
   HttpStreamBase() {}
   virtual ~HttpStreamBase() {}
 
   // Initialize stream.  Must be called before calling SendRequest().
+  // |request_info| must outlive the HttpStreamBase.
   // Returns a net error code, possibly ERR_IO_PENDING.
   virtual int InitializeStream(const HttpRequestInfo* request_info,
                                const BoundNetLog& net_log,
                                const CompletionCallback& callback) = 0;
 
   // Writes the headers and uploads body data to the underlying socket.
   // ERR_IO_PENDING is returned if the operation could not be completed
   // synchronously, in which case the result will be passed to the callback
   // when available. Returns OK on success.
+  // |response| must outlive the HttpStreamBase.
   virtual int SendRequest(const HttpRequestHeaders& request_headers,
                           HttpResponseInfo* response,
                           const CompletionCallback& callback) = 0;
 
   // Reads from the underlying socket until the response headers have been
   // completely received. ERR_IO_PENDING is returned if the operation could
   // not be completed synchronously, in which case the result will be passed
   // to the callback when available. Returns OK on success.  The response
   // headers are available in the HttpResponseInfo returned by GetResponseInfo
   virtual int ReadResponseHeaders(const CompletionCallback& callback) = 0;
@@ skipping 25 matching lines @@
   //                eliminate the SetConnectionReused() below.
   virtual void Close(bool not_reusable) = 0;
 
   // Indicates if the response body has been completely read.
   virtual bool IsResponseBodyComplete() const = 0;
 
   // Indicates that the end of the response is detectable. This means that
   // the response headers indicate either chunked encoding or content length.
   // If neither is sent, the server must close the connection for us to detect
   // the end of the response.
+  // TODO(rch): Rename this method, so that it is clear why it exists
+  // particularly as it applies to QUIC and SPDY for which the end of the
+  // response is always findable.
   virtual bool CanFindEndOfResponse() const = 0;
 
   // A stream exists on top of a connection.  If the connection has been used
   // to successfully exchange data in the past, error handling for the
   // stream is done differently.  This method returns true if the underlying
   // connection is reused or has been connected and idle for some time.
   virtual bool IsConnectionReused() const = 0;
   virtual void SetConnectionReused() = 0;
 
   // Checks whether the current state of the underlying connection
@@ skipping 20 matching lines @@
   // draining is complete.
   virtual void Drain(HttpNetworkSession* session) = 0;
 
  private:
   DISALLOW_COPY_AND_ASSIGN(HttpStreamBase);
 };
 
 }  // namespace net
 
 #endif  // NET_HTTP_HTTP_STREAM_BASE_H_