资源 (Resources) _ Spring Framework 6.1.11-SNAPSHOT 中文文档(官方文档中文翻译) —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Framework 6.1.10！Spring中文文档

本章介绍了 Spring 如何处理资源以及如何在 Spring。它包括以下主题：Spring中文文档

介绍

Java 的标准类和各种 URL 前缀的标准处理程序，不幸的是，它们还不足以满足所有对低级资源的访问。为例如，没有可用于访问需要从类路径或相对于类路径获取的资源。虽然可以为专用前缀注册新的处理程序（类似于前缀的现有处理程序，例如），但这通常是相当复杂，界面仍然缺乏一些理想的功能，例如检查所指向的资源是否存在的方法。java.net.URLURLServletContextURLhttp:URLSpring中文文档

界面`Resource`

Spring的接口位于软件包中旨在成为一个功能更强大的接口，用于抽象对低级资源的访问。这以下列表提供了接口的概述。有关更多详细信息，请参阅资源 javadoc。Resourceorg.springframework.core.io.ResourceSpring中文文档

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();
}

如接口的定义所示，它扩展了接口。以下列表显示了接口的定义：ResourceInputStreamSourceInputStreamSourceSpring中文文档

public interface InputStreamSource {

	InputStream getInputStream() throws IOException;
}

界面中一些最重要的方法是：ResourceSpring中文文档

getInputStream()：查找并打开资源，返回 for 从资源中读取。预计每次调用都会返回一个新的 .调用方负责关闭流。InputStreamInputStreamSpring中文文档
exists()：返回一个指示此资源是否实际存在于物理形式。booleanSpring中文文档
isOpen()：返回指示此资源是否表示句柄使用开放流。如果，则不能多次读取，并且必须只读取一次，然后关闭以避免资源泄漏。返回所有常用的资源实现，但 .booleantrueInputStreamfalseInputStreamResourceSpring中文文档
getDescription()：返回此资源的说明，用于错误使用资源时的输出。这通常是完全限定的文件名或资源的实际 URL。Spring中文文档

其他方法允许您获得表示资源（如果基础实现兼容并支持该实现功能）。URLFileSpring中文文档

该接口的某些实现还实现了扩展的 WritableResource 接口用于支持写入的资源。ResourceSpring中文文档

Spring 本身广泛使用抽象，作为需要资源时的许多方法签名。某些 Spring API 中的其他方法（例如各种实现的构造函数）采用一种以朴素或简单的形式用于创建适当的该上下文实现，或者通过路径上的特殊前缀，让调用方指定必须创建和使用特定的实现。ResourceApplicationContextStringResourceStringResourceSpring中文文档

虽然该接口在 Spring 和 Spring 中被大量使用，但它实际上是非常方便地在自己的代码中单独用作通用实用程序类，以便访问资源，即使你的代码不知道或不关心 Spring 的任何其他部分。虽然这会将您的代码耦合到 Spring，但它实际上只将其耦合到这一小集合实用程序类，它可以作为更有能力的替代品，并且可以被认为等同于您将用于此目的的任何其他库。ResourceURLSpring中文文档

抽象不会取代功能。它把它包裹在什么地方可能。例如，a 包装一个 URL 并使用包装的 URL 来执行其工作。ResourceUrlResourceURL

内置实现`Resource`

Spring 包含几个内置实现：ResourceSpring中文文档

有关 Spring 中可用实现的完整列表，请参阅 资源 javadoc 的“所有已知实现类”部分。ResourceSpring中文文档

`UrlResource`

UrlResource包装一个，可用于访问任何对象通常可通过 URL（例如文件、HTTPS 目标、FTP 目标和别人。所有 URL 都具有标准化的表示形式，因此适当的标准化前缀用于指示一种 URL 类型与另一种 URL 类型。这包括访问文件系统路径，通过 HTTPS协议，用于通过FTP访问资源等。java.net.URLStringfile:https:ftp:Spring中文文档

A 是由 Java 代码通过显式使用构造函数创建的但通常是在调用 API 方法时隐式创建的，该方法采用旨在表示路径的参数。对于后一种情况，JavaBeans 最终决定创建哪种类型。如果路径字符串包含众所周知的（对属性编辑器来说，即）前缀（例如），它创建一个适用于该前缀。但是，如果它无法识别前缀，它假定该字符串是标准 URL 字符串，并创建一个 .UrlResourceUrlResourceStringPropertyEditorResourceclasspath:ResourceUrlResourceSpring中文文档

