Fixes #5112: add ObjectMapper.findAndAddModules(...) variant (#5114)

Author: cowtowncoder

release-notes/CREDITS

@@ -44,3 +44,5 @@ Andy Boothe (@sigpwned)
 Sébastien Deleuze (@sdeleuze)
  * Requested #5110: Add missing `ObjectMapper#createNonBlockingByteBufferParser()` method
   [3.0.0]
+ * Requested #5112: Add a `MapperBuilder#findAndAddModules(ClassLoader)` variant
+  [3.0.0]

release-notes/VERSION

@@ -13,6 +13,8 @@ Versions: 3.x (for earlier see VERSION-2.x)
  to use `Supplier`
 #5110: Add missing `ObjectMapper#createNonBlockingByteBufferParser()` method
  (requested by Sébastien D)
+#5112: Add a `MapperBuilder#findAndAddModules(ClassLoader)` variant
+ (requested by Sébastien D)
 
 3.0.0-rc3 (13-Apr-2025)
 

src/main/java/tools/jackson/databind/cfg/MapperBuilder.java

@@ -1134,17 +1134,31 @@ public ServiceLoader<T> run() {
      *   addModules(builder.findModules());
      *</code>
      *<p>
-     * As with {@link #findModules()}, no caching is done for modules, so care
-     * needs to be taken to either create and share a single mapper instance;
-     * or to cache introspected set of modules.
+     * As with {@link #findModules()}, no caching is done for modules, so for
+     * performance reasons it may make sense to cache introspected set of modules
+     * if needed multiple times.
      */
     public B findAndAddModules() {
         return addModules(findModules());
     }
 
+    /**
+     * Convenience method that is functionally equivalent to:
+     *<code>
+     *   addModules(builder.findModules(classLoader));
+     *</code>
+     *<p>
+     * As with {@link #findModules(ClassLoader)}, no caching is done for modules, so for
+     * performance reasons it may make sense to cache introspected set of modules
+     * if needed multiple times.
+     */
+    public B findAndAddModules(ClassLoader cl) {
+        return addModules(findModules(cl));
+    }
+
     /**
      * "Accessor" method that will expose set of registered modules, in addition
-     * order, to given handler.
+     * order, using {@code handler} given.
      */
     public B withModules(Consumer<JacksonModule> handler) {
         if (_modules != null) {