Package org.eclipse.aether.internal.test.util.http

Class HttpTransporterTest

java.lang.Object

org.eclipse.aether.internal.test.util.http.HttpTransporterTest

@TestMethodOrder(org.junit.jupiter.api.MethodOrderer.MethodName.class)
public abstract class HttpTransporterTest
extends Object

Common set of tests against Http transporter.

Field Summary

Fields

Modifier and Type	Field	Description
protected Authentication	auth
protected static final Path	CLIENT_STORE_PATH
protected Runnable	closer
protected static SSLContext	defaultSslContext
protected HttpTransporterFactory	factory
protected HttpServer	httpServer
protected static final long	OLD_FILE_TIMESTAMP
protected static final Path	PEM_QUICHE_SERVER_PATH
protected Proxy	proxy
protected File	repoDir
protected static final Path	SERVER_STORE_PATH
protected DefaultRepositorySystemSession	session
protected HttpTransporter	transporter

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HttpTransporterTest(Supplier<HttpTransporterFactory> transporterFactorySupplier)

Method Summary

Modifier and Type	Method	Description
protected static void	afterAll()
protected static void	beforeAll()
protected boolean	closesAllConnectionsOnTransporterClose()	Indicates whether the transporter implementation closes all connections when the transporter is closed.
protected static SSLContext	createClientSSLContext()	Creates an SSLContext for the client that extends the default keystore and truststore with the entries from SERVER_STORE_PATH (password "server-pwd") and CLIENT_STORE_PATH (password "client-pwd").
protected boolean	exposeContentCodingInTransportProperties()
protected RemoteRepository	newRepo(String url)
protected void	newTransporter(String url)
protected void	setUp(org.junit.jupiter.api.TestInfo testInfo)
protected static ChecksumExtractor	standardChecksumExtractor()
protected abstract Stream<String>	supportedCompressionAlgorithms()	Provides compression algorithms supported by the transporter implementation.
protected boolean	supportsHttp2()	Indicates whether the transporter implementation supports HTTP/2.
protected boolean	supportsHttp3()	Indicates whether the transporter implementation supports HTTP/3.
protected boolean	supportsPreemptiveAuth()	Indicates whether the transporter implementation supports preemptive authentication (i.e., sending credentials with the first request).
protected void	tearDown()
protected void	testAuthSchemePreemptive()
protected void	testAuthSchemeReuse()
protected void	testClassify()
protected void	testConcurrency()
protected void	testConnectTimeout()
protected void	testCustomHeaders()
protected void	testGet_AcceptsRfc9457()
protected void	testGet_Authenticated()
protected void	testGet_Checksums_Nexus()
protected void	testGet_Checksums_XChecksum()
protected void	testGet_Closed()
protected void	testGet_EmptyResource()
protected void	testGet_EncodedResourcePath()
protected void	testGet_FileHandleLeak()
protected void	testGet_HTTP3()
protected void	testGet_HTTP3FallbackToHTTP2()
protected void	testGet_HTTP3Only()
protected void	testGet_HTTPS_HTTP2Only_Insecure_SecurityMode()
protected void	testGet_HTTPS_Insecure_SecurityMode()
protected void	testGet_HTTPS_Unknown_SecurityMode()
protected void	testGet_NotFound()
protected void	testGet_ParseRfc9457()
protected void	testGet_ProgressCancelled()
protected void	testGet_ProxyAuthenticated()
protected void	testGet_ProxyUnauthenticated()
protected void	testGet_Redirect()
protected void	testGet_Resume()
protected void	testGet_ResumeLocalContentsOutdated()
protected void	testGet_ResumeRangesNotSupportedByServer()
protected void	testGet_RFC9457Response()
protected void	testGet_RFC9457Response_with_missing_fields()
protected void	testGet_SSL()
protected void	testGet_SSL_WithServerErrors()
protected void	testGet_StartCancelled()
protected void	testGet_ToFile()
protected void	testGet_ToFileTimestamp()
protected void	testGet_ToMemory()
protected void	testGet_Unauthenticated()
protected void	testGet_WithCompression(String encoding)
protected void	testGetPut_AuthCache()
protected void	testPeek()
protected void	testPeek_Authenticated()
protected void	testPeek_Closed()
protected void	testPeek_DoesNotAcceptRfc9457()
protected void	testPeek_NotFound()
protected void	testPeek_ProxyAuthenticated()
protected void	testPeek_ProxyUnauthenticated()
protected void	testPeek_Redirect()
protected void	testPeek_SSL()
protected void	testPeek_Unauthenticated()
protected void	testProxyAuthScope_NotUsedForServer()
protected void	testPut_AcceptsRfc9457()
protected void	testPut_AuthCache()
protected void	testPut_AuthCache_Preemptive()
protected void	testPut_Authenticated_ExpectContinue()
protected void	testPut_Authenticated_ExpectContinueBroken()
protected void	testPut_Authenticated_ExpectContinueDisabled()
protected void	testPut_Authenticated_ExpectContinueRejected()
protected void	testPut_Authenticated_ExpectContinueRejected_ExplicitlyConfiguredHeader()
protected void	testPut_Closed()
protected void	testPut_EmptyResource()
protected void	testPut_EncodedResourcePath()
protected void	testPut_FileHandleLeak()
protected void	testPut_FromFile()
protected void	testPut_FromMemory()
protected void	testPut_PreemptiveIsDefault()
protected void	testPut_ProgressCancelled()
protected void	testPut_ProxyAuthenticated()
protected void	testPut_ProxyUnauthenticated()
protected void	testPut_SSL()
protected void	testPut_StartCancelled()
protected void	testPut_Unauthenticated()
protected void	testPut_WithResponseBody()
protected void	testRequestTimeout()
protected void	testRetryHandler_defaultCount_negative()
protected void	testRetryHandler_defaultCount_positive()
protected void	testRetryHandler_disabled()
protected void	testRetryHandler_explicitCount_positive()
protected void	testRetryHandler_tooManyRequests_explicitCount_negative()
protected void	testRetryHandler_tooManyRequests_explicitCount_positive()
protected void	testServerAuthScope_NotUsedForProxy()
protected void	testUserAgent()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

