TAO_IIOP_Transport Class Reference

Specialization of the base TAO_Transport class to handle the IIOP protocol. More...

#include <IIOP_Transport.h>

Inheritance diagram for TAO_IIOP_Transport:

[legend]Collaboration diagram for TAO_IIOP_Transport:

[legend]List of all members.

Overridden Template Methods
Please check the documentation in "tao/Transport.h" for more details.
void	update_protocol_properties (int send_buffer_size, int recv_buffer_size, int no_delay, int enable_network_priority)
	Bridge method to call a similar method on the connection handler.
virtual int	send_request (TAO_Stub *stub, TAO_ORB_Core *orb_core, TAO_OutputCDR &stream, TAO_Message_Semantics message_semantics, ACE_Time_Value *max_wait_time)
virtual int	send_message (TAO_OutputCDR &stream, TAO_Stub *stub=0, TAO_Message_Semantics message_semantics=TAO_Transport::TAO_TWOWAY_REQUEST, ACE_Time_Value *max_time_wait=0)
	Bridge method to call a similar method on the connection handler.
virtual int	generate_request_header (TAO_Operation_Details &opdetails, TAO_Target_Specification &spec, TAO_OutputCDR &msg)
	Bridge method to call a similar method on the connection handler.
virtual int	tear_listen_point_list (TAO_InputCDR &cdr)
	Bridge method to call a similar method on the connection handler.
virtual TAO_Connection_Handler *	connection_handler_i (void)
	Bridge method to call a similar method on the connection handler.
virtual ACE_Event_Handler *	event_handler_i (void)
	Bridge method to call a similar method on the connection handler.
virtual ssize_t	send (iovec *iov, int iovcnt, size_t &bytes_transferred, const ACE_Time_Value *timeout=0)
	Bridge method to call a similar method on the connection handler.
virtual ssize_t	recv (char *buf, size_t len, const ACE_Time_Value *s=0)
	Bridge method to call a similar method on the connection handler.
Public Member Functions
	TAO_IIOP_Transport (TAO_IIOP_Connection_Handler *handler, TAO_ORB_Core *orb_core)
	Constructor.
Protected Member Functions
virtual	~TAO_IIOP_Transport (void)
	Destructor.
Private Member Functions
void	set_bidir_context_info (TAO_Operation_Details &opdetails)
	Set the Bidirectional context info in the service context list.
int	get_listen_point (IIOP::ListenPointList &listen_point_list, TAO_Acceptor *acceptor)
Private Attributes
TAO_IIOP_Connection_Handler *	connection_handler_

---

Detailed Description

Specialization of the base TAO_Transport class to handle the IIOP protocol.

Specialization of the base TAO_Transport class to handle the IIOP protocol.

Definition at line 52 of file IIOP_Transport.h.

---

Constructor & Destructor Documentation

TAO_BEGIN_VERSIONED_NAMESPACE_DECL TAO_IIOP_Transport::TAO_IIOP_Transport	(	TAO_IIOP_Connection_Handler *	handler,
		TAO_ORB_Core *	orb_core
	)

Constructor.

Definition at line 26 of file IIOP_Transport.cpp.

  : TAO_Transport (IOP::TAG_INTERNET_IOP,
                   orb_core)
  , connection_handler_ (handler)
{
}

TAO_IIOP_Transport::~TAO_IIOP_Transport

(

void

)

[protected, virtual]

Destructor.

Protected destructor to enforce proper memory management through the reference counting mechanism.

Definition at line 34 of file IIOP_Transport.cpp.

{
}

---

Member Function Documentation

TAO_Connection_Handler * TAO_IIOP_Transport::connection_handler_i

(

void

)

[virtual]

Bridge method to call a similar method on the connection handler.

Implements TAO_Transport.

Definition at line 55 of file IIOP_Transport.cpp.

References connection_handler_.

{
  return this->connection_handler_;
}

ACE_Event_Handler * TAO_IIOP_Transport::event_handler_i

(

void

)

[protected, virtual]

Bridge method to call a similar method on the connection handler.

Implements TAO_Transport.

Definition at line 49 of file IIOP_Transport.cpp.

References connection_handler_.

{
  return this->connection_handler_;
}

int TAO_IIOP_Transport::generate_request_header	(	TAO_Operation_Details &	opdetails,
		TAO_Target_Specification &	spec,
		TAO_OutputCDR &	msg
	)			[virtual]

Bridge method to call a similar method on the connection handler.

Reimplemented from TAO_Transport.

Definition at line 261 of file IIOP_Transport.cpp.

