此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Framework 6.2.0！spring-doc.cadn.net.cn

资源

介绍

Java 的标准java.net.URL类和标准处理程序，用于各种 URL 前缀， 不幸的是，对于所有对低级资源的访问来说，这还不够。为 示例，则没有标准化的URL可用于访问 需要从 Classpath 获取的 Resource 或相对于ServletContext.虽然可以为 specialized 注册新的处理程序URL前缀（类似于http:），这通常是 相当复杂，而URL界面仍然缺乏一些理想的功能， 例如，用于检查所指向的资源是否存在的方法。spring-doc.cadn.net.cn

这Resource接口

Spring的Resource界面位于org.springframework.core.io.package 是 旨在成为对低级资源的抽象访问的更强大的接口。这 以下清单概述了Resource接口。请参阅Resourcejavadoc 了解更多详情。spring-doc.cadn.net.cn

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

作为Resourceinterface 显示，它扩展了InputStreamSource接口。下面的清单显示了InputStreamSource接口：spring-doc.cadn.net.cn

public interface InputStreamSource {

	InputStream getInputStream() throws IOException;
}

中Resource接口是：spring-doc.cadn.net.cn

  • getInputStream()：查找并打开资源，返回InputStream为 从资源中读取。预计每次调用都会返回一个全新的InputStream.调用方负责关闭流。spring-doc.cadn.net.cn

  • exists()：返回boolean指示此资源是否实际存在于 物理形式。spring-doc.cadn.net.cn

  • isOpen()：返回boolean指示此资源是否表示句柄 与开放的流。如果true这InputStream无法多次读取，并且 必须只读取一次，然后关闭以避免资源泄漏。返回false为 所有常用的资源实现，除了InputStreamResource.spring-doc.cadn.net.cn

  • getDescription()：返回此资源的说明，用于错误 output 来执行。这通常是完全限定的文件名或 资源的实际 URL。spring-doc.cadn.net.cn

其他方法允许您获取实际的URL或File对象表示 资源（如果底层实现兼容并支持 功能）。spring-doc.cadn.net.cn

某些Resource接口还实现了扩展的WritableResource接口 对于支持写入它的资源。spring-doc.cadn.net.cn

Spring 本身使用Resourceabstraction 中，作为 需要资源时有许多方法签名。某些 Spring API 中的其他方法 （例如各种ApplicationContextimplementations） 采用String它以未经修饰或简单的形式用于创建Resource适合于 该上下文实现，或者通过Stringpath 中，让 caller 指定特定的Resource必须创建和使用 implementation。spring-doc.cadn.net.cn

虽然Resourceinterface 在 Spring 中被大量使用，而 Spring 实际上是 非常方便，可以在您自己的代码中单独用作通用工具类，以便访问 添加到资源中，即使您的代码不知道或不关心 Spring 的任何其他部分。 虽然这会将您的代码耦合到 Spring，但它实际上只将其耦合到这一小群 实用程序类，它可以作为URL并且可以是 被认为等同于您用于此目的的任何其他库。spring-doc.cadn.net.cn

这Resourceabstraction 不会取代 functionality。它将其包装在 可能。例如，UrlResource包装 URL 并使用包装的URL来执行其 工作。

内置Resource实现

Spring 包含几个内置的Resource实现：spring-doc.cadn.net.cn

有关Resource实现，请参阅 “All Known Implementing Classes” 部分的Resourcejavadoc 的spring-doc.cadn.net.cn

UrlResource

UrlResource将java.net.URL，并可用于访问任何对象 通常可通过 URL（例如文件、HTTPS 目标、FTP 目标）以及 URL 访问 别人。所有 URL 都有一个标准化的String表示形式，以便适当的 标准化前缀用于指示一种 URL 类型与另一种 URL 类型。这包括file:用于访问文件系统路径，https:通过 HTTPS 协议 /ftp:用于通过 FTP 访问资源等。spring-doc.cadn.net.cn

一个UrlResource由 Java 代码显式使用UrlResource构造 函数 但通常在调用采用String参数来表示路径。对于后一种情况，JavaBeansPropertyEditor最终决定哪种类型的Resource以创建。如果路径字符串包含 众所周知的（即属性编辑器）前缀（例如classpath:），它会创建一个 适当的专业Resource对于该前缀。但是，如果它无法识别 前缀，则假定该字符串是标准 URL 字符串，并创建一个UrlResource.spring-doc.cadn.net.cn

