src/shrpx_upstream.h

   1 /*
   2  * nghttp2 - HTTP/2 C Library
   3  *
   4  * Copyright (c) 2012 Tatsuhiro Tsujikawa
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining
   7  * a copy of this software and associated documentation files (the
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sublicense, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be
  15  * included in all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  18  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  20  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  21  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  22  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  23  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  24  */
  25 #ifndef SHRPX_UPSTREAM_H
  26 #define SHRPX_UPSTREAM_H
  27
  28 #include "shrpx.h"
  29 #include "shrpx_io_control.h"
  30
  31 namespace shrpx {
  32
  33 class ClientHandler;
  34 class Downstream;
  35 class DownstreamConnection;
  36
  37 class Upstream {
  38 public:
  39   virtual ~Upstream() {}
  40   virtual int on_read() = 0;
  41   virtual int on_write() = 0;
  42   virtual int on_timeout(Downstream *downstream) { return 0; };
  43   virtual int on_downstream_abort_request(Downstream *downstream,
  44                                           unsigned int status_code) = 0;
  45   virtual int downstream_read(DownstreamConnection *dconn) = 0;
  46   virtual int downstream_write(DownstreamConnection *dconn) = 0;
  47   virtual int downstream_eof(DownstreamConnection *dconn) = 0;
  48   virtual int downstream_error(DownstreamConnection *dconn, int events) = 0;
  49   virtual ClientHandler *get_client_handler() const = 0;
  50
  51   virtual int on_downstream_header_complete(Downstream *downstream) = 0;
  52   virtual int on_downstream_body(Downstream *downstream, const uint8_t *data,
  53                                  size_t len, bool flush) = 0;
  54   virtual int on_downstream_body_complete(Downstream *downstream) = 0;
  55
  56   virtual void on_handler_delete() = 0;
  57   // Called when downstream connection is reset.  Currently this is
  58   // only used by Http2Session.  If |no_retry| is true, another
  59   // connection attempt using new DownstreamConnection is not allowed.
  60   virtual int on_downstream_reset(bool no_retry) = 0;
  61
  62   virtual void pause_read(IOCtrlReason reason) = 0;
  63   virtual int resume_read(IOCtrlReason reason, Downstream *downstream,
  64                           size_t consumed) = 0;
  65 };
  66
  67 } // namespace shrpx
  68
  69 #endif // SHRPX_UPSTREAM_H