References TAO_Transport::bidirectional_flag(), TAO_Transport::generate_request_header(), TAO_GIOP_Message_Base::is_ready_for_bidirectional(), TAO_Transport::messaging_object_, and TAO_Operation_Details::request_id().

{
  // Check whether we have a Bi Dir IIOP policy set, whether the
  // messaging objects are ready to handle bidirectional connections
  // and also make sure that we have not recd. or sent any information
  // regarding this before...
  if (this->orb_core ()->bidir_giop_policy () &&
      this->messaging_object_->is_ready_for_bidirectional (msg) &&
      this->bidirectional_flag () < 0)
    {
      this->set_bidir_context_info (opdetails);

      // Set the flag to 1 (i.e., originating side)
      this->bidirectional_flag (1);

      // At the moment we enable BiDIR giop we have to get a new
      // request id to make sure that we follow the even/odd rule
      // for request id's. We only need to do this when enabled
      // it, after that the Transport Mux Strategy will make sure
      // that the rule is followed
      opdetails.request_id (this->tms ()->request_id ());
    }

  return TAO_Transport::generate_request_header (opdetails, spec, msg);
}

int TAO_IIOP_Transport::get_listen_point	(	IIOP::ListenPointList &	listen_point_list,
		TAO_Acceptor *	acceptor
	)			[private]

Add the listen points in acceptor to the listen_point_list if this connection is in the same interface as that of the endpoints in the acceptor

Definition at line 366 of file IIOP_Transport.cpp.

References ACE_DEBUG, ACE_ERROR_RETURN, ACE_TEXT, TAO_IIOP_Acceptor::endpoint_count(), TAO_IIOP_Acceptor::endpoints(), ACE_INET_Addr::get_port_number(), ACE_Addr::get_type(), TAO_IIOP_Acceptor::hostname(), LM_DEBUG, LM_ERROR, ACE_INET_Addr::set_port_number(), ACE_OS::strchr(), CORBA::string_dup(), and TAO_debug_level.

{
  TAO_IIOP_Acceptor *iiop_acceptor =
    dynamic_cast<TAO_IIOP_Acceptor *> (acceptor);

  if (iiop_acceptor == 0)
    return -1;

  // Get the array of endpoints serviced by TAO_IIOP_Acceptor
  const ACE_INET_Addr *endpoint_addr =
    iiop_acceptor->endpoints ();

  // Get the endpoint count
  size_t const count =
    iiop_acceptor->endpoint_count ();

  // Get the local address of the connection
  ACE_INET_Addr local_addr;

  if (this->connection_handler_->peer ().get_local_addr (local_addr) == -1)
    {
      ACE_ERROR_RETURN ((LM_ERROR,
                         ACE_TEXT ("TAO (%P|%t) - IIOP_Transport::get_listen_point, ")
                         ACE_TEXT ("could not resolve local host address\n")),
                        -1);
    }

  // Note: Looks like there is no point in sending the list of
  // endpoints on interfaces on which this connection has not
  // been established. If this is wrong, please correct me.
  CORBA::String_var local_interface;

  // Get the hostname for the local address
  if (iiop_acceptor->hostname (this->orb_core_,
                               local_addr,
                               local_interface.out ()) == -1)
    {
      ACE_ERROR_RETURN ((LM_ERROR,
                         ACE_TEXT ("TAO (%P|%t) - IIOP_Transport::get_listen_point, ")
                         ACE_TEXT ("could not resolve local host name\n")),
                        -1);
    }
#if defined (ACE_HAS_IPV6)
  // If this is an IPv6 decimal linklocal address containing a scopeid than
  // remove the scopeid from the information being sent.
  const char *cp_scope = 0;
  if (local_addr.get_type () == PF_INET6 &&
        (cp_scope = ACE_OS::strchr (local_interface.in (), '%')) != 0)
    {
      CORBA::ULong len = cp_scope - local_interface.in ();
      local_interface[len] = '\0';
    }
#endif /* ACE_HAS_IPV6 */

  for (size_t index = 0;
       index < count;
       ++index)
    {
      // Make sure port numbers are equal so the following comparison
      // only concerns the IP(v4/v6) address.
      local_addr.set_port_number (endpoint_addr[index].get_port_number ());

      if (local_addr == endpoint_addr[index])
        {
          // Get the count of the number of elements
          const CORBA::ULong len = listen_point_list.length ();

          // Increase the length by 1
          listen_point_list.length (len + 1);

          // We have the connection and the acceptor endpoint on the
          // same interface
          IIOP::ListenPoint & point = listen_point_list[len];
          point.host = CORBA::string_dup (local_interface.in ());
          point.port = endpoint_addr[index].get_port_number ();

          if (TAO_debug_level >= 5)
          {
            ACE_DEBUG ((LM_DEBUG,
                        ACE_TEXT("TAO (%P|%t) - Listen_Point_List[%d] = <%s:%d>\n"),
                        len,
                        point.host.in (),
                        point.port));
          }

        }
    }

  return 1;
}

