/* * DO NOT EDIT. * * Generated by the protocol buffer compiler. * Source: echo.proto * */ /* * * Copyright 2017, Google Inc. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following disclaimer * in the documentation and/or other materials provided with the * distribution. * * Neither the name of Google Inc. nor the names of its * contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ import Foundation import Dispatch import gRPC /// Type for errors thrown from generated client code. public enum Echo_EchoClientError : Error { case endOfStream case invalidMessageReceived case error(c: CallResult) } /// Get (Unary) public class Echo_EchoGetCall { private var call : Call /// Create a call. fileprivate init(_ channel: Channel) { self.call = channel.makeCall("/echo.Echo/Get") } /// Run the call. Blocks until the reply is received. fileprivate func run(request: Echo_EchoRequest, metadata: Metadata) throws -> Echo_EchoResponse { let sem = DispatchSemaphore(value: 0) var callResult : CallResult! var response : Echo_EchoResponse? let requestData = try request.serializeProtobuf() try call.start(.unary, metadata:metadata, message:requestData) {(_callResult) in callResult = _callResult if let responseData = callResult.resultData { response = try? Echo_EchoResponse(protobuf:responseData) } sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) if let response = response { return response } else { throw Echo_EchoClientError.error(c: callResult) } } /// Start the call. Nonblocking. fileprivate func start(request: Echo_EchoRequest, metadata: Metadata, completion: @escaping (Echo_EchoResponse?, CallResult)->()) throws -> Echo_EchoGetCall { let requestData = try request.serializeProtobuf() try call.start(.unary, metadata:metadata, message:requestData) {(callResult) in if let responseData = callResult.resultData, let response = try? Echo_EchoResponse(protobuf:responseData) { completion(response, callResult) } else { completion(nil, callResult) } } return self } } /// Expand (Server Streaming) public class Echo_EchoExpandCall { private var call : Call /// Create a call. fileprivate init(_ channel: Channel) { self.call = channel.makeCall("/echo.Echo/Expand") } /// Call this once with the message to send. fileprivate func start(request: Echo_EchoRequest, metadata: Metadata, completion: @escaping (CallResult) -> ()) throws -> Echo_EchoExpandCall { let requestData = try request.serializeProtobuf() try call.start(.serverStreaming, metadata:metadata, message:requestData, completion:completion) return self } /// Call this to wait for a result. Blocking. public func receive() throws -> Echo_EchoResponse { var returnError : Echo_EchoClientError? var response : Echo_EchoResponse! let sem = DispatchSemaphore(value: 0) do { try call.receiveMessage() {(responseData) in if let responseData = responseData { response = try? Echo_EchoResponse(protobuf:responseData) if response == nil { returnError = Echo_EchoClientError.invalidMessageReceived } } else { returnError = Echo_EchoClientError.endOfStream } sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) } if let returnError = returnError { throw returnError } return response } /// Call this to wait for a result. Nonblocking. public func receive(completion:@escaping (Echo_EchoResponse?, Echo_EchoClientError?)->()) throws { do { try call.receiveMessage() {(responseData) in if let responseData = responseData { if let response = try? Echo_EchoResponse(protobuf:responseData) { completion(response, nil) } else { completion(nil, Echo_EchoClientError.invalidMessageReceived) } } else { completion(nil, Echo_EchoClientError.endOfStream) } } } } } /// Collect (Client Streaming) public class Echo_EchoCollectCall { private var call : Call /// Create a call. fileprivate init(_ channel: Channel) { self.call = channel.makeCall("/echo.Echo/Collect") } /// Call this to start a call. fileprivate func start(metadata:Metadata, completion:@escaping (CallResult)->()) throws -> Echo_EchoCollectCall { try self.call.start(.clientStreaming, metadata:metadata, completion:completion) return self } /// Call this to send each message in the request stream. public func send(_ message: Echo_EchoRequest) throws { let messageData = try message.serializeProtobuf() try call.sendMessage(data:messageData) } /// Call this to close the connection and wait for a response. Blocking. public func closeAndReceive() throws -> Echo_EchoResponse { var returnError : Echo_EchoClientError? var returnResponse : Echo_EchoResponse! let sem = DispatchSemaphore(value: 0) do { try call.receiveMessage() {(responseData) in if let responseData = responseData, let response = try? Echo_EchoResponse(protobuf:responseData) { returnResponse = response } else { returnError = Echo_EchoClientError.invalidMessageReceived } sem.signal() } try call.close(completion:{}) _ = sem.wait(timeout: DispatchTime.distantFuture) } catch (let error) { throw error } if let returnError = returnError { throw returnError } return returnResponse } /// Call this to close the connection and wait for a response. Nonblocking. public func closeAndReceive(completion:@escaping (Echo_EchoResponse?, Echo_EchoClientError?)->()) throws { do { try call.receiveMessage() {(responseData) in if let responseData = responseData, let response = try? Echo_EchoResponse(protobuf:responseData) { completion(response, nil) } else { completion(nil, Echo_EchoClientError.invalidMessageReceived) } } try call.close(completion:{}) } catch (let error) { throw error } } } /// Update (Bidirectional Streaming) public class Echo_EchoUpdateCall { private var call : Call /// Create a call. fileprivate init(_ channel: Channel) { self.call = channel.makeCall("/echo.Echo/Update") } /// Call this to start a call. Nonblocking. fileprivate func start(metadata:Metadata, completion:@escaping (CallResult)->()) throws -> Echo_EchoUpdateCall { try self.call.start(.bidiStreaming, metadata:metadata, completion:completion) return self } /// Call this to wait for a result. Blocks. public func receive() throws -> Echo_EchoResponse { var returnError : Echo_EchoClientError? var returnMessage : Echo_EchoResponse! let sem = DispatchSemaphore(value: 0) do { try call.receiveMessage() {(data) in if let data = data { returnMessage = try? Echo_EchoResponse(protobuf:data) if returnMessage == nil { returnError = Echo_EchoClientError.invalidMessageReceived } } else { returnError = Echo_EchoClientError.endOfStream } sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) } if let returnError = returnError { throw returnError } return returnMessage } /// Call this to wait for a result. Nonblocking. public func receive(completion:@escaping (Echo_EchoResponse?, Echo_EchoClientError?)->()) throws { do { try call.receiveMessage() {(data) in if let data = data { if let returnMessage = try? Echo_EchoResponse(protobuf:data) { completion(returnMessage, nil) } else { completion(nil, Echo_EchoClientError.invalidMessageReceived) } } else { completion(nil, Echo_EchoClientError.endOfStream) } } } } /// Call this to send each message in the request stream. public func send(_ message:Echo_EchoRequest) throws { let messageData = try message.serializeProtobuf() try call.sendMessage(data:messageData) } /// Call this to close the sending connection. Blocking public func closeSend() throws { let sem = DispatchSemaphore(value: 0) try call.close() { sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) } /// Call this to close the sending connection. Nonblocking public func closeSend(completion:@escaping ()->()) throws { try call.close() { completion() } } } /// Call methods of this class to make API calls. public class Echo_EchoService { private var channel: Channel /// This metadata will be sent with all requests. public var metadata : Metadata /// This property allows the service host name to be overridden. /// For example, it can be used to make calls to "localhost:8080" /// appear to be to "example.com". public var host : String { get { return self.channel.host } set { self.channel.host = newValue } } /// Create a client that makes insecure connections. public init(address: String) { gRPC.initialize() channel = Channel(address:address) metadata = Metadata() } /// Create a client that makes secure connections. public init(address: String, certificates: String?, host: String?) { gRPC.initialize() channel = Channel(address:address, certificates:certificates, host:host) metadata = Metadata() } /// Synchronous. Unary. public func get(_ request: Echo_EchoRequest) throws -> Echo_EchoResponse { return try Echo_EchoGetCall(channel).run(request:request, metadata:metadata) } /// Asynchronous. Unary. public func get(_ request: Echo_EchoRequest, completion: @escaping (Echo_EchoResponse?, CallResult)->()) throws -> Echo_EchoGetCall { return try Echo_EchoGetCall(channel).start(request:request, metadata:metadata, completion:completion) } /// Asynchronous. Server-streaming. /// Send the initial message. /// Use methods on the returned object to get streamed responses. public func expand(_ request: Echo_EchoRequest, completion: @escaping (CallResult)->()) throws -> Echo_EchoExpandCall { return try Echo_EchoExpandCall(channel).start(request:request, metadata:metadata, completion:completion) } /// Asynchronous. Client-streaming. /// Use methods on the returned object to stream messages and /// to close the connection and wait for a final response. public func collect(completion: @escaping (CallResult)->()) throws -> Echo_EchoCollectCall { return try Echo_EchoCollectCall(channel).start(metadata:metadata, completion:completion) } /// Asynchronous. Bidirectional-streaming. /// Use methods on the returned object to stream messages, /// to wait for replies, and to close the connection. public func update(completion: @escaping (CallResult)->()) throws -> Echo_EchoUpdateCall { return try Echo_EchoUpdateCall(channel).start(metadata:metadata, completion:completion) } }