git.sesse.net Git - cubemap/blob - input.h

   1 #ifndef _INPUT_H
   2 #define _INPUT_H 1
   3
   4 #include <stddef.h>
   5 #include <time.h>
   6 #include <string>
   7
   8 #include "thread.h"
   9
  10 class Input;
  11 class InputProto;
  12
  13 // Digested statistics for writing to logs etc.
  14 struct InputStats {
  15         std::string url;
  16
  17         // The number of bytes we have received so far, including any Metacube headers.
  18         //
  19         // Not reset across connections.
  20         size_t bytes_received;
  21
  22         // The number of data bytes we have received so far (or more precisely,
  23         // number of data bytes we have sent on to the stream). This excludes Metacube
  24         // headers, metadata and corrupted data we've skipped.
  25         //
  26         // Not reset across connections.
  27         size_t data_bytes_received;
  28
  29         // Same, except counts only Metacube metadata.
  30         size_t metadata_bytes_received;
  31
  32         // When the current connection was initiated. -1 if we are not currently connected.
  33         time_t connect_time;
  34
  35         // Last latency measurement, HUGE_VAL if no measurement yet.
  36         double latency_sec;
  37
  38         // TODO: Number of loss events might both be useful,
  39         // similar to for clients. Also, per-connection byte counters.
  40 };
  41
  42 class Input : public Thread {
  43 public:
  44         // Must be in sync with StreamConfig::Encoding.
  45         enum Encoding { INPUT_ENCODING_RAW = 0, INPUT_ENCODING_METACUBE };
  46
  47         virtual ~Input();
  48         virtual InputProto serialize() const = 0;
  49         virtual std::string get_url() const = 0;
  50         virtual void close_socket() = 0;
  51         virtual void add_destination(int stream_index) = 0;
  52
  53         // Note: May be called from a different thread, so must be thread-safe.
  54         virtual InputStats get_stats() const = 0;
  55 };
  56
  57 // Extremely rudimentary URL parsing.
  58 bool parse_url(const std::string &url, std::string *protocol, std::string *user, std::string *host, std::string *port, std::string *path);
  59
  60 // Figure out the right type of input based on the URL, and create a new Input of the right type.
  61 // Will return nullptr if unknown.
  62 Input *create_input(const std::string &url, Input::Encoding encoding);
  63 Input *create_input(const InputProto &serialized);
  64
  65 #endif  // !defined(_INPUT_H)