ssize_t TAO_IIOP_Transport::recv	(	char *	buf,
		size_t	len,
		const ACE_Time_Value *	s = 0
	)			[protected, virtual]

Bridge method to call a similar method on the connection handler.

Implements TAO_Transport.

Definition at line 166 of file IIOP_Transport.cpp.

References ACE_DEBUG, ACE_TEXT, connection_handler_, LM_DEBUG, and TAO_debug_level.

{
  ssize_t const n = this->connection_handler_->peer ().recv (buf,
                                                             len,
                                                             max_wait_time);

  // Do not print the error message if it is a timeout, which could
  // occur in thread-per-connection.
  if (n == -1 && TAO_debug_level > 4 && errno != ETIME)
    {
      ACE_DEBUG ((LM_DEBUG,
                  ACE_TEXT ("TAO (%P|%t) - IIOP_Transport[%d]::recv, ")
                  ACE_TEXT ("read failure - %m errno %d\n"),
                  this->id (),
                  errno));
    }

  // Error handling
  if (n == -1)
    {
      if (errno == EWOULDBLOCK)
        return 0;

      return -1;
    }

  // Most of the errors handling is common for
  // Now the message has been read

  // @@ What are the other error handling here??
  else if (n == 0)
    {
      return -1;
    }

  return n;
}

ssize_t TAO_IIOP_Transport::send	(	iovec *	iov,
		int	iovcnt,
		size_t &	bytes_transferred,
		const ACE_Time_Value *	timeout = 0
	)			[protected, virtual]

Bridge method to call a similar method on the connection handler.

Implements TAO_Transport.

Definition at line 61 of file IIOP_Transport.cpp.

References ACE_DEBUG, ACE_TEXT, connection_handler_, LM_DEBUG, and TAO_debug_level.

{
  ssize_t const retval =
    this->connection_handler_->peer ().sendv (iov,
                                              iovcnt,
                                              max_wait_time);
  if (retval > 0)
    bytes_transferred = retval;
  else
    {
      if (TAO_debug_level > 4)
        {
          ACE_DEBUG ((LM_DEBUG,
                      ACE_TEXT ("TAO (%P|%t) - IIOP_Transport[%d]::send, ")
                      ACE_TEXT ("send failure (errno: %d) - %m\n"),
                      this->id (), errno));
        }
    }

  return retval;
}

int TAO_IIOP_Transport::send_message	(	TAO_OutputCDR &	stream,
		TAO_Stub *	stub = 0,
		TAO_Message_Semantics	message_semantics = TAO_Transport::TAO_TWOWAY_REQUEST,
		ACE_Time_Value *	max_time_wait = 0
	)			[virtual]

Bridge method to call a similar method on the connection handler.

Definition at line 228 of file IIOP_Transport.cpp.

References ACE_DEBUG, ACE_TEXT, ACE_OutputCDR::begin(), LM_DEBUG, TAO_Transport::send_message_shared(), and TAO_debug_level.

{
  // Format the message in the stream first
  if (this->messaging_object_->format_message (stream) != 0)
    return -1;

  // This guarantees to send all data (bytes) or return an error.
  ssize_t const n = this->send_message_shared (stub,
                                               message_semantics,
                                               stream.begin (),
                                               max_wait_time);

  if (n == -1)
    {
      // Dont try to be smart and request for %p in the debug
      // statement.  If the event handler is destroyed the transport
      // would return -1 with errno set to ENOENT. %p then would dump
      // a core. %m would then be softer on this.
      if (TAO_debug_level)
        ACE_DEBUG ((LM_DEBUG,
                    ACE_TEXT ("TAO (%P|%t) - IIOP_Transport[%d]::send_message, ")
                    ACE_TEXT ("write failure - %m\n"),
                    this->id ()));
      return -1;
    }

  return 1;
}

int TAO_IIOP_Transport::send_request	(	TAO_Stub *	stub,
		TAO_ORB_Core *	orb_core,
		TAO_OutputCDR &	stream,
		TAO_Message_Semantics	message_semantics,
		ACE_Time_Value *	max_wait_time
	)			[virtual]

