TAO_Endpoint Class Reference

Defines the Endpoint interface in the Pluggable Protocol framework. More...

#include <Endpoint.h>

Public Member Functions
	TAO_Endpoint (CORBA::ULong tag, CORBA::Short priority=TAO_INVALID_PRIORITY)
	Constructor.
virtual	~TAO_Endpoint ()=default
	Destructor.
CORBA::ULong	tag () const
	IOP protocol tag accessor.
void	priority (CORBA::Short priority)
	priority_ attribute setter.
CORBA::Short	priority () const
	priority_ attribute getter.

TAO_Endpoint Template Methods
Abstract methods to be implemented by concrete subclasses.
TAO_SYNCH_MUTEX	addr_lookup_lock_
	Lock for the address lookup.
CORBA::ULong	hash_val_ {}
	Cache the hash value.
CORBA::ULong const	tag_
CORBA::Short	priority_
virtual CORBA::Boolean	is_equivalent (const TAO_Endpoint *other_endpoint)=0
virtual TAO_Endpoint *	next ()=0
	Endpoints can be linked in a list.
virtual TAO_Endpoint *	next_filtered (TAO_ORB_Core *, TAO_Endpoint *root)
virtual int	addr_to_string (char *buffer, size_t length)=0
	Return a string representation for the address.
virtual TAO_Endpoint *	duplicate ()=0
virtual CORBA::ULong	hash ()=0
	Return a hash value for this object.
	TAO_Endpoint (const TAO_Endpoint &)=delete
	Endpoints should not be copied.
void	operator= (const TAO_Endpoint &)=delete
	Lock for the address lookup.

Detailed Description

Defines the Endpoint interface in the Pluggable Protocol framework.

Lightweight encapsulation of addressing information for a single acceptor endpoint. In other words, Endpoint represents a single point of contact for the server, and is the smallest unit of addressing information necessary for a client to connect to a server. A Profile contains one or more Endpoints, i.e., knows of one or more ways to contact server(s).

Constructor & Destructor Documentation

TAO_Endpoint() [1/2]

TAO_Endpoint::TAO_Endpoint	(	CORBA::ULong	tag,
		CORBA::Short	priority = TAO_INVALID_PRIORITY )

Constructor.

~TAO_Endpoint()

virtual TAO_Endpoint::~TAO_Endpoint ( )

virtualdefault

Destructor.

TAO_Endpoint() [2/2]

TAO_Endpoint::TAO_Endpoint ( const TAO_Endpoint & )

privatedelete

Endpoints should not be copied.

Member Function Documentation

addr_to_string()

virtual int TAO_Endpoint::addr_to_string ( char * buffer, size_t length )

pure virtual

Return a string representation for the address.

The purpose of this method is to provide a general interface to the underlying address object's addr_to_string method. This allows the protocol implementor to select the appropriate string format.

Returns

-1 if buffer is too small.

duplicate()

virtual TAO_Endpoint * TAO_Endpoint::duplicate ( )

pure virtual

This method returns a deep copy of the corresponding endpoints by allocating memory.

hash()

virtual CORBA::ULong TAO_Endpoint::hash ( )

pure virtual

Return a hash value for this object.

is_equivalent()

virtual CORBA::Boolean TAO_Endpoint::is_equivalent ( const TAO_Endpoint * other_endpoint )

pure virtual

Returns

true if this endpoint is equivalent to other_endpoint.

next()

virtual TAO_Endpoint * TAO_Endpoint::next ( )

pure virtual

Endpoints can be linked in a list.

Returns

The next endpoint in the list, if any.

next_filtered()

TAO_Endpoint * TAO_Endpoint::next_filtered ( TAO_ORB_Core * , TAO_Endpoint * root )

virtual

Return the next endpoint in the list, but use protocol-specific filtering to constrain the value. The orb core is needed to supply any sort of filter arguments, and the root endpoint is needed in case the algorithm needs to rewind. If the supplied root is 0, then this is assumed to be the candidate next endpoint.

To use this, the caller starts off the change with root == 0. This is a bit of a violation in logic, a more correct implementation would accept this == 0 and a non-null root. To do iteration using next_filtered, do: for (TAO_Endpoint *ep = root_endpoint->next_filtered (orb_core, 0); ep != 0; ep = ep->next_filtered(orb_core, root_endpoint)) { }

operator=()

void TAO_Endpoint::operator= ( const TAO_Endpoint & )

privatedelete

Lock for the address lookup.

Todo

This lock should be strategized so that we dont lock in single threaded configurations. It is not possible to do this now as most of the information is available in the ORB_Core which is not available here.

priority() [1/2]

CORBA::Short TAO_Endpoint::priority

(

)

const

priority_ attribute getter.

priority() [2/2]

void TAO_Endpoint::priority

(

CORBA::Short

priority

)

priority_ attribute setter.

tag()

CORBA::ULong TAO_Endpoint::tag

(

)

const

IOP protocol tag accessor.

Member Data Documentation

addr_lookup_lock_

TAO_SYNCH_MUTEX TAO_Endpoint::addr_lookup_lock_

mutableprotected

Lock for the address lookup.

Todo

This lock should be strategized so that we dont lock in single threaded configurations. It is not possible to do this now as most of the information is available in the ORB_Core which is not available here.

hash_val_

CORBA::ULong TAO_Endpoint::hash_val_ {}

protected

Cache the hash value.

priority_

CORBA::Short TAO_Endpoint::priority_

protected

CORBA priority of the acceptor this Endpoint is representing. This is part of TAO 'prioritized endpoints' architecture, and is currently used for RTCORBA only.

tag_

CORBA::ULong const TAO_Endpoint::tag_

protected

IOP tag, identifying the protocol for which this endpoint contains addressing info.

---

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

• Endpoint.h
• Endpoint.cpp
• Endpoint.inl