ClassPathResource

此类表示应从 Classpath 获取的资源。它使用 线程上下文类加载器、给定类加载器或 loading resources.spring-doc.cadn.net.cn

这Resourceimplementation 支持将解析作为java.io.File如果类路径 资源驻留在文件系统中，但不适用于驻留在 jar 中，并且尚未扩展（通过 servlet 引擎或任何环境） 添加到文件系统中。为了解决这个问题，各种Resourceimplementations 始终支持 resolution 作为java.net.URL.spring-doc.cadn.net.cn

一个ClassPathResource由 Java 代码显式使用ClassPathResource构造函数，但通常在调用采用String参数来表示路径。对于后一种情况，JavaBeansPropertyEditor识别特殊前缀classpath:、字符串路径和 创建一个ClassPathResource在那种情况下。spring-doc.cadn.net.cn

FileSystemResource

这是一个Resourceimplementation forjava.io.File处理。它还支持java.nio.file.Pathhandles， 应用 Spring 的标准基于 String 的路径 转换，但通过java.nio.file.Files应用程序接口。对于纯java.nio.path.Path基于支持使用PathResource相反。FileSystemResource支持分辨率作为File和URL.spring-doc.cadn.net.cn

PathResource

这是一个Resourceimplementation forjava.nio.file.Path手柄， 执行所有 作和转换通过Path应用程序接口。它支持将分辨率解析为File和 作为URL并且还实现了扩展的WritableResource接口。PathResource实际上是纯粹的java.nio.path.Pathbased 替代项FileSystemResource跟 不同createRelative行为。spring-doc.cadn.net.cn

ServletContextResource

这是一个Resourceimplementation forServletContext解释 相关 Web 应用程序根目录中的相对路径。spring-doc.cadn.net.cn

它始终支持流访问和 URL 访问，但允许java.io.File仅限访问 当 Web 应用程序存档扩展并且资源物理位于 文件系统。无论它是否被扩展、在文件系统上或被访问 直接从 JAR 或其他位置（如数据库）实际上是 依赖于 Servlet 容器。spring-doc.cadn.net.cn

InputStreamResource

一InputStreamResource是一个Resourceimplementation for a givenInputStream.它 应仅在没有特定的Resourceimplementation 是适用的。在 特别，更喜欢ByteArrayResource或任何基于文件的Resourceimplementation 的 Implementations 中。spring-doc.cadn.net.cn

与其他Resourceimplementations，这是 已打开的资源。因此，它返回true从isOpen().如果出现以下情况，请勿使用 您需要将资源描述符保留在某个位置，或者如果您需要读取流 多次。spring-doc.cadn.net.cn

ByteArrayResource

这是一个Resource实现。它会创建一个ByteArrayInputStream对于给定的字节数组。spring-doc.cadn.net.cn

它对于从任何给定的字节数组加载内容非常有用，而不必求助于 一次性使用InputStreamResource.spring-doc.cadn.net.cn

这ResourceLoader接口

这ResourceLoaderinterface 的 API 是由可以返回 （即 load）Resource实例。下面的清单显示了ResourceLoader接口定义：spring-doc.cadn.net.cn

public interface ResourceLoader {

	Resource getResource(String location);

	ClassLoader getClassLoader();
}

所有应用程序上下文都实现ResourceLoader接口。因此，所有 应用程序上下文可用于获取Resource实例。spring-doc.cadn.net.cn

当您调用getResource()在特定的应用程序上下文中，以及位置路径 specified 没有特定的前缀，则会返回一个Resourcetype （即 适合该特定应用程序上下文。例如，假设以下内容 代码段针对ClassPathXmlApplicationContext实例：spring-doc.cadn.net.cn

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

针对ClassPathXmlApplicationContext，该代码会返回一个ClassPathResource.如果 对FileSystemXmlApplicationContext实例，它将 返回一个FileSystemResource.对于WebApplicationContext，它将返回一个ServletContextResource.它同样会为每个上下文返回适当的对象。spring-doc.cadn.net.cn