Todo:

These methods IMHO should have more meaningful names. The names seem to indicate nothing.

Definition at line 207 of file IIOP_Transport.cpp.

References TAO_Transport::first_request_sent(), and TAO_Transport::orb_core().

{
  if (this->ws_->sending_request (orb_core, message_semantics) == -1)
    return -1;

  if (this->send_message (stream,
                          stub,
                          message_semantics,
                          max_wait_time) == -1)
    return -1;

  this->first_request_sent();

  return 0;
}

void TAO_IIOP_Transport::set_bidir_context_info

(

TAO_Operation_Details &

opdetails

)

[private]

Set the Bidirectional context info in the service context list.

Definition at line 310 of file IIOP_Transport.cpp.

References TAO_Thread_Lane_Resources::acceptor_registry(), ACE_ERROR, TAO_Acceptor_Registry::begin(), TAO_Acceptor_Registry::end(), TAO_ORB_Core::lane_resources(), LM_ERROR, TAO_Transport::orb_core(), TAO_Operation_Details::request_service_context(), TAO_Service_Context::set_context(), TAO_debug_level, and TAO_ENCAP_BYTE_ORDER.

{
  // Get a handle to the acceptor registry
  TAO_Acceptor_Registry &ar =
    this->orb_core ()->lane_resources ().acceptor_registry ();

  IIOP::ListenPointList listen_point_list;

  const TAO_AcceptorSetIterator end = ar.end ();

  for (TAO_AcceptorSetIterator acceptor = ar.begin ();
       acceptor != end;
       ++acceptor)
    {
      // Check whether it is an IIOP acceptor
      if ((*acceptor)->tag () == IOP::TAG_INTERNET_IOP)
        {
          if (this->get_listen_point (listen_point_list, *acceptor) == -1)
            {
              if (TAO_debug_level > 0)
                ACE_ERROR ((LM_ERROR,
                            "TAO (%P|%t) - IIOP_Transport::set_bidir_context_info, "
                            "error getting listen_point\n"));

              return;
            }
        }
    }

  if (listen_point_list.length () == 0)
    {
      if (TAO_debug_level > 0)
        ACE_ERROR ((LM_ERROR,
                    "TAO (%P|%t) - IIOP_Transport::set_bidir_context_info, "
                    "listen_point list is empty, client should send a list "
                    "with at least one point\n"));

      return;
    }

  // We have the ListenPointList at this point. Create a output CDR
  // stream at this point
  TAO_OutputCDR cdr;

  // Marshal the information into the stream
  if ((cdr << ACE_OutputCDR::from_boolean (TAO_ENCAP_BYTE_ORDER) == 0)
      || (cdr << listen_point_list) == 0)
    return;

  // Add this info in to the svc_list
  opdetails.request_service_context ().set_context (IOP::BI_DIR_IIOP, cdr);

  return;
}

int TAO_IIOP_Transport::tear_listen_point_list

(

TAO_InputCDR &

cdr

)

[virtual]

Bridge method to call a similar method on the connection handler.

Reimplemented from TAO_Transport.

Definition at line 290 of file IIOP_Transport.cpp.

References TAO_Transport::bidirectional_flag(), connection_handler_, TAO_IIOP_Connection_Handler::process_listen_point_list(), and ACE_InputCDR::reset_byte_order().

{
  CORBA::Boolean byte_order;
  if ((cdr >> ACE_InputCDR::to_boolean (byte_order)) == 0)
    return -1;

  cdr.reset_byte_order (static_cast<int> (byte_order));

  IIOP::ListenPointList listen_list;
  if ((cdr >> listen_list) == 0)
    return -1;

  // As we have received a bidirectional information, set the flag to
  // 0 (i.e., non-originating side)
  this->bidirectional_flag (0);

  return this->connection_handler_->process_listen_point_list (listen_list);
}

void TAO_IIOP_Transport::update_protocol_properties	(	int	send_buffer_size,
		int	recv_buffer_size,
		int	no_delay,
		int	enable_network_priority
	)

Bridge method to call a similar method on the connection handler.

---

Member Data Documentation

TAO_IIOP_Connection_Handler* TAO_IIOP_Transport::connection_handler_ [private]

The connection service handler used for accessing lower layer communication protocols.

Definition at line 139 of file IIOP_Transport.h.

Referenced by connection_handler_i(), event_handler_i(), recv(), send(), and tear_listen_point_list().

---

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

• IIOP_Transport.h
• IIOP_Transport.cpp

---