Collaboration diagram for TAO_Stub:
Public Member Functions
|virtual CORBA::Policy_ptr||get_policy (CORBA::PolicyType type)|
|virtual CORBA::Policy_ptr||get_cached_policy (TAO_Cached_Policy_Type type)|
|virtual TAO_Stub *||set_policy_overrides (const CORBA::PolicyList &policies, CORBA::SetOverrideType set_add)|
|virtual CORBA::PolicyList *||get_policy_overrides (const CORBA::PolicyTypeSeq &types)|
|TAO::Transport_Queueing_Strategy &||transport_queueing_strategy (void)|
|CORBA::ULong||hash (CORBA::ULong maximum)|
|CORBA::Boolean||is_equivalent (CORBA::Object_ptr other_obj)|
|Implement the is_equivalent() method for the CORBA::Object. |
|TAO_Stub (const char *repository_id, const TAO_MProfile &profiles, TAO_ORB_Core *orb_core)|
|Construct from a repository ID and a list of profiles. |
|ACE_Lock *||profile_lock (void) const|
|TAO_Profile *||profile_in_use (void)|
|const TAO::ObjectKey &||object_key (void) const|
|Return the ObjectKey. |
|TAO_MProfile *||make_profiles (void)|
|const TAO_MProfile &||base_profiles (void) const|
|Obtain a reference to the basic profile set. |
|TAO_MProfile &||base_profiles (void)|
|Obtain a reference to the basic profile set. |
|const TAO_MProfile *||forward_profiles (void) const|
|Obtain a pointer to the forwarded profile set. |
|TAO_Profile *||next_profile (void)|
|True if permanent location forward occured, in this case the lock must be set and the. |
|NON-THREAD-SAFE. Will set profile_success_ to 0. |
|CORBA::Boolean||valid_profile (void) const|
|TAO_Profile *||base_profiles (const TAO_MProfile &mprofiles)|
|void||add_forward_profiles (const TAO_MProfile &mprofiles, const CORBA::Boolean permanent_forward=false)|
|TAO_ORB_Core *||orb_core (void) const|
|CORBA::Boolean||is_collocated (void) const|
|Is this stub collocated with the servant? |
|Mutator to mark this stub as being collocated with the servant. |
|This returns a duplicated ORB pointer. |
|CORBA::ORB_var &||servant_orb_var (void)|
|This returns the ORB var itself (generally for temporary use). |
|void||servant_orb (CORBA::ORB_ptr orb)|
|void||collocated_servant (TAO_Abstract_ServantBase *servant)|
|Mutator for setting the servant in collocated cases. |
|TAO_Abstract_ServantBase *||collocated_servant (void) const|
|Accessor for the servant reference in collocated cases. |
|void||object_proxy_broker (TAO::Object_Proxy_Broker *proxy_broker)|
|TAO::Object_Proxy_Broker *||object_proxy_broker (void) const|
|int||create_ior_info (IOP::IOR *&ior_info, CORBA::ULong &index)|
|Deallocate the TAO_Stub object. |
|CORBA::Boolean||optimize_collocation_objects (void) const|
|Return the cached value from the ORB_Core. |
|CORBA::Boolean||marshal (TAO_OutputCDR &)|
|Needed to avoid copying forward_profiles for thread safety. |
|All objref representations carry around a type ID. |
Protected Member Functions
|NON-THREAD SAFE version of reset_profiles (void);. |
|TAO_Profile *||next_profile_i (void)|
|NON-THREAD SAFE version of next_profile (void). |
|Automatically manage the ORB_Core reference count. |
|Servant pointer. It is 0 except for collocated objects. |
|Pointer to the Proxy Broker. |
|Ordered list of profiles for this object. |
|This is the profile that we are currently sending/receiving with. |
|Mutex to protect access to the forwarding profile. |
|Have we successfully talked to the forward profile yet? |
unsigned long >
|Reference counter. |
|Forwarded IOR info. |
Private Member Functions
|TAO_Profile *||set_profile_in_use_i (TAO_Profile *pfile)|
|TAO_Profile *||next_forward_profile (void)|
|NON-THREAD-SAFE. utility method for next_profile. |
|int||get_profile_ior_info (TAO_MProfile &profile, IOP::IOR *&ior_info)|
|THREAD-SAFE Create the IOR info. |
|TAO_Stub (const TAO_Stub &)|
|TAO_Stub &||operator= (const TAO_Stub &)|
Per-objref data includes the (protocol-specific) Profile, which is handled by placing it into a subclass of this type along with data that may be used in protocol-specific caching schemes. The type ID (the data specified by CORBA 2.0 that gets exposed "on the wire", and in stringified objrefs) is held by this module. The stub APIs are member functions of this type.
|TAO_BEGIN_VERSIONED_NAMESPACE_DECL TAO_Stub::TAO_Stub||(||const char *||repository_id,|
|const TAO_MProfile &||profiles,|
Construct from a repository ID and a list of profiles.
Destructor is to be called only through _decr_refcnt() to enforce proper reference counting.
|TAO_Stub::TAO_Stub||(||const TAO_Stub &||)||
|void TAO_Stub::add_forward_profiles||(||const TAO_MProfile &||mprofiles,|
|const CORBA::Boolean|| permanent_forward = |
THREAD SAFE. Set the forward_profiles. This object will assume ownership of this TAO_MProfile object!! if permanent_forward is true, currently used profiles will be replaced permanently, otherwise stub may fallback to current profiles later. The flag permanent_forward=true is only valid if currently used profile set represents a GroupObject (IOGR), otherwise this flag will be ignored.
Initialize the base_profiles_ and set profile_in_use_ to reference the first profile.
Obtain a reference to the basic profile set.
Obtain a reference to the basic profile set.
Accessor for the servant reference in collocated cases.
Mutator for setting the servant in collocated cases.
|int TAO_Stub::create_ior_info||(||IOP::IOR *&||ior_info,|
Create the IOP::IOR info. We will create the info at most once. Get the index of the profile we are using to make the invocation.
|ACE_INLINE void TAO_Stub::destroy||(||void||)|
NON-THREAD-SAFE. Utility method which unrolls (removes or pops) the top most forwarding profile list.
Obtain a pointer to the forwarded profile set.
Returns the effective policy if type is a known client-exposed policy type. Returns the effective override for all other policy types.
|CORBA::PolicyList * TAO_Stub::get_policy_overrides||(||const CORBA::PolicyTypeSeq &||types||)||
|int TAO_Stub::get_profile_ior_info||(||TAO_MProfile &||profile,|
THREAD-SAFE Create the IOR info.
All objref representations know how to hash themselves and compare themselves for equivalence to others. It's easily possible to have two objrefs that are distinct copies of data that refers/points to the same remote object (i.e. are equivalent).
Mutator to mark this stub as being collocated with the servant.
Is this stub collocated with the servant?
Needed to avoid copying forward_profiles for thread safety.
NON-THREAD-SAFE. utility method for next_profile.
True if permanent location forward occured, in this case the lock must be set and the.
THREAD SAFE. If forward_profiles is null then this will get the next profile in the base_profiles list. If forward is not null then this will get the next profile for the list of forwarding profiles. If all profiles have been tried then 0 is returned and profile_in_use_ is set to the first profile in the base_profiles list.
NON-THREAD SAFE version of next_profile (void).
THREAD SAFE Used to get the next profile after the one being used has failed during the initial connect or send of the message!
|const TAO::ObjectKey & TAO_Stub::object_key||(||void||)||const|
Return the ObjectKey.
|ACE_INLINE TAO::Object_Proxy_Broker * TAO_Stub::object_proxy_broker||(||void||)||const|
Accessor for getting the object proxy broker pointer. CORBA::Objects using this stub use this for standard calls like is_a; get_interface; etc...
|ACE_INLINE void TAO_Stub::object_proxy_broker||(||TAO::Object_Proxy_Broker *||proxy_broker||)|
Mutator for setting the object proxy broker pointer. CORBA::Objects using this stub will use this for standard calls like is_a; get_interface; etc...
Return the cached value from the ORB_Core.
This flag indicates whether the stub code should make use of the collocation opportunities that are available to the ORB.
returns a pointer to the profile_in_use object. This object retains ownership of this profile.
Return the Profile lock. This lock can be used at places where profiles need to be edited.
|TAO_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE void TAO_Stub::reset_base||(||)||
NON-THREAD-SAFE. Utility method which resets or initializes the base_profile list and forward flags.
|ACE_INLINE void TAO_Stub::reset_forward||(||)||
NOT THREAD-SAFE. Utility method which pops all forward profile lists and resets the forward_profiles_ pointer.
|ACE_INLINE void TAO_Stub::reset_profiles||(||void||)|
THREAD SAFE this method will reset the base profile list to reference the first profile and if there are anmy existing forward profiles they are reset.
|ACE_INLINE void TAO_Stub::reset_profiles_i||(||void||)||
NON-THREAD SAFE version of reset_profiles (void);.
This returns the ORB var itself (generally for temporary use).
|TAO_Stub * TAO_Stub::set_policy_overrides||(||const CORBA::PolicyList &||policies,|
Makes a copy of the profile and frees the existing profile_in_use. NOT THREAD SAFE
|ACE_INLINE void TAO_Stub::set_valid_profile||(||void||)|
NON-THREAD-SAFE. Will set profile_success_ to 0.
|TAO::Transport_Queueing_Strategy & TAO_Stub::transport_queueing_strategy||(||void||)|
Return the queueing strategy to be used in by the transport. Selection will be based on the SyncScope policies.
Returns 1 if a forward profile has successfully been used. profile_success_ && forward_profiles_
Returns TRUE if a connection was successful with at least one profile.
Servant pointer. It is 0 except for collocated objects.
This should be the same value as cached in the ORB_Core. The reason for caching this helps our generated code, notably the stubs to be decoubled from ORB_Core. Please do not move it away.
The list of forwarding profiles. This is actually implemented as a linked list of TAO_MProfile objects.
Forwarded IOR info.
The ior info. This is needed for GIOP 1.2, as the clients could receive an exception from the server asking for this info. The exception that the client receives is LOC_NEEDS_ADDRESSING_MODE. The data is set up here to be passed on to Invocation classes when they receive an exception. This info is for the base profiles that this class stores
Flag that indicates that this stub is collocated (and that it belongs to an ORB for which collocation optimisation is active).
Pointer to the Proxy Broker.
This cached pointer instance takes care of routing the call for standard calls in CORBA::Object like _is_a (), _get_component () etc.
Automatically manage the ORB_Core reference count.
The ORB_Core cannot go away until the object references it creates are destroyed. There are multiple reasons for this, but in particular, the allocators used for some of the TAO_Profile objects contained on each TAO_Stub are owned by the TAO_ORB_Core.
This must be the first field of the class, otherwise the TAO_ORB_Core is destroyed too early!
The policy overrides in this object, if nil then use the default policies.
This is the profile that we are currently sending/receiving with.
Mutex to protect access to the forwarding profile.
Have we successfully talked to the forward profile yet?