WebSockets Next: mark the extension as "stable"

- remove the Experimental annotation from the API
- move config classes to the runtime package
- remove experimental status from the docs
- resolves quarkusio#44469

docs/src/main/asciidoc/websockets-next-reference.adoc

@@ -13,7 +13,6 @@ include::_attributes.adoc[]
 :categories: web
 :topics: web,websockets
 :extensions: io.quarkus:quarkus-websockets-next
-:extension-status: experimental
 
 include::{includes}/extension-status.adoc[]
 

docs/src/main/asciidoc/websockets-next-tutorial.adoc

@@ -10,7 +10,6 @@ include::_attributes.adoc[]
 :summary: This guide explains how your Quarkus application can utilize web sockets to create interactive web applications. This guide uses the WebSockets Next extension
 :topics: web,websockets
 :extensions: io.quarkus:quarkus-websockets-next
-:extension-status: experimental
 
 This guide explains how your Quarkus application can utilize web sockets to create interactive web applications.
 In this guide, we will develop a very simple chat application using web sockets to receive and send messages to the other connected users.

extensions/websockets-next/deployment/src/main/java/io/quarkus/websockets/next/deployment/WebSocketProcessor.java

@@ -106,9 +106,9 @@
 import io.quarkus.websockets.next.WebSocketConnection;
 import io.quarkus.websockets.next.WebSocketException;
 import io.quarkus.websockets.next.WebSocketServerException;
-import io.quarkus.websockets.next.WebSocketsServerBuildConfig;
 import io.quarkus.websockets.next.deployment.Callback.MessageType;
 import io.quarkus.websockets.next.deployment.Callback.Target;
+import io.quarkus.websockets.next.deployment.config.WebSocketsServerBuildConfig;
 import io.quarkus.websockets.next.runtime.BasicWebSocketConnectorImpl;
 import io.quarkus.websockets.next.runtime.ClientConnectionManager;
 import io.quarkus.websockets.next.runtime.Codecs;

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/WebSocketsServerBuildConfig.java → extensions/websockets-next/deployment/src/main/java/io/quarkus/websockets/next/deployment/config/WebSocketsServerBuildConfig.java

@@ -1,12 +1,12 @@
-package io.quarkus.websockets.next;
+package io.quarkus.websockets.next.deployment.config;
 
 import io.quarkus.runtime.annotations.ConfigPhase;
 import io.quarkus.runtime.annotations.ConfigRoot;
 import io.smallrye.config.ConfigMapping;
 import io.smallrye.config.WithDefault;
 
 @ConfigMapping(prefix = "quarkus.websockets-next.server")
