GRPC C++  1.0.0
alarm.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright 2015, Google Inc.
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions are
8  * met:
9  *
10  * * Redistributions of source code must retain the above copyright
11  * notice, this list of conditions and the following disclaimer.
12  * * Redistributions in binary form must reproduce the above
13  * copyright notice, this list of conditions and the following disclaimer
14  * in the documentation and/or other materials provided with the
15  * distribution.
16  * * Neither the name of Google Inc. nor the names of its
17  * contributors may be used to endorse or promote products derived from
18  * this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  */
33 
36 #ifndef GRPCXX_ALARM_H
37 #define GRPCXX_ALARM_H
38 
44 #include <grpc/grpc.h>
45 
46 struct grpc_alarm;
47 
48 namespace grpc {
49 
50 class CompletionQueue;
51 
53 class Alarm : private GrpcLibraryCodegen {
54  public:
64  template <typename T>
65  Alarm(CompletionQueue* cq, const T& deadline, void* tag)
66  : tag_(tag),
67  alarm_(grpc_alarm_create(cq->cq(), TimePoint<T>(deadline).raw_time(),
68  static_cast<void*>(&tag_))) {}
69 
71  ~Alarm() { grpc_alarm_destroy(alarm_); }
72 
75  void Cancel() { grpc_alarm_cancel(alarm_); }
76 
77  private:
78  class AlarmEntry : public CompletionQueueTag {
79  public:
80  AlarmEntry(void* tag) : tag_(tag) {}
81  bool FinalizeResult(void** tag, bool* status) GRPC_OVERRIDE {
82  *tag = tag_;
83  return true;
84  }
85 
86  private:
87  void* tag_;
88  };
89 
90  AlarmEntry tag_;
91  grpc_alarm* const alarm_; // owned
92 };
93 
94 } // namespace grpc
95 
96 #endif // GRPCXX_ALARM_H
An interface allowing implementors to process and filter event tags.
Definition: completion_queue_tag.h:40
A thin wrapper around grpc_alarm (see / / src/core/surface/alarm.h).
Definition: alarm.h:53
Alarm(CompletionQueue *cq, const T &deadline, void *tag)
Create a completion queue alarm instance associated to cq.
Definition: alarm.h:65
GRPCAPI void grpc_alarm_destroy(grpc_alarm *alarm)
Destroy the given completion queue alarm, cancelling it in the process.
GRPCAPI void grpc_alarm_cancel(grpc_alarm *alarm)
Cancel a completion queue alarm.
Classes that require gRPC to be initialized should inherit from this class.
Definition: grpc_library.h:53
Definition: time.h:54
Definition: alarm.h:48
struct grpc_alarm grpc_alarm
An alarm associated with a completion queue.
Definition: grpc_types.h:51
GRPCAPI grpc_alarm * grpc_alarm_create(grpc_completion_queue *cq, gpr_timespec deadline, void *tag)
Create a completion queue alarm instance associated to cq.
A thin wrapper around grpc_completion_queue (see / src/core/surface/completion_queue.h).
Definition: completion_queue.h:97
void Cancel()
Cancel a completion queue alarm.
Definition: alarm.h:75
#define GRPC_OVERRIDE
Definition: config.h:78
~Alarm()
Destroy the given completion queue alarm, cancelling it in the process.
Definition: alarm.h:71