`ClassPathResource`

此类表示应从类路径获取的资源。它使用线程上下文类加载器、给定类加载器或给定的类加载资源。Spring中文文档

此实现支持将类路径解析为 if 资源驻留在文件系统中，但不驻留在 jar 并且尚未扩展（通过 servlet 引擎或任何环境）到文件系统。为了解决这个问题，各种实现始终支持分辨率为 .Resourcejava.io.FileResourcejava.net.URLSpring中文文档

A 是由 Java 代码通过显式使用构造函数创建的，但通常是在调用 API 方法时隐式创建的，该方法采用用于表示路径的参数。对于后一种情况，JavaBeans 会识别字符串路径上的特殊前缀，并且在这种情况下创建一个。ClassPathResourceClassPathResourceStringPropertyEditorclasspath:ClassPathResourceSpring中文文档

`FileSystemResource`

这是句柄的实现。它还支持句柄，应用 Spring 的标准基于字符串的路径转换，但通过 API 执行所有操作。对于纯基础支持，请改用。支持解析为 a 和 .Resourcejava.io.Filejava.nio.file.Pathjava.nio.file.Filesjava.nio.path.PathPathResourceFileSystemResourceFileURLSpring中文文档

`PathResource`

这是句柄的实现，执行所有通过 API 进行操作和转换。它支持分辨率为和作为和还实现了扩展接口。实际上是 with 的纯基替代品不同的行为。Resourcejava.nio.file.PathPathFileURLWritableResourcePathResourcejava.nio.path.PathFileSystemResourcecreateRelativeSpring中文文档

`ServletContextResource`

这是解释相关 Web 应用程序根目录中的相对路径。ResourceServletContextSpring中文文档

它始终支持流访问和 URL 访问，但仅允许访问当 Web 应用程序存档展开并且资源物理位于文件系统。无论它是否被扩展并在文件系统上或被访问直接来自 JAR 或其他地方，如数据库（可以想象）实际上是依赖于 Servlet 容器。java.io.FileSpring中文文档

`InputStreamResource`

an 是给定的实现。它仅当没有特定的实现适用时，才应使用。在 particular、preferred 或任何基于文件的实现（如果可能）。InputStreamResourceResourceInputStreamResourceByteArrayResourceResourceSpring中文文档

与其他实现相比，这是一个描述符已打开的资源。因此，它从返回。如果出现以下情况，请勿使用它您需要将资源描述符保留在某个位置，或者如果您需要读取流多次。ResourcetrueisOpen()Spring中文文档

`ByteArrayResource`

这是给定字节数组的实现。它为给定的字节数组创建一个。ResourceByteArrayInputStreamSpring中文文档

它对于从任何给定的字节数组加载内容很有用，而不必求助于一次性使用。InputStreamResourceSpring中文文档

界面`ResourceLoader`

该接口旨在由可以返回的对象实现（即加载）实例。以下列表显示了接口定义：ResourceLoaderResourceResourceLoaderSpring中文文档

public interface ResourceLoader {

	Resource getResource(String location);

	ClassLoader getClassLoader();
}

所有应用程序上下文都实现该接口。因此，所有应用程序上下文可用于获取实例。ResourceLoaderResourceSpring中文文档

调用特定应用程序上下文和位置路径时指定没有特定的前缀，则返回的类型是适用于该特定应用程序上下文。例如，假设如下针对实例运行代码片段：getResource()ResourceClassPathXmlApplicationContextSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

Resource template = ctx.getResource("some/resource/path/myTemplate.txt");

val template = ctx.getResource("some/resource/path/myTemplate.txt")

针对，该代码返回。如果对实例运行相同的方法，它将返回一个 .对于，它将返回 a 。同样，它将为每个上下文返回适当的对象。ClassPathXmlApplicationContextClassPathResourceFileSystemXmlApplicationContextFileSystemResourceWebApplicationContextServletContextResourceSpring中文文档

因此，您可以以适合特定应用程序的方式加载资源上下文。Spring中文文档

另一方面，你也可以强制使用，不管应用程序上下文类型，通过指定特殊前缀，如下所示示例显示：ClassPathResourceclasspath:Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

