DABC (Data Acquisition Backbone Core)  2.9.9
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes
aqua::ClientOutput Class Reference

#include <aqua/ClientOutput.h>

Inheritance diagram for aqua::ClientOutput:
dabc::SocketIOAddon dabc::DataOutput dabc::SocketAddon dabc::WorkerAddon dabc::Object

Public Member Functions

 ClientOutput (dabc::Url &url)
 
virtual unsigned Write_Buffer (dabc::Buffer &buf)
 Start writing of buffer to output. More...
 
virtual unsigned Write_Check ()
 Check if output can be done. More...
 
virtual unsigned Write_Complete ()
 Complete writing of the buffer. More...
 
virtual bool Write_Init ()
 This is generic virtual method to initialize output before real work is started. More...
 
virtual double Write_Timeout ()
 Timeout in seconds for write operation. More...
 
virtual ~ClientOutput ()
 
- Public Member Functions inherited from dabc::SocketIOAddon
void CancelIOOperations ()
 Method should be used to cancel all running I/O operation of the socket. More...
 
void SetSendAddr (const std::string &host="", int port=0)
 Set destination address for all send operations,. More...
 
 SocketIOAddon (int fd=0, bool isdatagram=false, bool usemsg=true)
 Constructor of SocketIOAddon class. More...
 
bool StartNetRecv (void *hdr, unsigned hdrsize, Buffer &buf, BufferSize_t datasize)
 
bool StartNetSend (void *hdr, unsigned hdrsize, const Buffer &buf)
 
bool StartRecv (Buffer &buf, BufferSize_t datasize)
 
bool StartRecv (void *buf, size_t size)
 
bool StartRecvHdr (void *hdr, unsigned hdrsize, void *buf, size_t size)
 
bool StartSend (const Buffer &buf)
 
bool StartSend (const void *buf, unsigned size, const void *buf2=0, unsigned size2=0, const void *buf3=0, unsigned size3=0)
 
virtual ~SocketIOAddon ()
 Destructor of SocketIOAddon class. More...
 
- Public Member Functions inherited from dabc::SocketAddon
void CloseSocket ()
 
bool IsDeliverEventsToWorker () const
 
bool IsDoingInput () const
 
bool IsDoingOutput () const
 
bool IsSocket () const
 
virtual std::string RequiredThrdClass () const
 
void SetDeliverEventsToWorker (bool on=true)
 
void SetIOPriority (int prior=1)
 Method defines priority level for socket IO events. More...
 
void SetSocket (int fd)
 
int Socket () const
 
 SocketAddon (int fd=-1)
 
int TakeSocket ()
 
int TakeSocketError ()
 
virtual ~SocketAddon ()
 
- Public Member Functions inherited from dabc::WorkerAddon
 WorkerAddon (const std::string &name)
 
virtual ~WorkerAddon ()
 
- Public Member Functions inherited from dabc::Object
bool AddChild (Object *child, bool withmutex=true) throw ()
 Add object to list of child objects, thread safe More...
 
bool AddChildAt (Object *child, unsigned pos, bool withmutex=true)
 Add object to list of child objects at specified position. More...
 
virtual void BuildFieldsMap (RecordFieldsMap *cont)
 Fill fields map, which is relevant for the object Objects hierarchy produced from dabc::Manager. More...
 
virtual bool Find (ConfigIO &cfg)
 Method to locate object in xml file. More...
 
ObjectFindChild (const char *name) const
 returns pointer on child object with given name More...
 
Reference FindChildRef (const char *name, bool force=false) const throw ()
 returns reference on child object with given name More...
 
bool GetAllChildRef (ReferencesVector *vect) const
 
ObjectGetChild (unsigned n) const
 returns pointer on child object More...
 
Reference GetChildRef (unsigned n) const
 returns reference on child object More...
 
Reference GetFolder (const std::string &name, bool force=false) throw ()
 Return folder of specified name, no special symbols allowed. More...
 
const char * GetName () const
 Returns name of the object, thread safe More...
 
ObjectGetParent () const
 Returns pointer on parent object, thread safe More...
 
Reference GetParentRef () const
 
bool IsChildsHidden () const
 Return true if object wants to hide childs from hierarchy scan, thread safe More...
 
bool IsHidden () const
 Return true if object wants to be hidden from hierarchy scan, thread safe More...
 
bool IsLogging () const
 Return true if object selected for logging, thread safe More...
 
bool IsName (const char *str) const
 Checks if object name is same as provided string, thread safe More...
 
