Spring 6 Spring Boot 3.x Support With Additional Spring 5 Backwards Compatibility

.github/workflows/build.yaml

@@ -38,7 +38,7 @@ jobs:
         java-version: 17
         cache: 'maven'
     - name: Compile
-      run: ./mvnw clean test-compile -B
+      run: ./mvnw clean package -DskipTests
     - name: Test
       run: ./mvnw verify -P "${{ matrix.profile }}" -B
     - name: Coverage

README.md

@@ -28,15 +28,15 @@ Logbook is ready to use out of the box for most common setups. Even for uncommon
 
 ## Dependencies
 
-- Java 8
+- Java 17
 - Any build tool using Maven Central, or direct download
 - Servlet Container (optional)
 - Apache HTTP Client 4.x **or 5.x** (optional)  
 - JAX-RS 2.x Client and Server (optional)
 - Netty 4.x (optional)
 - OkHttp 2.x **or 3.x** (optional)
-- Spring 5.x** (optional)
-- Spring Boot 2.x** (optional)
+- Spring **6.x** or Spring 5.x (optional, see instructions below)
+- Spring Boot **3.x** or 2.x (optional)
 - Ktor (optional)
 - logstash-logback-encoder 5.x (optional)
 
@@ -52,6 +52,19 @@ Add the following dependency to your project:
 </dependency>
 ```
 
+### Spring 5 Support
+
+For Spring 5 backwards compatibility please use the following import:
+
+```xml
+<dependency>
+    <groupId>org.zalando</groupId>
+    <artifactId>logbook-servlet</artifactId>
+    <version>${logbook.version}</version>
+    <classifier>javax</classifier>
+</dependency>
+```
+
 Additional modules/artifacts of Logbook always share the same version number.
 
 Alternatively, you can import our *bill of materials*...

logbook-jaxrs/pom.xml

@@ -31,9 +31,9 @@
             <artifactId>logbook-api</artifactId>
         </dependency>
         <dependency>
-            <groupId>javax.ws.rs</groupId>
-            <artifactId>javax.ws.rs-api</artifactId>
-            <version>2.1.1</version>
+            <groupId>jakarta.ws.rs</groupId>
+            <artifactId>jakarta.ws.rs-api</artifactId>
+            <version>2.1.6</version>
         </dependency>
         <!-- testing -->
         <dependency>

logbook-ktor-common/src/main/kotlin/org/zalando/logbook/common/ExperimentalLogbookKtorApi.kt

@@ -10,7 +10,7 @@ import kotlin.annotation.AnnotationTarget.*
  *
  * Any usage of a declaration annotated with `@ExperimentalLogbookKtorApi` must be accepted either by
  * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalLogbookKtorApi::class)`,
- * or by using the compiler argument `-Xopt-in=org.zalando.logbook.ktor.ExperimentalLogbookKtorApi`.
+ * or by using the compiler argument `-Opt-in=org.zalando.logbook.ktor.ExperimentalLogbookKtorApi`.
  */
 @RequiresOptIn(level = WARNING)
 @Retention(BINARY)

logbook-parent/pom.xml

@@ -27,6 +27,9 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <java.version>17</java.version>
+        <maven.compiler.source>${java.version}</maven.compiler.source>
+        <maven.compiler.target>${java.version}</maven.compiler.target>
 
         <jackson.version>2.14.2</jackson.version>
         <json-path.version>2.7.0</json-path.version>
@@ -36,12 +39,9 @@
         <reactor-netty.version>1.1.3</reactor-netty.version>
         <slf4j.version>1.7.36</slf4j.version>
 
-        <spring5.version>5.3.25</spring5.version>
-        <spring-security5.version>5.6.10</spring-security5.version>
-
-        <spring.version>5.3.25</spring.version>
-        <spring-boot.version>2.7.8</spring-boot.version>
-        <spring-security.version>5.8.1</spring-security.version>
+        <spring.version>6.0.7</spring.version>
+        <spring-boot.version>3.0.5</spring-boot.version>
+        <spring-security.version>6.0.1</spring-security.version>
 
         <junit.version>5.9.2</junit.version>
         <mockito.version>5.1.1</mockito.version>
