mirror of
https://github.com/swift-server/async-http-client.git
synced 2026-06-02 07:37:34 +00:00
Motivation Currently error reporting with NIO Transport Services is often sub-par. This occurs because the Network.framework connections may enter the waiting state until the network connectivity state changes. We were not watching for the user event that contains the error in that state, so if we timed out in that state we'd just give a generic timeout error, instead of telling the user anything more detailed. Additionally, several of our tests assume that failure will be fast, but in NIO Transport Services we will enter that .waiting state. This is reasonable, as changed network connections may make a connection that was not succeeding suddenly viable. However, it's inconvenient for testing, where we're mostly interested in confirming that the error path works as expected. Modifications - Add an observer of the WaitingForConnectivity event that records it into our state machine for later reporting. - Add support for disabling waiting for connectivity for testing purposes. - Add annotations to several tests to stop them waiting for connectivity. Results Faster tests, better coverage, better errors for our users. Co-authored-by: David Nadoba <dnadoba@gmail.com>
197 lines
7.0 KiB
Swift
197 lines
7.0 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the AsyncHTTPClient open source project
|
|
//
|
|
// Copyright (c) 2021 Apple Inc. and the AsyncHTTPClient project authors
|
|
// Licensed under Apache License v2.0
|
|
//
|
|
// See LICENSE.txt for license information
|
|
// See CONTRIBUTORS.txt for the list of AsyncHTTPClient project authors
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
@testable import AsyncHTTPClient
|
|
import Logging
|
|
import NIOCore
|
|
import NIOPosix
|
|
import NIOSOCKS
|
|
import NIOSSL
|
|
import XCTest
|
|
|
|
class HTTPConnectionPool_FactoryTests: XCTestCase {
|
|
func testConnectionCreationTimesoutIfDeadlineIsInThePast() {
|
|
let group = MultiThreadedEventLoopGroup(numberOfThreads: 1)
|
|
defer { XCTAssertNoThrow(try group.syncShutdownGracefully()) }
|
|
|
|
var server: Channel?
|
|
XCTAssertNoThrow(server = try ServerBootstrap(group: group)
|
|
.childChannelInitializer { channel in
|
|
channel.pipeline.addHandler(NeverrespondServerHandler())
|
|
}
|
|
.bind(to: .init(ipAddress: "127.0.0.1", port: 0))
|
|
.wait())
|
|
defer {
|
|
XCTAssertNoThrow(try server?.close().wait())
|
|
}
|
|
|
|
let request = try! HTTPClient.Request(url: "https://apple.com")
|
|
|
|
let factory = HTTPConnectionPool.ConnectionFactory(
|
|
key: .init(request),
|
|
tlsConfiguration: nil,
|
|
clientConfiguration: .init(proxy: .socksServer(host: "127.0.0.1", port: server!.localAddress!.port!)),
|
|
sslContextCache: .init()
|
|
)
|
|
|
|
XCTAssertThrowsError(try factory.makeChannel(
|
|
requester: ExplodingRequester(),
|
|
connectionID: 1,
|
|
deadline: .now() - .seconds(1),
|
|
eventLoop: group.next(),
|
|
logger: .init(label: "test")
|
|
).wait()
|
|
) {
|
|
XCTAssertEqual($0 as? HTTPClientError, .connectTimeout)
|
|
}
|
|
}
|
|
|
|
func testSOCKSConnectionCreationTimesoutIfRemoteIsUnresponsive() {
|
|
let group = MultiThreadedEventLoopGroup(numberOfThreads: 1)
|
|
defer { XCTAssertNoThrow(try group.syncShutdownGracefully()) }
|
|
|
|
var server: Channel?
|
|
XCTAssertNoThrow(server = try ServerBootstrap(group: group)
|
|
.childChannelInitializer { channel in
|
|
channel.pipeline.addHandler(NeverrespondServerHandler())
|
|
}
|
|
.bind(to: .init(ipAddress: "127.0.0.1", port: 0))
|
|
.wait())
|
|
defer {
|
|
XCTAssertNoThrow(try server?.close().wait())
|
|
}
|
|
|
|
let request = try! HTTPClient.Request(url: "https://apple.com")
|
|
|
|
let factory = HTTPConnectionPool.ConnectionFactory(
|
|
key: .init(request),
|
|
tlsConfiguration: nil,
|
|
clientConfiguration: .init(proxy: .socksServer(host: "127.0.0.1", port: server!.localAddress!.port!)),
|
|
sslContextCache: .init()
|
|
)
|
|
|
|
XCTAssertThrowsError(try factory.makeChannel(
|
|
requester: ExplodingRequester(),
|
|
connectionID: 1,
|
|
deadline: .now() + .seconds(1),
|
|
eventLoop: group.next(),
|
|
logger: .init(label: "test")
|
|
).wait()
|
|
) {
|
|
XCTAssertEqual($0 as? HTTPClientError, .socksHandshakeTimeout)
|
|
}
|
|
}
|
|
|
|
func testHTTPProxyConnectionCreationTimesoutIfRemoteIsUnresponsive() {
|
|
let group = MultiThreadedEventLoopGroup(numberOfThreads: 1)
|
|
defer { XCTAssertNoThrow(try group.syncShutdownGracefully()) }
|
|
|
|
var server: Channel?
|
|
XCTAssertNoThrow(server = try ServerBootstrap(group: group)
|
|
.childChannelInitializer { channel in
|
|
channel.pipeline.addHandler(NeverrespondServerHandler())
|
|
}
|
|
.bind(to: .init(ipAddress: "127.0.0.1", port: 0))
|
|
.wait())
|
|
defer {
|
|
XCTAssertNoThrow(try server?.close().wait())
|
|
}
|
|
|
|
let request = try! HTTPClient.Request(url: "https://localhost:\(server!.localAddress!.port!)")
|
|
|
|
let factory = HTTPConnectionPool.ConnectionFactory(
|
|
key: .init(request),
|
|
tlsConfiguration: nil,
|
|
clientConfiguration: .init(proxy: .server(host: "127.0.0.1", port: server!.localAddress!.port!)),
|
|
sslContextCache: .init()
|
|
)
|
|
|
|
XCTAssertThrowsError(try factory.makeChannel(
|
|
requester: ExplodingRequester(),
|
|
connectionID: 1,
|
|
deadline: .now() + .seconds(1),
|
|
eventLoop: group.next(),
|
|
logger: .init(label: "test")
|
|
).wait()
|
|
) {
|
|
XCTAssertEqual($0 as? HTTPClientError, .httpProxyHandshakeTimeout)
|
|
}
|
|
}
|
|
|
|
func testTLSConnectionCreationTimesoutIfRemoteIsUnresponsive() {
|
|
let group = MultiThreadedEventLoopGroup(numberOfThreads: 1)
|
|
defer { XCTAssertNoThrow(try group.syncShutdownGracefully()) }
|
|
|
|
var server: Channel?
|
|
XCTAssertNoThrow(server = try ServerBootstrap(group: group)
|
|
.childChannelInitializer { channel in
|
|
channel.pipeline.addHandler(NeverrespondServerHandler())
|
|
}
|
|
.bind(to: .init(ipAddress: "127.0.0.1", port: 0))
|
|
.wait())
|
|
defer {
|
|
XCTAssertNoThrow(try server?.close().wait())
|
|
}
|
|
|
|
let request = try! HTTPClient.Request(url: "https://localhost:\(server!.localAddress!.port!)")
|
|
|
|
var tlsConfig = TLSConfiguration.makeClientConfiguration()
|
|
tlsConfig.certificateVerification = .none
|
|
let factory = HTTPConnectionPool.ConnectionFactory(
|
|
key: .init(request),
|
|
tlsConfiguration: nil,
|
|
clientConfiguration: .init(tlsConfiguration: tlsConfig),
|
|
sslContextCache: .init()
|
|
)
|
|
|
|
XCTAssertThrowsError(try factory.makeChannel(
|
|
requester: ExplodingRequester(),
|
|
connectionID: 1,
|
|
deadline: .now() + .seconds(1),
|
|
eventLoop: group.next(),
|
|
logger: .init(label: "test")
|
|
).wait()
|
|
) {
|
|
XCTAssertEqual($0 as? HTTPClientError, .tlsHandshakeTimeout)
|
|
}
|
|
}
|
|
}
|
|
|
|
class NeverrespondServerHandler: ChannelInboundHandler {
|
|
typealias InboundIn = NIOAny
|
|
|
|
func channelRead(context: ChannelHandlerContext, data: NIOAny) {
|
|
// do nothing
|
|
}
|
|
}
|
|
|
|
/// A `HTTPConnectionRequester` that will fail a test if any of its methods are ever called.
|
|
final class ExplodingRequester: HTTPConnectionRequester {
|
|
func http1ConnectionCreated(_: HTTP1Connection) {
|
|
XCTFail("http1ConnectionCreated called unexpectedly")
|
|
}
|
|
|
|
func http2ConnectionCreated(_: HTTP2Connection, maximumStreams: Int) {
|
|
XCTFail("http2ConnectionCreated called unexpectedly")
|
|
}
|
|
|
|
func failedToCreateHTTPConnection(_: HTTPConnectionPool.Connection.ID, error: Error) {
|
|
XCTFail("failedToCreateHTTPConnection called unexpectedly")
|
|
}
|
|
|
|
func waitingForConnectivity(_: HTTPConnectionPool.Connection.ID, error: Error) {
|
|
XCTFail("waitingForConnectivity called unexpectedly")
|
|
}
|
|
}
|