bool IsName (const char *str, int len) const
 Checks if object name is same as provided, thread safe More...
 
bool IsName (const std::string &str) const
 Checks if object name is same as provided string, thread safe More...
 
bool IsNameMatch (const std::string &mask) const
 Check if object name match to the mask. More...
 
bool IsOwner () const
 Returns true if object is owner of its children, thread safe More...
 
bool IsParent (Object *obj) const
 Checks if specified argument is in the list of object parents. More...
 
bool IsTopXmlLevel () const
 Return true if object should be searched in the top level of the xml file, thread safe More...
 
std::string ItemName (bool compact=true) const
 Produce string, which can be used as name argument in dabc::mgr.FindItem(name) call. More...
 
unsigned NumChilds () const
 returns number of child objects More...
 
 Object (const std::string &name, unsigned flags=flIsOwner)
 Resolve problem with child-parent mutex locking. More...
 
 Object (Reference parent, const std::string &name, unsigned flags=flIsOwner)
 
virtual void Print (int lvl=0)
 Print object content on debug output. More...
 
bool RemoveChild (Object *child, bool cleanup=true) throw ()
 Detach child from parent object If cleanup==true and parent is owner of child, child will be destroyed. More...
 
bool RemoveChildAt (unsigned n, bool cleanup=true) throw ()
 Detach child object from parent at specified position If cleanup==true and object is owner of child, child will be destroyed. More...
 
bool RemoveChilds (bool cleanup=true)
 Remove all childs. More...
 
void SetLogging (bool on=true)
 Sets logging flag, thread safe More...
 
virtual ~Object ()
 
- Public Member Functions inherited from dabc::DataOutput
virtual std::string ProvideInfo ()
 Method can be used to get debug info about output. More...
 
void SetInfoParName (const std::string &name)
 Methods set parameter name, which could be used for debug output. More...
 
virtual void Write_Flush ()
 Flush output object, called when buffer with EOL type is appeared. More...
 
virtual bool Write_Restart (dabc::Command cmd)
 Method used to restart output - like recreate new output file. More...
 
virtual bool Write_Retry ()
 Returns true if output object can be reinitialized for recover error. More...
 
virtual bool Write_Stat (dabc::Command cmd)
 Fill different statistic parameters into provided command. More...
 
bool WriteBuffer (Buffer &buf)
 Write buffer to the output. More...
 
virtual ~DataOutput ()
 

Protected Types

enum  OutputState {
  oDisconnected , oReady , oSendingBuffer , oCompleteSend ,
  oError
}
 
- Protected Types inherited from dabc::Object
enum  EFlags {
  flStateMask = 0x000f , flIsOwner = 0x0010 , flCleanup = 0x0020 , flHasThread = 0x0040 ,
  flAutoDestroy = 0x0080 , flLogging = 0x0100 , flNoMutex = 0x0200 , flHidden = 0x0400 ,
  flChildsHidden = 0x0800 , flTopXmlLevel = 0x1000
}
 

Protected Member Functions

bool ConnectAquaServer ()
 
void MakeCallBack (unsigned arg)
 
virtual void OnRecvCompleted ()
 Method called when receive operation is completed. More...
 
virtual void OnSendCompleted ()
 Method called when send operation is completed. More...
 
virtual void OnSocketError (int errnum, const std::string &info)
 Generic error handler. More...
 
virtual void OnThreadAssigned ()
 
virtual double ProcessTimeout (double lastdiff)
 
virtual WorkerAddonWrite_GetAddon ()
 Returns addon, provided by data output If specified, supposed that I/O object is double-derived from DataOutput and Addon. More...
 
- Protected Member Functions inherited from dabc::SocketIOAddon
void AllocateRecvIOV (unsigned size)
 
void AllocateSendIOV (unsigned size)
 
virtual const char * ClassName () const
 Returns class name of the object instance. More...
 
struct sockaddr_in & GetRecvAddr ()
 Method provide address of last receive operation. More...
 
unsigned GetRecvSize () const
 Method return size of last buffer read from socket. More...
 
bool IsDatagramSocket () const
 
bool IsDoingRecv () const
 
bool IsDoingSend () const
 
virtual void ProcessEvent (const EventId &)
 
- Protected Member Functions inherited from dabc::SocketAddon
ssize_t DoRecvBuffer (void *buf, ssize_t len)
 
ssize_t DoRecvBufferHdr (void *hdr, ssize_t hdrlen, void *buf, ssize_t len, void *srcaddr=0, unsigned srcaddrlen=0)
 