SERVER_STORE_PATH

protected static final Path SERVER_STORE_PATH

CLIENT_STORE_PATH

protected static final Path CLIENT_STORE_PATH

PEM_QUICHE_SERVER_PATH

protected static final Path PEM_QUICHE_SERVER_PATH

defaultSslContext

protected static SSLContext defaultSslContext

session

protected DefaultRepositorySystemSession session

factory

protected HttpTransporterFactory factory

transporter

protected HttpTransporter transporter

closer

protected Runnable closer

repoDir

protected File repoDir

httpServer

protected HttpServer httpServer

auth

protected Authentication auth

proxy

protected Proxy proxy

OLD_FILE_TIMESTAMP

protected static final long OLD_FILE_TIMESTAMP

See Also:

• Constant Field Values

Constructor Details

HttpTransporterTest

protected HttpTransporterTest(Supplier<HttpTransporterFactory> transporterFactorySupplier)

Method Details

beforeAll

@BeforeAll
protected static void beforeAll()
                         throws NoSuchAlgorithmException

Throws:

NoSuchAlgorithmException

afterAll

@AfterAll
protected static void afterAll()

createClientSSLContext

protected static SSLContext createClientSSLContext()

Creates an SSLContext for the client that extends the default keystore and truststore with the entries from SERVER_STORE_PATH (password "server-pwd") and CLIENT_STORE_PATH (password "client-pwd").

Returns:

an SSLContext combining default and custom key/trust material

standardChecksumExtractor

protected static ChecksumExtractor standardChecksumExtractor()

newRepo

protected RemoteRepository newRepo(String url)

newTransporter

protected void newTransporter(String url)
                       throws Exception

Throws:

Exception

setUp

@BeforeEach
protected void setUp(org.junit.jupiter.api.TestInfo testInfo)
              throws Exception

Throws:

Exception

tearDown

@AfterEach
protected void tearDown()
                 throws Exception

Throws:

Exception

closesAllConnectionsOnTransporterClose

