TAO_SCIOP_Profile Class Reference

This class defines the protocol specific attributes required for locating ORBs over a TCP/IP network. More...

#include <SCIOP_Profile.h>

Inheritance diagram for TAO_SCIOP_Profile:

Collaboration diagram for TAO_SCIOP_Profile:

Public Member Functions
virtual char	object_key_delimiter (void) const
	TAO_SCIOP_Profile (const ACE_INET_Addr &addr, const TAO::ObjectKey &object_key, const TAO_GIOP_Message_Version &version, TAO_ORB_Core *orb_core)
	TAO_SCIOP_Profile (const char *host, CORBA::UShort port, const TAO::ObjectKey &object_key, const ACE_INET_Addr &addr, const TAO_GIOP_Message_Version &version, TAO_ORB_Core *orb_core)
	TAO_SCIOP_Profile (TAO_ORB_Core *orb_core)
	Profile constructor, default. More...
	~TAO_SCIOP_Profile (void)
	Destructor is to be called only through <_decr_refcnt>. More...
virtual char *	to_string (void) const
	Template methods. Please see Profile.h for documentation. More...
virtual int	encode_endpoints (void)
virtual TAO_Endpoint *	endpoint (void)
virtual CORBA::ULong	endpoint_count (void) const
virtual CORBA::ULong	hash (CORBA::ULong max)
void	add_endpoint (TAO_SCIOP_Endpoint *endp)
Public Member Functions inherited from TAO_Profile
	TAO_Profile (CORBA::ULong tag, TAO_ORB_Core *orb_core, const TAO_GIOP_Message_Version &version)
CORBA::ULong	tag (void) const
const TAO_GIOP_Message_Version &	version (void) const
TAO_ORB_Core *	orb_core (void) const
unsigned long	_incr_refcnt (void)
unsigned long	_decr_refcnt (void)
void	forward_to (TAO_MProfile *mprofiles)
TAO_MProfile *	forward_to (void)
const TAO_Tagged_Components &	tagged_components (void) const
TAO_Tagged_Components &	tagged_components (void)
void	add_tagged_component (const IOP::TaggedComponent &component)
CORBA::Short	addressing_mode (void) const
const TAO::ObjectKey &	object_key (void) const
TAO::ObjectKey *	_key (void) const
virtual int	encode (TAO_OutputCDR &stream) const
virtual int	decode (TAO_InputCDR &cdr)
IOP::TaggedProfile *	create_tagged_profile (void)
virtual void	policies (CORBA::PolicyList *policy_list)
virtual void	get_policies (CORBA::PolicyList &policy_list)
virtual int	supports_multicast (void) const
virtual bool	supports_non_blocking_oneways (void) const
virtual void	addressing_mode (CORBA::Short addr_mode)
virtual void	parse_string (const char *string)
virtual int	encode_alternate_endpoints (void)
virtual TAO_Endpoint *	base_endpoint (void)
TAO_Endpoint *	first_filtered_endpoint (void)
TAO_Endpoint *	next_filtered_endpoint (TAO_Endpoint *source)
virtual void	remove_generic_endpoint (TAO_Endpoint *ep)
virtual void	add_generic_endpoint (TAO_Endpoint *ep)
CORBA::Boolean	is_equivalent (const TAO_Profile *other_profile)
CORBA::Boolean	compare_key (const TAO_Profile *other) const
CORBA::ULong	tag (void) const
const TAO_GIOP_Message_Version &	version (void) const
TAO_ORB_Core *	orb_core (void) const
unsigned long	_incr_refcnt (void)
unsigned long	_decr_refcnt (void)
void	forward_to (TAO_MProfile *mprofiles)
TAO_MProfile *	forward_to (void)
const TAO_Tagged_Components &	tagged_components (void) const
TAO_Tagged_Components &	tagged_components (void)
void	add_tagged_component (const IOP::TaggedComponent &component)
CORBA::Short	addressing_mode (void) const
const TAO::ObjectKey &	object_key (void) const
TAO::ObjectKey *	_key (void) const
virtual int	encode (TAO_OutputCDR &stream) const
virtual int	decode (TAO_InputCDR &cdr)
IOP::TaggedProfile *	create_tagged_profile (void)
virtual void	policies (CORBA::PolicyList *policy_list)
virtual void	get_policies (CORBA::PolicyList &policy_list)
virtual int	supports_multicast (void) const
virtual bool	supports_non_blocking_oneways (void) const
virtual void	addressing_mode (CORBA::Short addr_mode)
virtual void	parse_string (const char *string)
virtual int	encode_alternate_endpoints (void)
virtual TAO_Endpoint *	base_endpoint (void)
TAO_Endpoint *	first_filtered_endpoint (void)
TAO_Endpoint *	next_filtered_endpoint (TAO_Endpoint *source)
virtual void	remove_generic_endpoint (TAO_Endpoint *ep)
virtual void	add_generic_endpoint (TAO_Endpoint *ep)
CORBA::Boolean	is_equivalent (const TAO_Profile *other_profile)
CORBA::Boolean	compare_key (const TAO_Profile *other) const

Static Public Member Functions
static const char *	prefix (void)
	Return the char string prefix. More...

Static Public Attributes
static const char	object_key_delimiter_ = '/'
	The object key delimiter that SCIOP uses or expects. More...

Protected Member Functions
virtual int	decode_profile (TAO_InputCDR &cdr)
	Template methods. Please see Profile.h for the documentation. More...
virtual int	decode_endpoints (void)
virtual void	parse_string_i (const char *string)
virtual void	create_profile_body (TAO_OutputCDR &cdr) const
virtual CORBA::Boolean	do_is_equivalent (const TAO_Profile *other_profile)
Protected Member Functions inherited from TAO_Profile
virtual	~TAO_Profile (void)
	TAO_Profile (CORBA::ULong tag, TAO_ORB_Core *orb_core, const TAO::ObjectKey &key, const TAO_GIOP_Message_Version &version)