@@ -133,9 +133,9 @@
             </dependency>
             <!-- javax -->
             <dependency>
-                <groupId>javax.servlet</groupId>
-                <artifactId>javax.servlet-api</artifactId>
-                <version>4.0.1</version>
+                <groupId>jakarta.servlet</groupId>
+                <artifactId>jakarta.servlet-api</artifactId>
+                <version>6.0.0</version>
                 <scope>provided</scope>
             </dependency>
             <!-- JsonPath -->
@@ -385,7 +385,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-compiler-plugin</artifactId>
-                    <version>3.8.1</version>
+                    <version>3.10.1</version>
                     <configuration>
                         <compilerArgs>
                             <compilerArg>-Xlint:unchecked,deprecation</compilerArg>

logbook-servlet/pom.xml

@@ -14,6 +14,11 @@
         <connection>scm:git:[email protected]:zalando/logbook.git</connection>
         <developerConnection>scm:git:[email protected]:zalando/logbook.git</developerConnection>
     </scm>
+
+    <properties>
+        <shadedClassifierName>javax</shadedClassifierName>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.zalando</groupId>
@@ -24,8 +29,8 @@
             <artifactId>logbook-core</artifactId>
         </dependency>
         <dependency>
-            <groupId>javax.servlet</groupId>
-            <artifactId>javax.servlet-api</artifactId>
+            <groupId>jakarta.servlet</groupId>
+            <artifactId>jakarta.servlet-api</artifactId>
         </dependency>
         <!-- testing -->
         <dependency>
@@ -109,4 +114,64 @@
             <artifactId>json-path-assert</artifactId>
         </dependency>
     </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>jakarta</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <shadedArtifactAttached>true</shadedArtifactAttached>
+                            <shadedClassifierName>${shadedClassifierName}</shadedClassifierName>
+                            <artifactSet>
+                                <includes>
+                                    <include>${project.groupId}:${project.artifactId}</include>
+                                </includes>
+                            </artifactSet>
+                            <relocations>
+                                <relocation>
+                                    <pattern>jakarta.servlet</pattern>
+                                    <shadedPattern>javax.servlet</shadedPattern>
+                                </relocation>
+                                <relocation>
+                                    <pattern>org.zalando.logbook.servlet</pattern>
+                                    <shadedPattern>org.zalando.logbook.servlet.javax</shadedPattern>
+                                </relocation>
+                            </relocations>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <!-- Make IntelliJ understand the shaded artifact location -->
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>build-helper-maven-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <id>compile</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>attach-artifact</goal>
+                        </goals>
+                        <configuration>
+                            <artifacts>
+                                <artifact>
+                                    <file>${project.build.directory}/${project.build.finalName}-${shadedClassifierName}.jar</file>
+                                    <classifier>${shadedClassifierName}</classifier>
+                                </artifact>
+                            </artifacts>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
 </project>

logbook-servlet/src/main/java/org/zalando/logbook/servlet/AsyncOnCompleteListener.java

@@ -1,7 +1,8 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.AsyncEvent;
+
 import java.io.IOException;