ssize_t DoSendBuffer (void *buf, ssize_t len)
 
ssize_t DoSendBufferHdr (void *hdr, ssize_t hdrlen, void *buf, ssize_t len, void *tgtaddr=0, unsigned tgtaddrlen=0)
 
bool IsDeleteWorkerOnClose () const
 
void SetDeleteWorkerOnClose (bool on=true)
 
void SetDoingInput (bool on=true)
 Call method to indicate that object wants to read data from the socket. More...
 
void SetDoingOutput (bool on=true)
 Call method to indicate that worker wants to write data to the socket. More...
 
- Protected Member Functions inherited from dabc::WorkerAddon
bool ActivateTimeout (double tmout_sec)
 
void DeleteAddonItself ()
 This is possibility to delete addon itself, invoking worker command. More...
 
void DeleteWorker ()
 This is way to delete worker with addon inclusive. More...
 
void FireWorkerEvent (unsigned evid)
 
virtual long Notify (const std::string &, int)
 Light-weight command interface, which can be used from worker. More...
 
virtual void ObjectCleanup ()
 User method to cleanup object content before it will be destroyed Main motivation is to release any references on other objects to avoid any cross-references and as result deadlocks in objects cleanup. More...
 
void SubmitWorkerCmd (Command cmd)
 
- Protected Member Functions inherited from dabc::Object
virtual void _ChildsChanged ()
 Method called when new childs are add or old are removed. More...
 
virtual bool _DoDeleteItself ()
 This method is called at the moment when DecReference think that object can be destroyed and wants to return true. More...
 
bool _IsNormalState ()
 Same as IsNormalState() but without mutex lock - user should lock mutex himself. More...
 
virtual ObjectCreateInstance (const std::string &name)
 Method used to create new item to be placed as child of the object. More...
 
void DeleteThis ()
 Method should be used by the object to delete itself. More...
 
virtual bool DestroyByOwnThread ()
 Internal DABC method, used to activate object cleanup via object thread Returns: false - object cannot be cleanup by the thread, true - thread guarantees that DestroyCalledFromOwnThread() will be called from thread context. More...
 
bool DestroyCalledFromOwnThread ()
 Internal DABC method, should be called by thread which was requested to destroy object. More...
 
void FillFullName (std::string &fullname, Object *upto, bool exclude_top_parent=false) const
 Method used to produce full item name,. More...
 
bool GetFlag (unsigned fl) const
 Return value of selected flag, not thread safe
More...
 
bool IsNormalState ()
 Return true if object is in normal state. More...
 
unsigned NumReferences ()
 Return number of references on the object. More...
 
 Object (const ConstructorPair &pair, unsigned flags=flIsOwner)
 
virtual void ObjectDestroyed (Object *)
 Method called by the manager when registered dependent object is destroyed Should be used in user class to clear all references on the object to let destroy it. More...
 
MutexObjectMutex () const
 Returns mutex, used for protection of Object data members. More...
 
void SetAutoDestroy (bool on=true)
 Set autodestroy flag for the object Once enabled, object will be destroyed when last reference will be cleared. More...
 
void SetFlag (unsigned fl, bool on=true)
 Change value of selected flag, not thread safe
More...
 
void SetName (const char *name)
 Changes object name. More...
 
void SetNameDirect (const char *name)
 Changes object name disregard of existing references. More...
 
void SetOwner (bool on=true)
 Specifies if object will be owner of its new childs. More...
 
- Protected Member Functions inherited from dabc::DataOutput
 DataOutput (const dabc::Url &url)
 
void ShowInfo (int lvl, const std::string &info)
 

Protected Attributes

int64_t fBufCounter
 
dabc::TimeStamp fLastConnect
 
double fReconnectTmout
 
SendHeader fSendHdr
 
std::string fServerName
 
int fServerPort
 
OutputState fState
 
- Protected Attributes inherited from dabc::SocketIOAddon
bool fDatagramSocket
 indicate if socket is datagram and all operations should be finished with single call More...
 
unsigned fLastRecvSize
 size of last recv operation More...
 
struct sockaddr_in fRecvAddr
 source address of last receive operation More...
 
struct iovec * fRecvIOV
 receive io vector for scatter list More...
 
unsigned fRecvIOVFirst
 number of element in recv IOV where transfer is started More...
 
unsigned fRecvIOVNumber
 number of elements in current recv operation More...
 
