资源 Resource

Resource 用于表示一个可以读取二进制数据的资源，通常用于表示一个文件资源。

Resource 通常用于配合其他类型，例如标准消息元素 StandardMessage 中的图片类型。

获取

在全平台下， Resource 提供了部分通用类型。

ByteArray: 通过 ByteArray 直接构建一个 Resource 。这是最基础最普通的 Resource, 没有什么资源读取，而是直接提供现成的字节数组。
val bytes: ByteArray = ... val bytesResource = bytes.toResource()
var bytes = new byte[0]; var bytesResource = Resources.valueOf(bytes);
File: 通过一个文件路径构建一个 Resource ，也就是通过文件构建。
从 v4.7.0 开始基于 kotlinx-io 增加在全平台下对文件系统的支持。
val fileResource1 = fileResource("/file/image.jpg") val fileResource2 = fileResource("file", "image.jpg")
var fileResource1 = Resources.valueOfPath("/file/image.jpg"); var fileResource2 = Resources.valueOfPath("file", "image.jpg");

基于 JVM 的文件系统，在 JVM 平台下提供了更多可用的 Resource 类型实现。

File: 基于 java.io.File 的 Resource 实现。
val file = File("sample.txt") val resource = file.toResource()
var file = new File("sample.txt"); var resource = Resources.valueOf(file);
Path: 基于 java.nio.file.Path 的 Resource 实现。
val path = Path("file.txt") val resource = path.toResource()
var path = Paths.get("file.txt"); var resrouce = Resources.valueOf(path);
URI: 基于 java.net.URI 和 java.net.URL 的 Resource 实现。
val uri = URI.create("file:///file.txt") val url = uri.toURL() val uriResource = uri.toResource() val urlResource = url.toResource()
var uri = URI.create("file:///file.txt"); var url = uri.toURL(); var uriResource = Resources.valueOf(uri); var urlResource = Resources.valueOf(url);

07 November 2026