Emulation of websocket with long poll requests.

Allows to send data from server to client without explicit request

Created automatically as fallback solution when normal WebSopcket connection cannot be established

Definition at line 23 of file THttpLongPollEngine.h.

Public Member Functions
	THttpLongPollEngine (bool raw=false)
	constructor

virtual	~THttpLongPollEngine ()=default

void	ClearHandle (Bool_t) override
	Clear request.

UInt_t	GetId () const override
	Returns ID of the engine, created from this pointer.

void	PostProcess (std::shared_ptr< THttpCallArg > &arg) override
	Post process http request.

Bool_t	PreProcess (std::shared_ptr< THttpCallArg > &arg) override
	Preview data for given socket.

void	Send (const void *buf, int len) override
	Send binary data via connection.

void	SendCharStar (const char *buf) override
	Send const char data.

void	SendHeader (const char hdr, const void buf, int len) override
	Send binary data with text header via connection.

Public Member Functions inherited from THttpWSEngine
virtual	~THttpWSEngine ()=default

virtual void	ClearHandle (Bool_t)=0

virtual UInt_t	GetId () const =0

virtual void	PostProcess (std::shared_ptr< THttpCallArg > &arg)
	Method invoked after user process data received via websocket.

virtual Bool_t	PreProcess (std::shared_ptr< THttpCallArg > &arg)
	Method should be invoked before processing data coming from websocket If method returns kTRUE, data is processed internally and not dedicated for further usage.

virtual void	Send (const void *buf, int len)=0

virtual void	SendCharStar (const char *str)
	Envelope for sending string via the websocket.

virtual void	SendHeader (const char hdr, const void buf, int len)=0

Protected Types
enum	EBufKind { kNoBuf , kTxtBuf , kBinBuf }

Protected Member Functions
virtual Bool_t	CanSendDirectly () override
	Indicate that polling requests is there or buffer empty and can be immediately invoked.

std::string	MakeBuffer (const void buf, int len, const char hdr=nullptr)
	!< default reply on the longpoll request

Protected Member Functions inherited from THttpWSEngine
	THttpWSEngine ()=default

virtual Bool_t	CanSendDirectly ()
	One always can send data to websocket - as long as previous send operation completed.

virtual Bool_t	SupportSendThrd () const
	Indicate if engine require extra thread to complete postponed thread operation.

Protected Attributes
std::string	fBuf
	!< if buffered data available

std::string	fBufHeader
	!< buffered data

EBufKind	fBufKind {kNoBuf}
	!< hold polling request, which can be immediately used for the next sending

std::mutex	fMutex
	!< if true, only content can be used for data transfer

std::shared_ptr< THttpCallArg >	fPoll
	!< protect polling request to use it from different threads

bool	fRaw {false}

Static Protected Attributes
static const std::string	gLongPollNope = "<<nope>>"
	!< buffered header

Friends
class	THttpServer

#include </home/sftnight/build/workspace/root-makedoc-master/rootspi/rdoc/src/master/net/http/src/THttpLongPollEngine.h>

Inheritance diagram for THttpLongPollEngine:

[legend]

Member Enumeration Documentation

◆ EBufKind

enum THttpLongPollEngine::EBufKind

protected

Enumerator
kNoBuf
kTxtBuf
kBinBuf

Definition at line 28 of file THttpLongPollEngine.h.

Constructor & Destructor Documentation

◆ THttpLongPollEngine()

THttpLongPollEngine::THttpLongPollEngine ( bool raw = false )

constructor

Definition at line 35 of file THttpLongPollEngine.cxx.

◆ ~THttpLongPollEngine()

virtual THttpLongPollEngine::~THttpLongPollEngine ( )

virtualdefault

Member Function Documentation

◆ CanSendDirectly()

Bool_t THttpLongPollEngine::CanSendDirectly ( )

overrideprotectedvirtual

Indicate that polling requests is there or buffer empty and can be immediately invoked.

Reimplemented from THttpWSEngine.

Definition at line 270 of file THttpLongPollEngine.cxx.

◆ ClearHandle()

void THttpLongPollEngine::ClearHandle ( Bool_t )

overridevirtual

Clear request.

normally called shortly before destructor

Implements THttpWSEngine.

Definition at line 53 of file THttpLongPollEngine.cxx.

◆ GetId()

UInt_t THttpLongPollEngine::GetId ( ) const