unsigned fRecvIOVSize
 number of elements in recv vector More...
 
bool fRecvUseMsg
 use recvmsg for transport More...
 
struct sockaddr_in fSendAddr
 optional send address for next send operation More...
 
struct iovec * fSendIOV
 sending io vector for gather list More...
 
unsigned fSendIOVFirst
 number of element in send IOV where transfer is started More...
 
unsigned fSendIOVNumber
 number of elements in current send operation More...
 
unsigned fSendIOVSize
 total number of elements in send vector More...
 
bool fSendUseAddr
 if true, fSendAddr will be used More...
 
bool fSendUseMsg
 use sendmsg for transport More...
 
bool fUseMsgOper
 indicate if sendmsg, recvmsg operations should be used, it is must for the datagram sockets More...
 
- Protected Attributes inherited from dabc::SocketAddon
bool fDeleteWorkerOnClose
 if true, worker will be deleted when socket closed or socket in error More...
 
bool fDeliverEventsToWorker
 if true, completion events will be delivered to the worker More...
 
bool fDoingInput
 true if input data are expected More...
 
bool fDoingOutput
 true if data need to be send More...
 
int fIOPriority
 priority of socket I/O events, default 1 More...
 
int fSocket
 socket handle More...
 
- Protected Attributes inherited from dabc::WorkerAddon
Reference fWorker
 
- Protected Attributes inherited from dabc::Object
int fObjectBlock
 counter for blocking calls, as long as non-zero, non of child can be removed More...
 
ReferencesVectorfObjectChilds
 list of the child objects More...
 
unsigned fObjectFlags
 flag, protected by the mutex More...
 
MutexfObjectMutex
 mutex protects all private property of the object More...
 
std::string fObjectName
 object name More...
 
Reference fObjectParent
 reference on the parent object More...
 
int fObjectRefCnt
 accounts how many references existing on the object, thread safe More...
 
- Protected Attributes inherited from dabc::DataOutput
std::string fInfoName
 

Additional Inherited Members

- Public Types inherited from dabc::SocketAddon
enum  ESocketEvents {
  evntSocketRead = Worker::evntFirstAddOn , evntSocketWrite , evntSocketError , evntSocketStartConnect ,
  evntSocketLast , evntSocketRecvInfo = Worker::evntFirstSystem , evntSocketSendInfo , evntSocketErrorInfo ,
  evntSocketCloseInfo , evntSocketLastInfo
}
 
- Static Public Member Functions inherited from dabc::Object
static void Destroy (Object *obj) throw ()
 User method for object destroyment. More...
 
static void InspectGarbageCollector ()
 \ brief Methods to inspect how many objects pointers are remained More...
 
static bool NameMatch (const std::string &name, const std::string &mask)
 Check if name matches to specified mask. More...
 
static bool NameMatchM (const std::string &name, const std::string &mask)
 Check if name matches to specified mask. More...
 
static unsigned NumInstances ()
 Static variable counts total number of objects instances. More...
 
- Static Protected Member Functions inherited from dabc::Object
static ConstructorPair MakePair (const std::string &fullname, bool withmanager=true)
 Internal DABC method, used to produce pair - object parent and object name, which is typically should be used as argument in class constructor. More...
 
static ConstructorPair MakePair (Object *prnt, const std::string &fullname, bool withmanager=true)
 Internal DABC method, used to produce pair - object parent and object name, which is typically should be used as argument in class constructor. More...
 
static ConstructorPair MakePair (Reference prnt, const std::string &fullname, bool withmanager=true)
 Internal DABC method, used to produce pair - object parent and object name, which is typically should be used as argument in class constructor. More...
 

Detailed Description

Definition at line 39 of file ClientOutput.h.

Member Enumeration Documentation

◆ OutputState

Enumerator
oDisconnected 
oReady 
oSendingBuffer 
oCompleteSend 
oError 

Definition at line 43 of file ClientOutput.h.

Constructor & Destructor Documentation

◆ ClientOutput()

aqua::ClientOutput::ClientOutput ( dabc::Url url)

Definition at line 56 of file ClientOutput.cxx.

◆ ~ClientOutput()

aqua::ClientOutput::~ClientOutput ( )
virtual

Definition at line 70 of file ClientOutput.cxx.

Member Function Documentation

◆ OnThreadAssigned()

void aqua::ClientOutput::OnThreadAssigned ( )
protectedvirtual

Reimplemented from dabc::WorkerAddon.

Definition at line 21 of file ClientOutput.cxx.

