GRPC C++  1.4.0
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
client_unary_call.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 
34 #ifndef GRPCXX_IMPL_CODEGEN_CLIENT_UNARY_CALL_H
35 #define GRPCXX_IMPL_CODEGEN_CLIENT_UNARY_CALL_H
36 
42 
43 namespace grpc {
44 
45 class Channel;
46 class ClientContext;
47 class CompletionQueue;
48 class RpcMethod;
49 
51 template <class InputMessage, class OutputMessage>
53  ClientContext* context, const InputMessage& request,
54  OutputMessage* result) {
57  GRPC_CQ_DEFAULT_POLLING}); // Pluckable completion queue
58  Call call(channel->CreateCall(method, context, &cq));
62  ops;
63  Status status = ops.SendMessage(request);
64  if (!status.ok()) {
65  return status;
66  }
67  ops.SendInitialMetadata(context->send_initial_metadata_,
68  context->initial_metadata_flags());
69  ops.RecvInitialMetadata(context);
70  ops.RecvMessage(result);
71  ops.ClientSendClose();
72  ops.ClientRecvStatus(context, &status);
73  call.PerformOps(&ops);
74  if (cq.Pluck(&ops)) {
75  if (!ops.got_message && status.ok()) {
77  "No message returned for unary request");
78  }
79  } else {
80  GPR_CODEGEN_ASSERT(!status.ok());
81  }
82  return status;
83 }
84 
85 } // namespace grpc
86 
87 #endif // GRPCXX_IMPL_CODEGEN_CLIENT_UNARY_CALL_H
#define GPR_CODEGEN_ASSERT(x)
Codegen specific version of GPR_ASSERT.
Definition: core_codegen_interface.h:137
Definition: call.h:516
#define GRPC_CQ_CURRENT_VERSION
Definition: grpc_types.h:601
Definition: grpc_types.h:602
A ClientContext allows the person implementing a service client to:
Definition: client_context.h:168
Definition: call.h:271
Events are popped out by calling grpc_completion_queue_pluck() API ONLY.
Definition: grpc_types.h:598
Definition: call.h:420
Straightforward wrapping of the C call object.
Definition: call.h:638
Codegen interface for grpc::Channel.
Definition: channel_interface.h:64
Status BlockingUnaryCall(ChannelInterface *channel, const RpcMethod &method, ClientContext *context, const InputMessage &request, OutputMessage *result)
Wrapper that performs a blocking unary call.
Definition: client_unary_call.h:52
The completion queue will have an associated pollset and there is no restriction on the type of file ...
Definition: grpc_types.h:578
Primary implementaiton of CallOpSetInterface.
Definition: call.h:583
Definition: call.h:318
A thin wrapper around grpc_completion_queue (see src/core/lib/surface/completion_queue.h).
Definition: completion_queue.h:101
Descriptor of an RPC method.
Definition: rpc_method.h:44
bool ok() const
Is the status OK?
Definition: status.h:76
Did it work? If it didn't, why?
Definition: status.h:45
Operation is not implemented or not supported/enabled in this service.
Definition: status_code_enum.h:130
Definition: call.h:218
Definition: call.h:487