summaryrefslogtreecommitdiff
path: root/examples/Smart_Pointers/Gadget.h
blob: 65b1fb0a34e10d78ca90aed5eec3f20dc87f033c (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
/* -*- C++ -*- */
//=============================================================================
/**
 *  @file    Gadget.h
 *
 *  $Id$
 *
 *  @author Christopher Kohlhoff <chris@kohlhoff.com>
 */
//=============================================================================

#ifndef GADGET_H
#define GADGET_H

#include "ace/Bound_Ptr.h"
#include "Gadget_Part.h"

/**
 * @class Gadget
 *
 * @brief An interface for some high-level application object.
 */
class Gadget
{
public:
  /// Destructor.
  virtual ~Gadget (void);

  /// Add a new part to the gadget. The gadget automatically takes shared
  /// responsibility for the ownership of the part object since we are passing
  /// a Gadget_Part_var.
  virtual void add_part (Gadget_Part_var part) = 0;

  /// Remove a random part from the gadget. Responsibility for ownership of the
  /// part is automatically returned to the caller since we are returning a
  /// Gadget_Part_var.
  virtual Gadget_Part_var remove_part (void) = 0;

  /// Ask the gadget to print information about the parts that it contains.
  virtual void list_parts (void) = 0;
};

// The Gadget_var smart pointer has shared (reference counted) ownership
// semantics.
typedef ACE_Strong_Bound_Ptr<Gadget, ACE_SYNCH_MUTEX> Gadget_var;

// The Gadget_ptr smart pointer has no ownership semantics, but supports
// conversion back into a Gadget_var.
typedef ACE_Weak_Bound_Ptr<Gadget, ACE_SYNCH_MUTEX> Gadget_ptr;

#endif /* GADGET_H */