/* * Copyright 2021, 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. */ #if compiler(>=5.5.2) && canImport(_Concurrency) import NIOHPACK /// Async-await variant of `ServerStreamingCall`. @available(macOS 10.15, iOS 13, tvOS 13, watchOS 6, *) public struct GRPCAsyncServerStreamingCall { private let call: Call private let responseParts: StreamingResponseParts private let responseSource: PassthroughMessageSource /// The stream of responses from the server. public let responseStream: GRPCAsyncResponseStream /// The options used to make the RPC. public var options: CallOptions { return self.call.options } /// Cancel this RPC if it hasn't already completed. public func cancel() async throws { try await self.call.cancel().get() } // MARK: - Response Parts /// The initial metadata returned from the server. /// /// - Important: The initial metadata will only be available when the first response has been /// received. However, it is not necessary for the response to have been consumed before reading /// this property. public var initialMetadata: HPACKHeaders { // swiftformat:disable:next redundantGet get async throws { try await self.responseParts.initialMetadata.get() } } /// The trailing metadata returned from the server. /// /// - Important: Awaiting this property will suspend until the responses have been consumed. public var trailingMetadata: HPACKHeaders { // swiftformat:disable:next redundantGet get async throws { try await self.responseParts.trailingMetadata.get() } } /// The final status of the the RPC. /// /// - Important: Awaiting this property will suspend until the responses have been consumed. public var status: GRPCStatus { // swiftformat:disable:next redundantGet get async { // force-try acceptable because any error is encapsulated in a successful GRPCStatus future. try! await self.responseParts.status.get() } } private init(call: Call) { self.call = call // We ignore messages in the closure and instead feed them into the response source when we // invoke the `call`. self.responseParts = StreamingResponseParts(on: call.eventLoop) { _ in } self.responseSource = PassthroughMessageSource() self.responseStream = .init(PassthroughMessageSequence(consuming: self.responseSource)) } /// We expose this as the only non-private initializer so that the caller /// knows that invocation is part of initialisation. internal static func makeAndInvoke( call: Call, _ request: Request ) -> Self { let asyncCall = Self(call: call) asyncCall.call.invokeUnaryRequest( request, onError: { error in asyncCall.responseParts.handleError(error) asyncCall.responseSource.finish(throwing: error) }, onResponsePart: AsyncCall.makeResponsePartHandler( responseParts: asyncCall.responseParts, responseSource: asyncCall.responseSource ) ) return asyncCall } } #endif