TAO_IIOP_Endpoint Class Reference

TAO_IIOP_Endpoint. More...

#include <IIOP_Endpoint.h>

Inheritance diagram for TAO_IIOP_Endpoint:

Inheritance graph
[legend]
Collaboration diagram for TAO_IIOP_Endpoint:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 TAO_IIOP_Endpoint (void)
 Default constructor.
 TAO_IIOP_Endpoint (const char *host, CORBA::UShort port, const ACE_INET_Addr &addr, CORBA::Short priority=TAO_INVALID_PRIORITY)
 TAO_IIOP_Endpoint (const ACE_INET_Addr &addr, int use_dotted_decimal_addresses)
 Constructor.
 TAO_IIOP_Endpoint (const char *host, CORBA::UShort port, CORBA::Short priority)
 Constructor. This constructor is used when decoding endpoints.
 ~TAO_IIOP_Endpoint (void)
 Destructor.
virtual TAO_Endpointnext (void)
 Endpoints can be linked in a list.
virtual TAO_Endpointnext_filtered (TAO_ORB_Core *, TAO_Endpoint *root)
virtual int addr_to_string (char *buffer, size_t length)
 Return a string representation for the address.
virtual TAO_Endpointduplicate (void)
 Makes a copy of this.
virtual CORBA::Boolean is_equivalent (const TAO_Endpoint *other_endpoint)
virtual CORBA::ULong hash (void)
 Return a hash value for this object.
const ACE_INET_Addrobject_addr (void) const
 Return a reference to the <object_addr>.
const char * host (void) const
const char * host (const char *h)
CORBA::UShort port (void) const
 Return the port number.
CORBA::UShort port (CORBA::UShort p)
 Set the port number.
bool is_preferred_network (void) const
 Do we have a preferred local network for the target?
const char * preferred_network (void) const
 Return the preferred network if any.
bool is_ipv6_decimal (void) const
 Does the host string represent an IPv6 decimal address.
TAO_IIOP_Endpointoperator= (const TAO_IIOP_Endpoint &other)

Private Member Functions

TAO_IIOP_Endpointnext_filtered_i (TAO_IIOP_Endpoint *root, bool ipv6_only, bool prefer_ipv6, bool want_ipv6)
int set (const ACE_INET_Addr &addr, int use_dotted_decimal_addresses)
 Helper method for setting INET_Addr.
void object_addr_i (void) const
 Helper method for object_addr () call.
CORBA::ULong preferred_interfaces (const char *csvPreferred, bool enforce, TAO_IIOP_Profile &profile)
TAO_IIOP_Endpointadd_local_endpoint (TAO_IIOP_Endpoint *ep, const char *local, TAO_IIOP_Profile &profile)
 TAO_IIOP_Endpoint (const TAO_IIOP_Endpoint &)
 Canonical copy constructor.

Private Attributes

CORBA::String_var host_
 String representing the host name.
CORBA::UShort port_
 TCP port number.
bool is_ipv6_decimal_
 Does the host string represent an IPv6 decimal address.
bool is_encodable_
 Is this endpoint created encodable as part of the IOR?
bool object_addr_set_
 Flag to indicate if the address has been resolved and set.
ACE_INET_Addr object_addr_
TAO::IIOP_Endpoint_Info preferred_path_
 Preferred path for this endpoint.
TAO_IIOP_Endpointnext_

Friends

class TAO_IIOP_Profile
class TAO_SSLIOP_Profile


Detailed Description

TAO_IIOP_Endpoint.

IIOP-specific implementation of PP Framework Endpoint interface.


Constructor & Destructor Documentation

TAO_IIOP_Endpoint::TAO_IIOP_Endpoint ( void   ) 

Default constructor.

TAO_IIOP_Endpoint::TAO_IIOP_Endpoint ( const char *  host,
CORBA::UShort  port,
const ACE_INET_Addr addr,
CORBA::Short  priority = TAO_INVALID_PRIORITY 
)

Constructor. This is the most efficient constructor since it does not require any address resolution processing.

TAO_IIOP_Endpoint::TAO_IIOP_Endpoint ( const ACE_INET_Addr addr,
int  use_dotted_decimal_addresses 
)

Constructor.

TAO_IIOP_Endpoint::TAO_IIOP_Endpoint ( const char *  host,
CORBA::UShort  port,
CORBA::Short  priority 
)

Constructor. This constructor is used when decoding endpoints.

TAO_IIOP_Endpoint::~TAO_IIOP_Endpoint ( void   ) 

Destructor.