-import javax.servlet.AsyncEvent;
 
 @FunctionalInterface
 interface AsyncOnCompleteListener {

logbook-servlet/src/main/java/org/zalando/logbook/servlet/HttpFilter.java

@@ -1,13 +1,14 @@
 package org.zalando.logbook.servlet;
 
-import javax.servlet.Filter;
-import javax.servlet.FilterChain;
-import javax.servlet.FilterConfig;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
+import jakarta.servlet.Filter;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.FilterConfig;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.ServletRequest;
+import jakarta.servlet.ServletResponse;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+
 import java.io.IOException;
 
 interface HttpFilter extends Filter {

logbook-servlet/src/main/java/org/zalando/logbook/servlet/LocalResponse.java

@@ -1,16 +1,16 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.ServletOutputStream;
+import jakarta.servlet.ServletResponse;
+import jakarta.servlet.WriteListener;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.servlet.http.HttpServletResponseWrapper;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
 import org.zalando.logbook.HttpHeaders;
 import org.zalando.logbook.HttpResponse;
 import org.zalando.logbook.Origin;
 
-import javax.servlet.ServletOutputStream;
-import javax.servlet.ServletResponse;
-import javax.servlet.WriteListener;
-import javax.servlet.http.HttpServletResponse;
-import javax.servlet.http.HttpServletResponseWrapper;
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.io.OutputStream;

logbook-servlet/src/main/java/org/zalando/logbook/servlet/LogbookAsyncListener.java

@@ -1,8 +1,9 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.AsyncEvent;
+import jakarta.servlet.AsyncListener;
+
 import java.io.IOException;
-import javax.servlet.AsyncEvent;
-import javax.servlet.AsyncListener;
 
 class LogbookAsyncListener implements AsyncListener {
 

logbook-servlet/src/main/java/org/zalando/logbook/servlet/LogbookFilter.java

@@ -1,14 +1,9 @@
 package org.zalando.logbook.servlet;
 
-import java.io.IOException;
-import java.util.Optional;
-import java.util.UUID;
-import java.util.concurrent.atomic.AtomicBoolean;
-import javax.annotation.Nullable;
-import javax.servlet.FilterChain;
-import javax.servlet.ServletException;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
 import lombok.AllArgsConstructor;
 import lombok.With;
 import org.apiguardian.api.API;
@@ -18,7 +13,14 @@
 import org.zalando.logbook.Logbook.ResponseProcessingStage;
 import org.zalando.logbook.Logbook.ResponseWritingStage;
 import org.zalando.logbook.Strategy;
-import static javax.servlet.DispatcherType.ASYNC;
+
+import javax.annotation.Nullable;
+import java.io.IOException;
+import java.util.Optional;
+import java.util.UUID;
+import java.util.concurrent.atomic.AtomicBoolean;
+
+import static jakarta.servlet.DispatcherType.ASYNC;
 import static lombok.AccessLevel.PRIVATE;
 import static org.apiguardian.api.API.Status.STABLE;
 

logbook-servlet/src/main/java/org/zalando/logbook/servlet/RemoteRequest.java

@@ -1,5 +1,20 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.AsyncContext;
+import jakarta.servlet.AsyncListener;
+import jakarta.servlet.ServletInputStream;
+import jakarta.servlet.ServletRequest;
+import jakarta.servlet.ServletResponse;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletRequestWrapper;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.SneakyThrows;
+import org.zalando.logbook.HttpHeaders;
+import org.zalando.logbook.HttpRequest;
+import org.zalando.logbook.Origin;
+import org.zalando.logbook.common.MediaTypeQuery;
+
 import java.io.BufferedReader;
 import java.io.ByteArrayInputStream;
 import java.io.IOException;
@@ -13,20 +28,7 @@
 import java.util.Optional;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.function.Predicate;
-import javax.servlet.AsyncContext;
-import javax.servlet.AsyncListener;
-import javax.servlet.ServletInputStream;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletRequestWrapper;
-import lombok.AllArgsConstructor;
-import lombok.Getter;
-import lombok.SneakyThrows;
-import org.zalando.logbook.HttpHeaders;
-import org.zalando.logbook.HttpRequest;
-import org.zalando.logbook.Origin;
-import org.zalando.logbook.common.MediaTypeQuery;
+
 import static java.nio.charset.StandardCharsets.ISO_8859_1;
 import static java.util.Collections.list;
 import static java.util.stream.Collectors.joining;

logbook-servlet/src/main/java/org/zalando/logbook/servlet/SecureLogbookFilter.java

@@ -1,13 +1,13 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
 import org.apiguardian.api.API;
 import org.zalando.logbook.Logbook;
 import org.zalando.logbook.SecurityStrategy;
 
-import javax.servlet.FilterChain;
-import javax.servlet.ServletException;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
 import java.io.IOException;
 
 import static org.apiguardian.api.API.Status.STABLE;

logbook-servlet/src/main/java/org/zalando/logbook/servlet/ServletInputStreamAdapter.java

@@ -1,9 +1,9 @@
 package org.zalando.logbook.servlet;
 
+import jakarta.servlet.ReadListener;
+import jakarta.servlet.ServletInputStream;
 import lombok.AllArgsConstructor;
 
-import javax.servlet.ReadListener;
-import javax.servlet.ServletInputStream;
 import java.io.ByteArrayInputStream;
 import java.io.IOException;