Class URL

plugins/experimental/txn_box/plugin/include/txn_box/ts_util.h:188–267

A URL object.

/// A URL object.
class URL : public HeapObject
{
  friend class HttpHeader;

  using self_type  = URL;        ///< Self reference type.
  using super_type = HeapObject; ///< Parent type.
public:
  URL() = default;

  /// Construct from TS data.
  URL(TSMBuffer buff, TSMLoc loc);

  /** Write the full URL to @a w.
   *
   * @param w Destination buffer.
   * @return @a w
   */
  swoc::BufferWriter &write_full(swoc::BufferWriter &w) const;

  /** Get the network location
   *
   * @return A tuple of [ host, port ].
   */
  std::tuple<swoc::TextView, in_port_t> loc() const;

  swoc::TextView host() const; ///< View of the URL host.

  /** Get the port in the URL.
   *
   * @return The port.
   *
   * @note If the port is not explicitly set, it is computed based on the scheme.
   */
  in_port_t      port() const;     ///< Port.
  swoc::TextView scheme() const;   ///< View of the URL scheme.
  swoc::TextView path() const;     ///< View of the URL path.
  swoc::TextView query() const;    ///< View of the query.
  swoc::TextView fragment() const; ///< View of the fragment.

  /** Set the scheme for the URL.
   *
   * @param scheme Scheme as text.
   * @return @a this
   */
  self_type &scheme_set(swoc::TextView const &scheme);

  /** Set the host in the URL.
   *
   * @param host Host.
   * @return @a this.
   */
  self_type &host_set(swoc::TextView const &host);

  static bool is_port_canonical(swoc::TextView const &scheme, in_port_t port);

  bool
  is_port_canonical() const
  {