Spring 提供了简单的接口来管理资源，并支持多种资源类型。
一、Resource 接口
Java 自带的 java.net.URL 类只能处理 URL 前缀的资源，不能访问更多类型的低级资源。
因此，Spring 提供了 Resource 接口以及多种资源类型的实现。
public static void main(String[] args) throws Exception {
// Resource
Resource resource = new ClassPathResource("test/test-one.txt");
System.out.println("Filename: " + resource.getFilename());
System.out.println("Description: " + resource.getDescription());
System.out.println("URI: " + resource.getURI());
System.out.println("URL: " + resource.getURL());
System.out.println("Data: " + streamToString(resource));
System.out.println();
}
// Stream to String
private static String streamToString(Resource resource) throws IOException {
return StreamUtils.copyToString(resource.getInputStream(), StandardCharsets.UTF_8);
}
1. 内置实现
Spring 提供了下面几种资源实现：
UrlResource
UrlResource 包装了 java.net.URL 类，通过 URL 访问资源，例如文件、HTTP、FTP 资源。
通过协议前缀区分资源类型，例如 file: 访问文件系统资源，还有 http:、ftp: 等。
public static void main(String[] args) throws Exception {
// UrlResource
UrlResource fileResource = new UrlResource("file:E:/codeartist/spring/spring-ioc/src/main/resources/test/test-one.txt");
UrlResource httpResource = new UrlResource("https://www.baidu.com/");
}
ClassPathResource
ClassPathResource 可以从 classpath 下获取资源。
public static void main(String[] args) throws Exception {
// ClassPathResource
ClassPathResource classPathResource = new ClassPathResource("test/test-one.txt");
}
FileSystemResource
FileSystemResource 实现了对 java.io.File 资源的处理，支持 File 和文件路径指定资源。
public static void main(String[] args) throws Exception {
// FileSystemResource
FileSystemResource fileSystemResource =
new FileSystemResource("E:/codeartist/spring/spring-ioc/src/main/resources/test/test-two.txt");
}
ServletContextResource
ServletContextResource 可以管理来自 ServletContext 的资源。
InputStreamResource
InputStreamResource 可以管理来自 InputStream 生成的资源。
ByteArrayResource
ByteArrayResource 可以管理来自 Byte 数组生成的资源。
如果是从 Jar 包里面获取资源，不能通过 File 形式获取，只能通过流来获取。
2. 协议前缀
| 前缀 | 示例 | 描述 |
|---|---|---|
| classpath: | classpath:myapp/config.xml |
加载来自 classpath 的资源 |
| file: | file:///data/config.xml |
通过 URL 加载来自文件系统的资源 |
| http: | http://myserver/logo.png |
通过 URL 加载来自网络的资源 |
| (none) | /data/config.xml |
依赖底层的 ApplicationContext |
二、ResourceLoader 接口
ResourceLoader 接口用来加载 Resource，通过协议前缀来区分资源的类型。
所有的 Application Context 都实现了 ResourceLoader 接口，当使用 Application Context 来加载资源的时候，如果没有指定协议前缀，根据 Application Context 的类型来指定从哪里加载。
-
ClassPathXmlApplicationContext加载ClassPathResource -
FileSystemXmlApplicationContext加载FileSystemResource -
WebApplicationContext加载ServletContextResource
在 Bean 中可以使用 ResourceLoaderAware 注入当前上下文的 ResourceLoader。
1. 资源注入
Spring 还支持通过 @Value 注解来注入资源，通过协议前缀来注入。
@Component
public class BeanExample {
@Value("classpath:test/test-one.txt")
private Resource resource;
@Value("classpath:test/test-two.txt")
private File file;
}
支持注入的字段类型有：File、Resource 等。
2. Application Context 资源
通过 Application Context 加载单个资源。
public static void main(String[] args) throws Exception {
ApplicationContext applicationContext =
new AnnotationConfigApplicationContext("cn.codeartist.spring.resource");
Resource resource = applicationContext.getResource("classpath:test/test-one.txt");
}
Ant-style 风格
Application Context 通过 Ant-style 正则表达式加载多个资源。
public static void main(String[] args) throws Exception {
ApplicationContext applicationContext =
new AnnotationConfigApplicationContext("cn.codeartist.spring.resource");
Resource[] resources = applicationContext.getResources("classpath:test/test-*.txt");
for (Resource res : resources) {
// do something
}
}
classpath*: 前缀
Application Context 通过 classpath*: 前缀加载多个资源，该方式加载速度慢，一般很少使用。
classpath: 表示只加载第一个 classpath 路径下的资源。
classpath*: 表示加载系统中所有 classpath 路径下的资源。
public static void main(String[] args) throws Exception {
ApplicationContext applicationContext =
new AnnotationConfigApplicationContext("cn.codeartist.spring.resource");
Resource[] resources = applicationContext.getResources("classpath*:**/test-one.txt");
for (Resource res : resources) {
// do something
}
}
ClassPathXmlApplicationContext 和 WebApplicationContext 等 Bean 配置文件资源都是基于 ResourceLoader 接口来加载的。
三、附录
1. 示例代码
Gitee 仓库：https://gitee.com/code_artist/spring
项目模块：spring-ioc
示例路径：cn.codeartist.spring.resource
最新文章关注 CodeArtist 码匠公众号。
更多：Spring高效实践专栏