protected boolean closesAllConnectionsOnTransporterClose()

Indicates whether the transporter implementation closes all connections when the transporter is closed.

Returns:

true if all connections are closed on transporter close, false otherwise.

supportsPreemptiveAuth

protected boolean supportsPreemptiveAuth()

Indicates whether the transporter implementation supports preemptive authentication (i.e., sending credentials with the first request).

Returns:

true if preemptive authentication is supported, false otherwise.

supportsHttp3

protected boolean supportsHttp3()

Indicates whether the transporter implementation supports HTTP/3.

Returns:

true if HTTP/3 is supported, false otherwise.

supportsHttp2

protected boolean supportsHttp2()

Indicates whether the transporter implementation supports HTTP/2.

Returns:

true if HTTP/2 is supported, false otherwise.

testClassify

@Test
protected void testClassify()

testPeek

@Test
protected void testPeek()
                 throws Exception

Throws:

Exception

testPeek_DoesNotAcceptRfc9457

@Test
protected void testPeek_DoesNotAcceptRfc9457()
                                      throws Exception

Throws:

Exception

testRetryHandler_defaultCount_positive

@Test
protected void testRetryHandler_defaultCount_positive()
                                               throws Exception

Throws:

Exception

testRetryHandler_defaultCount_negative

@Test
protected void testRetryHandler_defaultCount_negative()
                                               throws Exception

Throws:

Exception

testRetryHandler_tooManyRequests_explicitCount_positive

@Test
protected void testRetryHandler_tooManyRequests_explicitCount_positive()
                                                                throws Exception

Throws:

Exception

testRetryHandler_tooManyRequests_explicitCount_negative

@Test
protected void testRetryHandler_tooManyRequests_explicitCount_negative()
                                                                throws Exception

Throws:

Exception

testRetryHandler_explicitCount_positive

@Test
protected void testRetryHandler_explicitCount_positive()
                                                throws Exception

Throws:

Exception

testRetryHandler_disabled

@Test
protected void testRetryHandler_disabled()
                                  throws Exception

Throws:

Exception

testPeek_NotFound

@Test
protected void testPeek_NotFound()
                          throws Exception

Throws:

Exception

testPeek_Closed

@Test
protected void testPeek_Closed()
                        throws Exception

Throws:

Exception

testPeek_Authenticated

@Test
protected void testPeek_Authenticated()
                               throws Exception

Throws:

Exception

testPeek_Unauthenticated

@Test
protected void testPeek_Unauthenticated()
                                 throws Exception

Throws:

Exception

testPeek_ProxyAuthenticated

@Test
protected void testPeek_ProxyAuthenticated()
                                    throws Exception

Throws:

Exception

testPeek_ProxyUnauthenticated

@Test
protected void testPeek_ProxyUnauthenticated()
                                      throws Exception

Throws:

Exception

testPeek_SSL

@Test
protected void testPeek_SSL()
                     throws Exception

Throws:

Exception

testPeek_Redirect

@Test
protected void testPeek_Redirect()
                          throws Exception

Throws:

Exception

testGet_ToMemory

@Test
protected void testGet_ToMemory()
                         throws Exception

Throws:

Exception

testGet_ToFile

@Test
protected void testGet_ToFile()
                       throws Exception

Throws:

Exception

testGet_ToFileTimestamp

@Test
protected void testGet_ToFileTimestamp()
                                throws Exception

Throws:

Exception

testGet_AcceptsRfc9457

@Test
protected void testGet_AcceptsRfc9457()
                               throws Exception

Throws:

Exception

testGet_ParseRfc9457

@Test
protected void testGet_ParseRfc9457()
                             throws Exception

Throws:

Exception

supportedCompressionAlgorithms

protected abstract Stream<String> supportedCompressionAlgorithms()

Provides compression algorithms supported by the transporter implementation. This should be the string value passed in the Accept-Encoding header.

Returns:

stream of supported compression algorithm names

See Also:

• Accept-Encoding directives

exposeContentCodingInTransportProperties

protected boolean exposeContentCodingInTransportProperties()

testGet_WithCompression

