summaryrefslogtreecommitdiff
path: root/TAO/tao/Cache_Entries.h
blob: 8c3477be95a60062d709e3d557c5010ca8ab2580 (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
174
175
176
177
178
179
180
181
182
183
184
185
/* -*- 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/Transport_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_Transport;

#ifdef index
#undef index
#endif /* index */

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

public:

  // = Initialization and termination methods.

  /// Constructor.
  TAO_Cache_IntId (void);

  /// Constructor.
  TAO_Cache_IntId (TAO_Transport *transport);

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

  /// Destructor.
  ~TAO_Cache_IntId (void);

  /// Assignment operator (does copy memory).
  TAO_Cache_IntId& 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 transport
  TAO_Transport *transport (void);

  /// Return the underlying transport
  const TAO_Transport *transport (void) const;

  void recycle_state (ACE_Recyclable_State new_state);

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

  /// Relinquish ownership of the TAO_Transport object associated with
  /// this TAO_Cache_IntId.
  /**
   * @note This method should go away once the
   *       Transport_Cache_Map_Manager is improved so that it returns
   *       TAO_Transport objects when performing a find() operation.
   *       This method really only exists to get around inadequacies
   *       in the Transport_Cache_Map_Manager interface.
   */
  TAO_Transport *relinquish_transport (void);

private:
  /// The transport that needs to be cached.
  TAO_Transport *transport_;

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


/**
 * @class TAO_Cache_ExtId
 *
 * @brief Helper class for TAO_Transport_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
 * Transport Cache.
 *
 */
class TAO_Export TAO_Cache_ExtId
{
public:
  // = Initialization and termination methods.

  /// Constructor.
  TAO_Cache_ExtId (void);

  /// Constructor.
  TAO_Cache_ExtId (TAO_Transport_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).
  TAO_Cache_ExtId& 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_Transport_Cache_Manager class.
  void index (CORBA::ULong index);

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

private:
  // = Data members.

  /// A property object that we represent.
  TAO_Transport_Descriptor_Interface *transport_property_;

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

  /**
   * This is a supplementary index. Would be set to zero by
   * default. Would be altered by the Transport_Cache of TAO. Please
   * see the documentation of TAO_Transport_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 */