Resource template = ctx.getResource("classpath:some/resource/path/myTemplate.txt");

val template = ctx.getResource("classpath:some/resource/path/myTemplate.txt")

同样，您可以通过指定任何标准前缀来强制使用 a。以下示例使用 and 前缀：UrlResourcejava.net.URLfilehttpsSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

Resource template = ctx.getResource("file:///some/resource/path/myTemplate.txt");

val template = ctx.getResource("file:///some/resource/path/myTemplate.txt")

JavaSpring中文文档
KotlinSpring中文文档

Resource template = ctx.getResource("https://myhost.com/resource/path/myTemplate.txt");

val template = ctx.getResource("https://myhost.com/resource/path/myTemplate.txt")

下表总结了将对象转换为对象的策略：StringResourceSpring中文文档

表 1.资源字符串
前缀	例	解释
类路径：Spring中文文档	`classpath:com/myapp/config.xml`Spring中文文档	从类路径加载。Spring中文文档
文件：Spring中文文档	`file:///data/config.xml`Spring中文文档	从文件系统加载为。另请参阅 `FileSystemResource` 注意事项。`URL`Spring中文文档
https：Spring中文文档	`https://myserver/logo.png`Spring中文文档	加载为 .`URL`Spring中文文档
（无）Spring中文文档	`/data/config.xml`Spring中文文档	取决于基础 .`ApplicationContext`Spring中文文档

表 1.资源字符串
前缀	例	解释
类路径：Spring中文文档	`classpath:com/myapp/config.xml`Spring中文文档	从类路径加载。Spring中文文档
文件：Spring中文文档	`file:///data/config.xml`Spring中文文档	从文件系统加载为。另请参阅 `FileSystemResource` 注意事项。`URL`Spring中文文档
https：Spring中文文档	`https://myserver/logo.png`Spring中文文档	加载为 .`URL`Spring中文文档
（无）Spring中文文档	`/data/config.xml`Spring中文文档	取决于基础 .`ApplicationContext`Spring中文文档

界面`ResourcePatternResolver`

该接口是接口的扩展它定义了用于解析位置模式的策略（例如，Ant 样式的路径 pattern）到对象中。ResourcePatternResolverResourceLoaderResourceSpring中文文档

public interface ResourcePatternResolver extends ResourceLoader {

	String CLASSPATH_ALL_URL_PREFIX = "classpath*:";

	Resource[] getResources(String locationPattern) throws IOException;
}

从上面可以看出，这个接口还定义了一个特殊的资源前缀对于类路径中的所有匹配资源。请注意，资源位置是在本例中，应为不带占位符的路径，例如 .JAR 文件或类路径中的不同目录可以包含具有相同路径和相同名称的多个文件。有关更多详细信息，请参阅应用程序上下文构造函数资源路径中的通配符及其子部分在带有资源前缀的通配符支持上。classpath*:classpath*:/config/beans.xmlclasspath*:Spring中文文档

可以检查传入（例如，通过 ResourceLoaderAware 语义提供的传入）是否它也实现了这个扩展接口。ResourceLoaderSpring中文文档

PathMatchingResourcePatternResolver是可用的独立实现在 an 之外，也用于 for 填充 Bean 属性。能够将指定的资源位置路径解析为一个或多个匹配对象。源路径可以是具有到目标的一对一映射的简单路径，也可以包含特殊前缀和/或内部蚂蚁风格的正则表达式（使用 Spring 的实用程序进行匹配）。后者都是有效的通配符。ApplicationContextResourceArrayPropertyEditorResource[]PathMatchingResourcePatternResolverResourceResourceclasspath*:org.springframework.util.AntPathMatcherSpring中文文档

任何标准中的默认值实际上是一个实例其中实现接口。实例本身也是如此，它也实现接口并委托给默认值。ResourceLoaderApplicationContextPathMatchingResourcePatternResolverResourcePatternResolverApplicationContextResourcePatternResolverPathMatchingResourcePatternResolverSpring中文文档

界面`ResourceLoaderAware`

该接口是一个特殊的回调接口，用于识别希望提供参考的组件。以下列表显示接口的定义：ResourceLoaderAwareResourceLoaderResourceLoaderAwareSpring中文文档

public interface ResourceLoaderAware {

	void setResourceLoader(ResourceLoader resourceLoader);
}

