simbot-component-kook-api/love.forte.simbot.kook.api.asset/createCreateAssetApi

createCreateAssetApi

@JvmOverloads
@JvmName(name = "create")
fun createCreateAssetApi(file: File, filename: String? = null): CreateAssetApi(source)

提供文件的 File 作为上传API。

文件在上传时会通过 File.readChannel 转化为 ByteReadChannel。

File 不会被立即读取，而是在实际发起请求时被读取。 API 进行请求时，可能会因 File 而导致产生各种异常，比如 IOException。

Parameters

file

文件

filename

使用在表单数据中 HttpHeaders.ContentDisposition 的 filename 属性， 如果为 null 则会使用 File.getName 获取文件名称

See also

@JvmOverloads
@JvmName(name = "create")
fun createCreateAssetApi(path: Path, filename: String? = null): CreateAssetApi(source)

提供文件的 Path 作为上传API。

文件在上传时会通过 FileChannel.open 将 Path 打开并通过 FileChannel.asInput 转化为 Input。

Path 不会被立即读取，而是在实际发起请求时被读取。 API 进行请求时，可能会因 Path 而导致产生各种异常，比如 IOException。

Parameters

path

文件

filename

使用在表单数据中 HttpHeaders.ContentDisposition 的 filename 属性， 如果为 null 则会使用 Path.name 获取文件名称

See also

@JvmOverloads
@JvmName(name = "create")
fun createCreateAssetApi(fileURL: URL, filename: String? = null): CreateAssetApi(source)

提供文件的 URL 作为上传API。

文件在上传时会通过 URL.openStream 打开并通过 InputStream.asInput 转化为 Input。

URL 不会被立即读取，而是在实际发起请求时被读取。 API 进行请求时，可能会因 URL 而导致产生各种异常，比如 IOException。

Parameters

fileURL

文件 URL

filename

使用在表单数据中 HttpHeaders.ContentDisposition 的 filename 属性， 如果为 null 则会提供一个默认的文件名称 unknown-file。

See also

@JvmOverloads
@JvmName(name = "create")
fun createCreateAssetApi(fileURI: URI, filename: String? = null): CreateAssetApi(source)

提供文件的 URI 作为上传API。

文件在上传时会通过 URL.openStream 打开并通过 InputStream.asInput 转化为 Input。

URL 不会被立即读取，而是在实际发起请求时被读取。 API 进行请求时，可能会因 URL 而导致产生各种异常，比如 IOException。

Parameters

fileURI

文件 URI

filename

使用在表单数据中 HttpHeaders.ContentDisposition 的 filename 属性， 如果为 null 则会提供一个默认的文件名称 unknown-file。

See also

Throws