TAO  2.3.3
Public Member Functions | Private Attributes | List of all members
TAO_Synch_Queued_Message Class Reference

Specialize TAO_Queued_Message for synchronous requests, i.e. twoways and oneways sent with reliability better than SYNC_NONE. More...

#include <Synch_Queued_Message.h>

Inheritance diagram for TAO_Synch_Queued_Message:
Inheritance graph
[legend]
Collaboration diagram for TAO_Synch_Queued_Message:
Collaboration graph
[legend]

Public Member Functions

 TAO_Synch_Queued_Message (const ACE_Message_Block *contents, TAO_ORB_Core *oc, ACE_Allocator *alloc=0, bool is_heap_allocated=false)
 Constructor. More...
 
virtual ~TAO_Synch_Queued_Message (void)
 Destructor. More...
 
const ACE_Message_Blockcurrent_block (void) const
 
Implement the Template Methods from TAO_Queued_Message
virtual size_t message_length (void) const
 Return the length of the message. More...
 
virtual int all_data_sent (void) const
 Return 1 if all the data has been sent. More...
 
virtual void fill_iov (int iovcnt_max, int &iovcnt, iovec iov[]) const
 Fill up an io vector using the connects of the message. More...
 
virtual void bytes_transferred (size_t &byte_count)
 Update the internal state, data has been sent. More...
 
virtual TAO_Queued_Messageclone (ACE_Allocator *alloc)
 Clone this element. More...
 
virtual void destroy (void)
 Reclaim resources. More...
 
virtual void copy_if_necessary (const ACE_Message_Block *chain)
 Provide a hook for copying the underlying data. More...
 
- Public Member Functions inherited from TAO_Queued_Message
 TAO_Queued_Message (TAO_ORB_Core *oc, ACE_Allocator *alloc=0, bool is_heap_allocated=false)
 Constructor. More...
 
virtual ~TAO_Queued_Message (void)
 Destructor. More...
 
TAO_Queued_Messagenext (void) const
 Set/get the next element in the list. More...
 
TAO_Queued_Messageprev (void) const
 Set/get the previous element in the list. More...
 
void remove_from_list (TAO_Queued_Message *&head, TAO_Queued_Message *&tail)
 Remove this element from the list. More...
 
void push_back (TAO_Queued_Message *&head, TAO_Queued_Message *&tail)
 Insert the current element at the tail of the queue. More...
 
void push_front (TAO_Queued_Message *&head, TAO_Queued_Message *&tail)
 Insert the current element at the head of the queue. More...
 
virtual bool is_expired (const ACE_Time_Value &now) const
 Check for timeout. More...
 
- Public Member Functions inherited from TAO_LF_Invocation_Event
 TAO_LF_Invocation_Event (void)
 Constructor. More...
 
virtual ~TAO_LF_Invocation_Event (void)
 Destructor. More...
 
int successful (void) const
 
int error_detected (void) const
 
- Public Member Functions inherited from TAO_LF_Event
 TAO_LF_Event (void)
 Constructor. More...
 
virtual ~TAO_LF_Event (void)
 Destructor. More...
 
virtual int bind (TAO_LF_Follower *follower)
 Bind a follower. More...
 
virtual int unbind (TAO_LF_Follower *follower)
 Unbind the follower. More...
 
void reset_state (int new_state)
 Reset the state, irrespective of the previous states. More...
 
void state_changed (int new_state, TAO_Leader_Follower &lf)
 
int keep_waiting (void)
 Check if we should keep waiting. More...
 

Private Attributes

ACE_Message_Blockcontents_
 The contents of the message. More...
 
ACE_Message_Blockcurrent_block_
 The current message block. More...
 
bool own_contents_
 Do we own the contents_ message block? More...
 

Additional Inherited Members

- Public Types inherited from TAO_LF_Event
enum  {
  LFS_IDLE = 0, LFS_ACTIVE, LFS_CONNECTION_WAIT, LFS_SUCCESS,
  LFS_FAILURE, LFS_TIMEOUT, LFS_CONNECTION_CLOSED
}
 
- Static Public Member Functions inherited from TAO_LF_Event
static const char * state_name (int st)
 
- Protected Member Functions inherited from TAO_LF_Invocation_Event
virtual void state_changed_i (int new_state)
 Validate and perform the state change. More...
 
- Protected Attributes inherited from TAO_Queued_Message
ACE_Allocatorallocator_
 
bool const is_heap_created_
 