当类实现并部署到应用程序上下文中时（作为 Spring 管理的 bean），它被应用程序识别为上下文。然后，应用程序上下文调用，提供自身作为参数（请记住，Spring 中的所有应用程序上下文都实现了接口）。ResourceLoaderAwareResourceLoaderAwaresetResourceLoader(ResourceLoader)ResourceLoaderSpring中文文档

由于 an 是，因此 bean 也可以实现接口，并直接使用提供的应用程序上下文来加载资源。但是，一般来说，如果这就是您所需要的，最好使用专用界面。代码将仅与资源加载耦合接口（可以被认为是一个实用程序接口），而不是整个Spring接口。ApplicationContextResourceLoaderApplicationContextAwareResourceLoaderApplicationContextSpring中文文档

在应用程序组件中，您还可以依赖 as 的自动接线实现接口的替代方法。传统模式和自动接线模式（如自动接线协作者中所述）能够为构造函数参数或 setter 方法参数。为了获得更大的灵活性（包括能够 autowire 字段和多参数方法），考虑使用基于注释的自动接线功能。在这种情况下，自动连接到一个字段，构造函数参数，或要求类型为 long 的方法参数因为所讨论的字段、构造函数或方法带有注释。有关详细信息，请参阅使用 @Autowired。ResourceLoaderResourceLoaderAwareconstructorbyTypeResourceLoaderResourceLoaderResourceLoader@AutowiredSpring中文文档

为包含通配符的资源路径加载一个或多个对象或者使用特殊的资源前缀，请考虑将 ResourcePatternResolver 的实例自动连接到应用程序组件，而不是 .Resourceclasspath*:ResourceLoader

作为依赖关系的资源

如果 Bean 本身要通过某种方式确定和提供资源路径在动态过程中，Bean 使用 OR 接口来加载资源可能是有意义的。例如，考虑加载某种模板，其中所需的特定资源取决于用户的角色。如果资源是静态的，则完全消除接口（或接口）的使用是有意义的，将 Bean 公开了它需要的属性，并期望它们被注入到其中。ResourceLoaderResourcePatternResolverResourceLoaderResourcePatternResolverResourceSpring中文文档

然后注入这些属性变得微不足道的是，所有应用程序上下文注册并使用一个特殊的 JavaBeans ，它可以转换路径到对象。例如，以下类具有类型的属性。PropertyEditorStringResourceMyBeantemplateResourceSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

public class MyBean {

	private Resource template;

	public setTemplate(Resource template) {
		this.template = template;
	}

	// ...
}

class MyBean(var template: Resource)

在 XML 配置文件中，可以使用简单的该资源的字符串，如以下示例所示：templateSpring中文文档

<bean id="myBean" class="example.MyBean">
	<property name="template" value="some/resource/path/myTemplate.txt"/>
</bean>

请注意，资源路径没有前缀。因此，由于应用程序上下文本身将用作，资源通过、 a 或 a 加载，具体取决于应用程序上下文的确切类型。ResourceLoaderClassPathResourceFileSystemResourceServletContextResourceSpring中文文档

如果需要强制使用特定类型，可以使用前缀。这以下两个示例演示如何强制 A 和 A （后者用于访问文件系统中的文件）：ResourceClassPathResourceUrlResourceSpring中文文档

<property name="template" value="classpath:some/resource/path/myTemplate.txt">

<property name="template" value="file:///some/resource/path/myTemplate.txt"/>

如果该类被重构为与注释驱动的配置一起使用，则 path to 可以存储在名为 — 例如，在提供给 Spring 的属性文件中（参见 Environment Abstraction）。然后，可以使用属性占位符通过批注引用模板路径（请参阅使用@Value）。Spring会以字符串形式检索模板路径的值，并带有特殊遗嘱将字符串转换为要注入到构造函数中的对象。下面的示例演示了如何实现此目的。MyBeanmyTemplate.txttemplate.pathEnvironment@ValuePropertyEditorResourceMyBeanSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

@Component
public class MyBean {

	private final Resource template;

	public MyBean(@Value("${template.path}") Resource template) {
		this.template = template;
	}

	// ...
}

@Component
class MyBean(@Value("\${template.path}") private val template: Resource)

