TAO::PICurrent_Guard Class Reference

Class used to make copying between request scope current and thread scope current exception-safe. More...

#include <PICurrent_Guard.h>

Collaboration diagram for TAO::PICurrent_Guard:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 PICurrent_Guard (TAO_ServerRequest &server_request, bool tsc_to_rsc)
 Constructor.
 ~PICurrent_Guard (void)
 Destructor.

Private Attributes

PICurrent_Implsrc_
 The PICurrent implementation whose slot table will be copied.
PICurrent_Impldest_
PICurrent_Copy_Callbackcopy_callback_
const bool tsc_to_rsc_
 Flag that indicates if the TSC is to be copied to the RSC.

Detailed Description

Class used to make copying between request scope current and thread scope current exception-safe.

Since copies between the request scope current and thread scope current must also occur if an exception is thrown, e.g. made available to the send_exception() interception points, the "guard" idiom is used to make this action exception-safe.

Note:
This Guard class is only used on the server side.


Constructor & Destructor Documentation

TAO::PICurrent_Guard::PICurrent_Guard TAO_ServerRequest server_request,
bool  tsc_to_rsc
 

Constructor.

This constructor sets up this guard to copy the data held in a given PICurrent when transitioning from that PICurrent's scope to another scope (e.g. request scope to thread scope transition immediately following receive_request_service_contexts() on server side).

Parameters:
tsc_to_rsc true when copying TSC slot table to RSC slot table, i.e. after target operation completes.

TAO::PICurrent_Guard::~PICurrent_Guard void   ) 
 

Destructor.

The destructor copies (a logical copy whenever possible) data held in a given PICurrent when transitioning from one PICurrent scope to another immediately before any ending interception points are invoked, and after the starting and intermediate (if any) interception points are invoked.


Member Data Documentation

PICurrent_Copy_Callback& TAO::PICurrent_Guard::copy_callback_ [private]
 

Callback object responsible for performing deep copies of a PICurrent's slot table.

PICurrent_Impl* TAO::PICurrent_Guard::dest_ [private]
 

The PICurrent implementation whose slot table will be filled with the contents of another PICurrent's slot table.

PICurrent_Impl* TAO::PICurrent_Guard::src_ [private]
 

The PICurrent implementation whose slot table will be copied.

const bool TAO::PICurrent_Guard::tsc_to_rsc_ [private]
 

Flag that indicates if the TSC is to be copied to the RSC.

If false, then the RSC must be deep copied upon leaving the request scope and entering the thread scope. This is necessary since the RSC slot table is no longer available upon leaving the thread scope, meaning that a logical copy is not enough.


The documentation for this class was generated from the following files:
Generated on Wed Nov 23 16:10:38 2005 for TAO_PortableServer by  doxygen 1.4.5