/* * 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 returnCallResult : CallResult! var returnResponse : Echo_EchoResponse? _ = try start(request:request, metadata:metadata) {response, callResult in returnResponse = response returnCallResult = callResult sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) if let returnResponse = returnResponse { return returnResponse } else { throw Echo_EchoClientError.error(c: returnCallResult) } } /// 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. Nonblocking. 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 returnResponse : Echo_EchoResponse! let sem = DispatchSemaphore(value: 0) do { try receive() {response, error in returnResponse = response returnError = error sem.signal() } _ = sem.wait(timeout: DispatchTime.distantFuture) } if let returnError = returnError { throw returnError } return returnResponse } /// 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. Nonblocking. 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. Nonblocking. public func send(_ message:Echo_EchoRequest, errorHandler:@escaping (Error)->()) throws { let messageData = try message.serializeProtobuf() try call.sendMessage(data:messageData, errorHandler:errorHandler) } /// 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 closeAndReceive() {response, error in returnResponse = response returnError = error sem.signal() } _ = 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. Blocking. public func receive() throws -> Echo_EchoResponse { var returnError : Echo_EchoClientError? var returnMessage : Echo_EchoResponse! let sem = DispatchSemaphore(value: 0) do { try receive() {response, error in returnMessage = response returnError = error 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, errorHandler:@escaping (Error)->()) throws { let messageData = try message.serializeProtobuf() try call.sendMessage(data:messageData, errorHandler:errorHandler) } /// Call this to close the sending connection. Blocking. public func closeSend() throws { let sem = DispatchSemaphore(value: 0) try closeSend() { 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) } }