TAO_ORB_Coreorb_core_
 Cached copy of ORB_Core pointer. More...
 
- Protected Attributes inherited from TAO_LF_Event
int state_
 The current state. More...
 
TAO_LF_Followerfollower_
 The bounded follower. More...
 

Detailed Description

Specialize TAO_Queued_Message for synchronous requests, i.e. twoways and oneways sent with reliability better than SYNC_NONE.

Reliable requests block the sending thread until the message is sent, likewise, the sending thread must be informed if the connection is closed or the message times out.

In contrast oneway (and AMI) requests sent with the SYNC_NONE policy are simple discarded if the connection fails or they timeout.

Another important difference is the management of the data buffer: one SYNC_NONE messages the buffer is immediately copied into a newly allocated buffer, and must be deallocated. Other types of requests use the memory allocated by the sending thread.

Constructor & Destructor Documentation

TAO_Synch_Queued_Message::TAO_Synch_Queued_Message ( const ACE_Message_Block contents,
TAO_ORB_Core oc,
ACE_Allocator alloc = 0,
bool  is_heap_allocated = false 
)

Constructor.

Parameters
contentsThe message block chain that must be sent.
allocThe allocator that is used to allocate objects of this type.
TAO_Synch_Queued_Message::~TAO_Synch_Queued_Message ( void  )
virtual

Destructor.

Member Function Documentation

int TAO_Synch_Queued_Message::all_data_sent ( void  ) const
virtual

Return 1 if all the data has been sent.

Implements TAO_Queued_Message.

void TAO_Synch_Queued_Message::bytes_transferred ( size_t &  byte_count)
virtual

Update the internal state, data has been sent.

After the TAO_Transport class completes a successful (or partially successful) I/O operation it must update the state of all the messages queued. This callback method is used by each message to update its state and determine if all the data has been sent already.

Parameters
byte_countThe number of bytes successfully sent. The TAO_Queued_Message should decrement this value by the number of bytes that must still be sent.
Returns
Returns 1 if the TAO_Queued_Message has any more data to send.

Implements TAO_Queued_Message.

TAO_Queued_Message * TAO_Synch_Queued_Message::clone ( ACE_Allocator allocator)
virtual

Clone this element.

Implements TAO_Queued_Message.

void TAO_Synch_Queued_Message::copy_if_necessary ( const ACE_Message_Block chain)
virtual

Provide a hook for copying the underlying data.

Parameters
chainFor use in determining origin of underlying data. This parameter must not be modified (through const_cast).

Implements TAO_Queued_Message.

const ACE_Message_Block * TAO_Synch_Queued_Message::current_block ( void  ) const
void TAO_Synch_Queued_Message::destroy ( void  )
virtual

Reclaim resources.

Reliable messages are allocated from the stack, thus they do not be deallocated. Asynchronous (SYNC_NONE) messages are allocated from the heap (or a pool), they need to be reclaimed explicitly.

Implements TAO_Queued_Message.

void TAO_Synch_Queued_Message::fill_iov ( int  iovcnt_max,
int &  iovcnt,
iovec  iov[] 
) const
virtual

Fill up an io vector using the connects of the message.

Different versions of this class represent the message using either a single buffer, or a message block. This method allows a derived class to fill up the contents of an io vector, the TAO_Transport class uses this method to group as many messages as possible in an iovector before sending them to the OS I/O subsystem.

Parameters
iovcnt_maxThe number of elements in iov
iovcntThe number of elements already used by iov, this method should update this counter
iovThe io vector

Implements TAO_Queued_Message.

size_t TAO_Synch_Queued_Message::message_length ( void  ) const
virtual

Return the length of the message.

If the message has been partially sent it returns the number of bytes that are still not sent.

Implements TAO_Queued_Message.

Member Data Documentation

ACE_Message_Block* TAO_Synch_Queued_Message::contents_
private

The contents of the message.

The message is normally generated by a TAO_OutputCDR stream. The application marshals the payload, possibly generating a chain of message block connected via the 'cont()' field.

ACE_Message_Block* TAO_Synch_Queued_Message::current_block_
private

The current message block.

The message may be set in multiple writev() operations. This point keeps track of the next message to send out.

bool TAO_Synch_Queued_Message::own_contents_
private

Do we own the contents_ message block?

This flag differs from the is_heap_allocated_ flag in that it only applies to the contents_ message block and not the TAO_Synch_Queued_Message object itself.


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