void	set_tagged_components (TAO_OutputCDR &cdr)
virtual TAO_Service_Callbacks::Profile_Equivalence	is_equivalent_hook (const TAO_Profile *other)
CORBA::ULong	hash_service_i (CORBA::ULong m)

Protected Attributes
TAO_SCIOP_Endpoint	endpoint_
CORBA::ULong	count_
	Number of endpoints in the list headed by <endpoint_>. More...
Protected Attributes inherited from TAO_Profile
TAO_GIOP_Message_Version	version_
TAO_Tagged_Components	tagged_components_
CORBA::Boolean	are_policies_parsed_
CORBA::Short	addressing_mode_
IOP::TaggedProfile *	tagged_profile_
TAO::Refcounted_ObjectKey *	ref_object_key_

Detailed Description

This class defines the protocol specific attributes required for locating ORBs over a TCP/IP network.

This class defines the SCIOP profile as specified in the CORBA specification.

Constructor & Destructor Documentation

TAO_SCIOP_Profile::TAO_SCIOP_Profile	(	const ACE_INET_Addr &	addr,
		const TAO::ObjectKey &	object_key,
		const TAO_GIOP_Message_Version &	version,
		TAO_ORB_Core *	orb_core
	)

Profile constructor, same as above except the object_key has already been marshaled.

TAO_SCIOP_Profile::TAO_SCIOP_Profile	(	const char *	host,
		CORBA::UShort	port,
		const TAO::ObjectKey &	object_key,
		const ACE_INET_Addr &	addr,
		const TAO_GIOP_Message_Version &	version,
		TAO_ORB_Core *	orb_core
	)

Profile constructor, this is the most efficient since it doesn't require any address resolution processing.

TAO_SCIOP_Profile::TAO_SCIOP_Profile

(

TAO_ORB_Core *

orb_core

)

Profile constructor, default.

TAO_SCIOP_Profile::~TAO_SCIOP_Profile

(

void

)

Destructor is to be called only through <_decr_refcnt>.

Member Function Documentation

void TAO_SCIOP_Profile::add_endpoint

(

TAO_SCIOP_Endpoint *

endp

)

Add <endp> to this profile's list of endpoints (it is inserted next to the head of the list). This profiles takes ownership of <endp>.

void TAO_SCIOP_Profile::create_profile_body ( TAO_OutputCDR &  cdr ) const

protectedvirtual

Implements TAO_Profile.

int TAO_SCIOP_Profile::decode_endpoints ( void  )

protectedvirtual

Implements TAO_Profile.

int TAO_SCIOP_Profile::decode_profile ( TAO_InputCDR &  cdr )

protectedvirtual

Template methods. Please see Profile.h for the documentation.

Implements TAO_Profile.

CORBA::Boolean TAO_SCIOP_Profile::do_is_equivalent ( const TAO_Profile *  other_profile )

protectedvirtual

Implements TAO_Profile.

int TAO_SCIOP_Profile::encode_endpoints ( void  )

virtual

Implements TAO_Profile.

TAO_Endpoint * TAO_SCIOP_Profile::endpoint ( void  )

virtual

Implements TAO_Profile.

CORBA::ULong TAO_SCIOP_Profile::endpoint_count ( void  ) const

virtual

Implements TAO_Profile.

CORBA::ULong TAO_SCIOP_Profile::hash ( CORBA::ULong  max )

virtual

Implements TAO_Profile.

char TAO_SCIOP_Profile::object_key_delimiter ( void  ) const

virtual

Implements TAO_Profile.

void TAO_SCIOP_Profile::parse_string_i ( const char *  string )

protectedvirtual

Implements TAO_Profile.

const char * TAO_SCIOP_Profile::prefix ( void  )

static

Return the char string prefix.

char * TAO_SCIOP_Profile::to_string ( void  ) const

virtual

Template methods. Please see Profile.h for documentation.

Implements TAO_Profile.

Member Data Documentation

CORBA::ULong TAO_SCIOP_Profile::count_

protected

Number of endpoints in the list headed by <endpoint_>.

TAO_SCIOP_Endpoint TAO_SCIOP_Profile::endpoint_

protected

Head of this profile's list of endpoints. This endpoint is not dynamically allocated because a profile always contains at least one endpoint.

Currently, a profile contains more than one endpoint, i.e., list contains more than just the head, only for two cases (1) when RTCORBA is enabled and (2) the ORB is initialized with -ORBPreferredInterfaces option. However, in the near future, this will be used in for mode as well, e.g., to support TAG_ALTERNATE_IIOP_ADDRESS feature.

This is probably as good a place to discuss how the list of endpoints is used for #2. If the ORB is configured to use preferred interfaces for invocation, TAO creates an endpoint per preferred interface. To be clear, every tuple <destination:target> will have an endpoint. What TAO essentially does is that creates it multiple endpoints so that the invocation code path can use existing iterating techniques to try one preferred interface after another (if the first did not work). If the ORB is configured with -ORBEnforcePreferredInterface set to false in addition to the ORBPreferredInterfaces option , TAO creates another endpoint with the preferred bit set to null, so that the invocation code can fall back to a SCTP stack returned local address. Addressing info of the default endpoint, i.e., head of the list, is transmitted using standard SCIOP ProfileBody components. See <encode_endpoints> method documentation above for how the rest of the endpoint list is transmitted.

const char TAO_SCIOP_Profile::object_key_delimiter_ = '/'

static

The object key delimiter that SCIOP uses or expects.

---

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

• SCIOP_Profile.h
• SCIOP_Profile.cpp