ssliop_profile.h

这是广泛使用的通信开源项目,对于大容量,高并发的通讯要求完全能够胜任,他广泛可用于网络游戏医学图像网关的高qos要求.更详细的内容可阅读相应的材料

// -*- C++ -*-

//=============================================================================
/**
 *  @file SSLIOP_Profile.h
 *
 *  SSLIOP_Profile.h,v 1.23 2003/10/28 15:10:59 ossama Exp
 *
 *  SSLIOP profile specific processing
 *
 *  @author Carlos O'Ryan <[e-mail]>
 *  @author Ossama Othman <[e-mail]>
 */
//=============================================================================


#ifndef TAO_SSLIOP_PROFILE_H
#define TAO_SSLIOP_PROFILE_H

#include /**/ "ace/pre.h"

#include "ace/config-all.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

#include "SSLIOP_Endpoint.h"
#include "tao/IIOP_Profile.h"

class TAO_SSLIOP_Client_Connection_Handler;

/**
 * @class TAO_SSLIOP_Profile
 *
 * @brief This class defines the protocol specific attributes required
 * for locating ORBs over a TCP/IP network, using either IIOP or
 * IIOP/SSL for communication.
 *
 * This class extends TAO_IIOP_Profile to support secure
 * communication using SSL.
 */
class TAO_SSLIOP_Export TAO_SSLIOP_Profile : public TAO_IIOP_Profile
{
public:
  /// Profile constructor, same as above except the object_key has
  /// already been marshaled.
  TAO_SSLIOP_Profile (const ACE_INET_Addr & addr,
                      const TAO::ObjectKey & object_key,
                      const TAO_GIOP_Message_Version & version,
                      TAO_ORB_Core * orb_core,
                      const SSLIOP::SSL * ssl_component);

  ///  Profile constructor, this is the most efficient since it
  /// doesn't require any address resolution processing.
  TAO_SSLIOP_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,
                      const SSLIOP::SSL * ssl_component);

  /// Create profile with the given SSLIOP tagged component.
  TAO_SSLIOP_Profile (TAO_ORB_Core * orb_core,
                      const SSLIOP::SSL * ssl_component);

  /// Profile constructor, default.
  TAO_SSLIOP_Profile (TAO_ORB_Core * orb_core);

  /// Destructor is to be called only through _decr_refcnt().
  ~TAO_SSLIOP_Profile (void);

  // = Please see Profile.h for the documentation of these methods.
  virtual int decode (TAO_InputCDR& cdr);
  virtual int encode_endpoints (void);
  virtual TAO_Endpoint *endpoint (void);

  /**
   * Override parse_string() from the base class to update the ssl
   * endpoint's iiop endpoint once the base class has completed parsing
   * the string.
   *@par
   * Initialize this object using the given input string.
   * Url-style string contain only one endpoint.
   */
  virtual void parse_string (const char * string
                             ACE_ENV_ARG_DECL);

  /**
   * 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>.  If <endp>'s <iiop_endpoint_> member is not 0, it is
   * added to our parent's class endpoint list.
   */
  void add_endpoint (TAO_SSLIOP_Endpoint * endp);

protected:

  /// Profile equivalence template method.
  /**
   * @see TAO_Profile::do_is_equivalent()
   */
  virtual CORBA::Boolean do_is_equivalent (const TAO_Profile * other_profile);

private:

  /**
   * Helper for <decode>.  Decodes TAO_TAG_SSL_ENDPOINTS from a tagged
   * component. Decode only if RTCORBA is enabled.  Return 0 on
   * success and -1 on failure.
   *
   * @NOTE: This should be enabled only when RTCORBA is enabled, but
   * sadly others pay the price (of footprint) under normal
   * operations.
   */
  int decode_tagged_endpoints (void);

  /**
   * Head of this profile's list of endpoints.  This endpoint is not
   * dynamically allocated because a profile always contains at least
   * one endpoint.
   * @par
   * Currently, a profile contains more than one endpoint, i.e., list
   * contains more than just the head, only when RTCORBA is enabled.
   * However, in the near future, this will be used in nonRT mode as
   * well, e.g., to support TAG_ALTERNATE_IIOP_ADDRESS feature.
   * @par
   * Since SSLIOP profile is an extension of IIOP profile, its
   * addressing info is contained in two places:  IIOP parent class
   * contains all iiop addressing while this class contains
   * ssl-specific addressing additions to iiop.  This means that
   * there are two lists of endpoints: one maintained in the parent
   * class and one maintained here.  Each ssl endpoint maintains a
   * pointer to its counterpart in the parent class endpoint list.
   * @par
   * For transmission of iiop addressing information, see
   * TAO_IIOP_Profile.  Addressing info of the default ssl endpoint,
   * i.e., head of the list, is transmitted using standard
   * SSLIOP::TAG_SSL_SEC_TRANS tagged component.  See
   * <encode_endpoints> method documentation above for how the rest of
   * the ssl endpoint list is transmitted.
   */
  TAO_SSLIOP_Endpoint ssl_endpoint_;
};

#if defined (__ACE_INLINE__)
# include "SSLIOP_Profile.i"
#endif /* __ACE_INLINE__ */

#include /**/ "ace/post.h"

#endif  /* TAO_SSLIOP_PROFILE_H */