overridevirtual

Returns ID of the engine, created from this pointer.

Implements THttpWSEngine.

Definition at line 42 of file THttpLongPollEngine.cxx.

◆ MakeBuffer()

std::string THttpLongPollEngine::MakeBuffer	(	const void *	buf,
		int	len,
		const char *	hdr = `nullptr`
	)

protected

!< default reply on the longpoll request

Create raw buffer which should be send as reply.

For the raw mode all information must be send via binary response

Definition at line 73 of file THttpLongPollEngine.cxx.

◆ PostProcess()

void THttpLongPollEngine::PostProcess ( std::shared_ptr< THttpCallArg > & arg )

overridevirtual

Post process http request.

Normally requests from client does not replied directly for longpoll socket Therefore one can use such request to send data, which was submitted before to the queue

Reimplemented from THttpWSEngine.

Definition at line 239 of file THttpLongPollEngine.cxx.

◆ PreProcess()

Bool_t THttpLongPollEngine::PreProcess ( std::shared_ptr< THttpCallArg > & arg )

overridevirtual

Preview data for given socket.

Method called by WS handler before processing websocket data Returns kTRUE when user should ignore such http request - it is for internal use

Reimplemented from THttpWSEngine.

Definition at line 200 of file THttpLongPollEngine.cxx.

◆ Send()

void THttpLongPollEngine::Send	(	const void *	buf,
		int	len
	)

overridevirtual

Send binary data via connection.

Implements THttpWSEngine.

Definition at line 103 of file THttpLongPollEngine.cxx.

◆ SendCharStar()

void THttpLongPollEngine::SendCharStar ( const char * buf )

overridevirtual

Send const char data.

Either do it immediately or keep in internal buffer

Reimplemented from THttpWSEngine.

Definition at line 166 of file THttpLongPollEngine.cxx.

◆ SendHeader()

void THttpLongPollEngine::SendHeader	(	const char *	hdr,
		const void *	buf,
		int	len
	)

overridevirtual

Send binary data with text header via connection.

Implements THttpWSEngine.

Definition at line 132 of file THttpLongPollEngine.cxx.

Friends And Related Symbol Documentation

◆ THttpServer

friend class THttpServer

friend

Definition at line 24 of file THttpLongPollEngine.h.

Member Data Documentation

◆ fBuf

std::string THttpLongPollEngine::fBuf

protected

!< if buffered data available

Definition at line 34 of file THttpLongPollEngine.h.

◆ fBufHeader

std::string THttpLongPollEngine::fBufHeader

protected

!< buffered data

Definition at line 35 of file THttpLongPollEngine.h.

◆ fBufKind

EBufKind THttpLongPollEngine::fBufKind {kNoBuf}

protected

!< hold polling request, which can be immediately used for the next sending

Definition at line 33 of file THttpLongPollEngine.h.

◆ fMutex

std::mutex THttpLongPollEngine::fMutex

protected

!< if true, only content can be used for data transfer

Definition at line 31 of file THttpLongPollEngine.h.

◆ fPoll

std::shared_ptr<THttpCallArg> THttpLongPollEngine::fPoll

protected

!< protect polling request to use it from different threads

Definition at line 32 of file THttpLongPollEngine.h.

◆ fRaw

bool THttpLongPollEngine::fRaw {false}

protected

Definition at line 30 of file THttpLongPollEngine.h.

◆ gLongPollNope

const std::string THttpLongPollEngine::gLongPollNope = "<<nope>>"

staticprotected

!< buffered header

Definition at line 36 of file THttpLongPollEngine.h.

net/http/src/THttpLongPollEngine.h

net/http/src/THttpLongPollEngine.cxx

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Protected Attributes

Friends

Member Enumeration Documentation

◆ EBufKind

Constructor & Destructor Documentation

◆ THttpLongPollEngine()

◆ ~THttpLongPollEngine()

Member Function Documentation

◆ CanSendDirectly()

◆ ClearHandle()

◆ GetId()

◆ MakeBuffer()

◆ PostProcess()

◆ PreProcess()

◆ Send()

◆ SendCharStar()

◆ SendHeader()

Friends And Related Symbol Documentation

◆ THttpServer

Member Data Documentation

◆ fBuf

◆ fBufHeader

◆ fBufKind

◆ fMutex

◆ fPoll

◆ fRaw

◆ gLongPollNope