TransportKind.swift 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. /*
  2. * Copyright 2025, gRPC Authors All rights reserved.
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. import GRPCCore
  17. import GRPCNIOTransportHTTP2
  18. enum TransportKind: CaseIterable, Hashable, Sendable {
  19. case wrappedChannel
  20. case posix
  21. #if canImport(Network)
  22. case transportServices
  23. #endif
  24. static var clients: [Self] {
  25. Self.allCases
  26. }
  27. static var clientsWithTLS: [Self] {
  28. Self.allCases.filter { $0 != .wrappedChannel }
  29. }
  30. static var servers: [Self] {
  31. Self.allCases.filter { $0 != .wrappedChannel }
  32. }
  33. static var serversWithTLS: [Self] {
  34. Self.allCases.filter { $0 != .wrappedChannel }
  35. }
  36. static var supportsDebugCallbacks: [Self] {
  37. Self.allCases.filter { $0 != .wrappedChannel }
  38. }
  39. }
  40. @available(gRPCSwiftNIOTransport 2.0, *)
  41. enum NIOClientTransport: ClientTransport {
  42. case wrappedChannel(HTTP2ClientTransport.WrappedChannel)
  43. case posix(HTTP2ClientTransport.Posix)
  44. #if canImport(Network)
  45. case transportServices(HTTP2ClientTransport.TransportServices)
  46. #endif
  47. init(_ transport: HTTP2ClientTransport.WrappedChannel) {
  48. self = .wrappedChannel(transport)
  49. }
  50. init(_ transport: HTTP2ClientTransport.Posix) {
  51. self = .posix(transport)
  52. }
  53. #if canImport(Network)
  54. init(_ transport: HTTP2ClientTransport.TransportServices) {
  55. self = .transportServices(transport)
  56. }
  57. #endif
  58. typealias Bytes = GRPCNIOTransportBytes
  59. var retryThrottle: GRPCCore.RetryThrottle? {
  60. switch self {
  61. case .posix(let transport):
  62. return transport.retryThrottle
  63. #if canImport(Network)
  64. case .transportServices(let transport):
  65. return transport.retryThrottle
  66. #endif
  67. case .wrappedChannel(let transport):
  68. return transport.retryThrottle
  69. }
  70. }
  71. func connect() async throws {
  72. switch self {
  73. case .posix(let transport):
  74. try await transport.connect()
  75. #if canImport(Network)
  76. case .transportServices(let transport):
  77. try await transport.connect()
  78. #endif
  79. case .wrappedChannel(let transport):
  80. try await transport.connect()
  81. }
  82. }
  83. func beginGracefulShutdown() {
  84. switch self {
  85. case .posix(let transport):
  86. transport.beginGracefulShutdown()
  87. #if canImport(Network)
  88. case .transportServices(let transport):
  89. transport.beginGracefulShutdown()
  90. #endif
  91. case .wrappedChannel(let transport):
  92. transport.beginGracefulShutdown()
  93. }
  94. }
  95. func withStream<T: Sendable>(
  96. descriptor: MethodDescriptor,
  97. options: CallOptions,
  98. _ closure: (_ stream: RPCStream<Inbound, Outbound>, _ context: ClientContext) async throws -> T
  99. ) async throws -> T {
  100. switch self {
  101. case .posix(let transport):
  102. return try await transport.withStream(descriptor: descriptor, options: options, closure)
  103. #if canImport(Network)
  104. case .transportServices(let transport):
  105. return try await transport.withStream(descriptor: descriptor, options: options, closure)
  106. #endif
  107. case .wrappedChannel(let transport):
  108. return try await transport.withStream(descriptor: descriptor, options: options, closure)
  109. }
  110. }
  111. func config(forMethod descriptor: GRPCCore.MethodDescriptor) -> GRPCCore.MethodConfig? {
  112. switch self {
  113. case .posix(let transport):
  114. return transport.config(forMethod: descriptor)
  115. #if canImport(Network)
  116. case .transportServices(let transport):
  117. return transport.config(forMethod: descriptor)
  118. #endif
  119. case .wrappedChannel(let transport):
  120. return transport.config(forMethod: descriptor)
  121. }
  122. }
  123. }
  124. @available(gRPCSwiftNIOTransport 2.0, *)
  125. enum NIOServerTransport: ServerTransport, ListeningServerTransport {
  126. case posix(HTTP2ServerTransport.Posix)
  127. #if canImport(Network)
  128. case transportServices(HTTP2ServerTransport.TransportServices)
  129. #endif
  130. init(_ transport: HTTP2ServerTransport.Posix) {
  131. self = .posix(transport)
  132. }
  133. #if canImport(Network)
  134. init(_ transport: HTTP2ServerTransport.TransportServices) {
  135. self = .transportServices(transport)
  136. }
  137. #endif
  138. typealias Bytes = GRPCNIOTransportBytes
  139. var listeningAddress: GRPCNIOTransportCore.SocketAddress {
  140. get async throws {
  141. switch self {
  142. case .posix(let transport):
  143. try await transport.listeningAddress
  144. #if canImport(Network)
  145. case .transportServices(let transport):
  146. try await transport.listeningAddress
  147. #endif
  148. }
  149. }
  150. }
  151. func listen(
  152. streamHandler:
  153. @escaping @Sendable (
  154. _ stream: RPCStream<Inbound, Outbound>,
  155. _ context: ServerContext
  156. ) async -> Void
  157. ) async throws {
  158. switch self {
  159. case .posix(let transport):
  160. try await transport.listen(streamHandler: streamHandler)
  161. #if canImport(Network)
  162. case .transportServices(let transport):
  163. try await transport.listen(streamHandler: streamHandler)
  164. #endif
  165. }
  166. }
  167. func beginGracefulShutdown() {
  168. switch self {
  169. case .posix(let transport):
  170. transport.beginGracefulShutdown()
  171. #if canImport(Network)
  172. case .transportServices(let transport):
  173. transport.beginGracefulShutdown()
  174. #endif
  175. }
  176. }
  177. }