From be4764837a880d193de52d42f428dfb46f0c7bf9 Mon Sep 17 00:00:00 2001
From: Matthias Andreas Benkard <code@mail.matthias.benkard.de>
Date: Wed, 27 Sep 2023 18:06:56 +0200
Subject: fix(docs): Deal with TomcatURLStreamHandlerFactory conflict.

Change-Id: Iab1bf00ad122464b8c770301d2c33406ece072e0
---
 README.adoc | 29 ++++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

(limited to 'README.adoc')

diff --git a/README.adoc b/README.adoc
index 76f9eae..6b479ca 100644
--- a/README.adoc
+++ b/README.adoc
@@ -201,6 +201,12 @@ If you are using Maven:
       <version>3.0.2.Final</version>
     </dependency>
 
+    <dependency>
+      <groupId>org.jboss.logmanager</groupId>
+      <artifactId>jboss-logmanager-embedded</artifactId>
+      <version>1.2.0.Final</version>
+    </dependency>
+
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter</artifactId>
@@ -245,6 +251,7 @@ configurations {
 dependencies {
   implementation("eu.mulk.quarkus-googlecloud-jsonlogging:quarkus-googlecloud-jsonlogging-core:6.1.0")
   implementation("org.jboss.logmanager:jboss-logmanager:3.0.2.Final")
+  implementation("org.jboss.logmanager:jboss-logmanager-embedded:1.2.0.Final")
   implementation("org.jboss.slf4j:slf4j-jboss-logmanager:2.0.1.Final")
 }
 
@@ -272,15 +279,31 @@ entry to `application.properties` that points to the file:
 logging.config = classpath:logging.properties
 ----
 
-Finally, create the `logging.properties` file in your `resources`
-directory and set the root logger level to something other than
-`SEVERE`:
+Create the `logging.properties` file in your `resources` directory and
+set the root logger level to something other than `SEVERE`:
 
 [source,properties]
 ----
 logger.level = INFO
 ----
 
+Finally, add a `static` block to your Spring Boot application class
+that disables the Tomcat URL stream handler factory, which conflicts
+with the URL stream handler factory registered by the JBoss Modules
+library:
+
+[source,java]
+----
+@SpringBootApplication
+public class Application {
+
+  static {
+    TomcatURLStreamHandlerFactory.disable();
+  }
+
+  // ...
+}
+----
 
 == Usage
 
-- 
cgit v1.2.3

