customizable DefaultTestClientFactory: it is now possible to use default implementation with customizations (override configure method);

add ApacheTestClientFactory: useful to support PATCH methods on jdk > 16;
add `useApacheClient` (shortcut) configuration into `@TestGuiceyApp` and `@TestDropwizardApp` to simplify usage of ApacheTestClientFactory with annotations;
add `useApacheClient()` (shortcut) method into extension and generic builders

Author: xvik

CHANGELOG.md

@@ -1,4 +1,10 @@
 * Update to dropwizard 5 (requires java 17)
+* Customizable DefaultTestClientFactory: it is now possible to use default implementation
+  with customizations (override `configure` method)
+    - Add ApacheTestClientFactory: useful to support PATCH methods on jdk > 16
+    - Add `useApacheClient` (shortcut) configuration into `@TestGuiceyApp` and `@TestDropwizardApp`
+        to simplify usage of ApacheTestClientFactory with annotations
+    - Add `useApacheClient()` (shortcut) method into extension and generic builders 
 
 ### 7.2.1 (2025-05-12)
 * Fix NoClassDefFoundError on guicey startup due to junit classes leak into core (#428)

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/builder/TestSupportBuilder.java

@@ -10,6 +10,7 @@
 import jakarta.annotation.Nullable;
 import ru.vyarus.dropwizard.guice.test.GuiceyTestSupport;
 import ru.vyarus.dropwizard.guice.test.TestSupport;
+import ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory;
 import ru.vyarus.dropwizard.guice.test.client.DefaultTestClientFactory;
 import ru.vyarus.dropwizard.guice.test.client.TestClientFactory;
 import ru.vyarus.dropwizard.guice.test.util.ConfigOverrideUtils;
@@ -86,6 +87,18 @@ public TestSupportBuilder<C> clientFactory(final TestClientFactory factory) {
         return this;
     }
 
+    /**
+     * Shortcut for {@link #clientFactory(ru.vyarus.dropwizard.guice.test.client.TestClientFactory)} to configure
+     * {@link ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory}. The default
+     * {@link org.glassfish.jersey.client.HttpUrlConnectorProvider} supports only HTTP 1.1 methods and have
+     * problem with PATCH method usage on jdk > 16.
+     *
+     * @return builder instance for chained calls
+     */
+    public TestSupportBuilder<C> useApacheClient() {
+        return clientFactory(new ApacheTestClientFactory());
+    }
+
     /**
      * Listener used ONLY when builder run methods used! Listener may be used to perform additional initialization
      * or cleanup before/after application execution.
@@ -104,7 +117,9 @@ public TestSupportBuilder<C> listen(final TestListener<C> listener) {
      * creation. Prefer direct run ({@link #runCore()}) method usage (used support object could be easily obtained
      * with {@link ru.vyarus.dropwizard.guice.test.TestSupport#getContext()} in any place).
      * <p>
-     * IMPORTANT: listeners could not be used (because they are implemented as a custom run callback)
+     * IMPORTANT: listeners could not be used (because they are implemented as a custom run callback).
+     * Custom {@link ru.vyarus.dropwizard.guice.test.client.TestClientFactory} would also be lost! Use direct run
+     * methods to not lose them.
      *
      * @return guicey test support implementation
      */
@@ -121,7 +136,9 @@ public GuiceyTestSupport<C> buildCore() {
      * creation. Prefer direct run ({@link #runWeb()}) method usage (used support object could be easily obtained
      * with {@link ru.vyarus.dropwizard.guice.test.TestSupport#getContext()} in any place).
      * <p>
-     * IMPORTANT: listeners could not be used (because they are implemented as a custom run callback)
+     * IMPORTANT: listeners could not be used (because they are implemented as a custom run callback).
+     * Custom {@link ru.vyarus.dropwizard.guice.test.client.TestClientFactory} would also be lost! Use direct run
+     * methods to not lose them.
      *
      * @return dropwizard test support implementation
      */

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/client/ApacheTestClientFactory.java

@@ -0,0 +1,19 @@
+package ru.vyarus.dropwizard.guice.test.client;
+
+import io.dropwizard.testing.DropwizardTestSupport;
+import org.glassfish.jersey.apache5.connector.Apache5ConnectorProvider;
+import org.glassfish.jersey.client.JerseyClientBuilder;
+
+/**
+ * Use {@link Apache5ConnectorProvider} instead of default {@link org.glassfish.jersey.client.HttpUrlConnectorProvider}.
+ *
+ * @author Vyacheslav Rusakov
+ * @since 12.09.2025
+ */
+public class ApacheTestClientFactory extends DefaultTestClientFactory {
+
+    @Override
+    protected void configure(final JerseyClientBuilder builder, final DropwizardTestSupport<?> support) {
+        builder.getConfiguration().connectorProvider(new Apache5ConnectorProvider());
+    }
+}

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/client/DefaultTestClientFactory.java

@@ -2,6 +2,7 @@
 
 import io.dropwizard.jersey.jackson.JacksonFeature;
 import io.dropwizard.testing.DropwizardTestSupport;
+import jakarta.ws.rs.core.Feature;
 import org.glassfish.jersey.client.ClientProperties;
 import org.glassfish.jersey.client.HttpUrlConnectorProvider;
 import org.glassfish.jersey.client.JerseyClient;
@@ -19,8 +20,16 @@
  * <p>
  * By default, log all requests and responses into system out (console). This could be disabled with
  * {@link #disableConsoleLog()} method (system property).
+ * <p>
+ * NOTE: default {@link org.glassfish.jersey.client.HttpUrlConnectorProvider} does not support PATCH method on
+ * jdk > 16 (requires additional --add-opens). To workaround it, use apache or connection provider.
+ * <p>
+ * If client customization is required, extend this class and override
+ * {@link #configure(org.glassfish.jersey.client.JerseyClientBuilder,
+ * io.dropwizard.testing.DropwizardTestSupport)} method.
  *
  * @author Vyacheslav Rusakov
+ * @see ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory
  * @since 15.11.2023
  */
 public class DefaultTestClientFactory implements TestClientFactory {
@@ -50,24 +59,53 @@ public JerseyClient create(final DropwizardTestSupport<?> support) {
         final JerseyClientBuilder builder = new JerseyClientBuilder()
                 .register(new JacksonFeature(support.getEnvironment().getObjectMapper()))
                 // log everything to simplify debug
-                .register(LoggingFeature.builder()
-                        .withLogger(System.getProperty(USE_LOGGER) != null
-                                // use console log by default
-                                ? Logger.getLogger(ClientSupport.class.getName()) : new ConsoleLogger())
-                        .verbosity(LoggingFeature.Verbosity.PAYLOAD_TEXT)
-                        .level(Level.INFO)
-                        .build())
+                .register(createLogger())
                 .property(ClientProperties.CONNECT_TIMEOUT, 1000)
                 .property(ClientProperties.READ_TIMEOUT, 5000)
                 .property(HttpUrlConnectorProvider.SET_METHOD_WORKAROUND, true);
+        applyMultiPartSupport(builder);
+        configure(builder, support);
+        return builder.build();
+    }
+
+    /**
+     * Configure logging feature.
+     *
+     * @return logging feature
+     */
+    protected Feature createLogger() {
+        return LoggingFeature.builder()
+                .withLogger(System.getProperty(USE_LOGGER) != null
+                        // use console log by default
+                        ? Logger.getLogger(ClientSupport.class.getName()) : new ConsoleLogger())
+                .verbosity(LoggingFeature.Verbosity.PAYLOAD_TEXT)
+                .level(Level.INFO)
+                .build();
+    }
+
+    /**
+     * Apply multipart support, if multipart feature is present in classpath.
+     *
+     * @param builder client builder
+     */
+    protected void applyMultiPartSupport(final JerseyClientBuilder builder) {
         try {
             // when dropwizard-forms used automatically register multipart feature
             final Class<?> cls = Class.forName("org.glassfish.jersey.media.multipart.MultiPartFeature");
             builder.register(cls);
         } catch (Exception ignored) {
             // do nothing - no multipart feature available
         }
-        return builder.build();
+    }
+
+    /**
+     * Provides ability to customize default client in extending class.
+     *
+     * @param builder client builder (pre-configured)
+     * @param support dropwizard support instance (for accessing environment and configuration)
+     */
+    protected void configure(final JerseyClientBuilder builder, final DropwizardTestSupport<?> support) {
+        // empty
     }
 
     /**

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/jupiter/TestDropwizardApp.java

@@ -230,8 +230,22 @@
     /**
      * Custom client factory for {@link ru.vyarus.dropwizard.guice.test.ClientSupport} object. Custom factory
      * may be required in case when custom client configuration is required for test.
+     * <p>
+     * Note: value is ignored when {@link #useApacheClient()} set to true
      *
      * @return client factory class
      */
     Class<? extends TestClientFactory> clientFactory() default DefaultTestClientFactory.class;
+
+    /**
+     * Shortcut for {@link #clientFactory()} to configure
+     * {@link ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory}. The default
+     * {@link org.glassfish.jersey.client.HttpUrlConnectorProvider} supports only HTTP 1.1 methods and have
+     * problem with PATCH method usage on jdk > 16.
+     * <p>
+     * Note: {@link #clientFactory()} value is ignored when set to true,
+     *
+     * @return true to use apache connection provider in jersey client
+     */
+    boolean useApacheClient() default false;
 }

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/jupiter/TestGuiceyApp.java

@@ -204,11 +204,25 @@
      * may be required in case when custom client configuration is required for test.
      * <p>
      * Core test does not start dropwizard web services, but client still could be used to call external services.
+     * <p>
+     * Note: value is ignored when {@link #useApacheClient()} set to true
      *
      * @return client factory class
      */
     Class<? extends TestClientFactory> clientFactory() default DefaultTestClientFactory.class;
 
+    /**
+     * Shortcut for {@link #clientFactory()} to configure
+     * {@link ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory}. The default
+     * {@link org.glassfish.jersey.client.HttpUrlConnectorProvider} supports only HTTP 1.1 methods and have
+     * problem with PATCH method usage on jdk > 16.
+     * <p>
+     * Note: {@link #clientFactory()} value is ignored when set to true,
+     *
+     * @return true to use apache connection provider in jersey client
+     */
+    boolean useApacheClient() default false;
+
     /**
      * By default, guicey simulates {@link io.dropwizard.lifecycle.Managed} objects lifecycle.
      * <p>

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/jupiter/ext/TestDropwizardAppExtension.java

@@ -13,6 +13,7 @@
 import org.junit.jupiter.api.extension.RegisterExtension;
 import org.junit.platform.commons.support.AnnotationSupport;
 import ru.vyarus.dropwizard.guice.hook.GuiceyConfigurationHook;
+import ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory;
 import ru.vyarus.dropwizard.guice.test.jupiter.TestDropwizardApp;
 import ru.vyarus.dropwizard.guice.test.jupiter.env.TestEnvironmentSetup;
 import ru.vyarus.dropwizard.guice.test.jupiter.ext.conf.ExtensionBuilder;
@@ -364,7 +365,11 @@ static Config parse(final TestDropwizardApp ann, final TestExtensionsTracker tra
             res.tracker.debug = ann.debug();
             res.reuseApp = ann.reuseApplication();
             res.defaultExtensionsEnabled = ann.useDefaultExtensions();
-            res.clientFactory(ann.clientFactory());
+            if (ann.useApacheClient()) {
+                res.clientFactory(ApacheTestClientFactory.class);
+            } else {
+                res.clientFactory(ann.clientFactory());
+            }
             return res;
         }
     }

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/jupiter/ext/TestGuiceyAppExtension.java

@@ -11,6 +11,7 @@
 import org.junit.platform.commons.support.AnnotationSupport;
 import ru.vyarus.dropwizard.guice.hook.GuiceyConfigurationHook;
 import ru.vyarus.dropwizard.guice.test.GuiceyTestSupport;
+import ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory;
 import ru.vyarus.dropwizard.guice.test.jupiter.TestGuiceyApp;
 import ru.vyarus.dropwizard.guice.test.jupiter.env.TestEnvironmentSetup;
 import ru.vyarus.dropwizard.guice.test.jupiter.ext.conf.ExtensionBuilder;
@@ -333,7 +334,11 @@ static Config parse(final TestGuiceyApp ann, final TestExtensionsTracker tracker
             res.tracker.debug = ann.debug();
             res.reuseApp = ann.reuseApplication();
             res.defaultExtensionsEnabled = ann.useDefaultExtensions();
-            res.clientFactory(ann.clientFactory());
+            if (ann.useApacheClient()) {
+                res.clientFactory(ApacheTestClientFactory.class);
+            } else {
+                res.clientFactory(ann.clientFactory());
+            }
             res.managedLifecycle = ann.managedLifecycle();
             return res;
         }

dropwizard-guicey/src/main/java/ru/vyarus/dropwizard/guice/test/jupiter/ext/conf/ExtensionBuilder.java

@@ -7,6 +7,7 @@
 import org.junit.jupiter.api.function.ThrowingConsumer;
 import org.junit.jupiter.api.function.ThrowingSupplier;
 import ru.vyarus.dropwizard.guice.hook.GuiceyConfigurationHook;
+import ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory;
 import ru.vyarus.dropwizard.guice.test.client.TestClientFactory;
 import ru.vyarus.dropwizard.guice.test.util.ConfigModifier;
 import ru.vyarus.dropwizard.guice.test.util.ConfigOverrideExtensionValue;
@@ -370,6 +371,18 @@ public T clientFactory(final TestClientFactory factory) {
         return self();
     }
 
+    /**
+     * Shortcut for {@link #clientFactory(ru.vyarus.dropwizard.guice.test.client.TestClientFactory)} to configure
+     * {@link ru.vyarus.dropwizard.guice.test.client.ApacheTestClientFactory}. The default
+     * {@link org.glassfish.jersey.client.HttpUrlConnectorProvider} supports only HTTP 1.1 methods and have
+     * problem with PATCH method usage on jdk > 16.
+     *
+     * @return builder instance for chained calls
+     */
+    public T useApacheClient() {
+        return clientFactory(new ApacheTestClientFactory());
+    }
+
     @SuppressWarnings("unchecked")
     private T self() {
         return (T) this;

dropwizard-guicey/src/test/groovy/ru/vyarus/dropwizard/guice/test/general/ApacheFactoryTest.java

@@ -0,0 +1,23 @@
+package ru.vyarus.dropwizard.guice.test.general;
+
+import org.glassfish.jersey.apache5.connector.Apache5ConnectorProvider;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+import ru.vyarus.dropwizard.guice.support.AutoScanApplication;
+import ru.vyarus.dropwizard.guice.test.TestSupport;
+
+/**
+ * @author Vyacheslav Rusakov
+ * @since 12.09.2025
+ */
+public class ApacheFactoryTest {
+
+    @Test
+    void testApacheFactoryShortcut() throws Exception{
+        Class<?> cls = TestSupport.build(AutoScanApplication.class)
+                .useApacheClient()
+                .runCore(injector -> TestSupport
+                        .getContextClient().getClient().getConfiguration().getConnectorProvider().getClass());
+        Assertions.assertEquals(Apache5ConnectorProvider.class, cls);
+    }
+}