5.3.内置 Resource 实现
5.3. 内置 Resource
实现
Spring提供了很多 Resource
的实现:
5.3.1. UrlResource
UrlResource
封装了java.net.URL
,它能够被用来访问任何通过URL可以获得的对象,例如:文件、HTTP对象、FTP对象等。所有的URL都有个标准的 String
表示,这些标准前缀可以标识不同的URL类型,包括file:
访问文件系统路径,http:
通过HTTP协议访问的资源,ftp:
通过FTP访问的资源等等。
UrlResource
对象可以在Java代码中显式地使用 UrlResource
构造函数来创建。但更多的是通过调用带表示路径的 String
参数的API函数隐式地创建。在后一种情况下,JavaBeans的 PropertyEditor
会最终决定哪种类型的 Resource
被创建。如果这个字符串包含一些众所周知的前缀,比如 classpath:
,它就会创建一个对应的已串行化的 Resource
。 然而,如果不能分辨出这个前缀,就会假定它是个标准的URL字符串,然后创建UrlResource
。
5.3.2. ClassPathResource
这个类标识从classpath获得的资源。它会使用线程context的类加载器(class loader)、给定的类加载器或者用来载入资源的给定类。
如果类路径上的资源存在于文件系统里,这个 Resource
的实现会提供类似于java.io.File
的功能。而如果资源是存在于还未解开(被servlet引擎或其它的环境解开)的jar包中,一般提供类似于java.net.URL
的功能。
ClassPathResource
对象可以在Java代码中显式地使用ClassPathResource
构造函数来创建。但更多的是通过调用带表示路径的String
参数的API函数隐式地创建。在后一种情况下,JavaBeans的 PropertyEditor
会分辨字符串中 classpath:
前缀,然后相应创建 ClassPathResource
。
5.3.3. FileSystemResource
这是为处理 java.io.File
而准备的Resource
实现。它既可以作为File
提供,也可以作为URL
。
5.3.4. ServletContextResource
这是为 ServletContext
资源提供的 Resource
实现,它负责解析相关web应用根目录中的相对路径。
它始终支持以流和URL的方式访问。但是只有当web应用包被解开并且资源在文件系统的物理路径上时,才允许以 java.io.File
方式访问。是否解开并且在文件系统中访问,还是直接从JAR包访问或以其它方式访问如DB(这是可以想象的),仅取决于Servlet容器。
5.3.5. InputStreamResource
这是为给定的 InputStream
而准备的 Resource
实现。它只有在没有其它合适的 Resource
实现时才使用。而且,只要有可能就尽量使用 ByteArrayResource
或者其它基于文件的Resource
实现。
与其它 Resource
实现不同的是,这是个 已经 打开资源的描述符-因此 isOpen()
函数返回 true
。 如果你需要在其它位置保持这个资源的描述符或者多次读取一个流,请不要使用它。
5.3.6. ByteArrayResource
这是为给定的byte数组准备的 Resource
实现。 它会为给定的byte数组构造一个 ByteArrayInputStream
。
它在从任何给定的byte数组读取内容时很有用,因为不用转换成单一作用的 InputStreamResource
。