ssliop_endpoint.h

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

// -*- C++ -*-

//=============================================================================
/**
 *  @file     SSLIOP_Endpoint.h
 *
 *  SSLIOP_Endpoint.h,v 1.17 2003/07/21 23:51:33 dhinton Exp
 *
 *  SSLIOP implementation of PP Framework Endpoint interface.
 *
 *  @author Marina Spivak <[e-mail]>
 *  @author Ossama Othman <[e-mail]>
 */
//=============================================================================

#ifndef TAO_SSLIOP_ENDPOINT_H
#define TAO_SSLIOP_ENDPOINT_H

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

#include "SSLIOP_Export.h"

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

#include "ace/INET_Addr.h"

#include "tao/IIOP_Endpoint.h"
#include "orbsvcs/SSLIOPC.h"

#include "SSLIOP_Credentials.h"


/// Tag for storing multiple ssl endpoints within a single profile.
const ACE_UINT32 TAO_TAG_SSL_ENDPOINTS = 0x54414f01U;


/**
 * @class TAO_SSLIOP_Endpoint
 *
 * @brief SSLIOP-specific implementation of PP Framework Endpoint
 *        interface.
 *
 *
 */
class TAO_SSLIOP_Export TAO_SSLIOP_Endpoint : public TAO_Endpoint
{
public:

  friend class TAO_SSLIOP_Profile;


  /// Constructor
  TAO_SSLIOP_Endpoint (const SSLIOP::SSL *ssl_component,
                       TAO_IIOP_Endpoint *iiop_endp);

  /// Destructor.
  ~TAO_SSLIOP_Endpoint (void);

  /**
   * @name TAO_Endpoint Methods
   *
   * See Endpoint.h for their documentation.
   */
  //@{
  virtual TAO_Endpoint *next (void);
  virtual int addr_to_string (char *buffer, size_t length);

  /// Return true if this endpoint is equivalent to @param
  /// other_endpoint.
  /**
   * Two endpoints are equivalent iff their iiop counterparts are
   * equivalent, and, if both have non-zero ssl ports, their ssl ports
   * are the same.
   */
  CORBA::Boolean is_equivalent (const TAO_Endpoint *other_endpoint);

  /// Return a copy of the corresponding endpoints by allocating
  /// memory.
  virtual TAO_Endpoint *duplicate (void);

  /// Return a hash value for this object.
  virtual CORBA::ULong hash (void);
  //@}

  /**
   * @name SSLIOP_Endpoint-specific Methods
   */
  //@{
  /// Return SSL component corresponding to this endpoint.
  const SSLIOP::SSL &ssl_component (void) const;

  /// Accessor to our IIOP counterpart.
  TAO_IIOP_Endpoint *iiop_endpoint (void) const;

  /// Mutator to our IIOP counterpart.
  /**
   * @param destroy If set to a non-zero value, then the
   *                TAO_SSLIOP_Endpoint object retains ownership of
   *                the given TAO_IIOP_Endpoint.
   */
  void iiop_endpoint (TAO_IIOP_Endpoint *endpoint, int destroy);

  /// Return the SSLIOP-specific ACE_INET_Addr.
  const ACE_INET_Addr &object_addr (void) const;

  /// Set the Quality-of-Protection settings for this endpoint.
  void qop (Security::QOP qop);

  /// Get the Quality-of-Protection settings for this endpoint.
  Security::QOP qop (void) const;

  /// Set the establishment of trust settings for this endpoint.
  void trust (const Security::EstablishTrust &trust);

  /// Get the establishment of trust settings for this endpoint.
  Security::EstablishTrust trust (void) const;

  /// Set the credentials for this endpoint.
  void credentials (TAO_SSLIOP_Credentials_ptr creds);

  /// Get the credentials for this endpoint.
  /**
   * @note This method does not follow C++ mapping memory management
   *       rules.  Specifically, no duplication or reference counting
   *       occurs in this method.  This is so that no additional locks
   *       occur when checking the transport cache.
   */
  TAO_SSLIOP_Credentials * credentials (void) const;
  //@}

private:

  /// Cache the SSL tagged component in a decoded format. Notice that
  /// we do not need to marshal this object!
  SSLIOP::SSL ssl_component_;

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

  /// IIOP Endpoints can be stringed into a list.  Return the next
  /// endpoint in the list, if any.
  TAO_SSLIOP_Endpoint *next_;

  /// IIOP counterpart.
  /**
   * Since SSLIOP is an 'extension' of IIOP, each SSLIOP_Endpoint
   * contains SSL-specific information plus a pointer to the
   * IIOP_Endpoint containing the IIOP portion of our address.
   */
  TAO_IIOP_Endpoint *iiop_endpoint_;

  /// Flag that determines whether or not the iiop_endpoint_ member is
  /// deallocated with delete().
  int destroy_iiop_endpoint_;

  /// Quailty-of-Protection settings for this endpoint object.
  Security::QOP qop_;

  /// Establishment of trust settings for this endpoint object.
  Security::EstablishTrust trust_;

  /// SSLIOP-specific credentials for this endpoint object.
  TAO_SSLIOP_Credentials_var credentials_;

};

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

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

#endif  /* TAO_SSLIOP_ENDPOINT_H */