如果我们想支持在同一路径下发现的多个模板类路径中的位置（例如，类路径中的多个 jar 中）我们可以使用特殊前缀和通配符将键定义为。如果我们按如下方式重新定义类， Spring 会将模板路径模式转换为一个对象数组，这些对象可以注入到构造函数中。classpath*:templates.pathclasspath*:/config/templates/*.txtMyBeanResourceMyBeanSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

@Component
public class MyBean {

	private final Resource[] templates;

	public MyBean(@Value("${templates.path}") Resource[] templates) {
		this.templates = templates;
	}

	// ...
}

@Component
class MyBean(@Value("\${templates.path}") private val templates: Resource[])

应用程序上下文和资源路径

本节介绍如何使用资源（包括快捷方式）创建应用程序上下文适用于 XML、如何使用通配符和其他详细信息。Spring中文文档

构建应用程序上下文

应用程序上下文构造函数（对于特定的应用程序上下文类型）将字符串或字符串数组作为资源的位置路径，例如构成上下文定义的 XML 文件。Spring中文文档

当这样的位置路径没有前缀时，从中构建的特定类型该路径并用于加载 Bean 定义取决于并适用于特定的应用程序上下文。例如，请考虑以下示例，该示例将创建一个：ResourceClassPathXmlApplicationContextSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx = new ClassPathXmlApplicationContext("conf/appContext.xml");

val ctx = ClassPathXmlApplicationContext("conf/appContext.xml")

Bean 定义是从类路径加载的，因为使用。但是，请考虑以下示例，该示例将创建一个：ClassPathResourceFileSystemXmlApplicationContextSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx =
	new FileSystemXmlApplicationContext("conf/appContext.xml");

val ctx = FileSystemXmlApplicationContext("conf/appContext.xml")

现在，Bean 定义是从文件系统位置加载的（在本例中，相对于当前工作目录）。Spring中文文档

请注意，在位置路径覆盖为加载 Bean 而创建的缺省类型定义。请看以下示例：classpathResourceSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx =
	new FileSystemXmlApplicationContext("classpath:conf/appContext.xml");

val ctx = FileSystemXmlApplicationContext("classpath:conf/appContext.xml")

using 从类路径加载 Bean 定义。但是，它仍然是一个.如果它随后被用作，则任何不带前缀的路径仍被视为文件系统路径。FileSystemXmlApplicationContextFileSystemXmlApplicationContextResourceLoaderSpring中文文档

构造实例 — 快捷方式`ClassPathXmlApplicationContext`

公开了许多构造函数，以启用方便的实例化。其基本思想是，您可以只提供一个字符串数组仅包含 XML 文件本身的文件名（不带前导路径）信息），并提供 .然后派生所提供类中的路径信息。ClassPathXmlApplicationContextClassClassPathXmlApplicationContextSpring中文文档

请考虑以下目录布局：Spring中文文档

com/
  example/
    services.xml
    repositories.xml
    MessengerService.class

以下示例演示了以下实例如何由在名为和（ classpath）可以实例化：ClassPathXmlApplicationContextservices.xmlrepositories.xmlSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx = new ClassPathXmlApplicationContext(
	new String[] {"services.xml", "repositories.xml"}, MessengerService.class);

val ctx = ClassPathXmlApplicationContext(arrayOf("services.xml", "repositories.xml"), MessengerService::class.java)

有关各种构造函数的详细信息，请参阅 ClassPathXmlApplicationContext javadoc。Spring中文文档

应用程序上下文构造函数资源路径中的通配符

应用程序上下文构造函数值中的资源路径可以是简单路径（如如前所示），其中每个都具有与目标的一对一映射，或者，或者，可以包含特殊前缀或内部 Ant 样式的模式（使用 Spring 的实用程序进行匹配）。后者都是有效的通配符。Resourceclasspath*:PathMatcherSpring中文文档

此机制的一个用途是当您需要执行组件样式的应用程序组装时。都组件可以将上下文定义片段发布到已知位置路径，并且当使用以为前缀的相同路径创建最终应用程序上下文时，将自动拾取所有组件片段。classpath*:Spring中文文档

请注意，此通配符特定于应用程序上下文中资源路径的使用构造函数（或者直接使用实用程序类层次结构时）和 is 在施工时解决。它与类型本身无关。不能使用前缀构造实际的，因为一个资源一次只指向一个资源。PathMatcherResourceclasspath*:ResourceSpring中文文档

蚂蚁风格的图案

路径位置可以包含 Ant 样式的模式，如以下示例所示：Spring中文文档

/WEB-INF/*-context.xml
com/mycompany/**/applicationContext.xml
file:C:/some/path/*-context.xml
classpath:com/mycompany/**/applicationContext.xml

