net/http/http_stream.h

   1 // Copyright (c) 2012 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.
   4 //
   5 // HttpStream provides an abstraction for a basic http streams, http pipelining
   6 // implementations, and SPDY.  The HttpStream subtype is expected to manage the
   7 // underlying transport appropriately.  For example, a non-pipelined HttpStream
   8 // would return the transport socket to the pool for reuse.  SPDY streams on the
   9 // other hand leave the transport socket management to the SpdySession.
  10
  11 #ifndef NET_HTTP_HTTP_STREAM_H_
  12 #define NET_HTTP_HTTP_STREAM_H_
  13
  14 #include "base/basictypes.h"
  15 #include "net/base/completion_callback.h"
  16 #include "net/base/net_export.h"
  17 #include "net/base/upload_progress.h"
  18 #include "net/http/http_stream_base.h"
  19
  20 namespace net {
  21
  22 class IOBuffer;
  23
  24 class NET_EXPORT_PRIVATE HttpStream : public HttpStreamBase {
  25  public:
  26   HttpStream() {}
  27   virtual ~HttpStream() {}
  28
  29   // Queries the UploadDataStream for its progress (bytes sent).
  30   virtual UploadProgress GetUploadProgress() const = 0;
  31
  32   // Returns a new (not initialized) stream using the same underlying
  33   // connection and invalidates the old stream - no further methods should be
  34   // called on the old stream.  The caller should ensure that the response body
  35   // from the previous request is drained before calling this method.  If the
  36   // subclass does not support renewing the stream, NULL is returned.
  37   virtual HttpStream* RenewStreamForAuth() = 0;
  38
  39  private:
  40   DISALLOW_COPY_AND_ASSIGN(HttpStream);
  41 };
  42
  43 }  // namespace net
  44
  45 #endif  // NET_HTTP_HTTP_STREAM_H_