resources.adoc

Resources

API 文档

Resources 接口根据以下规则管理资源的加载：

1. 如果提供的位置是 URL，则通过该 URL 下载资源;

2. 如果提供的位置以 classpath: 前缀开头，则从类路径(classpath)加载资源;

3. 如果该位置不是 URL 并且它不以 classpath: 开头，那么：

   1. 使用提供的位置作为相对路径，在应用程序的 配置文件目录 中搜索该文件。如果找到该文件，则从中下载资源;

   2. 如果在前面的步骤中找不到资源，则从类路径(classpath)下载。

实际上，很少使用显式的 URL 标识或 classpath: 前缀，因此通常可以通过配置文件目录或类路径下载资源。配置文件目录中的资源会覆盖类路径下相同名称的资源，即配置文件目录下的资源的优先级更高。

Resources 接口的方法:

• getResourceAsStream() – 返回指定资源的 InputStream，如果找不到资源则返回 null。应该在使用后关闭流，例如：

  link:../../../../../source/common/resources_1.java[role=include]

  也可以使用 "try with resources" 的编码方式:

  link:../../../../../source/common/resources_2.java[role=include]

• getResourceAsString() – 则以字符串形式返回所指定的资源内容，如果没有找到资源，返回 null。