github-repos/mirai
1
0
Fork 0
mirror of https://github.com/mamoe/mirai.git synced 2025-03-26 07:20:09 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add implementation notes

Browse Source
This commit is contained in:
Him188 2021-01-01 16:15:00 +08:00
parent fb8c17c6dc
commit fc2df4b9ad
1 changed files with 4 additions and 1 deletions

5
mirai-core-api/src/commonMain/kotlin/utils/ExternalResource.kt
View File

@ -104,6 +104,7 @@ public interface ExternalResource : Closeable {
@JvmOverloads
@JvmName("create")
public fun File.toExternalResource(formatName: String? = null): ExternalResource =
// although RandomAccessFile constructor throws IOException, actual performance influence is minor so not propagating IOException
RandomAccessFile(this, "r").toExternalResource(formatName)
/**
@ -144,7 +145,7 @@ public interface ExternalResource : Closeable {
@JvmStatic
@JvmOverloads
@JvmName("create")
@Throws(IOException::class)
@Throws(IOException::class) // not in BIO context so propagate IOException
public fun InputStream.toExternalResource(formatName: String? = null): ExternalResource =
Mirai.FileCacheStrategy.newCache(this, formatName)
@ -182,6 +183,7 @@ public interface ExternalResource : Closeable {
formatName: String? = null
): MessageReceipt<C> =
runBIO {
// toExternalResource throws IOException however we're in BIO context so not propagating IOException to sendAsImageTo
@Suppress("BlockingMethodInNonBlockingContext")
toExternalResource(formatName)
}.withUse { sendAsImageTo(contact) }
@ -225,6 +227,7 @@ public interface ExternalResource : Closeable {
@JvmBlockingBridge
@JvmOverloads
public suspend fun InputStream.uploadAsImage(contact: Contact, formatName: String? = null): Image =
// toExternalResource throws IOException however we're in BIO context so not propagating IOException to sendAsImageTo
@Suppress("BlockingMethodInNonBlockingContext")
runBIO { toExternalResource(formatName) }.withUse { uploadAsImage(contact) }