在应用 Spring 的工程中,使用 class path 的方式加载配置文件应该是最常用的做法,然而对大部分人来说,刚开始使用 Spring 时,几乎都碰到过加载配置文件失败的情况,除了配置上的错误外,很多时候是因为配置文件的路径和程序中指定的加载路径不一致,从而导致配置文件找不到,或是加载了错误地方的配置文件。本文将就 Spring 如何从 class path 中加载配置文件做一些简要的分析。
情形一:使用 classpath 加载且不含通配符
这是最简单的情形, Spring 默认会使用当前线程的 ClassLoader 的 getResource 方法获取资源的 URL ,如果无法获得当前线程的 ClassLoader , Spring 将使用加载类 org.springframework.util.ClassUtils 的 ClassLoader 。
1. 当工程目录结构如图所示 :

即配置文件放在 bin 目录中的 conf 文件夹里,这时使用
ApplicationContext context =
new ClassPathXmlApplicationContext("conf/application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 将加载 bin/conf 目录下的 application-context.xml 文件。 Spring 启动时的输出显示为:
Loading XML bean definitions from
class path resource [conf/application-context.xml]
这时使用
ApplicationContext context =
new ClassPathXmlApplicationContext("conf/application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 将加载 conf.jar 文件中 conf 目录下的 application-context.xml 文件。 Spring 启动时的输出显示为:
Loading XML bean definitions from
class path resource [conf/application-context.xml]

这时使用
ApplicationContext context =
new ClassPathXmlApplicationContext("conf/application-context.xml"); 来创建 ApplicationContext 对象的话,由于没有使用 classpath* 前缀, Spring 只会加载一个 application-context.xml 文件。在 eclipse 中将会加载 bin/conf 目录下的 application-context.xml 文件,而 jar 包中的 conf/application-context.xml 并不会被加载, Spring 启动时的输出显示为:
Loading XML bean definitions from
情形二:使用 classpath 加载,包含通配符
碰到通配符的情况时, Spring 会通过使用路径中的非通配符部分先确定资源的大致位置,然后根据这个位置在确定具体的资源位置,结合下面给出的几种情况可以更好地理解 Spring 的这种工作方式
即配置文件放在 bin 目录中的 conf 文件夹里,这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("conf/**/*application-context.xml");
来创建 ApplicationContext 对象的话, Spring 首先会通过路径中的非通配符部分即 conf ,先确定 conf 的路径,即 bin/conf 目录,然后从该目录下加载配置文件,由于使用了 /**/ 的方式,表明要加载 conf 目录下包括各级子目录中的所有配置文件,因此 bin/conf/application-context.xml 文件和
bin/conf/admin/admin-application-context.xml 都会被加载, Spring 启动时的输出显示为:
Loading XML bean definitions from file
[D:/myworkspace/spring-study/bin/conf/admin/admin-application-context.xml]
Loading XML bean definitions from file
[D:/myworkspace/spring-study/bin/conf/application-context.xml]
2 .当工程目录结构如图所示:

即 bin 目录下只有 .class 文件,没有配置文件,同时在工程属性的 Java Build Path->Libraries 里导入 conf.jar 文件, jar 文件结构如图所示:

这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("conf/**/*application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 首先会通过路径中的非通配符部分即 conf ,先确定 conf 的路径,即 conf.jar 中的 conf 目录,然后从该目录下加载配置文件,由于使用了 /**/ 的方式,表明要加载 conf 目录下包括各级子目录中的所有配置文件,因此 conf/application-context.xml 文件和
conf/admin/admin-application-context.xml 都会被加载, Spring 启动时的输出显示为:
Loading XML bean definitions from class path resource
[conf/admin/admin-application-context.xml]
Loading XML bean definitions from class path resource
[conf/application-context.xml]
3 .当工程目录结构如图所示:

即配置文件放在 bin 目录中的 conf 文件夹里,同时在工程属性的 Java Build Path->Libraries 里导入 conf.jar 文件, jar 文件结构如图所示:

这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("conf/**/*application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 首先会通过路径中的非通配符部分即 conf ,先确定 conf 的路径,在 eclipse 中是 bin/conf 目录,然后从该目录下加载配置文件,由于使用了 /**/ 的方式,表明要加载 conf 目录下包括各级子目录中的所有配置文件,因此 bin/conf/application-context.xml 文件和
bin/conf/admin/admin-application-context.xml 都会被加载,但 conf.jar 文件中的配置文件并不会被加载, Spring 启动时的输出显示为:
Loading XML bean definitions from file
[D:/myworkspace/spring-study/bin/conf/admin/admin-application-context.xml]
Loading XML bean definitions from file
情形三:使用 classpath* 前缀且不包含通配符
使用 classpath* 前缀可以获取所有与给定路径匹配的 classpath 资源,从而避免出现两个不同位置有相同名字的文件, Spring 只加载其中一个的情况。
这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("classpath*:conf/application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 将会加载 bin 目录下的 application-context.xml 文件和 jar 包里的 application-context.xml 文件, Spring 启动时的输出显示为:
Loading XML bean definitions from URL
[file:/D:/myworkspace/spring-study/bin/conf/application-context.xml]
Loading XML bean definitions from URL
[jar:file:/D:/myworkspace/conf1.jar!/conf/application-context.xml]
情形四:使用 classpath* 前缀,包含通配符
当工程目录结构如图所示:

即配置文件放在 bin 目录中的 conf 文件夹里,同时在工程属性的 Java Build Path->Libraries 里导入 conf.jar 文件, jar 文件结构如图所示:

这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("classpath*:conf/**/*application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 首先会通过路径中的非通配符部分即 conf ,先确定 conf 的路径,由于使用了 classpaht* 前缀,因此 bin 目录下的 conf 和 jar 包里的 conf 都会被加载,同时由于使用了 /**/ 的方式,表明要加载 conf 目录下包括各级子目录中的所有配置文件,因此 bin/conf/application-context.xml 和
bin/conf/admin/admin-application-context.xml 以及 jar 包中的
conf/application-context.xml 和
conf/admin/admin-application-context.xml 都会被加载, Spring 启动时的输出显示为:
Loading XML bean definitions from file
[D:/myworkspace/spring-study/bin/conf/admin/admin-application-context.xml]
Loading XML bean definitions from file
[D:/myworkspace/spring-study/bin/conf/application-context.xml]
Loading XML bean definitions from URL
[jar:file:/D:/myworkspace/conf1.jar!/conf/admin/admin-application-context.xml]
Loading XML bean definitions from URL
[jar:file:/D:/myworkspace/conf1.jar!/conf/application-context.xml]
特别注意:
这时使用
ApplicationContext context = new
ClassPathXmlApplicationContext("classpath*:**/*application-context.xml"); 来创建 ApplicationContext 对象的话, Spring 只会加载
bin/application-context.xml 和 bin/admin/admin-application-context.xml ,
而 jar 包中的配置文件并不会被加载。这是因为 Spring 使用 class path 加载配置文件时需要借助 JDK 的 ClassLoader.getResources( String name) 方法,而该方法有一个局限:当传入的参数为空字符串时,即我们本意是想从根目录获取文件,这时 JDK 只会返回存在于文件系统中的资源,而在 jar 包中的资源并不会被返回。
我们在 eclipse 中写个简单的测试类就能很容易看到这点:
ClassLoader loader = Thread.currentThread ().getContextClassLoader();
Enumeration resources = loader.getResources( "" );
while (resources.hasMoreElements()) {
URL url = (URL)resources.nextElement();
System. out .println(url);
}
运行测试类后,输出结果为:
file:/D:/myworkspace/spring-study/bin/
file:/D:/ProgramFiles/eclipse3.2/configuration/org.eclipse.osgi/bundles/47/1/.cp/
本文详细解析了Spring框架从classpath中加载配置文件的不同情形,包括使用不同路径前缀及通配符的情况,并提供了具体示例。

1094

被折叠的 条评论
为什么被折叠?



