A helper for recording entire message/reply transactions. More...

#include <yarp/os/impl/ConnectionRecorder.h>

Inheritance diagram for yarp::os::impl::ConnectionRecorder:

Public Member Functions
	ConnectionRecorder ()

void	init (yarp::os::ConnectionReader *wrappedReader)
	Call this to wrap a specific ConnectionReader. More...

void	fini ()
	Call this when all reading/writing has been done. More...

const yarp::os::impl::BufferedConnectionWriter &	getMessage () const

const yarp::os::impl::BufferedConnectionWriter &	getReply () const

bool	hasReply () const

bool	expectBlock (char *data, size_t len) override
	Read a block of data from the network connection. More...

std::string	expectText (const char terminatingChar) override
	Read some text from the network connection. More...

std::int8_t	expectInt8 () override
	Read a 8-bit integer from the network connection. More...

std::int16_t	expectInt16 () override
	Read a 16-bit integer from the network connection. More...

std::int32_t	expectInt32 () override
	Read a 32-bit integer from the network connection. More...

std::int64_t	expectInt64 () override
	Read a 64-bit integer from the network connection. More...

yarp::conf::float32_t	expectFloat32 () override
	Read a 32-bit floating point number from the network connection. More...

yarp::conf::float64_t	expectFloat64 () override
	Read a 64-bit floating point number from the network connection. More...

bool	pushInt (int x) override
	Store an integer to return on the next call to expectInt() More...

bool	isTextMode () const override
	Check if the connection is text mode. More...

bool	isBareMode () const override
	Check if the connection is bare mode. More...

bool	convertTextMode () override
	Reads in a standard description in text mode, and converts it to a standard description in binary. More...

size_t	getSize () const override
	Checks how much data is available. More...

yarp::os::ConnectionWriter *	getWriter () override
	Gets a way to reply to the message, if possible. More...

yarp::os::Portable *	getReference () const override
	Get a direct pointer to the object being sent, if possible. More...

yarp::os::Contact	getRemoteContact () const override
	Gets information about who is supplying the data being read, if that information is available. More...

yarp::os::Contact	getLocalContact () const override
	Gets information about who is receiving the data, if that information is available. More...

bool	isValid () const override

bool	isActive () const override

bool	isError () const override

void	appendBlock (const char *data, size_t len) override
	Send a block of data to the network connection. More...

void	appendInt8 (std::int8_t data) override
	Send a representation of a 8-bit integer to the network connection. More...

void	appendInt16 (std::int16_t data) override
	Send a representation of a 16-bit integer to the network connection. More...

void	appendInt32 (std::int32_t data) override
	Send a representation of a 32-bit integer to the network connection. More...

void	appendInt64 (std::int64_t data) override
	Send a representation of a 64-bit integer to the network connection. More...

void	appendFloat32 (yarp::conf::float32_t data) override
	Send a representation of a 32-bit floating point number to the network connection. More...

void	appendFloat64 (yarp::conf::float64_t data) override
	Send a representation of a 64-bit floating point number to the network connection. More...

void	appendText (const std::string &str, const char terminate) override
	Send a terminated string to the network connection. More...

void	appendExternalBlock (const char *data, size_t len) override
	Send a block of data to the network connection, without making a copy. More...

void	declareSizes (int argc, int *argv) override
	If you can easily determine how many blocks there are in a message, call this first, before anything else. More...

void	setReplyHandler (yarp::os::PortReader &reader) override
	This sets a handler to deal with replies to the message. More...

void	setReference (yarp::os::Portable *obj) override
	Stores a direct pointer to the object being sent. More...

bool	write (yarp::os::ConnectionWriter &connection) const override
	Write this object to a network connection. More...

void	requestDrop () override
	Tag the connection to be dropped after the current message. More...

const yarp::os::Searchable &	getConnectionModifiers () const override
	Access modifiers associated with the connection, if any. More...

yarp::os::SizedWriter *	getBuffer () override

const yarp::os::SizedWriter *	getBuffer () const override

bool	setSize (size_t len) override

void	flushWriter () override

Public Member Functions inherited from yarp::os::ConnectionReader
virtual	~ConnectionReader ()
	Destructor. More...

virtual bool	expectBlock (char *data, size_t len)=0
	Read a block of data from the network connection. More...

virtual std::string	expectText (const char terminatingChar='\n')=0
	Read some text from the network connection. More...

virtual std::string	expectString ()
	Read a string from the network connection. More...

virtual std::int8_t	expectInt8 ()=0
	Read a 8-bit integer from the network connection. More...

virtual std::int16_t	expectInt16 ()=0
	Read a 16-bit integer from the network connection. More...

virtual std::int32_t	expectInt32 ()=0
	Read a 32-bit integer from the network connection. More...

virtual std::int64_t	expectInt64 ()=0
	Read a 64-bit integer from the network connection. More...

virtual yarp::conf::float32_t	expectFloat32 ()=0
	Read a 32-bit floating point number from the network connection. More...

virtual yarp::conf::float64_t	expectFloat64 ()=0
	Read a 64-bit floating point number from the network connection. More...