-@ConfigRoot(phase = ConfigPhase.BUILD_AND_RUN_TIME_FIXED)
+@ConfigRoot(phase = ConfigPhase.BUILD_TIME)
 public interface WebSocketsServerBuildConfig {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/BasicWebSocketConnector.java

@@ -10,7 +10,6 @@
 
 import io.quarkus.arc.Arc;
 import io.smallrye.common.annotation.CheckReturnValue;
-import io.smallrye.common.annotation.Experimental;
 import io.smallrye.mutiny.Uni;
 import io.vertx.core.buffer.Buffer;
 
@@ -42,7 +41,6 @@
  *
  * @see WebSocketClientConnection
  */
-@Experimental("This API is experimental and may change in the future")
 public interface BasicWebSocketConnector {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/BinaryDecodeException.java

@@ -1,13 +1,11 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
 import io.vertx.core.buffer.Buffer;
 
 /**
  *
  * @see BinaryMessageCodec
  */
-@Experimental("This API is experimental and may change in the future")
 public class BinaryDecodeException extends WebSocketException {
 
     private static final long serialVersionUID = 6814319993301938091L;

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/BinaryEncodeException.java

@@ -1,12 +1,9 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  *
  * @see BinaryMessageCodec
  */
-@Experimental("This API is experimental and may change in the future")
 public class BinaryEncodeException extends WebSocketException {
 
     private static final long serialVersionUID = -8042792962717461873L;

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/BinaryMessageCodec.java

@@ -1,6 +1,5 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
 import io.vertx.core.buffer.Buffer;
 
 /**
@@ -28,7 +27,6 @@
  * @param <T>
  * @see OnBinaryMessage
  */
-@Experimental("This API is experimental and may change in the future")
 public interface BinaryMessageCodec<T> extends MessageCodec<T, Buffer> {
 
 }

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/InboundProcessingMode.java

@@ -1,7 +1,5 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * WebSocket endpoints define the mode used to process incoming events for a specific connection.
  * <p>
@@ -10,7 +8,6 @@
  * @see WebSocketConnection
  * @see WebSocketClientConnection
  */
-@Experimental("This API is experimental and may change in the future")
 public enum InboundProcessingMode {
 
     /**
@@ -23,4 +20,4 @@ public enum InboundProcessingMode {
      */
     CONCURRENT,
 
-}
+}

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/MessageCodec.java

@@ -2,8 +2,6 @@
 
 import java.lang.reflect.Type;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Used to encode and decode messages.
  *
@@ -12,7 +10,6 @@
  * @see TextMessageCodec
  * @see BinaryMessageCodec
  */
-@Experimental("This API is experimental and may change in the future")
 public interface MessageCodec<T, MESSAGE> {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnBinaryMessage.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation consume binary messages. An
  * endpoint may declare at most one method annotated with this annotation.
@@ -61,7 +59,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnBinaryMessage {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnClose.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation are invoked when a connection
  * is closed. An endpoint may declare at most one method annotated with this annotation. The method must return {@code void} or
@@ -46,7 +44,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnClose {
 
 }

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnError.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation are invoked when an error
  * occurs.
@@ -59,7 +57,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnError {
 
 }

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnOpen.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation are invoked when a new
  * connection is opened. An endpoint may declare at most one method annotated with this annotation.
@@ -43,7 +41,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnOpen {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnPongMessage.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation consume pong messages. An
  * endpoint may declare at most one method annotated with this annotation.
@@ -45,7 +43,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnPongMessage {
 
 }

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OnTextMessage.java

@@ -6,8 +6,6 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * {@link WebSocket} and {@link WebSocketClient} endpoint methods annotated with this annotation consume text messages. An
  * endpoint may declare at most one method annotated with this annotation.
@@ -60,7 +58,6 @@
  */
 @Retention(RUNTIME)
 @Target(METHOD)
-@Experimental("This API is experimental and may change in the future")
 public @interface OnTextMessage {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OpenClientConnections.java

@@ -6,14 +6,11 @@
 
 import jakarta.enterprise.inject.Default;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Provides convenient access to all open client connections.
  * <p>
  * Quarkus provides a CDI bean with bean type {@link OpenClientConnections} and qualifier {@link Default}.
  */
-@Experimental("This API is experimental and may change in the future")
 public interface OpenClientConnections extends Iterable<WebSocketClientConnection> {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/OpenConnections.java

@@ -6,14 +6,11 @@
 
 import jakarta.enterprise.inject.Default;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Provides convenient access to all open connections.
  * <p>
  * Quarkus provides a CDI bean with bean type {@link OpenConnections} and qualifier {@link Default}.
  */
-@Experimental("This API is experimental and may change in the future")
 public interface OpenConnections extends Iterable<WebSocketConnection> {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/Sender.java

@@ -1,14 +1,12 @@
 package io.quarkus.websockets.next;
 
 import io.smallrye.common.annotation.CheckReturnValue;
-import io.smallrye.common.annotation.Experimental;
 import io.smallrye.mutiny.Uni;
 import io.vertx.core.buffer.Buffer;
 
 /**
  * Sends messages to the connected WebSocket client/server.
  */
-@Experimental("This API is experimental and may change in the future")
 public interface Sender {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/TextDecodeException.java

@@ -1,12 +1,9 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  *
  * @see TextMessageCodec
  */
-@Experimental("This API is experimental and may change in the future")
 public class TextDecodeException extends WebSocketException {
 
     private static final long serialVersionUID = 6814319993301938091L;

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/TextEncodeException.java

@@ -1,12 +1,9 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  *
  * @see TextMessageCodec
  */
-@Experimental("This API is experimental and may change in the future")
 public class TextEncodeException extends WebSocketException {
 
     private static final long serialVersionUID = 837621296462089705L;

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/TextMessageCodec.java

@@ -1,7 +1,5 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Used to encode and decode text messages.
  *
@@ -27,7 +25,6 @@
  * @param <T>
  * @see OnTextMessage
  */
-@Experimental("This API is experimental and may change in the future")
 public interface TextMessageCodec<T> extends MessageCodec<T, String> {
 
 }

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/WebSocket.java

@@ -9,8 +9,6 @@
 import jakarta.enterprise.context.ApplicationScoped;
 import jakarta.inject.Singleton;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Denotes a WebSocket server endpoint.
  * <p>
@@ -24,7 +22,6 @@
  */
 @Retention(RUNTIME)
 @Target(TYPE)
-@Experimental("This API is experimental and may change in the future")
 public @interface WebSocket {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/WebSocketClient.java

@@ -9,8 +9,6 @@
 import jakarta.enterprise.context.ApplicationScoped;
 import jakarta.inject.Singleton;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * Denotes a WebSocket client endpoint.
  * <p>
@@ -24,7 +22,6 @@
  */
 @Retention(RUNTIME)
 @Target(TYPE)
-@Experimental("This API is experimental and may change in the future")
 public @interface WebSocketClient {
 
     /**

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/WebSocketClientConnection.java

@@ -1,14 +1,11 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
 /**
  * This interface represents a client connection to a WebSocket endpoint.
  * <p>
  * Quarkus provides a CDI bean that implements this interface and can be injected in a {@link WebSocketClient}
  * endpoint and used to interact with the connected server.
  */
-@Experimental("This API is experimental and may change in the future")
 public interface WebSocketClientConnection extends Connection {
 
     /*

extensions/websockets-next/runtime/src/main/java/io/quarkus/websockets/next/WebSocketClientException.java

@@ -1,8 +1,5 @@
 package io.quarkus.websockets.next;
 
-import io.smallrye.common.annotation.Experimental;
-
-@Experimental("This API is experimental and may change in the future")
 public class WebSocketClientException extends WebSocketException {
 
     private static final long serialVersionUID = -4213710383874397185L;