因此，您可以以适合特定应用程序的方式加载资源 上下文。spring-doc.cadn.net.cn

另一方面，您也可以强制ClassPathResource，无论 application context 类型，通过指定特殊的classpath:前缀，如下所示 示例显示：spring-doc.cadn.net.cn

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

同样，您可以强制UrlResource通过指定任何标准java.net.URL前缀。以下示例使用file和https前缀：spring-doc.cadn.net.cn

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

下表总结了转换策略String对象设置为Resource对象：spring-doc.cadn.net.cn

表 1.资源字符串
前缀 例 解释

类路径：spring-doc.cadn.net.cn

classpath:com/myapp/config.xmlspring-doc.cadn.net.cn

从 Classpath 加载。spring-doc.cadn.net.cn

文件：spring-doc.cadn.net.cn

file:///data/config.xmlspring-doc.cadn.net.cn

加载为URL从文件系统。另请参阅FileSystemResource警告.spring-doc.cadn.net.cn

https 的 URL 中：spring-doc.cadn.net.cn

https://myserver/logo.pngspring-doc.cadn.net.cn

加载为URL.spring-doc.cadn.net.cn

（无）spring-doc.cadn.net.cn

/data/config.xmlspring-doc.cadn.net.cn

取决于底层ApplicationContext.spring-doc.cadn.net.cn

这ResourcePatternResolver接口

这ResourcePatternResolverinterface 是ResourceLoader接口 ，它定义了解析位置模式（例如，Ant 样式路径 pattern） 转换为Resource对象。spring-doc.cadn.net.cn

public interface ResourcePatternResolver extends ResourceLoader {

	String CLASSPATH_ALL_URL_PREFIX = "classpath*:";

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

从上面可以看出，这个接口还定义了一个特殊的classpath*:资源前缀 对于类路径中的所有匹配资源。请注意，资源位置为 在本例中，预期为没有占位符的 path — 例如classpath*:/config/beans.xml.JAR 文件或类路径中的不同目录可以 包含多个具有相同路径和名称的文件。有关更多详细信息，请参阅 Application Context Constructor Resource Paths 及其子部分中的通配符 on 通配符支持与classpath*:resource 前缀。spring-doc.cadn.net.cn

传入的ResourceLoader（例如，通过ResourceLoaderAwaresemantics）可以检查 它也实现了这个扩展接口。spring-doc.cadn.net.cn

PathMatchingResourcePatternResolver是可用的独立实现 在ApplicationContext，也被ResourceArrayPropertyEditor为 填充Resource[]bean 属性。PathMatchingResourcePatternResolver能够 将指定的资源位置路径解析为一个或多个匹配项Resource对象。 源路径可以是一个简单的路径，该路径具有与目标的一对一映射Resource，或者可能包含特殊的classpath*:前缀和/或内部 Ant 样式的正则表达式（使用 Spring 的org.springframework.util.AntPathMatcher实用程序）。后者两者都是有效的 通配符。spring-doc.cadn.net.cn

默认的ResourceLoader在任何标准ApplicationContext实际上是一个实例 之PathMatchingResourcePatternResolver它实现了ResourcePatternResolver接口。对于ApplicationContext实例本身，它也 实现ResourcePatternResolver接口并委托给默认的PathMatchingResourcePatternResolver.spring-doc.cadn.net.cn

这ResourceLoaderAware接口

这ResourceLoaderAwareinterface 是一个特殊的回调接口，用于标识 组件，这些组件希望提供ResourceLoader参考。以下清单 显示了ResourceLoaderAware接口：spring-doc.cadn.net.cn

public interface ResourceLoaderAware {

