summaryrefslogtreecommitdiff
path: root/docs/tutorials/014/Task.h
blob: 765496598e55df8654b385e3594c54094dadc98e (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
// $Id$

// Task.h
//
// Tutorial regarding a way to use ACE_Stream.
//
// written by bob mcwhirter (bob@netwrench.com)

#ifndef TASK_H
#define TASK_H

#include <ace/Task.h>
#include <ace/Synch.h>

// Always typedef when possible.

typedef ACE_Task<ACE_MT_SYNCH> Task_Base;

class Task : public Task_Base
{
public:
  typedef Task_Base inherited;
  // This is just good form.

  Task (const char *nameOfTask,
        int numberOfThreads);
  // Initialize our Task with a name, and number of threads to spawn.

  virtual ~Task (void);

  virtual int open (void *arg);
  // This is provided to prevent compiler complaints about hidden
  // virtual functions.

  virtual int close (u_long flags);
  // This closes down the Task and all service threads.

  virtual int put (ACE_Message_Block *message,
                   ACE_Time_Value *timeout);
  // This is the interface that ACE_Stream uses to communicate with
  // our Task.

  virtual int svc (void);
  // This is the actual service loop each of the service threads
  // iterates through.

  const char *nameOfTask (void) const;
  // Returns the name of this Task.

  static ACE_Lock_Adapter<ACE_SYNCH_MUTEX> *lock_adapter (void);
  // Returns a pointer to the lock adapter.

private:
  int d_numberOfThreads;
  char d_nameOfTask[64];

  ACE_Barrier d_barrier;
  // Simple Barrier to make sure all of our service threads have
  // entered their loop before accepting any messages.

  static ACE_Lock_Adapter<ACE_SYNCH_MUTEX> lock_adapter_;
  // This Lock_Adapter is used to synchronize operations
  // on the ACE_Message_Block objects
};

#endif /* TASK_H */