TAO_IIOP_Endpoint::TAO_IIOP_Endpoint ( const TAO_IIOP_Endpoint rhs  )  [private]

Canonical copy constructor.

In private section to prevent clients from invoking this accidentally. Clients should only use duplicate () to make a deep copy


Member Function Documentation

TAO_IIOP_Endpoint * TAO_IIOP_Endpoint::add_local_endpoint ( TAO_IIOP_Endpoint ep,
const char *  local,
TAO_IIOP_Profile profile 
) [private]

Chain a new duplicate of ourself with the specified local preferred interface.

int TAO_IIOP_Endpoint::addr_to_string ( char *  buffer,
size_t  length 
) [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.

Implements TAO_Endpoint.

TAO_Endpoint * TAO_IIOP_Endpoint::duplicate ( void   )  [virtual]

Makes a copy of this.

Implements TAO_Endpoint.

CORBA::ULong TAO_IIOP_Endpoint::hash ( void   )  [virtual]

Return a hash value for this object.

Implements TAO_Endpoint.

const char * TAO_IIOP_Endpoint::host ( const char *  h  ) 

Copy the string <h> into <host_> and return the resulting pointer. This object maintains ownership of this string.

const char* TAO_IIOP_Endpoint::host ( void   )  const

Return a pointer to the host string. This object maintains ownership of this string.

CORBA::Boolean TAO_IIOP_Endpoint::is_equivalent ( const TAO_Endpoint other_endpoint  )  [virtual]

Return true if this endpoint is equivalent to other_endpoint. Two endpoints are equivalent if their port and host are the same.

Implements TAO_Endpoint.

bool TAO_IIOP_Endpoint::is_ipv6_decimal ( void   )  const

Does the host string represent an IPv6 decimal address.

bool TAO_IIOP_Endpoint::is_preferred_network ( void   )  const

Do we have a preferred local network for the target?

TAO_Endpoint * TAO_IIOP_Endpoint::next ( void   )  [virtual]

Endpoints can be linked in a list.

Returns:
The next endpoint in the list, if any.

Implements TAO_Endpoint.

TAO_Endpoint * TAO_IIOP_Endpoint::next_filtered ( TAO_ORB_Core 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)) { }

Reimplemented from TAO_Endpoint.

TAO_IIOP_Endpoint * TAO_IIOP_Endpoint::next_filtered_i ( TAO_IIOP_Endpoint root,
bool  ipv6_only,
bool  prefer_ipv6,
bool  want_ipv6 
) [private]

const ACE_INET_Addr & TAO_IIOP_Endpoint::object_addr ( void   )  const

Return a reference to the <object_addr>.

void TAO_IIOP_Endpoint::object_addr_i ( void   )  const [private]

Helper method for object_addr () call.

TAO_IIOP_Endpoint & TAO_IIOP_Endpoint::operator= ( const TAO_IIOP_Endpoint other  ) 

Need to have an assignment operator since the IIOP_Profile class may have to reorder its list of endpoints based on filtering by the EndpointPolicy.

CORBA::UShort TAO_IIOP_Endpoint::port ( CORBA::UShort  p  ) 

Set the port number.

CORBA::UShort TAO_IIOP_Endpoint::port ( void   )  const

Return the port number.

CORBA::ULong TAO_IIOP_Endpoint::preferred_interfaces ( const char *  csvPreferred,
bool  enforce,
TAO_IIOP_Profile profile 
) [private]

Generate preferred interfaces from the options passed in by the user.

const char * TAO_IIOP_Endpoint::preferred_network ( void   )  const

Return the preferred network if any.

int TAO_IIOP_Endpoint::set ( const ACE_INET_Addr addr,
int  use_dotted_decimal_addresses 
) [private]

Helper method for setting INET_Addr.


Friends And Related Function Documentation

friend class TAO_IIOP_Profile [friend]

friend class TAO_SSLIOP_Profile [friend]


Member Data Documentation

String representing the host name.

Is this endpoint created encodable as part of the IOR?

Does the host string represent an IPv6 decimal address.

IIOP Endpoints can be stringed into a list. Return the next endpoint in the list, if any.

Cached instance of ACE_INET_Addr for use in making invocations, etc.

bool TAO_IIOP_Endpoint::object_addr_set_ [mutable, private]

Flag to indicate if the address has been resolved and set.

TCP port number.

TAO::IIOP_Endpoint_Info TAO_IIOP_Endpoint::preferred_path_ [private]

Preferred path for this endpoint.


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

Generated on Mon Jul 13 16:26:05 2009 for TAO by  doxygen 1.5.8