ソースを参照

Mark `ExternalResource.isAutoClose`, `ExternalResource.useAutoClose` and `ExternalResource.runAutoClose` stable

Him188 3 年 前
コミット
a51f55124c

+ 2 - 0
mirai-core-api/compatibility-validation/android/api/android.api

@@ -6051,6 +6051,8 @@ public final class net/mamoe/mirai/utils/ExternalResource$Companion {
 }
 
 public final class net/mamoe/mirai/utils/ExternalResourceKt {
+	public static final fun runAutoClose (Lnet/mamoe/mirai/utils/ExternalResource;Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
+	public static final fun useAutoClose (Lnet/mamoe/mirai/utils/ExternalResource;Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
 }
 
 public abstract interface class net/mamoe/mirai/utils/FileCacheStrategy {

+ 2 - 0
mirai-core-api/compatibility-validation/jvm/api/jvm.api

@@ -6051,6 +6051,8 @@ public final class net/mamoe/mirai/utils/ExternalResource$Companion {
 }
 
 public final class net/mamoe/mirai/utils/ExternalResourceKt {
+	public static final fun runAutoClose (Lnet/mamoe/mirai/utils/ExternalResource;Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
+	public static final fun useAutoClose (Lnet/mamoe/mirai/utils/ExternalResource;Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
 }
 
 public abstract interface class net/mamoe/mirai/utils/FileCacheStrategy {

+ 0 - 3
mirai-core-api/src/commonMain/kotlin/utils/ExternalResource.kt

@@ -131,7 +131,6 @@ public expect interface ExternalResource : Closeable {
      *
      * @since 2.8
      */
-    @MiraiExperimentalApi
     public open val isAutoClose: Boolean
 
     /**
@@ -298,7 +297,6 @@ public inline fun <T : ExternalResource, R> T.withAutoClose(action: () -> R): R
  *
  * @since 2.8
  */
-@MiraiExperimentalApi
 public inline fun <T : ExternalResource, R> T.runAutoClose(action: T.() -> R): R {
     contract { callsInPlace(action, InvocationKind.EXACTLY_ONCE) }
     return withAutoClose { action() }
@@ -309,7 +307,6 @@ public inline fun <T : ExternalResource, R> T.runAutoClose(action: T.() -> R): R
  *
  * @since 2.8
  */
-@MiraiExperimentalApi
 public inline fun <T : ExternalResource, R> T.useAutoClose(action: (resource: T) -> R): R {
     contract { callsInPlace(action, InvocationKind.EXACTLY_ONCE) }
     return runAutoClose(action)

+ 0 - 1
mirai-core-api/src/jvmBaseMain/kotlin/utils/ExternalResource.kt

@@ -136,7 +136,6 @@ public actual interface ExternalResource : Closeable {
      *
      * @since 2.8
      */
-    @MiraiExperimentalApi
     public actual val isAutoClose: Boolean
         get() = false
 

+ 0 - 1
mirai-core-api/src/nativeMain/kotlin/utils/ExternalResource.kt

@@ -120,7 +120,6 @@ public actual interface ExternalResource : Closeable {
      *
      * @since 2.8
      */
-    @MiraiExperimentalApi
     public actual val isAutoClose: Boolean
         get() = false