@ParameterizedTest
@ValueSource(strings={"br","gzip","zstd"})
protected void testGet_WithCompression(String encoding)
                                throws Exception

Throws:

Exception

testGet_EmptyResource

@Test
protected void testGet_EmptyResource()
                              throws Exception

Throws:

Exception

testGet_EncodedResourcePath

@Test
protected void testGet_EncodedResourcePath()
                                    throws Exception

Throws:

Exception

testGet_Authenticated

@Test
protected void testGet_Authenticated()
                              throws Exception

Throws:

Exception

testGet_Unauthenticated

@Test
protected void testGet_Unauthenticated()
                                throws Exception

Throws:

Exception

testGet_ProxyAuthenticated

@Test
protected void testGet_ProxyAuthenticated()
                                   throws Exception

Throws:

Exception

testGet_ProxyUnauthenticated

@Test
protected void testGet_ProxyUnauthenticated()
                                     throws Exception

Throws:

Exception

testGet_RFC9457Response

@Test
protected void testGet_RFC9457Response()
                                throws Exception

Throws:

Exception

testGet_RFC9457Response_with_missing_fields

@Test
protected void testGet_RFC9457Response_with_missing_fields()
                                                    throws Exception

Throws:

Exception

testGet_SSL

@Test
protected void testGet_SSL()
                    throws Exception

Throws:

Exception

testGet_SSL_WithServerErrors

@Test
protected void testGet_SSL_WithServerErrors()
                                     throws Exception

Throws:

Exception

testGet_HTTPS_Unknown_SecurityMode

@Test
protected void testGet_HTTPS_Unknown_SecurityMode()
                                           throws Exception

Throws:

Exception

testGet_HTTPS_Insecure_SecurityMode

@Test
protected void testGet_HTTPS_Insecure_SecurityMode()
                                            throws Exception

Throws:

Exception

testGet_HTTPS_HTTP2Only_Insecure_SecurityMode

@Test
protected void testGet_HTTPS_HTTP2Only_Insecure_SecurityMode()
                                                      throws Exception

Throws:

Exception

testGet_HTTP3Only

@Test
protected void testGet_HTTP3Only()
                          throws Exception

Throws:

Exception

testGet_HTTP3

@Test
protected void testGet_HTTP3()
                      throws Exception

Throws:

Exception

testGet_HTTP3FallbackToHTTP2

@Test
protected void testGet_HTTP3FallbackToHTTP2()
                                     throws Exception

Throws:

Exception

testGet_Redirect

@Test
protected void testGet_Redirect()
                         throws Exception

Throws:

Exception

testGet_Resume

@Test
protected void testGet_Resume()
                       throws Exception

Throws:

Exception

testGet_ResumeLocalContentsOutdated

@Test
protected void testGet_ResumeLocalContentsOutdated()
                                            throws Exception

Throws:

Exception

testGet_ResumeRangesNotSupportedByServer

@Test
protected void testGet_ResumeRangesNotSupportedByServer()
                                                 throws Exception

Throws:

Exception

testGet_Checksums_Nexus

@Test
protected void testGet_Checksums_Nexus()
                                throws Exception

Throws:

Exception

testGet_Checksums_XChecksum

@Test
protected void testGet_Checksums_XChecksum()
                                    throws Exception

Throws:

Exception

testGet_FileHandleLeak

@Test
protected void testGet_FileHandleLeak()
                               throws Exception

Throws:

Exception

testGet_NotFound

@Test
protected void testGet_NotFound()
                         throws Exception

Throws:

Exception

testGet_Closed

@Test
protected void testGet_Closed()
                       throws Exception

Throws:

Exception

testGet_StartCancelled

@Test
protected void testGet_StartCancelled()
                               throws Exception

Throws:

Exception

testGet_ProgressCancelled

@Test
protected void testGet_ProgressCancelled()
                                  throws Exception

Throws:

Exception

testPut_FromMemory

@Test
protected void testPut_FromMemory()
                           throws Exception

Throws:

Exception

testPut_AcceptsRfc9457

@Test
protected void testPut_AcceptsRfc9457()
                               throws Exception

Throws:

Exception

testPut_FromFile