当路径位置包含 Ant 样式模式时，解析器将遵循更复杂的模式尝试解析通配符的过程。它为路径生成一个最后一个非通配符段，并从中获取 URL。如果此 URL 不是 URL，或者特定于容器的变体（例如在 WebLogic、WebSphere 等中）， a 是从中获取的，用于通过遍历文件系统。对于 jar URL，解析器要么从中获取 a，要么手动解析 jar URL，然后遍历用于解析通配符的 JAR 文件的内容。Resourcejar:zip:wsjarjava.io.Filejava.net.JarURLConnectionSpring中文文档

对可移植性的影响

如果指定的路径已经是 URL（隐式地，因为基是文件系统 URL 或显式），则保证通配符以完全便携的方式工作。fileResourceLoaderSpring中文文档

如果指定的路径是位置，则解析器必须获取最后一个通过拨打非通配符路径段 URL。由于这个只是路径的一个节点（不是末尾的文件），实际上（在 javadoc 中）在这种情况下返回什么样的 URL 是未定义的。在实践中，它始终是一个表示目录（其中类路径资源解析为文件系统位置）或某种 jar URL（其中类路径资源解析为 jar 位置）。尽管如此，此操作仍存在可移植性问题。classpathClassloader.getResource()ClassLoaderjava.io.FileSpring中文文档

如果获取了最后一个非通配符段的 jar URL，则解析器必须能够从中获取或手动解析 jar URL，以便能够遍历 jar 的内容并解析通配符。这在大多数环境中都有效但在其他情况下失败，我们强烈建议对资源进行通配符解析来自罐子在你依赖它之前，要在你的特定环境中进行彻底的测试。java.net.JarURLConnectionSpring中文文档

前缀`classpath*:`

在构造基于 XML 的应用程序上下文时，位置字符串可以使用特殊前缀，如以下示例所示：classpath*:Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx =
	new ClassPathXmlApplicationContext("classpath*:conf/appContext.xml");

val ctx = ClassPathXmlApplicationContext("classpath*:conf/appContext.xml")

此特殊前缀指定与给定名称匹配的所有类路径资源必须获得（在内部，这基本上是通过调用）然后合并以形成最终应用程序上下文定义。ClassLoader.getResources(…)Spring中文文档

通配符类路径依赖于基础 .由于现在大多数应用程序服务器都提供自己的实现，因此行为可能会有所不同，尤其是在处理 jar 文件时。一个检查是否有效的简单测试是使用从在类路径上的 jar 中：.尝试此测试具有相同名称但位于两个不同位置的文件（例如，文件）具有相同的名称和相同的路径，但在类路径上的不同 jar 中。如果返回不适当的结果，请查看应用程序服务器文档的设置这可能会影响行为。getResources()ClassLoaderClassLoaderclasspath*ClassLoadergetClass().getClassLoader().getResources("<someFileInsideTheJar>")ClassLoader

您还可以将前缀与位置路径的其余部分（例如，）。在这个案例，解决策略相当简单：调用是用于最后一个非通配符路径段，以获取类加载器层次结构，然后，关闭每个资源，相同的分辨率前面描述的策略用于通配符子路径。classpath*:PathMatcherclasspath*:META-INF/*-beans.xmlClassLoader.getResources()PathMatcherSpring中文文档

与通配符有关的其他说明

请注意，当与 Ant 样式模式结合使用时，仅有效在模式开始之前，至少有一个根目录，除非实际目标文件驻留在文件系统中。这意味着这样的模式可能不会从 jar 文件的根目录中检索文件，而只能从 jar 文件的根目录中检索文件从扩展目录的根目录。classpath*:classpath*:*.xmlSpring中文文档

Spring 检索类路径条目的能力源于 JDK 的方法，该方法仅返回空字符串（指示要搜索的潜在根）。Spring 评估 jar 文件中的运行时配置和清单也是如此，但这并不能保证会导致可移植行为。ClassLoader.getResources()URLClassLoaderjava.class.pathSpring中文文档

类路径包的扫描需要存在相应的目录类路径中的条目。使用 Ant 构建 JAR 时，不要激活 JAR 任务的 Switch。此外，基于安全性，类路径目录可能不会公开某些环境中的策略 — 例如，JDK 1.7.0_45 上的独立应用程序及更高版本（这需要在清单中设置“Trusted-Library”。见 stackoverflow.com/questions/19394570/java-jre-7u45-breaks-classloader-getresources）。files-onlySpring中文文档

在 JDK 9 的模块路径（Jigsaw）上，Spring 的类路径扫描通常按预期工作。在这里，也强烈建议将资源放入专用目录中，通过搜索 JAR 文件根级别避免了上述可移植性问题。Spring中文文档

带有资源的蚂蚁式模式不保证找到匹配项资源（如果要搜索的根包在多个类路径位置可用）。请考虑以下资源位置示例：classpath:Spring中文文档

com/mycompany/package1/service-context.xml

现在考虑一个 Ant 样式的路径，有人可能会用它来尝试查找该文件：Spring中文文档

classpath:com/mycompany/**/service-context.xml

