#include <endpoint.hpp>

Public Types
typedef endpoint	type
	Type of this endpoint transport component. More...

typedef lib::shared_ptr< type >	ptr
	Type of a pointer to this endpoint transport component. More...

typedef config::concurrency_type	concurrency_type
	Type of this endpoint's concurrency policy. More...

typedef config::elog_type	elog_type
	Type of this endpoint's error logging policy. More...

typedef config::alog_type	alog_type
	Type of this endpoint's access logging policy. More...

typedef iostream::connection< config >	transport_con_type
	Type of this endpoint transport component's associated connection transport component. More...

typedef transport_con_type::ptr	transport_con_ptr
	Type of a shared pointer to this endpoint transport component's associated connection transport component. More...

Public Member Functions
	endpoint ()

void	register_ostream (std::ostream *o)
	Register a default output stream. More...

void	set_secure (bool value)
	Set whether or not endpoint can create secure connections. More...

bool	is_secure () const
	Tests whether or not the underlying transport is secure. More...

void	set_write_handler (write_handler h)
	Sets the write handler. More...

void	set_shutdown_handler (shutdown_handler h)
	Sets the shutdown handler. More...

Protected Member Functions
void	init_logging (lib::shared_ptr< alog_type > a, lib::shared_ptr< elog_type > e)
	Initialize logging. More...

void	async_connect (transport_con_ptr, uri_ptr, connect_handler cb)
	Initiate a new connection. More...

lib::error_code	init (transport_con_ptr tcon)
	Initialize a connection. More...

Detailed Description

template<typename config>
class websocketpp::transport::iostream::endpoint< config >

Definition at line 46 of file endpoint.hpp.

Member Typedef Documentation

◆ type

template<typename config >

typedef endpoint websocketpp::transport::iostream::endpoint< config >::type

Type of this endpoint transport component.

Definition at line 49 of file endpoint.hpp.

◆ ptr

template<typename config >

typedef lib::shared_ptr<type> websocketpp::transport::iostream::endpoint< config >::ptr

Type of a pointer to this endpoint transport component.

Definition at line 51 of file endpoint.hpp.

◆ concurrency_type

template<typename config >

typedef config::concurrency_type websocketpp::transport::iostream::endpoint< config >::concurrency_type

Type of this endpoint's concurrency policy.

Definition at line 54 of file endpoint.hpp.

◆ elog_type

template<typename config >

typedef config::elog_type websocketpp::transport::iostream::endpoint< config >::elog_type

Type of this endpoint's error logging policy.

Definition at line 56 of file endpoint.hpp.

◆ alog_type

template<typename config >

typedef config::alog_type websocketpp::transport::iostream::endpoint< config >::alog_type

Type of this endpoint's access logging policy.

Definition at line 58 of file endpoint.hpp.

◆ transport_con_type

template<typename config >

typedef iostream::connection<config> websocketpp::transport::iostream::endpoint< config >::transport_con_type

Type of this endpoint transport component's associated connection transport component.

Definition at line 62 of file endpoint.hpp.

◆ transport_con_ptr

template<typename config >

typedef transport_con_type::ptr websocketpp::transport::iostream::endpoint< config >::transport_con_ptr

Type of a shared pointer to this endpoint transport component's associated connection transport component.

Definition at line 65 of file endpoint.hpp.

Constructor & Destructor Documentation

◆ endpoint()

template<typename config >

websocketpp::transport::iostream::endpoint< config >::endpoint ( )

inlineexplicit

Definition at line 68 of file endpoint.hpp.

Member Function Documentation

◆ register_ostream()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::register_ostream ( std::ostream * o )

inline

Register a default output stream.

The specified output stream will be assigned to future connections as the default output stream.

Parameters

o	The ostream to use as the default output stream.

Definition at line 80 of file endpoint.hpp.

References websocketpp::log::alevel::devel.

◆ set_secure()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::set_secure ( bool value )

inline

Set whether or not endpoint can create secure connections.

The iostream transport does not provide any security features. As such it defaults to returning false when is_secure is called. However, the iostream transport may be used to wrap an external socket API that may provide secure transport. This method allows that external API to flag whether or not it can create secure connections so that users of the WebSocket++ API will get more accurate information.

