From 5aacc3aa3265e6c893bc2a08e5f59eedeb043d28 Mon Sep 17 00:00:00 2001
From: Violeta Georgieva <violeta.georgieva@broadcom.com>
Date: Fri, 19 Apr 2024 15:37:37 +0300
Subject: [PATCH] Annotate HTTP/3 server support as incubating (#3183)

---
 .../src/main/java/reactor/netty/http/Http3SettingsSpec.java    | 2 ++
 .../src/main/java/reactor/netty/http/Http3SslContextSpec.java  | 2 ++
 .../src/main/java/reactor/netty/http/HttpProtocol.java         | 3 +++
 .../src/main/java/reactor/netty/http/server/HttpServer.java    | 2 ++
 .../main/java/reactor/netty/http/server/HttpServerConfig.java  | 2 ++
 5 files changed, 11 insertions(+)

diff --git a/reactor-netty-http/src/main/java/reactor/netty/http/Http3SettingsSpec.java b/reactor-netty-http/src/main/java/reactor/netty/http/Http3SettingsSpec.java
index d0142098a..8af9f0f29 100644
--- a/reactor-netty-http/src/main/java/reactor/netty/http/Http3SettingsSpec.java
+++ b/reactor-netty-http/src/main/java/reactor/netty/http/Http3SettingsSpec.java
@@ -16,6 +16,7 @@
 package reactor.netty.http;
 
 import io.netty.incubator.codec.quic.QuicTokenHandler;
+import reactor.util.annotation.Incubating;
 import reactor.util.annotation.Nullable;
 
 import java.util.Objects;
@@ -26,6 +27,7 @@
  * @author Violeta Georgieva
  * @since 1.2.0
  */
+@Incubating
 public final class Http3SettingsSpec {
 
 	public interface Builder {
diff --git a/reactor-netty-http/src/main/java/reactor/netty/http/Http3SslContextSpec.java b/reactor-netty-http/src/main/java/reactor/netty/http/Http3SslContextSpec.java
index be9c0b467..3c0b85e7c 100644
--- a/reactor-netty-http/src/main/java/reactor/netty/http/Http3SslContextSpec.java
+++ b/reactor-netty-http/src/main/java/reactor/netty/http/Http3SslContextSpec.java
@@ -18,6 +18,7 @@
 import io.netty.handler.ssl.SslContext;
 import io.netty.incubator.codec.quic.QuicSslContextBuilder;
 import reactor.netty.tcp.SslProvider;
+import reactor.util.annotation.Incubating;
 import reactor.util.annotation.Nullable;
 
 import javax.net.ssl.KeyManager;
@@ -42,6 +43,7 @@
  * @since 1.2.0
  * @see io.netty.incubator.codec.http3.Http3#supportedApplicationProtocols()
  */
+@Incubating
 public final class Http3SslContextSpec implements SslProvider.GenericSslContextSpec<QuicSslContextBuilder> {
 
 	/**
diff --git a/reactor-netty-http/src/main/java/reactor/netty/http/HttpProtocol.java b/reactor-netty-http/src/main/java/reactor/netty/http/HttpProtocol.java
index 6519c3e4e..e34d2bfdb 100644
--- a/reactor-netty-http/src/main/java/reactor/netty/http/HttpProtocol.java
+++ b/reactor-netty-http/src/main/java/reactor/netty/http/HttpProtocol.java
@@ -15,6 +15,8 @@
  */
 package reactor.netty.http;
 
+import reactor.util.annotation.Incubating;
+
 /**
  * An enum defining various HTTP negotiations between H2, H2C-upgrade,
  * H2C-prior-knowledge and HTTP/1.1.
@@ -54,5 +56,6 @@ public enum HttpProtocol {
 	 * HTTP/3.0 support.
 	 * @since 1.2.0
 	 */
+	@Incubating
 	HTTP3
 }
diff --git a/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServer.java b/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServer.java
index 696663b27..b8128dde7 100644
--- a/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServer.java
+++ b/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServer.java
@@ -54,6 +54,7 @@
 import reactor.netty.transport.ServerTransport;
 import reactor.util.Logger;
 import reactor.util.Loggers;
+import reactor.util.annotation.Incubating;
 import reactor.util.annotation.Nullable;
 import reactor.util.context.Context;
 
@@ -464,6 +465,7 @@ public final HttpServer http2Settings(Consumer<Http2SettingsSpec.Builder> http2S
 	 * @return a new {@link HttpServer}
 	 * @since 1.2.0
 	 */
+	@Incubating
 	public final HttpServer http3Settings(Consumer<Http3SettingsSpec.Builder> http3Settings) {
 		Objects.requireNonNull(http3Settings, "http3Settings");
 		if (!isHttp3Available()) {
diff --git a/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServerConfig.java b/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServerConfig.java
index ba92218de..7d9ad493b 100644
--- a/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServerConfig.java
+++ b/reactor-netty-http/src/main/java/reactor/netty/http/server/HttpServerConfig.java
@@ -76,6 +76,7 @@
 import reactor.netty.transport.logging.AdvancedByteBufFormat;
 import reactor.util.Logger;
 import reactor.util.Loggers;
+import reactor.util.annotation.Incubating;
 import reactor.util.annotation.Nullable;
 
 import java.net.SocketAddress;
@@ -170,6 +171,7 @@ public Http2SettingsSpec http2SettingsSpec() {
 	 * @return the HTTP/3 configuration
 	 * @since 1.2.0
 	 */
+	@Incubating
 	public Http3SettingsSpec http3SettingsSpec() {
 		return http3Settings;
 	}