web::ng::Connection Class Reference

A class representing a connection to a client. More...

#include <Connection.hpp>

Inheritance diagram for web::ng::Connection:

Collaboration diagram for web::ng::Connection:

Public Member Functions
	Connection (std::string ip, boost::beast::flat_buffer buffer, util::TagDecoratorFactory const &tagDecoratorFactory)
	Construct a new Connection object.
virtual void	setTimeout (std::chrono::steady_clock::duration newTimeout)=0
	Get the timeout for send, receive, and close operations. For WebSocket connections, this is the ping interval.
virtual std::expected< void, Error >	send (Response response, boost::asio::yield_context yield)=0
	Send a response to the client.
virtual std::expected< Request, Error >	receive (boost::asio::yield_context yield)=0
	Receive a request from the client.
virtual void	close (boost::asio::yield_context yield)=0
	Gracefully close the connection.
Public Member Functions inherited from web::ng::ConnectionMetadata
	ConnectionMetadata (std::string ip, util::TagDecoratorFactory const &tagDecoratorFactory)
	Construct a new ConnectionMetadata object.
virtual bool	wasUpgraded () const =0
	Whether the connection was upgraded. Upgraded connections are websocket connections.
std::string const &	ip () const
	Get the ip of the client.
void	setIp (std::string newIp)
	Set the ip of the client.
bool	isAdmin () const
	Get whether the client is an admin.
template<std::invocable T>
void	setIsAdmin (T &&setter)
	Set the isAdmin field.
Public Member Functions inherited from util::Taggable
	Taggable (Taggable &&)=default
Taggable &	operator= (Taggable &&)=default
BaseTagDecorator const &	tag () const
	Getter for tag decorator.

Static Public Attributes
static constexpr std::chrono::steady_clock::duration	kDEFAULT_TIMEOUT = std::chrono::seconds{11}
	The default timeout for send, receive, and close operations.

Protected Attributes
boost::beast::flat_buffer	buffer_
Protected Attributes inherited from web::ng::ConnectionMetadata
std::string	ip_
std::optional< bool >	isAdmin_

Additional Inherited Members
Protected Member Functions inherited from util::Taggable
	Taggable (util::TagDecoratorFactory const &tagFactory)
	New Taggable from a specified factory.

Detailed Description

A class representing a connection to a client.

Constructor & Destructor Documentation

Connection()

web::ng::Connection::Connection	(	std::string	ip,
		boost::beast::flat_buffer	buffer,
		util::TagDecoratorFactory const &	tagDecoratorFactory )

Construct a new Connection object.

Parameters

ip	The client ip.
buffer	The buffer to use for reading and writing.
tagDecoratorFactory	The factory for creating tag decorators.

Member Function Documentation

close()

virtual void web::ng::Connection::close ( boost::asio::yield_context yield )

pure virtual

Gracefully close the connection.

Parameters

yield

The yield context.

Implemented in web::ng::impl::HttpConnection< StreamType >, web::ng::impl::HttpConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, web::ng::impl::HttpConnection< boost::beast::tcp_stream >, web::ng::impl::WsConnection< StreamType >, web::ng::impl::WsConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, and web::ng::impl::WsConnection< boost::beast::tcp_stream >.

receive()

virtual std::expected< Request, Error > web::ng::Connection::receive ( boost::asio::yield_context yield )

pure virtual

Receive a request from the client.

Parameters

yield

The yield context.

Returns

The request if it was received or an error if the operation failed.

Implemented in web::ng::impl::HttpConnection< StreamType >, web::ng::impl::HttpConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, web::ng::impl::HttpConnection< boost::beast::tcp_stream >, web::ng::impl::WsConnection< StreamType >, web::ng::impl::WsConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, and web::ng::impl::WsConnection< boost::beast::tcp_stream >.

send()

virtual std::expected< void, Error > web::ng::Connection::send ( Response response, boost::asio::yield_context yield )

pure virtual

Send a response to the client.

Parameters

response	The response to send.
yield	The yield context.

Returns

An error if the operation fails, otherwise nothing.

Implemented in web::ng::impl::HttpConnection< StreamType >, web::ng::impl::HttpConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, web::ng::impl::HttpConnection< boost::beast::tcp_stream >, web::ng::impl::WsConnection< StreamType >, web::ng::impl::WsConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, and web::ng::impl::WsConnection< boost::beast::tcp_stream >.

setTimeout()

virtual void web::ng::Connection::setTimeout ( std::chrono::steady_clock::duration newTimeout )

pure virtual

Get the timeout for send, receive, and close operations. For WebSocket connections, this is the ping interval.

Parameters

newTimeout

The new timeout to set.

Implemented in web::ng::impl::HttpConnection< StreamType >, web::ng::impl::HttpConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, web::ng::impl::HttpConnection< boost::beast::tcp_stream >, web::ng::impl::WsConnection< StreamType >, web::ng::impl::WsConnection< boost::asio::ssl::stream< boost::beast::tcp_stream > >, and web::ng::impl::WsConnection< boost::beast::tcp_stream >.

Member Data Documentation

kDEFAULT_TIMEOUT

std::chrono::steady_clock::duration web::ng::Connection::kDEFAULT_TIMEOUT = std::chrono::seconds{11}

staticconstexpr

The default timeout for send, receive, and close operations.

Note

This value should be higher than forwarding timeout to not disconnect clients if rippled is slow.

---

The documentation for this class was generated from the following files:

• /__w/clio/clio/src/web/ng/Connection.hpp
• /__w/clio/clio/src/web/ng/Connection.cpp