virtual bool	isTextMode () const =0
	Check if the connection is text mode. More...

virtual bool	isBareMode () const =0
	Check if the connection is bare mode. More...

virtual bool	convertTextMode ()=0
	Reads in a standard description in text mode, and converts it to a standard description in binary. More...

virtual size_t	getSize () const =0
	Checks how much data is available. More...

virtual ConnectionWriter *	getWriter ()=0
	Gets a way to reply to the message, if possible. More...

virtual Bytes	readEnvelope ()
	Read a message envelope, if available. More...

virtual Portable *	getReference () const =0
	Get a direct pointer to the object being sent, if possible. More...

virtual Contact	getRemoteContact () const =0
	Gets information about who is supplying the data being read, if that information is available. More...

virtual Contact	getLocalContact () const =0
	Gets information about who is receiving the data, if that information is available. More...

virtual bool	isValid () const =0

virtual bool	isActive () const =0

virtual bool	isError () const =0

virtual void	requestDrop ()=0
	Tag the connection to be dropped after the current message. More...

virtual const Searchable &	getConnectionModifiers () const =0
	Access modifiers associated with the connection, if any. More...

virtual bool	pushInt (int x)=0
	Store an integer to return on the next call to expectInt() More...

virtual bool	setSize (size_t len)=0

virtual void	setParentConnectionReader (ConnectionReader *parentConnectionReader)
	Set ConnectionReader to be used for reading the envelope. More...

virtual void	flushWriter ()=0

Public Member Functions inherited from yarp::os::ConnectionWriter
virtual	~ConnectionWriter ()
	Destructor. More...

virtual void	appendBlock (const char *data, size_t len)=0
	Send a block of data to the network connection. More...

virtual void	appendInt8 (std::int8_t data)=0
	Send a representation of a 8-bit integer to the network connection. More...

virtual void	appendInt16 (std::int16_t data)=0
	Send a representation of a 16-bit integer to the network connection. More...

virtual void	appendInt32 (std::int32_t data)=0
	Send a representation of a 32-bit integer to the network connection. More...

virtual void	appendInt64 (std::int64_t data)=0
	Send a representation of a 64-bit integer to the network connection. More...

virtual void	appendFloat32 (yarp::conf::float32_t data)=0
	Send a representation of a 32-bit floating point number to the network connection. More...

virtual void	appendFloat64 (yarp::conf::float64_t data)=0
	Send a representation of a 64-bit floating point number to the network connection. More...

virtual void	appendText (const std::string &str, const char terminate='\n')=0
	Send a terminated string to the network connection. More...

void	appendString (const std::string &str)
	Send a string to the network connection. More...

virtual void	appendExternalBlock (const char *data, size_t len)=0
	Send a block of data to the network connection, without making a copy. More...

virtual bool	isTextMode () const =0
	Check if the connection is text mode. More...

virtual bool	isBareMode () const =0
	Check if the connection is bare mode. More...

virtual void	declareSizes (int argc, int *argv)=0
	If you can easily determine how many blocks there are in a message, call this first, before anything else. More...

virtual void	setReplyHandler (PortReader &reader)=0
	This sets a handler to deal with replies to the message. More...

virtual void	setReference (Portable *obj)=0
	Stores a direct pointer to the object being sent. More...

virtual bool	convertTextMode ()=0
	Converts a standard description in binary into a textual description, if the connection is in text-mode. More...

virtual bool	isValid () const =0

virtual bool	isActive () const =0

virtual bool	isError () const =0

virtual void	requestDrop ()=0
	Tag the connection to be dropped after the current message. More...

virtual bool	isNull () const

virtual SizedWriter *	getBuffer ()=0

virtual const SizedWriter *	getBuffer () const =0

Public Member Functions inherited from yarp::os::PortWriter
virtual	~PortWriter ()
	Destructor. More...

virtual bool	write (ConnectionWriter &writer) const =0
	Write this object to a network connection. More...

virtual void	onCompletion () const
	This is called when the port has finished all writing operations. More...

virtual void	onCommencement () const
	This is called when the port is about to begin writing operations. More...

virtual yarp::os::Type	getWriteType () const

Additional Inherited Members
Static Public Member Functions inherited from yarp::os::ConnectionReader
static ConnectionReader *	createConnectionReader (InputStream &is)
	Create an instance of YARP's standard connection reader implementation. More...

static bool	readFromStream (PortReader &portable, InputStream &is)

Static Public Member Functions inherited from yarp::os::ConnectionWriter
static ConnectionWriter *	createBufferedConnectionWriter ()
	Create a connection writer implementation that stores to a buffer which can be read later using getBuffer() More...

static bool	writeToStream (PortWriter &portable, OutputStream &os)

Detailed Description

A helper for recording entire message/reply transactions.

Definition at line 22 of file ConnectionRecorder.h.

Constructor & Destructor Documentation

◆ ConnectionRecorder()

yarp::os::impl::ConnectionRecorder::ConnectionRecorder ( )

Definition at line 11 of file ConnectionRecorder.cpp.

Member Function Documentation

◆ appendBlock()

