/* * Copyright 2019, 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 NIO import NIOHTTP2 /// Underlying channel and HTTP/2 stream multiplexer. /// /// Different service clients implementing `GRPCServiceClient` may share an instance of this class. open class GRPCClient { public static func start( host: String, port: Int, eventLoopGroup: EventLoopGroup ) -> EventLoopFuture { let bootstrap = ClientBootstrap(group: eventLoopGroup) // Enable SO_REUSEADDR. .channelOption(ChannelOptions.socket(SocketOptionLevel(SOL_SOCKET), SO_REUSEADDR), value: 1) .channelInitializer { channel in channel.pipeline.add(handler: HTTP2Parser(mode: .client)) } return bootstrap.connect(host: host, port: port).then { (channel: Channel) -> EventLoopFuture in let multiplexer = HTTP2StreamMultiplexer(inboundStreamStateInitializer: nil) return channel.pipeline.add(handler: multiplexer) .map { GRPCClient(channel: channel, multiplexer: multiplexer, host: host) } } } public let channel: Channel public let multiplexer: HTTP2StreamMultiplexer public let host: String public var defaultCallOptions: CallOptions init(channel: Channel, multiplexer: HTTP2StreamMultiplexer, host: String, defaultCallOptions: CallOptions = CallOptions()) { self.channel = channel self.multiplexer = multiplexer self.host = host self.defaultCallOptions = defaultCallOptions } /// Fired when the client shuts down. public var onClose: EventLoopFuture { return channel.closeFuture } public func close() -> EventLoopFuture { return channel.close(mode: .all) } } /// A GRPC client for a given service. public protocol GRPCServiceClient { /// The client providing the underlying HTTP/2 channel for this client. var client: GRPCClient { get } /// Name of the service this client is for (e.g. "echo.Echo"). var service: String { get } /// The call options to use should the user not provide per-call options. var defaultCallOptions: CallOptions { get set } /// Return the path for the given method in the format "/Service-Name/Method-Name". /// /// This may be overriden if consumers require a different path format. /// /// - Parameter forMethod: name of method to return a path for. /// - Returns: path for the given method used in gRPC request headers. func path(forMethod method: String) -> String } extension GRPCServiceClient { public func path(forMethod method: String) -> String { return "/\(service)/\(method)" } }