Setting this value only indicates whether or not the endpoint is capable of producing and managing secure connections. Connections produced by this endpoint must also be individually flagged as secure if they are.

Since: 0.3.0-alpha4

Parameters

value Whether or not the endpoint can create secure connections.

Definition at line 102 of file endpoint.hpp.

◆ is_secure()

template<typename config >

bool websocketpp::transport::iostream::endpoint< config >::is_secure ( ) const

inline

Tests whether or not the underlying transport is secure.

iostream transport will return false by default because it has no information about the ultimate remote endpoint. This may or may not be accurate depending on the real source of bytes being input. set_secure may be used by a wrapper API to correct the return value in the case that secure connections are in fact possible.

Returns: Whether or not the underlying transport is secure

Definition at line 116 of file endpoint.hpp.

◆ set_write_handler()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::set_write_handler ( write_handler h )

inline

Sets the write handler.

The write handler is called when the iostream transport receives data that needs to be written to the appropriate output location. This handler can be used in place of registering an ostream for output.

The signature of the handler is lib::error_code (connection_hdl, char const *, size_t) The code returned will be reported and logged by the core library.

Since: 0.5.0

Parameters

h	The handler to call on connection shutdown.

Definition at line 134 of file endpoint.hpp.

◆ set_shutdown_handler()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::set_shutdown_handler ( shutdown_handler h )

inline

Sets the shutdown handler.

The shutdown handler is called when the iostream transport receives a notification from the core library that it is finished with all read and write operations and that the underlying transport can be cleaned up.

If you are using iostream transport with another socket library, this is a good time to close/shutdown the socket for this connection.

The signature of the handler is lib::error_code (connection_hdl). The code returned will be reported and logged by the core library.

Since: 0.5.0

Parameters

h	The handler to call on connection shutdown.

Definition at line 154 of file endpoint.hpp.

◆ init_logging()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::init_logging	(	lib::shared_ptr< alog_type >	a,
		lib::shared_ptr< elog_type >	e
	)

inlineprotected

Initialize logging.

The loggers are located in the main endpoint class. As such, the transport doesn't have direct access to them. This method is called by the endpoint constructor to allow shared logging from the transport component. These are raw pointers to member variables of the endpoint. In particular, they cannot be used in the transport constructor as they haven't been constructed yet, and cannot be used in the transport destructor as they will have been destroyed by then.

Parameters

a	A pointer to the access logger to use.
e	A pointer to the error logger to use.

Definition at line 171 of file endpoint.hpp.

◆ async_connect()

template<typename config >

void websocketpp::transport::iostream::endpoint< config >::async_connect	(	transport_con_ptr	,
		uri_ptr	,
		connect_handler	cb
	)

inlineprotected

Initiate a new connection.

Parameters

tcon	A pointer to the transport connection component of the connection to connect.
u	A URI pointer to the URI to connect to.
cb	The function to call back with the results when complete.

Definition at line 183 of file endpoint.hpp.

◆ init()

template<typename config >

lib::error_code websocketpp::transport::iostream::endpoint< config >::init ( transport_con_ptr tcon )

inlineprotected

Initialize a connection.

Init is called by an endpoint once for each newly created connection. It's purpose is to give the transport policy the chance to perform any transport specific initialization that couldn't be done via the default constructor.

Parameters

tcon	A pointer to the transport portion of the connection.

Returns: A status code indicating the success or failure of the operation

Definition at line 197 of file endpoint.hpp.

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

ndnSIM/NFD/websocketpp/websocketpp/transport/iostream/endpoint.hpp

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

template<typename config> class websocketpp::transport::iostream::endpoint< config >

Member Typedef Documentation

◆ type

◆ ptr

◆ concurrency_type

◆ elog_type

◆ alog_type

◆ transport_con_type

◆ transport_con_ptr

Constructor & Destructor Documentation

◆ endpoint()

Member Function Documentation

◆ register_ostream()

◆ set_secure()

◆ is_secure()

◆ set_write_handler()

◆ set_shutdown_handler()

◆ init_logging()

◆ async_connect()

◆ init()

template<typename config>
class websocketpp::transport::iostream::endpoint< config >