◆ OnSendCompleted()

void aqua::ClientOutput::OnSendCompleted ( )
protectedvirtual

Method called when send operation is completed.

Reimplemented from dabc::SocketIOAddon.

Definition at line 28 of file ClientOutput.cxx.

◆ OnRecvCompleted()

void aqua::ClientOutput::OnRecvCompleted ( )
protectedvirtual

Method called when receive operation is completed.

Reimplemented from dabc::SocketIOAddon.

Definition at line 34 of file ClientOutput.cxx.

◆ OnSocketError()

void aqua::ClientOutput::OnSocketError ( int  msg,
const std::string &  info 
)
protectedvirtual

Generic error handler.

Also invoked when socket is closed (msg==0)

Reimplemented from dabc::SocketAddon.

Definition at line 41 of file ClientOutput.cxx.

◆ ProcessTimeout()

double aqua::ClientOutput::ProcessTimeout ( double  lastdiff)
protectedvirtual

Reimplemented from dabc::WorkerAddon.

Definition at line 51 of file ClientOutput.cxx.

◆ Write_GetAddon()

virtual WorkerAddon* aqua::ClientOutput::Write_GetAddon ( )
inlineprotectedvirtual

Returns addon, provided by data output If specified, supposed that I/O object is double-derived from DataOutput and Addon.

Reimplemented from dabc::DataOutput.

Definition at line 69 of file ClientOutput.h.

◆ ConnectAquaServer()

bool aqua::ClientOutput::ConnectAquaServer ( )
protected

Definition at line 90 of file ClientOutput.cxx.

◆ MakeCallBack()

void aqua::ClientOutput::MakeCallBack ( unsigned  arg)
protected

Definition at line 75 of file ClientOutput.cxx.

◆ Write_Init()

bool aqua::ClientOutput::Write_Init ( )
virtual

This is generic virtual method to initialize output before real work is started.

If returns false, object is immediately deleted

Reimplemented from dabc::DataOutput.

Definition at line 113 of file ClientOutput.cxx.

◆ Write_Check()

unsigned aqua::ClientOutput::Write_Check ( )
virtual

Check if output can be done.

Return values: do_Ok - object is ready to write next buffer do_Error - error do_Skip - skip current buffer do_Repeat - repeat operation as soon as possible do_RepeatTimeOut - repeat operation after timeout do_Close - output is closed and need to be destroyed

Reimplemented from dabc::DataOutput.

Definition at line 121 of file ClientOutput.cxx.

◆ Write_Buffer()

unsigned aqua::ClientOutput::Write_Buffer ( dabc::Buffer buf)
virtual

Start writing of buffer to output.

Return values: do_Ok - operation is started, Write_Complete() must be called do_Error - error do_Skip - buffer must be skipped do_Close - output is closed

Reimplemented from dabc::DataOutput.

Definition at line 144 of file ClientOutput.cxx.

◆ Write_Complete()

unsigned aqua::ClientOutput::Write_Complete ( )
virtual

Complete writing of the buffer.

Return values: do_Ok - writing is done do_Error - error do_Close - output is closed

Reimplemented from dabc::DataOutput.

Definition at line 161 of file ClientOutput.cxx.

◆ Write_Timeout()

double aqua::ClientOutput::Write_Timeout ( )
virtual

Timeout in seconds for write operation.

Should be used when any of Write_ operation return do_RepeatTimeOut

Reimplemented from dabc::DataOutput.

Definition at line 172 of file ClientOutput.cxx.

Field Documentation

◆ fLastConnect

dabc::TimeStamp aqua::ClientOutput::fLastConnect
protected

Definition at line 51 of file ClientOutput.h.

◆ fReconnectTmout

double aqua::ClientOutput::fReconnectTmout
protected

Definition at line 52 of file ClientOutput.h.

◆ fServerName

std::string aqua::ClientOutput::fServerName
protected

Definition at line 53 of file ClientOutput.h.

◆ fServerPort

int aqua::ClientOutput::fServerPort
protected

Definition at line 54 of file ClientOutput.h.

◆ fSendHdr

SendHeader aqua::ClientOutput::fSendHdr
protected

Definition at line 56 of file ClientOutput.h.

◆ fState

OutputState aqua::ClientOutput::fState
protected

Definition at line 58 of file ClientOutput.h.

◆ fBufCounter

int64_t aqua::ClientOutput::fBufCounter
protected

Definition at line 59 of file ClientOutput.h.


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