-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Motivation: Many users will rely on DNS to resolve the IP addresses of servers to connect to, we should therefore provide a DNS name resolver. Modifications: - Add a DNS name resolver factory capable of resolving IP addresses - Add the resolver to the registry defaults Result: Can resolve DNS targets
- Loading branch information
Showing
3 changed files
with
163 additions
and
2 deletions.
There are no files selected for viewing
127 changes: 127 additions & 0 deletions
127
Sources/GRPCNIOTransportCore/Client/Resolver/NameResolver+DNS.swift
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,127 @@ | ||
| /* | ||
| * Copyright 2024, 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. | ||
| */ | ||
|
|
||
| private import GRPCCore | ||
|
|
||
| extension ResolvableTargets { | ||
| /// A resolvable target for addresses which can be resolved via DNS. | ||
| /// | ||
| /// If you already have an IPv4 or IPv6 address use ``ResolvableTargets/IPv4`` and | ||
| /// ``ResolvableTargets/IPv6`` respectively. | ||
| public struct DNS: ResolvableTarget, Sendable { | ||
| /// The host to resolve via DNS. | ||
| public var host: String | ||
|
|
||
| /// The port to use with resolved addresses. | ||
| public var port: Int | ||
|
|
||
| /// Create a new DNS target. | ||
| /// - Parameters: | ||
| /// - host: The host to resolve via DNS. | ||
| /// - port: The port to use with resolved addresses. | ||
| public init(host: String, port: Int) { | ||
| self.host = host | ||
| self.port = port | ||
| } | ||
| } | ||
| } | ||
|
|
||
| extension ResolvableTarget where Self == ResolvableTargets.DNS { | ||
| /// Creates a new resolvable DNS target. | ||
| /// - Parameters: | ||
| /// - host: The host address to resolve. | ||
| /// - port: The port to use for each resolved address. | ||
| /// - Returns: A ``ResolvableTarget``. | ||
| public static func dns(host: String, port: Int = 443) -> Self { | ||
| return Self(host: host, port: port) | ||
| } | ||
| } | ||
|
|
||
| @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) | ||
| extension NameResolvers { | ||
| /// A ``NameResolverFactory`` for ``ResolvableTargets/DNS`` targets. | ||
| public struct DNS: NameResolverFactory { | ||
| public typealias Target = ResolvableTargets.DNS | ||
|
|
||
| /// Create a new DNS name resolver factory. | ||
| public init() {} | ||
|
|
||
| public func resolver(for target: Target) -> NameResolver { | ||
| let resolver = Self.Resolver(target: target) | ||
| return NameResolver(names: RPCAsyncSequence(wrapping: resolver), updateMode: .pull) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) | ||
| extension NameResolvers.DNS { | ||
| struct Resolver: Sendable { | ||
| var target: ResolvableTargets.DNS | ||
|
|
||
| init(target: ResolvableTargets.DNS) { | ||
| self.target = target | ||
| } | ||
|
|
||
| func resolve( | ||
| isolation actor: isolated (any Actor)? = nil | ||
| ) async throws -> NameResolutionResult { | ||
| let addresses: [SocketAddress] | ||
|
|
||
| do { | ||
| addresses = try await DNSResolver.resolve(host: self.target.host, port: self.target.port) | ||
| } catch let error as CancellationError { | ||
| throw error | ||
| } catch { | ||
| throw RPCError( | ||
| code: .internalError, | ||
| message: "Couldn't resolve address for \(self.target.host):\(self.target.port)", | ||
| cause: error | ||
| ) | ||
| } | ||
|
|
||
| return NameResolutionResult(endpoints: [Endpoint(addresses: addresses)], serviceConfig: nil) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| @available(macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *) | ||
| extension NameResolvers.DNS.Resolver: AsyncSequence { | ||
| typealias Element = NameResolutionResult | ||
|
|
||
| func makeAsyncIterator() -> AsyncIterator { | ||
| return AsyncIterator(resolver: self) | ||
| } | ||
|
|
||
| struct AsyncIterator: AsyncIteratorProtocol { | ||
| typealias Element = NameResolutionResult | ||
|
|
||
| private let resolver: NameResolvers.DNS.Resolver | ||
|
|
||
| init(resolver: NameResolvers.DNS.Resolver) { | ||
| self.resolver = resolver | ||
| } | ||
|
|
||
| func next() async throws -> NameResolutionResult? { | ||
| return try await self.next(isolation: nil) | ||
| } | ||
|
|
||
| func next( | ||
| isolation actor: isolated (any Actor)? | ||
| ) async throws(any Error) -> NameResolutionResult? { | ||
| return try await self.resolver.resolve(isolation: actor) | ||
| } | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters