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
|
/* -*- C++ -*- */
//=============================================================================
/**
* @file Gadget_Part_Impl.h
*
* $Id: Gadget_Part_Impl.h 91743 2010-09-13 18:24:51Z johnnyw $
*
* @author Christopher Kohlhoff <chris@kohlhoff.com>
*/
//=============================================================================
#ifndef GADGET_PART_IMPL_H
#define GADGET_PART_IMPL_H
#include "Gadget_Part.h"
#include "Gadget.h"
/**
* @class Gadget_Part_Impl
*
* @brief An implementation of the Gadget_Part interface.
*/
class Gadget_Part_Impl : public Gadget_Part
{
public:
/// Constructor.
Gadget_Part_Impl (Gadget_ptr owner, const char* name, int size);
/// Destructor.
virtual ~Gadget_Part_Impl (void);
/// Ask the part to print information about itself.
virtual void print_info (void);
/// Ask the part to remove itself from the gadget that contains it.
virtual void remove_from_owner (void);
private:
/// The gadget that contains this part.
///
/// Some things to note about the choice of ACE_Weak_Bound_Ptr (from the
/// typedef for Gadget_ptr):
/// - We cannot use an ACE_Strong_Bound_Ptr (Gadget_var) since that would
/// result in circular ownership.
/// - If we use a raw pointer we have no circular ownership problems, but we
/// are unable to guarantee the lifetime of the owner object for the
/// duration of the remove_from_owner call. This may not be a problem in
/// this limited example, but in multithreaded programs remove_from_owner
/// may be called from a different thread to the thread which manages the
/// owner's lifetime.
/// - ACE_Weak_Bound_Ptr (Gadget_ptr) has no ownership semantics, so we have
/// no circular ownership problems. Weak pointers can also be converted
/// back into strong ones, so it is possible to guarantee the lifetime of
/// the owner object for the duration of the remove_from_owner call.
Gadget_ptr owner_;
/// The name of this part.
char *name_;
/// The size of this part.
int size_;
};
#endif /* GADGET_PART_IMPL_H */
|