@Test
protected void testPut_FromFile()
                         throws Exception

Throws:

Exception

testPut_EmptyResource

@Test
protected void testPut_EmptyResource()
                              throws Exception

Throws:

Exception

testPut_EncodedResourcePath

@Test
protected void testPut_EncodedResourcePath()
                                    throws Exception

Throws:

Exception

testPut_Authenticated_ExpectContinue

@Test
protected void testPut_Authenticated_ExpectContinue()
                                             throws Exception

Throws:

Exception

testPut_Authenticated_ExpectContinueBroken

@Test
protected void testPut_Authenticated_ExpectContinueBroken()
                                                   throws Exception

Throws:

Exception

testPut_Authenticated_ExpectContinueRejected

@Test
protected void testPut_Authenticated_ExpectContinueRejected()
                                                     throws Exception

Throws:

Exception

testPut_Authenticated_ExpectContinueDisabled

@Test
protected void testPut_Authenticated_ExpectContinueDisabled()
                                                     throws Exception

Throws:

Exception

testPut_Authenticated_ExpectContinueRejected_ExplicitlyConfiguredHeader

@Test
protected void testPut_Authenticated_ExpectContinueRejected_ExplicitlyConfiguredHeader()
                                                                                throws Exception

Throws:

Exception

testPut_Unauthenticated

@Test
protected void testPut_Unauthenticated()
                                throws Exception

Throws:

Exception

testPut_ProxyAuthenticated

@Test
protected void testPut_ProxyAuthenticated()
                                   throws Exception

Throws:

Exception

testPut_ProxyUnauthenticated

@Test
protected void testPut_ProxyUnauthenticated()
                                     throws Exception

Throws:

Exception

testPut_SSL

@Test
protected void testPut_SSL()
                    throws Exception

Throws:

Exception

testPut_FileHandleLeak

@Test
protected void testPut_FileHandleLeak()
                               throws Exception

Throws:

Exception

testPut_Closed

@Test
protected void testPut_Closed()
                       throws Exception

Throws:

Exception

testPut_StartCancelled

@Test
protected void testPut_StartCancelled()
                               throws Exception

Throws:

Exception

testPut_ProgressCancelled

@Test
protected void testPut_ProgressCancelled()
                                  throws Exception

Throws:

Exception

testGetPut_AuthCache

@Test
protected void testGetPut_AuthCache()
                             throws Exception

Throws:

Exception

testPut_PreemptiveIsDefault

@Test
protected void testPut_PreemptiveIsDefault()
                                    throws Exception

Throws:

Exception

testPut_AuthCache

@Test
protected void testPut_AuthCache()
                          throws Exception

Throws:

Exception

testPut_AuthCache_Preemptive

@Test
protected void testPut_AuthCache_Preemptive()
                                     throws Exception

Throws:

Exception

testPut_WithResponseBody

@Test
protected void testPut_WithResponseBody()
                                 throws Exception

Throws:

Exception

testConcurrency

@Test
@Timeout(20L)
protected void testConcurrency()
                        throws Exception

Throws:

Exception

testConnectTimeout

@Test
@Timeout(10L)
protected void testConnectTimeout()
                           throws Exception

Throws:

Exception

testRequestTimeout

@Test
@Timeout(10L)
protected void testRequestTimeout()
                           throws Exception

Throws:

Exception

testUserAgent

@Test
protected void testUserAgent()
                      throws Exception

Throws:

Exception

testCustomHeaders

@Test
protected void testCustomHeaders()
                          throws Exception

Throws:

Exception

testServerAuthScope_NotUsedForProxy

@Test
protected void testServerAuthScope_NotUsedForProxy()
                                            throws Exception

Throws:

Exception

testProxyAuthScope_NotUsedForServer

@Test
protected void testProxyAuthScope_NotUsedForServer()
                                            throws Exception

Throws:

Exception

testAuthSchemeReuse

@Test
protected void testAuthSchemeReuse()
                            throws Exception

Throws:

Exception

testAuthSchemePreemptive

@Test
protected void testAuthSchemePreemptive()
                                 throws Exception

Throws:

Exception