这样的资源可能只存在于类路径中的一个位置，但是当路径如前面的示例用于尝试解决它，解析器将（第一个）返回的 URL。如果此基础包节点存在于多个位置，所需的资源可能不存在第一个位置找到位置。因此，在这种情况下，您应该更愿意使用相同的 Ant 样式模式，它搜索包含基本包的所有类路径位置： .getResource("com/mycompany");ClassLoaderclasspath*:com.mycompanyclasspath*:com/mycompany/**/service-context.xmlSpring中文文档

`FileSystemResource`警告

未附加到 a 的 A （that 是，当 a 不是实际的）处理时绝对路径和相对路径，如您所料。相对路径相对于当前工作目录，而绝对路径是相对于文件系统。FileSystemResourceFileSystemApplicationContextFileSystemApplicationContextResourceLoaderSpring中文文档

但是，由于向后兼容性（历史）原因，当为 .强制所有附加的实例将所有位置路径视为相对路径，无论它们是否以前导斜杠开头。在实践中，这意味着以下示例是等效的：FileSystemApplicationContextResourceLoaderFileSystemApplicationContextFileSystemResourceSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx =
	new FileSystemXmlApplicationContext("conf/context.xml");

val ctx = FileSystemXmlApplicationContext("conf/context.xml")

JavaSpring中文文档
KotlinSpring中文文档

ApplicationContext ctx =
	new FileSystemXmlApplicationContext("/conf/context.xml");

val ctx = FileSystemXmlApplicationContext("/conf/context.xml")

以下示例也是等效的（即使它们不同是有意义的，作为一个大小写是相对的，另一个是绝对的）：Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

FileSystemXmlApplicationContext ctx = ...;
ctx.getResource("some/resource/path/myTemplate.txt");

val ctx: FileSystemXmlApplicationContext = ...
ctx.getResource("some/resource/path/myTemplate.txt")

JavaSpring中文文档
KotlinSpring中文文档

FileSystemXmlApplicationContext ctx = ...;
ctx.getResource("/some/resource/path/myTemplate.txt");

val ctx: FileSystemXmlApplicationContext = ...
ctx.getResource("/some/resource/path/myTemplate.txt")

在实践中，如果您需要真正的绝对文件系统路径，则应避免使用具有或和的绝对路径使用 URL 前缀强制使用 a。以下示例演示如何操作：FileSystemResourceFileSystemXmlApplicationContextUrlResourcefile:Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

// actual context type doesn't matter, the Resource will always be UrlResource
ctx.getResource("file:///some/resource/path/myTemplate.txt");

// actual context type doesn't matter, the Resource will always be UrlResource
ctx.getResource("file:///some/resource/path/myTemplate.txt")

JavaSpring中文文档
KotlinSpring中文文档

// force this FileSystemXmlApplicationContext to load its definition via a UrlResource
ApplicationContext ctx =
	new FileSystemXmlApplicationContext("file:///conf/context.xml");

// force this FileSystemXmlApplicationContext to load its definition via a UrlResource
val ctx = FileSystemXmlApplicationContext("file:///conf/context.xml")

介绍

界面Resource

内置实现Resource

UrlResource

ClassPathResource

FileSystemResource

PathResource

ServletContextResource

InputStreamResource

ByteArrayResource

界面ResourceLoader

界面ResourcePatternResolver

界面ResourceLoaderAware