summaryrefslogtreecommitdiff
path: root/TAO/tao/Cache_Entries.h
blob: a725698436efdef028e22729f73c9192720a164e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
/* -*- C++ -*- */

//=============================================================================
/**
 *  @file   Cache_Entries.h
 *
 *  $Id$
 *
 *  @author Bala Natarajan  <bala@cs.wustl.edu>
 */
//=============================================================================


#ifndef TAO_CACHE_ENTRIES_H
#define TAO_CACHE_ENTRIES_H
#include "ace/pre.h"

#include "tao/Connection_Descriptor_Interface.h"

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

#if defined(_MSC_VER)
#if (_MSC_VER >= 1200)
#pragma warning(push)
#endif /* _MSC_VER >= 1200 */
#pragma warning(disable:4250)
#endif /* _MSC_VER */

class TAO_Connection_Handler;
class Tao_Base_Connection_Property;


/**
 * @class TAO_Cache_IntId
 *
 * @brief Helper class for TAO_Connection_Cache_Manager
 *
 * Helper class that wraps the <value> part of the Map or
 * table holding the Connection state.: unifies data items, so
 * they can be stored together as a <value> for a <key> in a
 * table holding the state of the Connection Cache.
 */
class TAO_Export TAO_Cache_IntId
{

public:

  // = Initialization and termination methods.

  /// Constructor.
  TAO_Cache_IntId (void);

  /// Constructor.
  TAO_Cache_IntId (TAO_Connection_Handler *handler);

  /// Copy constructor.
  TAO_Cache_IntId (const TAO_Cache_IntId & rhs);

  /// Destructor.
  ~TAO_Cache_IntId (void);

  /// Assignment operator (does copy memory).
  void operator= (const TAO_Cache_IntId &rhs);

  /// Equality comparison operator (must match both id_ and kind_).
  int operator== (const TAO_Cache_IntId &rhs) const;

  /// Inequality comparison operator.
  int operator!= (const TAO_Cache_IntId &rhs) const;

  /// Return the underlying handler
  TAO_Connection_Handler *handler (void);

  /// Return the underlying handler
  const TAO_Connection_Handler *handler (void) const;

  void recycle_state (ACE_Recyclable_State new_state);

  /// Get/Set <recycle_state>.
  ACE_Recyclable_State recycle_state (void);

private:

  /// The connection handler that needs to be cached.
  TAO_Connection_Handler *handler_;

  /// The state of the handle
  ACE_Recyclable_State recycle_state_;
};


/**
 * @class TAO_Cache_ExtId
 *
 * @brief Helper class for TAO_Connection_Cache_Manager: unifies
 * several  data items, so they can be stored together as a
 * <value> for a <key> in a hash table holding the state of the
 * Connection Cache.
 *
 */
class TAO_Export TAO_Cache_ExtId
{
public:
  // = Initialization and termination methods.

  /// Constructor.
  TAO_Cache_ExtId (void);

  /// Constructor.
  TAO_Cache_ExtId (TAO_Connection_Descriptor_Interface *prop);

  /// Copy constructor.
  TAO_Cache_ExtId (const TAO_Cache_ExtId & rhs);

  /// Destructor.
  ~TAO_Cache_ExtId (void);

  // = Assignment and comparison operators.
  /// Assignment operator (does copy memory).
  void operator= (const TAO_Cache_ExtId &rhs);

  /// Equality comparison operator (must match both id_ and kind_).
  int operator== (const TAO_Cache_ExtId &rhs) const;

  /// Inequality comparison operator.
  int operator!= (const TAO_Cache_ExtId &rhs) const;

  /// <hash> function is required in order for this class to be usable by
  /// ACE_Hash_Map_Manager.
  u_long hash (void) const;

  /// Make a deep copy of the underlying pointer
  void duplicate (void);

  /// Return the index value
  CORBA::ULong index (void);
  CORBA::ULong index (void) const;

  /// Set the index value. This calls should not be used by any users
  /// but for the TAO_Connection_Cache_Manager class.
  void index (CORBA::ULong index);

  // = Accessors
  /// Get the underlying the property pointer
  TAO_Connection_Descriptor_Interface *property (void) const;

private:
  // = Data members.

  /// A property object that we represent.
  TAO_Connection_Descriptor_Interface *connection_property_;

  /// Do we need to delete connection_propert_?
  CORBA::Boolean is_delete_;

  /**
   * This is a supplementary index. Would be set to zero by
   * default. Would be altered by the Connection_Cache of TAO. Please
   * see the documentation of TAO_Connection_Cache_Manager for
   * details.
   */
  CORBA::ULong index_;
};


#if defined (__ACE_INLINE__)
# include "tao/Cache_Entries.inl"
#endif /* __ACE_INLINE__ */

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