Craig Tiller | ad1fd3a | 2015-02-16 12:23:04 -0800 | [diff] [blame] | 1 | |
Aaron Isotton | 24e69bf | 2016-02-26 11:53:22 -0800 | [diff] [blame] | 2 | // Copyright 2015-2016, Google Inc. |
Craig Tiller | ad1fd3a | 2015-02-16 12:23:04 -0800 | [diff] [blame] | 3 | // All rights reserved. |
Craig Tiller | ce5021b | 2015-02-18 09:25:21 -0800 | [diff] [blame] | 4 | // |
Craig Tiller | ad1fd3a | 2015-02-16 12:23:04 -0800 | [diff] [blame] | 5 | // Redistribution and use in source and binary forms, with or without |
| 6 | // modification, are permitted provided that the following conditions are |
| 7 | // met: |
Craig Tiller | ce5021b | 2015-02-18 09:25:21 -0800 | [diff] [blame] | 8 | // |
Craig Tiller | ad1fd3a | 2015-02-16 12:23:04 -0800 | [diff] [blame] | 9 | // * Redistributions of source code must retain the above copyright |
| 10 | // notice, this list of conditions and the following disclaimer. |
| 11 | // * Redistributions in binary form must reproduce the above |
| 12 | // copyright notice, this list of conditions and the following disclaimer |
| 13 | // in the documentation and/or other materials provided with the |
| 14 | // distribution. |
| 15 | // * Neither the name of Google Inc. nor the names of its |
| 16 | // contributors may be used to endorse or promote products derived from |
| 17 | // this software without specific prior written permission. |
Craig Tiller | ce5021b | 2015-02-18 09:25:21 -0800 | [diff] [blame] | 18 | // |
Craig Tiller | ad1fd3a | 2015-02-16 12:23:04 -0800 | [diff] [blame] | 19 | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 20 | // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 21 | // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 22 | // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 23 | // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 24 | // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 25 | // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 26 | // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 27 | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 28 | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 29 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 30 | |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 31 | // An integration test service that covers all the method signature permutations |
| 32 | // of unary/streaming requests/responses. |
Abhishek Kumar | 60572d4 | 2015-04-16 20:45:25 -0700 | [diff] [blame] | 33 | |
yang-g | f6befe8 | 2015-08-13 13:51:53 -0700 | [diff] [blame] | 34 | syntax = "proto3"; |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 35 | |
Craig Tiller | 1b4e330 | 2015-12-17 16:35:00 -0800 | [diff] [blame] | 36 | import "src/proto/grpc/testing/empty.proto"; |
| 37 | import "src/proto/grpc/testing/messages.proto"; |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 38 | |
| 39 | package grpc.testing; |
| 40 | |
| 41 | // A simple service to test the various types of RPCs and experiment with |
| 42 | // performance with various types of payload. |
| 43 | service TestService { |
| 44 | // One empty request followed by one empty response. |
nnoble | 72309c6 | 2014-12-12 11:42:26 -0800 | [diff] [blame] | 45 | rpc EmptyCall(grpc.testing.Empty) returns (grpc.testing.Empty); |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 46 | |
| 47 | // One request followed by one response. |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 48 | rpc UnaryCall(SimpleRequest) returns (SimpleResponse); |
| 49 | |
Makarand Dharmapurikar | 1ed0b8e | 2016-09-14 15:01:16 -0700 | [diff] [blame] | 50 | // One request followed by one response. Response has cache control |
| 51 | // headers set such that a caching HTTP proxy (such as GFE) can |
| 52 | // satisfy subsequent requests. |
| 53 | rpc CacheableUnaryCall(SimpleRequest) returns (SimpleResponse); |
| 54 | |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 55 | // One request followed by a sequence of responses (streamed download). |
| 56 | // The server returns the payload with client desired type and sizes. |
| 57 | rpc StreamingOutputCall(StreamingOutputCallRequest) |
| 58 | returns (stream StreamingOutputCallResponse); |
| 59 | |
| 60 | // A sequence of requests followed by one response (streamed upload). |
| 61 | // The server returns the aggregated size of client payload as the result. |
| 62 | rpc StreamingInputCall(stream StreamingInputCallRequest) |
| 63 | returns (StreamingInputCallResponse); |
| 64 | |
| 65 | // A sequence of requests with each request served by the server immediately. |
| 66 | // As one request could lead to multiple responses, this interface |
| 67 | // demonstrates the idea of full duplexing. |
| 68 | rpc FullDuplexCall(stream StreamingOutputCallRequest) |
| 69 | returns (stream StreamingOutputCallResponse); |
| 70 | |
| 71 | // A sequence of requests followed by a sequence of responses. |
| 72 | // The server buffers all the client requests and then serves them in order. A |
| 73 | // stream of responses are returned to the client when the server starts with |
| 74 | // first request. |
| 75 | rpc HalfDuplexCall(stream StreamingOutputCallRequest) |
| 76 | returns (stream StreamingOutputCallResponse); |
Noah Eisen | a27eb1d | 2016-09-28 12:19:52 -0700 | [diff] [blame] | 77 | |
Noah Eisen | 02e70ed | 2016-09-28 14:17:25 -0700 | [diff] [blame] | 78 | // The test server will not implement this method. It will be used |
| 79 | // to test the behavior when clients call unimplemented methods. |
Noah Eisen | 32eee77 | 2016-10-19 10:04:38 -0700 | [diff] [blame] | 80 | rpc UnimplementedCall(grpc.testing.Empty) returns (grpc.testing.Empty); |
chenw | a8fd44a | 2014-12-10 15:13:55 -0800 | [diff] [blame] | 81 | } |
Abhishek Kumar | 905a65b | 2015-06-19 15:28:07 -0700 | [diff] [blame] | 82 | |
Abhishek Kumar | 905a65b | 2015-06-19 15:28:07 -0700 | [diff] [blame] | 83 | // A simple service NOT implemented at servers so clients can test for |
| 84 | // that case. |
Abhishek Kumar | 7bce516 | 2015-06-24 15:36:40 -0700 | [diff] [blame] | 85 | service UnimplementedService { |
Abhishek Kumar | 905a65b | 2015-06-19 15:28:07 -0700 | [diff] [blame] | 86 | // A call that no server should implement |
Craig Tiller | 1b4e330 | 2015-12-17 16:35:00 -0800 | [diff] [blame] | 87 | rpc UnimplementedCall(grpc.testing.Empty) returns (grpc.testing.Empty); |
Abhishek Kumar | 905a65b | 2015-06-19 15:28:07 -0700 | [diff] [blame] | 88 | } |
yang-g | c9c69e2 | 2015-07-24 14:38:26 -0700 | [diff] [blame] | 89 | |
| 90 | // A service used to control reconnect server. |
| 91 | service ReconnectService { |
Aaron Isotton | 24e69bf | 2016-02-26 11:53:22 -0800 | [diff] [blame] | 92 | rpc Start(grpc.testing.ReconnectParams) returns (grpc.testing.Empty); |
yang-g | c9c69e2 | 2015-07-24 14:38:26 -0700 | [diff] [blame] | 93 | rpc Stop(grpc.testing.Empty) returns (grpc.testing.ReconnectInfo); |
| 94 | } |