	void setResourceLoader(ResourceLoader resourceLoader);
}

当类实现ResourceLoaderAware并部署到应用程序上下文中 （作为 Spring 管理的 bean），它被识别为ResourceLoaderAware按应用程序 上下文。然后，应用程序上下文调用setResourceLoader(ResourceLoader), 将自身作为参数提供（请记住，Spring 中的所有应用程序上下文都实现了 这ResourceLoader接口）。spring-doc.cadn.net.cn

由于ApplicationContext是一个ResourceLoader，该 bean 还可以实现ApplicationContextAware接口，并使用提供的 Application Context 直接 load 资源。但是，一般来说，最好使用专用的ResourceLoader界面。该代码将仅与资源加载耦合 interface（可以认为是一个 Util 接口），而不是整个 SpringApplicationContext接口。spring-doc.cadn.net.cn

在应用程序组件中，您还可以依赖ResourceLoader如 实现ResourceLoaderAware接口。传统的 constructor和byType自动装配模式（如 自动装配协作者中所述） 能够提供ResourceLoader对于构造函数参数或 setter 方法参数。为了获得更大的灵活性（包括 autowire fields 和多个参数方法），请考虑使用基于注释的 自动装配功能。在这种情况下，ResourceLoader自动连接到字段， constructor 参数或方法参数，该参数需要ResourceLoadertype 作为 long 由于有问题的字段、构造函数或方法带有@Autowired注解。 有关更多信息，请参阅用@Autowired.spring-doc.cadn.net.cn

加载一个或多个Resource包含通配符的资源路径的 objects 或使用特殊的classpath*:资源前缀，请考虑使用ResourcePatternResolver自动连接到您的 应用程序组件，而不是ResourceLoader.

作为依赖项的资源

如果 Bean 本身将通过某种排序来确定和提供资源路径 的 Bean 使用ResourceLoader或ResourcePatternResolverinterface 加载资源。例如，考虑 loading 中，所需的特定资源取决于 用户的角色。如果资源是静态的，则消除对ResourceLoader接口（或ResourcePatternResolver接口）完全具有 bean 公开了Resource属性，并期望它们被注入其中。spring-doc.cadn.net.cn

然后注入这些属性变得微不足道的是，所有应用程序上下文 注册并使用特殊的 JavaBeansPropertyEditor，它可以将String路径 自Resource对象。例如，以下MyBean类具有templatetype 为Resource.spring-doc.cadn.net.cn

public class MyBean {

	private Resource template;

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

	// ...
}
class MyBean(var template: Resource)

在 XML 配置文件中，template属性可以使用简单的 string 的 String，如下例所示：spring-doc.cadn.net.cn

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

请注意，资源路径没有前缀。因此，由于应用程序上下文 本身将用作ResourceLoader，资源将通过ClassPathResource一个FileSystemResource或ServletContextResource根据 应用程序上下文的确切类型。spring-doc.cadn.net.cn

如果您需要强制使用特定的Resourcetype，可以使用前缀。这 以下两个示例展示了如何强制ClassPathResource以及UrlResource（ 后者用于访问文件系统中的文件）：spring-doc.cadn.net.cn

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

如果MyBean类被重构以用于注解驱动的配置， 路径myTemplate.txt可以存储在名为template.path— 例如， 在 Spring 可用的属性文件中Environment（请参阅 Environment Abstraction）。然后，可以通过@Value使用属性占位符的注释（请参阅用@Value).Spring会 将模板路径的值检索为字符串，并将PropertyEditor将 将字符串转换为Resource对象注入到MyBean构造 函数。 以下示例演示了如何实现此目的。spring-doc.cadn.net.cn

@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)

