commonMain.aws.smithy.kotlin.runtime.http.engine.ProxySelector.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of http-client-jvm Show documentation

HTTP client abstractions

There is a newer version: 1.3.25

/*
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * SPDX-License-Identifier: Apache-2.0
 */

package aws.smithy.kotlin.runtime.http.engine

import aws.smithy.kotlin.runtime.net.url.Url

/**
 * Selects the proxy to use for a given [Url]. Implementations **MUST** be stable and return the
 * same [ProxyConfig] for a given [Url].
 */
public fun interface ProxySelector {
    /**
     * Return the proxy configuration to use for [Url]
     */
    public fun select(url: Url): ProxyConfig

    public companion object {
        /**
         * Explicitly disable proxy selection
         */
        public val NoProxy: ProxySelector = ProxySelector { ProxyConfig.Direct }
    }
}