(Resource)

Resource 接口

  Java的标准Java.net.URL类和各种URL前缀的标准处理程序对于所有对低级资源的访问来说都不够充分。例如，没有标准化的URL实现可以用于访问需要从类路径或相对于Servlet上下文获得的资源。虽然可以为专用URL前缀注册新的处理程序（类似于http:等前缀的现有处理程序），但这通常相当复杂，并且URL接口仍然缺乏一些所需的功能，例如检查所指向的资源是否存在的方法。

介绍

  Java的标准Java.net.URL 类和各种URL前缀的标准处理程序对于所有对低级资源的访问来说都不够充分，基于此，Spring 的 org.springframework.core.io.Resource接口旨在成为一个更强大的接口，用于抽象对低级资源的访问，有关Resource接口的更多详细信息，参考Resource。 在这里插入图片描述

public interface Resource extends InputStreamSource {

	boolean exists();

	boolean isReadable();

	boolean isOpen();

	boolean isFile();

	URL getURL() throws IOException;

	URI getURI() throws IOException;

	File getFile() throws IOException;

	ReadableByteChannel readableChannel() throws IOException;

	long contentLength() throws IOException;

	long lastModified() throws IOException;

	Resource createRelative(String relativePath) throws IOException;

	String getFilename();

	String getDescription();
}

 正如Resource接口的定义所示，它扩展了InputStreamSource接口。以下列表显示InputStreamSource接口的定义：

public interface InputStreamSource {
	InputStream getInputStream() throws IOException;
}

核心方法

Resource 接口的最核心方法如下：

  • getInputStream()：定位并打开资源，返回用于从资源中读取的InputStream。预计每次调用都会返回一个新的 InputStream。 调用者需要负责关闭流。
  • exists()：返回一个boolean值，用于判断当前资源是否存在。
  • isOpen()：返回一个boolean值，判断当前资源是否是一个已打开的 InputStream。如果为 true，则不能多次读取InputStream ，必须只读取一次，然后关闭以避免资源泄漏。除InputStreamResource 外，对于所有常见的资源实现，返回false。
  • getDescription()：返回该资源的描述，当处理资源出错时，资源的描述会用于错误信息的输出。一般来说，资源的描述是一个完全限定的文件名称，或者是当前资源的实际URL。

注： 资源抽象不会取代功能。它尽可能地将其包裹起来。例如，UrlResource包装了一个URL，并使用包装后的URL来完成其工作。

常见接口

Resource 一些常见接口:

类型 接口
输入流 org.springframework.core.io.InputStreamSource
只读资源 org.springframework.core.io.Resource
可写资源 org.springframework.core.io.WritableResource
编码资源 org.springframework.core.io.support.EncodedResource
上下文资源 org.springframework.core.io.ContextResource

图解关系如下： 在这里插入图片描述

优缺点

Resource 接口的优缺点：

  • 优点

    • Resource 接口是一个标准接口，可以用于任何资源加载，不管资源是在文件中、在数据库中或其他地方。
    • Resource 接口提供了同步和异步加载方法，可以适应不同的应用场景。
    • Resource 接口可以方便地获取资源的元数据信息，例如资源的大小、修改时间等。
    • Resource 接口支持资源锁定和解锁，可以避免多个线程同时访问同一个资源导致的问题。

  • 缺点：

    • Resource 接口需要应用层自己维护资源之间的依赖关系以及管理生命周期，比较麻烦。
    • Resource 接口对内存敏感，如果加载的资源过多可能会导致内存溢出。
    • Resource 接口不支持动态加载和更新资源，需要手动进行操作。

内置Resource实现

Spring 包含几个内置Resource实现：

  • UrlResource
  • ClassPathResource
  • FileSystemResource
  • PathResource
  • ServletContextResource
  • InputStreamResource
  • ByteArrayResource
资源来源 前缀 描述
UrlResource file:、https:、ftp:等 UrlResource
ClassPathResource classpath: ClassPathResource
FileSystemResource file: FileSystemResource
PathResource -- PathResource
ServletContextResource -- ServletContextResource
InputStreamResource -- InputStreamResource
ByteArrayResource -- ByteArrayResource

UrlResource

  UrlResource封装了一个 java.net.URL 对象，用于访问可通过 URL 访问的任何对象，例如文件、HTTPS 目标、FTP 目标等。所有 URL 都可以通过标准化的字符串形式表示，因此可以使用适当的标准化前缀来指示一种 URL 类型与另一种 URL 类型的区别。 这包括：file：用于访问文件系统路径；https：用于通过 HTTPS 协议访问资源；ftp：用于通过 FTP 访问资源等等。

  UrlResource是由Java代码显式使用UrlResoResource构造函数创建的，但当您调用采用String参数表示路径的API方法时，通常会隐式创建。对于后一种情况，JavaBeans PropertyEditor最终决定创建哪种类型的Resource。如果路径字符串包含一个众所周知的（对属性编辑器来说就是）前缀（例如classpath：），它会为该前缀创建一个适当的专用Resource。但是，如果它不能识别前缀，它会假定该字符串是标准URL字符串，并创建一个UrlResource。

ClassPathResource

  ClassPathResource从类路径上加载资源。它使用线程上下文加载器、给定的类加载器或给定的类来加载资源。

  如果类路径资源驻留在文件系统中，但不支持驻留在jar中且尚未（通过servlet引擎或任何环境）扩展到文件系统的类路径资源，则此Resource实现支持解析为java.io.File。为了解决这一问题，各种Resource实现始终支持解析为java.net.URL。

   ClassPathResource是由Java代码显式使用ClassPath资源构造函数创建的，但当您调用接受表示路径的String参数的API方法时，通常会隐式创建。对于后一种情况，JavaBeans PropertyEditor识别字符串路径上的特殊前缀classpath：，并在这种情况下创建一个ClassPathResource。

FileSystemResource

  FileSystemResource是java.io.File 的资源实现。它还支持 java.nio.file.Path，应用 Spring的标准对字符串路径进行转换。FileSystemResource 支持解析为文件和 URL。

PathResource

  PathResource是 java.nio.file.Path 的资源实现。它实际上是FileSystemResource的纯java.nio.path.path替代方案，具有不同的createRelative行为。

ServletContextResource

  ServletContextResource是 ServletContext 的资源实现。它表示相应 Web 应用程序根目录中的相对路径。

  它始终支持流访问和URL访问，但仅当web应用程序归档扩展并且资源在文件系统上时才允许java.io.File访问。无论它是在文件系统上扩展还是直接从JAR或其他类似数据库的地方访问（这是可以想象的），实际上都取决于Servlet容器。

InputStreamResource

  InputStreamResource指定 InputStream的资源实现。注意：如果该 InputStream 已被打开，则不可以多次读取该流。

ByteArrayResource

  ByteArrayResource是指定的二进制数组的资源实现。它会为给定的字节数组创建一个ByteArrayInputStream`。

在这里插入图片描述

  如果喜欢的话，欢迎 🤞关注 👍点赞 💬评论 🤝收藏  🙌一起讨论
  你的支持就是我✍️创作的动力！					  💞💞💞

参考： spring - Resource 官方文档

感兴趣的可以点击 apllo社区 参加，几分钟就能领礼品，数量有限，先到先得 报名学习完毕之后填下方这个链接领取(视频可以直接拉进度，很快) https://www.wjx.top/vm/mB0APpq.aspx# 另有这个活动感兴趣的也可以参加下 https://apollo.baidu.com/community/activity/2?code=9884b4aa-ccbc-450f-ba3a-9405cc1ae097