Add Spring Boot 3 integration modules

Motivation:

Spring 6 and Spring Boot 3 have been released.
https://spring.io/blog/2022/11/24/spring-boot-3-0-goes-ga

Note that the added modules will not be published until we refactor
`spring-boot2-autoconfigure` internals.

Modifications:

- Add Spring Boot 3 integrations symmetirically with Spring Boot 2.
  - `publish` flags are not added intentionally.
- Set the release target for Spring Boot 3 and examples to Java 17.
- Add `PortUtil` and migrate off `SocketUtils`.
- Migrate AutoConfiguration in spring.factories to
  `o.s.b.a.AutoConfiguration.imports`.
  https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.7-Release-Notes#new-autoconfiguration-annotation
- Change `management.metrics.export.defaults.enabled` to
  `management.promethus.metrics.export.enabled` in tests
  spring-projects/spring-boot#30381
- Fix compile errors in the webflux integration
- Migrate moved `LocalServerPort` and `LocalManagementPort`.

Depedencies:

- Add Spring Boot 3.0.0
- Add `hibernate-validator 8.0.0
- Bump Micrometer into 1.10.2
- Add Jakarta dependencies
  - jakarta-inject 2.0.1
  - jakarta-validation 3.0.2
  - jakarta-websocket 2.1.0

Result:

Experimentally set up Spring Boot 3 integrations.

Author: ikhoon

build.gradle

@@ -178,14 +178,15 @@ configure(projectsWithFlags('java')) {
     }
 
     tasks.withType(JavaCompile) { task ->
-        if (task.path.startsWith(':examples:')) {
-            // Target Java 11 for examples.
-            options.release.set(11)
+        def path = task.path
+        if (path.startsWith(':spring:boot3') || path.startsWith(':examples') || path.startsWith(':it:spring')) {
+            // Target Java 17 for examples, Spring Boot 3 and Spring Boot integration tests.
+            options.release.set(17)
             // IntelliJ fails to compile example projects with IntelliJ compiler because of a wrong target
             // bytecode version which is marked as Java 8 without the following options.
             // See https://github.com/line/armeria/pull/3712
-            sourceCompatibility = '11'
-            targetCompatibility = '11'
+            sourceCompatibility = '17'
+            targetCompatibility = '17'
         } else {
             // Target Java 8 for the rest of them.
             options.release.set(8)

core/src/main/java/com/linecorp/armeria/internal/common/util/PortUtil.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2022 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you under the Apache License,
+ * version 2.0 (the "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at:
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+package com.linecorp.armeria.internal.common.util;
+
+import java.io.IOException;
+import java.net.InetAddress;
+import java.net.ServerSocket;
+import java.util.Random;
+import java.util.concurrent.ThreadLocalRandom;
+
+public final class PortUtil {
+
+    private static final int PORT_MIN = 1024;
+    private static final int PORT_RANGE = 64511;
+    private static final int PORT_MAX = PORT_MIN + PORT_RANGE;
+
+    public static int unusedTcpPort() {
+        final Random random = ThreadLocalRandom.current();
+        for (int i = 0; i < PORT_RANGE; i++) {
+            final int candidatePort = random.nextInt(PORT_RANGE) + PORT_MIN;
+            System.out.println(candidatePort);
+            try (ServerSocket ignored = new ServerSocket(candidatePort, 1,
+                                                         InetAddress.getByName("127.0.0.1"))) {
+                return candidatePort;
+            } catch (IOException e) {
+                // Port in use or unable to bind.
+                continue;
+            }
+        }
+
+        throw new IllegalStateException(
+                "Failed to find an unused TCP port in the range [" + PORT_MIN + ", " + PORT_MAX + "] after + " +
+                PORT_RANGE + " attempts");
+    }
+
+    private PortUtil() {}
+}

core/src/test/java/com/linecorp/armeria/internal/common/util/PortUtilTest.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2022 LINE Corporation
+ *
+ * LINE Corporation licenses this file to you under the Apache License,
+ * version 2.0 (the "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at:
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ */
+
+package com.linecorp.armeria.internal.common.util;
+
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.ServerSocket;
+
+import org.junit.jupiter.api.Test;
+
+class PortUtilTest {
+
+    @Test
+    void shouldAcquireUnusedPort() throws IOException {
+        final int port = PortUtil.unusedTcpPort();
+        try (ServerSocket serverSocket = new ServerSocket()) {
+            // Make sure the ServerSocket is successfully bound to the port.
+            serverSocket.bind(new InetSocketAddress("127.0.0.1", port));
+        }
+    }
+}

dependencies.toml

@@ -37,9 +37,13 @@ grpc-kotlin = "1.3.0"
 guava = "31.1-jre"
 hamcrest = "2.2"
 hbase = "1.2.6"
-hibernate-validator = "6.2.3.Final"
+hibernate-validator6 = "6.2.3.Final"
+hibernate-validator8 = "8.0.0.Final"
 j2objc = "1.3"
 jackson = "2.13.4"
+jakarta-inject = "2.0.1"
+jakarta-validation = "3.0.2"
+jakarta-websocket= "2.1.0"
 javax-annotation = "1.3.2"
 javax-inject = "1"
 javax-jsr311 = "1.1.1"
@@ -64,7 +68,7 @@ kotlin = "1.7.20"
 kotlin-coroutine = "1.6.4"
 ktlint-gradle-plugin = "11.0.0"
 logback = "1.2.11"
-micrometer = "1.9.4"
+micrometer = "1.10.2"
 micrometer13 = "1.3.20"
 mockito = "4.8.0"
 monix = "3.4.1"
@@ -104,13 +108,14 @@ scala3 = "3.2.0"
 scalafmt-gradle-plugin = "1.16.2"
 scalapb = "0.11.11"
 scalapb-json = "0.12.0"
-shadow-gradle-plugin = "6.1.0"
+shadow-gradle-plugin = "7.1.2"
 shibboleth-utilities = "7.5.2"
 snappy = "1.1.8.4"
 slf4j = "1.7.36"
 spring = "5.3.23"
 spring-boot1 = "1.5.22.RELEASE"
 spring-boot2 = "2.7.4"
+spring-boot3 = "3.0.0"
 testng = "7.5"
 thrift09 = { strictly = "0.9.3-1" }
 thrift012 = { strictly = "0.12.0" }
@@ -467,16 +472,32 @@ exclusions = [
 
 # Validator is only used for examples and testings in Spring
 # version 7 starts using jakarta api, which isn't compatible with spring-boot2
-[libraries.hibernate-validator]
+[libraries.hibernate-validator6]
 module = "org.hibernate.validator:hibernate-validator"
-version.ref = "hibernate-validator"
+version.ref = "hibernate-validator6"
+[libraries.hibernate-validator8]
+module = "org.hibernate.validator:hibernate-validator"
+version.ref = "hibernate-validator8"
 
 # We do not depend on j2objc-annotations. We just need this to stop Javadoc from
 # complaining about "unknown enum constant Level.FULL".
 [libraries.j2objc]
 module = "com.google.j2objc:j2objc-annotations"
 version.ref = "j2objc"
 
+[libraries.jakarta-inject]
+module = "jakarta.inject:jakarta.inject-api"
+version.ref = "jakarta-inject"
+[libraries.jakarta-validation]
+module = "jakarta.validation:jakarta.validation-api"
+version.ref = "jakarta-validation"
+[libraries.jakarta-websocket]
+module = "jakarta.websocket:jakarta.websocket-api"
+version.ref = "jakarta-websocket"
+[libraries.jakarta-websocket-client]
+module = "jakarta.websocket:jakarta.websocket-client-api"
+version.ref = "jakarta-websocket"
+
 [libraries.jackson-annotations]
 module = "com.fasterxml.jackson.core:jackson-annotations"
 javadocs = "https://fasterxml.github.io/jackson-annotations/javadoc/2.13/"
@@ -953,7 +974,7 @@ module = "com.thesamet.scalapb:scalapb-json4s_3"
 version.ref = "scalapb-json"
 
 [libraries.shadow-gradle-plugin]
-module = "com.github.jengelman.gradle.plugins:shadow"
+module = "gradle.plugin.com.github.johnrengelman:shadow"
 version.ref = "shadow-gradle-plugin"
 
 [libraries.slf4j-api]
@@ -1020,6 +1041,36 @@ exclusions = "org.springframework.boot:spring-boot-starter-reactor-netty"
 module = "org.springframework.boot:spring-boot-configuration-processor"
 version.ref = "spring-boot2"
 
+[libraries.spring-boot3-actuator-autoconfigure]
+module = "org.springframework.boot:spring-boot-actuator-autoconfigure"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-autoconfigure]
+module = "org.springframework.boot:spring-boot-autoconfigure"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-starter]
+module = "org.springframework.boot:spring-boot-starter"
+version.ref = "spring-boot3"
+javadocs = "https://docs.spring.io/spring/docs/current/javadoc-api/"
+[libraries.spring-boot3-starter-actuator]
+module = "org.springframework.boot:spring-boot-starter-actuator"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-starter-security]
+module = "org.springframework.boot:spring-boot-starter-security"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-starter-test]
+module = "org.springframework.boot:spring-boot-starter-test"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-starter-web]
+module = "org.springframework.boot:spring-boot-starter-web"
+version.ref = "spring-boot3"
+[libraries.spring-boot3-starter-webflux]
+module = "org.springframework.boot:spring-boot-starter-webflux"
+version.ref = "spring-boot3"
+exclusions = "org.springframework.boot:spring-boot-starter-reactor-netty"
+[libraries.spring-boot3-configuration-processor]
+module = "org.springframework.boot:spring-boot-configuration-processor"
+version.ref = "spring-boot3"
+
 # jdk 11 is required from testng version 7.6
 [libraries.testng]
 module = "org.testng:testng"

examples/spring-boot-minimal-kotlin/build.gradle.kts

@@ -7,18 +7,18 @@ plugins {
 }
 
 dependencies {
-    implementation(project(":spring:boot2-starter"))
-    implementation(libs.hibernate.validator)
+    implementation(project(":spring:boot3-starter"))
+    implementation(libs.hibernate.validator8)
 
-    implementation(project(":spring:boot2-actuator-starter"))
+    implementation(project(":spring:boot3-actuator-starter"))
 
     implementation(libs.jackson.kotlin)
     implementation(kotlin("reflect"))
     implementation(kotlin("stdlib-jdk8"))
 
     testImplementation(libs.json.unit.fluent)
     testImplementation(libs.junit5.jupiter.api)
-    testImplementation(libs.spring.boot2.starter.test)
+    testImplementation(libs.spring.boot3.starter.test)
 
     // Preprocessor that enables you to use KDoc to add description to REST API parameters.
     // If you don't want to use it, you can use the annotation

examples/spring-boot-minimal-kotlin/src/main/kotlin/example/springframework/boot/minimal/kotlin/HelloAnnotatedService.kt

@@ -3,9 +3,9 @@ package example.springframework.boot.minimal.kotlin
 import com.linecorp.armeria.server.annotation.ExceptionHandler
 import com.linecorp.armeria.server.annotation.Get
 import com.linecorp.armeria.server.annotation.Param
+import jakarta.validation.constraints.Size
 import org.springframework.stereotype.Component
 import org.springframework.validation.annotation.Validated
-import javax.validation.constraints.Size
 
 /**
  * Note that this is not a Spring-based component but an annotated HTTP service that leverages

examples/spring-boot-minimal-kotlin/src/main/kotlin/example/springframework/boot/minimal/kotlin/ValidationExceptionHandler.kt

@@ -1,21 +1,18 @@
 package example.springframework.boot.minimal.kotlin
 
-import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
 import com.linecorp.armeria.common.HttpRequest
 import com.linecorp.armeria.common.HttpResponse
 import com.linecorp.armeria.common.HttpStatus
 import com.linecorp.armeria.server.ServiceRequestContext
 import com.linecorp.armeria.server.annotation.ExceptionHandlerFunction
+import jakarta.validation.ValidationException
 import java.time.Instant
-import javax.validation.ValidationException
 
 /**
  * A sample exception handler which handles a [ValidationException].
  */
 class ValidationExceptionHandler : ExceptionHandlerFunction {
 
-    private val mapper = jacksonObjectMapper()
-
     override fun handleException(ctx: ServiceRequestContext, req: HttpRequest, cause: Throwable): HttpResponse {
         return if (cause is ValidationException) {
             val status = HttpStatus.BAD_REQUEST

examples/spring-boot-minimal/build.gradle

@@ -3,20 +3,20 @@ plugins {
 }
 
 dependencies {
-    implementation project(':spring:boot2-starter')
-    implementation libs.hibernate.validator
+    implementation project(':spring:boot3-starter')
+    implementation libs.hibernate.validator8
 
     // Preprocessor that enables you to use JavaDoc to add description to REST API parameters.
     // If you don't want to use it, you can use the annotation
     // com.linecorp.armeria.server.annotation.Description otherwise.
     compileOnly project(':annotation-processor')
     annotationProcessor project(':annotation-processor')
 
-    annotationProcessor libs.spring.boot2.configuration.processor
+    annotationProcessor libs.spring.boot3.configuration.processor
 
-    runtimeOnly project(':spring:boot2-actuator-starter')
+    runtimeOnly project(':spring:boot3-actuator-starter')
 
     testImplementation libs.json.unit.fluent
     testImplementation libs.junit5.jupiter.api
-    testImplementation libs.spring.boot2.starter.test
+    testImplementation libs.spring.boot3.starter.test
 }

examples/spring-boot-minimal/src/main/java/example/springframework/boot/minimal/HelloAnnotatedService.java

@@ -1,14 +1,14 @@
 package example.springframework.boot.minimal;
 
-import javax.validation.constraints.Size;
-
 import org.springframework.stereotype.Component;
 import org.springframework.validation.annotation.Validated;
 
 import com.linecorp.armeria.server.annotation.ExceptionHandler;
 import com.linecorp.armeria.server.annotation.Get;
 import com.linecorp.armeria.server.annotation.Param;
 
+import jakarta.validation.constraints.Size;
+
 /**
  * Note that this is not a Spring-based component but an annotated HTTP service that leverages
  * Armeria's built-in annotations.

examples/spring-boot-minimal/src/main/java/example/springframework/boot/minimal/ValidationExceptionHandler.java

@@ -4,8 +4,6 @@
 
 import java.time.Instant;
 
-import javax.validation.ValidationException;
-
 import com.fasterxml.jackson.annotation.JsonCreator;
 import com.fasterxml.jackson.annotation.JsonProperty;
 
@@ -15,6 +13,8 @@
 import com.linecorp.armeria.server.ServiceRequestContext;
 import com.linecorp.armeria.server.annotation.ExceptionHandlerFunction;
 
+import jakarta.validation.ValidationException;
+
 /**
  * A sample exception handler which handles a {@link ValidationException}.
  */