// // DO NOT EDIT. // // Generated by the protocol buffer compiler. // Source: echo.proto // // // Copyright 2018, gRPC Authors All rights reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // import Foundation import GRPC import NIO import NIOHTTP1 import SwiftProtobuf /// Usage: instantiate Echo_EchoClient, then call methods of this protocol to make API calls. public protocol Echo_EchoClientProtocol: GRPCClient { func get( _ request: Echo_EchoRequest, callOptions: CallOptions? ) -> UnaryCall func expand( _ request: Echo_EchoRequest, callOptions: CallOptions?, handler: @escaping (Echo_EchoResponse) -> Void ) -> ServerStreamingCall func collect( callOptions: CallOptions? ) -> ClientStreamingCall func update( callOptions: CallOptions?, handler: @escaping (Echo_EchoResponse) -> Void ) -> BidirectionalStreamingCall } extension Echo_EchoClientProtocol { /// Immediately returns an echo of a request. /// /// - Parameters: /// - request: Request to send to Get. /// - callOptions: Call options. /// - Returns: A `UnaryCall` with futures for the metadata, status and response. public func get( _ request: Echo_EchoRequest, callOptions: CallOptions? = nil ) -> UnaryCall { return self.makeUnaryCall( path: "/echo.Echo/Get", request: request, callOptions: callOptions ?? self.defaultCallOptions ) } /// Splits a request into words and returns each word in a stream of messages. /// /// - Parameters: /// - request: Request to send to Expand. /// - callOptions: Call options. /// - handler: A closure called when each response is received from the server. /// - Returns: A `ServerStreamingCall` with futures for the metadata and status. public func expand( _ request: Echo_EchoRequest, callOptions: CallOptions? = nil, handler: @escaping (Echo_EchoResponse) -> Void ) -> ServerStreamingCall { return self.makeServerStreamingCall( path: "/echo.Echo/Expand", request: request, callOptions: callOptions ?? self.defaultCallOptions, handler: handler ) } /// Collects a stream of messages and returns them concatenated when the caller closes. /// /// Callers should use the `send` method on the returned object to send messages /// to the server. The caller should send an `.end` after the final message has been sent. /// /// - Parameters: /// - callOptions: Call options. /// - Returns: A `ClientStreamingCall` with futures for the metadata, status and response. public func collect( callOptions: CallOptions? = nil ) -> ClientStreamingCall { return self.makeClientStreamingCall( path: "/echo.Echo/Collect", callOptions: callOptions ?? self.defaultCallOptions ) } /// Streams back messages as they are received in an input stream. /// /// Callers should use the `send` method on the returned object to send messages /// to the server. The caller should send an `.end` after the final message has been sent. /// /// - Parameters: /// - callOptions: Call options. /// - handler: A closure called when each response is received from the server. /// - Returns: A `ClientStreamingCall` with futures for the metadata and status. public func update( callOptions: CallOptions? = nil, handler: @escaping (Echo_EchoResponse) -> Void ) -> BidirectionalStreamingCall { return self.makeBidirectionalStreamingCall( path: "/echo.Echo/Update", callOptions: callOptions ?? self.defaultCallOptions, handler: handler ) } } public final class Echo_EchoClient: Echo_EchoClientProtocol { public let channel: GRPCChannel public var defaultCallOptions: CallOptions /// Creates a client for the echo.Echo service. /// /// - Parameters: /// - channel: `GRPCChannel` to the service host. /// - defaultCallOptions: Options to use for each service call if the user doesn't provide them. public init(channel: GRPCChannel, defaultCallOptions: CallOptions = CallOptions()) { self.channel = channel self.defaultCallOptions = defaultCallOptions } } public final class Echo_EchoTestClient: Echo_EchoClientProtocol { private let fakeChannel: FakeChannel public var defaultCallOptions: CallOptions public var channel: GRPCChannel { return self.fakeChannel } public init( fakeChannel: FakeChannel = FakeChannel(), defaultCallOptions callOptions: CallOptions = CallOptions() ) { self.fakeChannel = fakeChannel self.defaultCallOptions = callOptions } /// Make a unary response for the Get RPC. This must be called /// before calling 'get'. See also 'FakeUnaryResponse'. /// /// - Parameter requestHandler: a handler for request parts sent by the RPC. public func makeGetResponseStream( _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) -> FakeUnaryResponse { return self.fakeChannel.makeFakeUnaryResponse(path: "/echo.Echo/Get", requestHandler: requestHandler) } public func enqueueGetResponse( _ response: Echo_EchoResponse, _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) { let stream = self.makeGetResponseStream(requestHandler) // This is the only operation on the stream; try! is fine. try! stream.sendMessage(response) } /// Returns true if there are response streams enqueued for 'Get' public var hasGetResponsesRemaining: Bool { return self.fakeChannel.hasFakeResponseEnqueued(forPath: "/echo.Echo/Get") } /// Make a streaming response for the Expand RPC. This must be called /// before calling 'expand'. See also 'FakeStreamingResponse'. /// /// - Parameter requestHandler: a handler for request parts sent by the RPC. public func makeExpandResponseStream( _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) -> FakeStreamingResponse { return self.fakeChannel.makeFakeStreamingResponse(path: "/echo.Echo/Expand", requestHandler: requestHandler) } public func enqueueExpandResponses( _ responses: [Echo_EchoResponse], _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) { let stream = self.makeExpandResponseStream(requestHandler) // These are the only operation on the stream; try! is fine. responses.forEach { try! stream.sendMessage($0) } try! stream.sendEnd() } /// Returns true if there are response streams enqueued for 'Expand' public var hasExpandResponsesRemaining: Bool { return self.fakeChannel.hasFakeResponseEnqueued(forPath: "/echo.Echo/Expand") } /// Make a unary response for the Collect RPC. This must be called /// before calling 'collect'. See also 'FakeUnaryResponse'. /// /// - Parameter requestHandler: a handler for request parts sent by the RPC. public func makeCollectResponseStream( _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) -> FakeUnaryResponse { return self.fakeChannel.makeFakeUnaryResponse(path: "/echo.Echo/Collect", requestHandler: requestHandler) } public func enqueueCollectResponse( _ response: Echo_EchoResponse, _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) { let stream = self.makeCollectResponseStream(requestHandler) // This is the only operation on the stream; try! is fine. try! stream.sendMessage(response) } /// Returns true if there are response streams enqueued for 'Collect' public var hasCollectResponsesRemaining: Bool { return self.fakeChannel.hasFakeResponseEnqueued(forPath: "/echo.Echo/Collect") } /// Make a streaming response for the Update RPC. This must be called /// before calling 'update'. See also 'FakeStreamingResponse'. /// /// - Parameter requestHandler: a handler for request parts sent by the RPC. public func makeUpdateResponseStream( _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) -> FakeStreamingResponse { return self.fakeChannel.makeFakeStreamingResponse(path: "/echo.Echo/Update", requestHandler: requestHandler) } public func enqueueUpdateResponses( _ responses: [Echo_EchoResponse], _ requestHandler: @escaping (FakeRequestPart) -> () = { _ in } ) { let stream = self.makeUpdateResponseStream(requestHandler) // These are the only operation on the stream; try! is fine. responses.forEach { try! stream.sendMessage($0) } try! stream.sendEnd() } /// Returns true if there are response streams enqueued for 'Update' public var hasUpdateResponsesRemaining: Bool { return self.fakeChannel.hasFakeResponseEnqueued(forPath: "/echo.Echo/Update") } } /// To build a server, implement a class that conforms to this protocol. public protocol Echo_EchoProvider: CallHandlerProvider { /// Immediately returns an echo of a request. func get(request: Echo_EchoRequest, context: StatusOnlyCallContext) -> EventLoopFuture /// Splits a request into words and returns each word in a stream of messages. func expand(request: Echo_EchoRequest, context: StreamingResponseCallContext) -> EventLoopFuture /// Collects a stream of messages and returns them concatenated when the caller closes. func collect(context: UnaryResponseCallContext) -> EventLoopFuture<(StreamEvent) -> Void> /// Streams back messages as they are received in an input stream. func update(context: StreamingResponseCallContext) -> EventLoopFuture<(StreamEvent) -> Void> } extension Echo_EchoProvider { public var serviceName: String { return "echo.Echo" } /// Determines, calls and returns the appropriate request handler, depending on the request's method. /// Returns nil for methods not handled by this service. public func handleMethod(_ methodName: String, callHandlerContext: CallHandlerContext) -> GRPCCallHandler? { switch methodName { case "Get": return CallHandlerFactory.makeUnary(callHandlerContext: callHandlerContext) { context in return { request in self.get(request: request, context: context) } } case "Expand": return CallHandlerFactory.makeServerStreaming(callHandlerContext: callHandlerContext) { context in return { request in self.expand(request: request, context: context) } } case "Collect": return CallHandlerFactory.makeClientStreaming(callHandlerContext: callHandlerContext) { context in return self.collect(context: context) } case "Update": return CallHandlerFactory.makeBidirectionalStreaming(callHandlerContext: callHandlerContext) { context in return self.update(context: context) } default: return nil } } } // Provides conformance to `GRPCPayload` extension Echo_EchoRequest: GRPCProtobufPayload {} extension Echo_EchoResponse: GRPCProtobufPayload {}