Promote ApiMayChange features #26532 (#26838)

akka-remote/src/main/scala/akka/remote/artery/tcp/SSLEngineProvider.scala

@@ -18,7 +18,6 @@ import scala.util.Try
 import akka.actor.ActorSystem
 import akka.actor.ExtendedActorSystem
 import akka.actor.setup.Setup
-import akka.annotation.ApiMayChange
 import akka.annotation.InternalApi
 import akka.event.LogMarker
 import akka.event.Logging
@@ -35,7 +34,6 @@ import javax.net.ssl.SSLSession
 import javax.net.ssl.TrustManager
 import javax.net.ssl.TrustManagerFactory
 
-@ApiMayChange
 @ccompatUsedUntil213
 trait SSLEngineProvider {
 
@@ -66,7 +64,7 @@ class SslTransportException(message: String, cause: Throwable) extends RuntimeEx
  *
  * Subclass may override protected methods to replace certain parts, such as key and trust manager.
  */
-@ApiMayChange class ConfigSSLEngineProvider(protected val config: Config, protected val log: MarkerLoggingAdapter)
+class ConfigSSLEngineProvider(protected val config: Config, protected val log: MarkerLoggingAdapter)
     extends SSLEngineProvider {
 
   def this(system: ActorSystem) =
@@ -217,8 +215,7 @@ object SSLEngineProviderSetup {
  *
  * Constructor is *Internal API*, use factories in [[SSLEngineProviderSetup()]]
  */
-@ApiMayChange class SSLEngineProviderSetup private (val sslEngineProvider: ExtendedActorSystem => SSLEngineProvider)
+class SSLEngineProviderSetup private (val sslEngineProvider: ExtendedActorSystem => SSLEngineProvider) extends Setup
-    extends Setup
 
 /**
  * INTERNAL API

akka-remote/src/main/scala/akka/remote/transport/netty/SSLEngineProvider.scala

@@ -15,7 +15,6 @@ import java.security.SecureRandom
 import scala.util.Try
 
 import akka.actor.ActorSystem
-import akka.annotation.ApiMayChange
 import akka.event.Logging
 import akka.event.MarkerLoggingAdapter
 import akka.remote.RemoteTransportException
@@ -28,7 +27,7 @@ import javax.net.ssl.SSLEngine
 import javax.net.ssl.TrustManager
 import javax.net.ssl.TrustManagerFactory
 
-@ApiMayChange trait SSLEngineProvider {
+trait SSLEngineProvider {
 
   def createServerSSLEngine(): SSLEngine
 
@@ -41,7 +40,7 @@ import javax.net.ssl.TrustManagerFactory
  *
  * Subclass may override protected methods to replace certain parts, such as key and trust manager.
  */
-@ApiMayChange class ConfigSSLEngineProvider(protected val log: MarkerLoggingAdapter, private val settings: SSLSettings)
+class ConfigSSLEngineProvider(protected val log: MarkerLoggingAdapter, private val settings: SSLSettings)
     extends SSLEngineProvider {
 
   def this(system: ActorSystem) =

akka-stream/src/main/scala/akka/stream/javadsl/Hub.scala

@@ -8,7 +8,6 @@ import akka.NotUsed
 import java.util.function.{ BiFunction, Supplier, ToLongBiFunction }
 
 import akka.annotation.DoNotInherit
-import akka.annotation.ApiMayChange
 import akka.util.unused
 
 /**
@@ -133,7 +132,7 @@ object PartitionHub {
    * @param bufferSize Total number of elements that can be buffered. If this buffer is full, the producer
    *   is backpressured.
    */
-  @ApiMayChange def ofStateful[T](
+  def ofStateful[T](
       @unused clazz: Class[T],
       partitioner: Supplier[ToLongBiFunction[ConsumerInfo, T]],
       startAfterNrOfConsumers: Int,
@@ -148,7 +147,7 @@ object PartitionHub {
       .asJava
   }
 
-  @ApiMayChange def ofStateful[T](
+  def ofStateful[T](
       clazz: Class[T],
       partitioner: Supplier[ToLongBiFunction[ConsumerInfo, T]],
       startAfterNrOfConsumers: Int): Sink[T, Source[T, NotUsed]] =
@@ -183,7 +182,7 @@ object PartitionHub {
    * @param bufferSize Total number of elements that can be buffered. If this buffer is full, the producer
    *   is backpressured.
    */
-  @ApiMayChange def of[T](
+  def of[T](
       @unused clazz: Class[T],
       partitioner: BiFunction[Integer, T, Integer],
       startAfterNrOfConsumers: Int,
@@ -193,13 +192,13 @@ object PartitionHub {
       .mapMaterializedValue(_.asJava)
       .asJava
 
-  @ApiMayChange def of[T](
+  def of[T](
       clazz: Class[T],
       partitioner: BiFunction[Integer, T, Integer],
       startAfterNrOfConsumers: Int): Sink[T, Source[T, NotUsed]] =
     of(clazz, partitioner, startAfterNrOfConsumers, akka.stream.scaladsl.PartitionHub.defaultBufferSize)
 
-  @DoNotInherit @ApiMayChange trait ConsumerInfo {
+  @DoNotInherit trait ConsumerInfo {
 
     /**
      * Sequence of all identifiers of current consumers.

akka-stream/src/main/scala/akka/stream/javadsl/Source.scala

@@ -12,7 +12,7 @@ import akka.annotation.ApiMayChange
 import akka.event.LoggingAdapter
 import akka.japi.{ function, Pair, Util }
 import akka.stream._
-import akka.stream.impl.{ LinearTraversalBuilder }
+import akka.stream.impl.LinearTraversalBuilder
 import akka.util.{ ConstantFun, Timeout }
 import akka.util.JavaDurationConverters._
 import akka.{ Done, NotUsed }

akka-stream/src/main/scala/akka/stream/javadsl/SourceWithContext.scala

@@ -4,7 +4,6 @@
 
 package akka.stream.javadsl
 
-import akka.annotation.ApiMayChange
 import akka.japi.{ function, Pair, Util }
 import akka.stream._
 import akka.event.LoggingAdapter
@@ -16,10 +15,6 @@ import java.util.concurrent.CompletionStage
 
 import scala.compat.java8.FutureConverters._
 
-/**
- * API MAY CHANGE
- */
-@ApiMayChange
 object SourceWithContext {
 
   /**
@@ -37,10 +32,7 @@ object SourceWithContext {
  * operations.
  *
  * Can be created by calling [[Source.asSourceWithContext()]]
- *
- * API MAY CHANGE
  */
-@ApiMayChange
 final class SourceWithContext[+Out, +Ctx, +Mat](delegate: scaladsl.SourceWithContext[Out, Ctx, Mat])
     extends GraphDelegate(delegate) {
 

akka-stream/src/main/scala/akka/stream/javadsl/Tcp.scala

@@ -27,7 +27,7 @@ import scala.compat.java8.FutureConverters._
 import java.util.concurrent.CompletionStage
 
 import javax.net.ssl.SSLContext
-import akka.annotation.{ ApiMayChange, InternalApi }
+import akka.annotation.InternalApi
 import akka.stream.TLSProtocol.NegotiateNewSession
 import com.github.ghik.silencer.silent
 
@@ -246,7 +246,6 @@ class Tcp(system: ExtendedActorSystem) extends akka.actor.Extension {
    *
    * Marked API-may-change to leave room for an improvement around the very long parameter list.
    */
-  @ApiMayChange
   def outgoingTlsConnection(
       remoteAddress: InetSocketAddress,
       sslContext: SSLContext,
@@ -276,7 +275,6 @@ class Tcp(system: ExtendedActorSystem) extends akka.actor.Extension {
    *
    * Note: the half close parameter is currently ignored
    */
-  @ApiMayChange
   def bindTls(
       interface: String,
       port: Int,

akka-stream/src/main/scala/akka/stream/scaladsl/Flow.scala

@@ -29,7 +29,7 @@ import scala.language.higherKinds
 import akka.stream.impl.fusing.FlattenMerge
 import akka.NotUsed
 import akka.actor.ActorRef
-import akka.annotation.{ ApiMayChange, DoNotInherit }
+import akka.annotation.DoNotInherit
 
 import scala.annotation.implicitNotFound
 import scala.reflect.ClassTag
@@ -319,10 +319,7 @@ final class Flow[-In, +Out, +Mat](
    *
    * @param collapseContext turn each incoming pair of element and context value into an element of this Flow
    * @param extractContext turn each outgoing element of this Flow into an outgoing context value
-   *
-   * API MAY CHANGE
    */
-  @ApiMayChange
   def asFlowWithContext[U, CtxU, CtxOut](collapseContext: (U, CtxU) => In)(
       extractContext: Out => CtxOut): FlowWithContext[U, CtxU, Out, CtxOut, Mat] =
     new FlowWithContext(

akka-stream/src/main/scala/akka/stream/scaladsl/Hub.scala

@@ -24,7 +24,6 @@ import scala.collection.immutable.Queue
 
 import akka.annotation.InternalApi
 import akka.annotation.DoNotInherit
-import akka.annotation.ApiMayChange
 import akka.stream.Attributes.LogLevels
 
 /**
@@ -774,7 +773,7 @@ object PartitionHub {
    * @param bufferSize Total number of elements that can be buffered. If this buffer is full, the producer
    *   is backpressured.
    */
-  @ApiMayChange def statefulSink[T](
+  def statefulSink[T](
       partitioner: () => (ConsumerInfo, T) => Long,
       startAfterNrOfConsumers: Int,
       bufferSize: Int = defaultBufferSize): Sink[T, Source[T, NotUsed]] =
@@ -809,7 +808,6 @@ object PartitionHub {
    * @param bufferSize Total number of elements that can be buffered. If this buffer is full, the producer
    *   is backpressured.
    */
-  @ApiMayChange
   def sink[T](
       partitioner: (Int, T) => Int,
       startAfterNrOfConsumers: Int,
@@ -822,7 +820,7 @@ object PartitionHub {
     statefulSink(() => fun, startAfterNrOfConsumers, bufferSize)
   }
 
-  @DoNotInherit @ApiMayChange trait ConsumerInfo extends akka.stream.javadsl.PartitionHub.ConsumerInfo {
+  @DoNotInherit trait ConsumerInfo extends akka.stream.javadsl.PartitionHub.ConsumerInfo {
 
     /**
      * Sequence of all identifiers of current consumers.

akka-stream/src/main/scala/akka/stream/scaladsl/RestartFlow.scala

@@ -5,7 +5,6 @@
 package akka.stream.scaladsl
 
 import akka.NotUsed
-import akka.annotation.ApiMayChange
 import akka.event.Logging
 import akka.pattern.BackoffSupervisor
 import akka.stream.Attributes.Attribute
@@ -355,7 +354,6 @@ object RestartWithBackoffFlow {
    *
    * Will be removed if/when cancellation can include a cause.
    */
-  @ApiMayChange
   case class Delay(duration: FiniteDuration) extends Attribute
 
   /**

akka-stream/src/main/scala/akka/stream/scaladsl/SourceWithContext.scala

@@ -6,13 +6,8 @@ package akka.stream.scaladsl
 
 import scala.annotation.unchecked.uncheckedVariance
 
-import akka.annotation.ApiMayChange
 import akka.stream._
 
-/**
- * API MAY CHANGE
- */
-@ApiMayChange
 object SourceWithContext {
 
   /**
@@ -29,10 +24,7 @@ object SourceWithContext {
  * operations.
  *
  * Can be created by calling [[Source.asSourceWithContext()]]
- *
- * API MAY CHANGE
  */
-@ApiMayChange
 final class SourceWithContext[+Out, +Ctx, +Mat] private[stream] (delegate: Source[(Out, Ctx), Mat])
     extends GraphDelegate(delegate)
     with FlowWithContextOps[Out, Ctx, Mat] {

akka-stream/src/main/scala/akka/stream/scaladsl/Tcp.scala

@@ -11,7 +11,7 @@ import javax.net.ssl.SSLContext
 import javax.net.ssl.SSLEngine
 import javax.net.ssl.SSLSession
 import akka.actor._
-import akka.annotation.{ ApiMayChange, InternalApi }
+import akka.annotation.InternalApi
 import akka.io.Inet.SocketOption
 import akka.io.{ IO, Tcp => IoTcp }
 import akka.stream.TLSProtocol.NegotiateNewSession
@@ -262,7 +262,6 @@ final class Tcp(system: ExtendedActorSystem) extends akka.actor.Extension {
    *
    * Marked API-may-change to leave room for an improvement around the very long parameter list.
    */
-  @ApiMayChange
   def outgoingTlsConnection(
       remoteAddress: InetSocketAddress,
       sslContext: SSLContext,
@@ -307,7 +306,6 @@ final class Tcp(system: ExtendedActorSystem) extends akka.actor.Extension {
    *
    * Marked API-may-change to leave room for an improvement around the very long parameter list.
    */
-  @ApiMayChange
   def bindTls(
       interface: String,
       port: Int,
@@ -355,7 +353,6 @@ final class Tcp(system: ExtendedActorSystem) extends akka.actor.Extension {
    *
    * Marked API-may-change to leave room for an improvement around the very long parameter list.
    */
-  @ApiMayChange
   def bindAndHandleTls(
       handler: Flow[ByteString, ByteString, _],
       interface: String,

akka-stream/src/main/scala/akka/stream/stage/GraphStage.scala

@@ -7,7 +7,7 @@ package akka.stream.stage
 import java.util.concurrent.atomic.AtomicReference
 
 import akka.actor._
-import akka.annotation.{ ApiMayChange, InternalApi }
+import akka.annotation.InternalApi
 import akka.japi.function.{ Effect, Procedure }
 import akka.pattern.ask
 import akka.stream._
@@ -1223,7 +1223,6 @@ abstract class GraphStageLogic private[stream] (val inCount: Int, val outCount:
    * @param receive callback that will be called upon receiving of a message by this special Actor
    * @return minimal actor with watch method
    */
-  @ApiMayChange
   final protected def getStageActor(receive: ((ActorRef, Any)) => Unit): StageActor =
     getEagerStageActor(interpreter.materializer, poisonPillCompatibility = false)(receive)
 
@@ -1255,7 +1254,6 @@ abstract class GraphStageLogic private[stream] (val inCount: Int, val outCount:
    *
    * Returns an empty string by default, which means that the name will a unique generated String (e.g. "$$a").
    */
-  @ApiMayChange
   protected def stageActorName: String = ""
 
   // Internal hooks to avoid reliance on user calling super in preStart