void yarp::os::impl::ConnectionRecorder::appendBlock	(	const char *	data,
		size_t	len
	)

overridevirtual

Send a block of data to the network connection.

Since communication may not happen immediately, or may happen multiple times, a copy of this data is made. If you know the block of data will remain valid, and it is a large block of data, please call ConnectionWriter::appendExternalBlock instead.

Parameters

data	the start of the data block
len	the length of the data block

Implements yarp::os::ConnectionWriter.

Definition at line 193 of file ConnectionRecorder.cpp.

◆ appendExternalBlock()

void yarp::os::impl::ConnectionRecorder::appendExternalBlock	(	const char *	data,
		size_t	len
	)

overridevirtual

Send a block of data to the network connection, without making a copy.

If you are not confident that the block of data will remain valid throughout transmission, call ConnectionWriter::appendBlock instead.

Parameters

data	the start of the data block
len	the length of the data block

Implements yarp::os::ConnectionWriter.

Definition at line 241 of file ConnectionRecorder.cpp.

◆ appendFloat32()

void yarp::os::impl::ConnectionRecorder::appendFloat32 ( yarp::conf::float32_t data )

overridevirtual

Send a representation of a 32-bit floating point number to the network connection.

Parameters

data	the floating point number to send

Implements yarp::os::ConnectionWriter.

Definition at line 223 of file ConnectionRecorder.cpp.

◆ appendFloat64()

void yarp::os::impl::ConnectionRecorder::appendFloat64 ( yarp::conf::float64_t data )

overridevirtual

Send a representation of a 64-bit floating point number to the network connection.

Parameters

data	the floating point number to send

Implements yarp::os::ConnectionWriter.

Definition at line 229 of file ConnectionRecorder.cpp.

◆ appendInt16()

void yarp::os::impl::ConnectionRecorder::appendInt16 ( std::int16_t data )

overridevirtual

Send a representation of a 16-bit integer to the network connection.

Parameters

data	the integer to send

Implements yarp::os::ConnectionWriter.

Definition at line 205 of file ConnectionRecorder.cpp.

◆ appendInt32()

void yarp::os::impl::ConnectionRecorder::appendInt32 ( std::int32_t data )

overridevirtual

Send a representation of a 32-bit integer to the network connection.

Parameters

data	the integer to send

Implements yarp::os::ConnectionWriter.

Definition at line 211 of file ConnectionRecorder.cpp.

◆ appendInt64()

void yarp::os::impl::ConnectionRecorder::appendInt64 ( std::int64_t data )

overridevirtual

Send a representation of a 64-bit integer to the network connection.

Parameters

data	the integer to send

Implements yarp::os::ConnectionWriter.

Definition at line 217 of file ConnectionRecorder.cpp.

◆ appendInt8()

void yarp::os::impl::ConnectionRecorder::appendInt8 ( std::int8_t data )

overridevirtual

Send a representation of a 8-bit integer to the network connection.

Parameters

data	the integer to send

Implements yarp::os::ConnectionWriter.

Definition at line 199 of file ConnectionRecorder.cpp.

◆ appendText()

void yarp::os::impl::ConnectionRecorder::appendText	(	const std::string &	str,
		const char	terminate
	)

overridevirtual

Send a terminated string to the network connection.

The lenght of string is not specified in advance, therefore the reader should read until the terminating character is found.

Parameters

str	the string to send
terminate	the terminating character to use

Implements yarp::os::ConnectionWriter.

Definition at line 235 of file ConnectionRecorder.cpp.

◆ convertTextMode()

bool yarp::os::impl::ConnectionRecorder::convertTextMode ( )

overridevirtual

Reads in a standard description in text mode, and converts it to a standard description in binary.

Useful if you only operate on the binary description usually, and just want to permit text mode for command-line interaction. If isTextMode would return false, no conversion is done.

Returns: true if the conversion was possible

argc	Number of blocks
argv	An array of integers, giving the length of each block

data	Start of the block of data
len	Length of the block of data

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ConnectionRecorder()

Member Function Documentation

◆ appendBlock()

◆ appendExternalBlock()

◆ appendFloat32()

◆ appendFloat64()

◆ appendInt16()

◆ appendInt32()

◆ appendInt64()

◆ appendInt8()

◆ appendText()

◆ convertTextMode()

◆ declareSizes()

◆ expectBlock()

◆ expectFloat32()

◆ expectFloat64()

◆ expectInt16()

◆ expectInt32()

◆ expectInt64()

◆ expectInt8()

◆ expectText()

◆ fini()

◆ flushWriter()

◆ getBuffer() [1/2]

◆ getBuffer() [2/2]

◆ getConnectionModifiers()

◆ getLocalContact()

◆ getMessage()

◆ getReference()

◆ getRemoteContact()

◆ getReply()

◆ getSize()

◆ getWriter()

◆ hasReply()

◆ init()

◆ isActive()

◆ isBareMode()

◆ isError()

◆ isTextMode()

◆ isValid()

◆ pushInt()

◆ requestDrop()

◆ setReference()

◆ setReplyHandler()

◆ setSize()

◆ write()