如果我们想支持在多个 位置 — 例如，在 Classpath 的多个 jar 中 — 我们可以 使用特殊的classpath*:前缀和通配符来定义templates.pathkey 指定为classpath*:/config/templates/*.txt.如果我们重新定义MyBean类，如下所示， Spring 会将模板路径模式转换为Resource对象 可以注射到MyBean构造 函数。spring-doc.cadn.net.cn

@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-doc.cadn.net.cn

构造应用程序上下文

应用程序上下文构造函数（针对特定的应用程序上下文类型） 将字符串或字符串数组作为资源的位置路径，例如 构成上下文定义的 XML 文件。spring-doc.cadn.net.cn

当此类位置路径没有前缀时，特定的Resource类型构建自 该路径 和 用于加载 bean 定义的路径取决于 并且适合于 特定的应用程序上下文。例如，请考虑以下示例，该示例会创建一个ClassPathXmlApplicationContext:spring-doc.cadn.net.cn

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

bean 定义是从 classpath 加载的，因为ClassPathResource是 使用。但是，请考虑以下示例，该示例会创建一个FileSystemXmlApplicationContext:spring-doc.cadn.net.cn

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

现在，bean 定义是从文件系统位置加载的（在本例中，相对于 当前工作目录）。spring-doc.cadn.net.cn

请注意，使用特殊的classpath前缀或标准 URL 前缀 location path 会覆盖默认类型Resourcecreated 以加载 bean 定义。请考虑以下示例：spring-doc.cadn.net.cn

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

用FileSystemXmlApplicationContext从 Classpath 中加载 bean 定义。 但是，它仍然是一个FileSystemXmlApplicationContext.如果它随后被用作ResourceLoader，则任何无前缀的路径仍被视为文件系统路径。spring-doc.cadn.net.cn

构建ClassPathXmlApplicationContext实例 — 快捷方式

这ClassPathXmlApplicationContext公开了许多构造函数以启用 方便的实例化。基本思想是，您可以只提供一个字符串数组 ，仅包含 XML 文件本身的文件名（没有前导路径 信息），并提供Class.这ClassPathXmlApplicationContext然后派生 来自提供的类的路径信息。spring-doc.cadn.net.cn

请考虑以下目录布局：spring-doc.cadn.net.cn

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

以下示例显示了ClassPathXmlApplicationContext实例由 在名为services.xml和repositories.xml（位于 classpath） 可以实例化：spring-doc.cadn.net.cn

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

请参阅ClassPathXmlApplicationContextjavadoc 了解有关各种构造函数的详细信息。spring-doc.cadn.net.cn

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

应用程序上下文构造函数值中的资源路径可以是简单路径（如 前面所示），每个 API 都有一个到目标的一对一映射Resource或 或者，可能包含特殊的classpath*:前缀或内部 Ant 样式模式 （使用 Spring 的PathMatcher实用程序）。后者两者都是有效的 通配符。spring-doc.cadn.net.cn

此机制的一个用途是当您需要执行组件样式的应用程序组装时。都 组件可以将上下文定义片段发布到已知的位置路径，并且 当使用前缀为classpath*:，则会自动选取所有组件片段。spring-doc.cadn.net.cn

请注意，此通配符特定于应用程序上下文中资源路径的使用 构造函数（或者当您使用PathMatcherUtility 类层次结构），并且是 在构建时解决。它与Resource键入自身。 您不能使用classpath*:前缀来构造实际的Resource如 一个资源一次只指向一个资源。spring-doc.cadn.net.cn

Ant-style 模式

路径位置可以包含 Ant 样式模式，如下例所示：spring-doc.cadn.net.cn

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

当路径位置包含 Ant 样式模式时，解析程序遵循更复杂的 过程以尝试解析通配符。它生成一个Resource对于到 last 非通配符段并从中获取 URL。如果此 URL 不是jar:URL 或 特定于容器的变体（例如zip:在 WebLogic 中，wsjar在 WebSphere 中，依此类推）， 一个java.io.File从中获取，并用于通过遍历 文件系统。对于 jar URL，解析器要么获得java.net.JarURLConnection或手动解析 jar URL，然后遍历 内容解析通配符。spring-doc.cadn.net.cn

对可移植性的影响

如果指定的路径已经是fileURL（要么隐式，因为 baseResourceLoader是文件系统 One 或显式的），则通配符保证为 以完全便携的方式工作。spring-doc.cadn.net.cn

如果指定的路径是classpathlocation，则解析程序必须获取最后一个 非通配符路径段 URL，方法是将Classloader.getResource()叫。由于这个 只是路径的一个节点（不是末尾的文件），它实际上是 undefined 的（在ClassLoaderjavadoc） 中返回的 URL 类型。在实践中， 它始终是一个java.io.File表示目录（其中 Classpath 资源 解析为文件系统位置）或某种类型的 jar URL（其中 Classpath 资源 解析为 jar 位置）。尽管如此，此作仍然存在可移植性问题。spring-doc.cadn.net.cn

如果获取了最后一个非通配符段的 jar URL，则解析程序必须能够 获取java.net.JarURLConnection或手动解析 jar URL，以便能够 遍历 jar 的内容并解析通配符。这在大多数环境中都有效 但在其他 API 中失败，我们强烈建议 resources 的通配符解析 来自 jars 在您依赖它之前，请在您的特定环境中对其进行全面测试。spring-doc.cadn.net.cn

这classpath*:前缀

在构建基于 XML 的应用程序上下文时，位置字符串可以使用 特殊classpath*:前缀，如下例所示：spring-doc.cadn.net.cn

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

此特殊前缀指定与给定名称匹配的所有 Classpath 资源 必须获取（在内部，这基本上是通过调用ClassLoader.getResources(…​)），然后合并形成最终应用程序 context 定义。spring-doc.cadn.net.cn

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

您还可以将classpath*:前缀替换为PathMatcherpattern 中 位置路径的其余部分（例如classpath*:META-INF/*-beans.xml).在这个 的情况下，解决策略相当简单：AClassLoader.getResources()call 为 用于获取 类加载器层次结构，然后从每个资源中，相同的PathMatcher分辨率 前面描述的策略用于通配符子路径。spring-doc.cadn.net.cn

与通配符相关的其他说明

请注意，classpath*:，当与 Ant 样式模式结合使用时，仅有效 可靠地使用至少一个根目录，除非实际的 目标文件驻留在文件系统中。这意味着classpath*:*.xml可能不会从 jar 文件的根目录中检索文件，而只能检索 从扩展目录的根目录。spring-doc.cadn.net.cn

Spring 检索 Classpath 条目的能力源自 JDK 的ClassLoader.getResources()方法，该方法仅返回 空字符串（指示要搜索的潜在根）。Spring 计算URLClassLoader运行时配置和java.class.path在 jar 文件中的清单 ，但不能保证这会导致可移植行为。spring-doc.cadn.net.cn

扫描 classpath 包需要存在相应的目录 条目。使用 Ant 构建 JAR 时，请勿激活files-onlyswitch 的 jar 任务。此外，Classpath 目录可能不会根据安全性公开 某些环境中的策略 — 例如，JDK 1.7.0_45 上的独立应用程序 和更高级别（这需要在您的清单中设置 'Trusted-Library'）。请参阅 stackoverflow.com/questions/19394570/java-jre-7u45-breaks-classloader-getresources）。spring-doc.cadn.net.cn

在模块路径（Java Module System）上，Spring 的类路径扫描通常工作为 预期。在这里，强烈建议将资源放入专用目录， 避免了上述搜索 jar 文件根级别的可移植性问题。spring-doc.cadn.net.cn

Ant 样式的模式，其中classpath:不保证 resources 能找到匹配项 resources（如果要搜索的根包在多个 Classpath 位置中可用）。 请考虑以下资源位置示例：spring-doc.cadn.net.cn

com/mycompany/package1/service-context.xml

现在考虑一个 Ant 样式的路径，有人可能会使用它来尝试查找该文件：spring-doc.cadn.net.cn

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

这样的资源可能只存在于 Classpath 中的一个位置，但是当 前面的示例用于尝试解决它，解析器在（第一个） 返回的 URLgetResource("com/mycompany");.如果此基础包节点存在于 倍数ClassLoaderlocations 中，所需的资源可能不存在于第一个 找到位置。因此，在这种情况下，您应该更喜欢使用classpath*:使用 相同的 Ant 样式模式，它搜索包含com.mycompany基础包：classpath*:com/mycompany/**/service-context.xml.spring-doc.cadn.net.cn

FileSystemResource警告

一个FileSystemResource未附加到FileSystemApplicationContext（那个 是，当FileSystemApplicationContext不是实际的ResourceLoader） 治疗 绝对路径和相对路径。相对路径是相对于 当前工作目录，而绝对路径是相对于 文件系统。spring-doc.cadn.net.cn

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

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

以下示例也是等效的（即使它们不同是有意义的，但作为一个 case 是相对的，另一个是绝对的）：spring-doc.cadn.net.cn

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

在实践中，如果你需要真正的绝对文件系统路径，你应该避免使用 绝对路径FileSystemResource或FileSystemXmlApplicationContext和 强制使用UrlResource通过使用file:URL 前缀。以下示例 演示如何执行此作：spring-doc.cadn.net.cn

// 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")
// 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")