摘要: 本文我们重点分析一下 Spring框架中的SpringFactoriesLoader类以及META-INF/spring.factories的使用。在详细分析之前,我们可以思考一个问题?在我们设计一套API供别人调用的时候,如果同一个功能的要求特别多,或者同一个接口要面对很复杂的业务场景,这个时候我们该怎么办呢?其一:我们可以规范不同的系统调用,也就是传递一个系统标识;其二:我们在内部编码的时候可以使用不同的条件判断语句进行处理;其三:我们可以写几个策略类来来应对这个复杂的业务逻辑,比如同一个功能的实现,A实现类与B实现类的逻辑一点也不一样,但是目标是一样的,这个时候使用策略类是毋庸置疑的?上述的问题我们是在API层面进行处理的?那万一有一天让我们自己设计一套框架,然后让别人直接使用?我们该如何处理上述的这个问题呢?这个可能就涉及到SPI的一些规范了跟技巧了,比如同一套API可能有很多实现类,这个时候我们该如何内置一系列实现类供框架使用呢?或者让用户也可以自定义这些API的实现类,相互之间协作运转。带着这些问题我们看一下Spring框架中的SpringFactoriesLoader以及META-INF/spring.factories的使用。
首先,我们来看一下属性的配置方式,在传统的开发模式中(无 springboot),属性文件的格式无外乎就是两种,第一种是XML,第二种是key、value形式( properties 文件)。当然 springboot引入了yaml方式。这里我们重点看一下XML以及 properties 的定义以及获取方式。
1.1.1.1.单个属性配置
首先,我们新建一个 shareniu-single.factories文件,该文件的目录结构如下图所示:
shareniu-single.factories的内容如下:
shareniu=http://www.shareniu.com/
1.1.1.2.多个属性配置
单个属性的定义比较简单,就是 key、value形式即可。对于同一个属性有多个值的定义格式如下:
com.example.demo.ch3.IShareniu=/
com.example.demo.ch3.ShareniuA,/
com.example.demo.ch3.ShareniuB
1.1.1.3.properties读取工具类
上述的属性定义完毕之后,我们写一个工具类进行测试,在这里我们直接调用了 PropertiesLoaderUtils类中的方法。实例代码如下:
1 public class PropertiesLoaderUtilsTest {
2 public static final String FACTORIES_RESOURCE_LOCATION = "META-INF/shareniu-single.factories";
3 public static void main(String[] args) throws IOException {
4 Properties properties = PropertiesLoaderUtils.loadAllProperties(FACTORIES_RESOURCE_LOCATION,null);
5 System.out.println(properties);
6 }
7 }
上述的代码直接调用了 PropertiesLoaderUtils类中的loadAllProperties方法,PropertiesLoaderUtils的全路径名称为: org . springframework . core . io . support .PropertiesLoaderUtils。该类位于spring-core-5.0.0.RC3.jar包中。
运行上面的代码,程序的输出如下:
{shareniu=http://www.shareniu.com/, com.example.demo.ch3.IShareniu=com.example.demo.ch3.ShareniuA,com.example.demo.ch3.ShareniuB}
果真我们自定义的属性都可以完美的获取到。
关于 PropertiesLoaderUtils.loadAllProperties的核心代码如下:
1 public static Properties loadAllProperties(String resourceName, @Nullable ClassLoader classLoader) throws IOException {
2 ClassLoader classLoaderToUse = classLoader;
3 if (classLoaderToUse == null) {
4 classLoaderToUse = ClassUtils.getDefaultClassLoader();
5 }
6 Enumeration<URL> urls = (classLoaderToUse != null ? classLoaderToUse.getResources(resourceName) :
7 ClassLoader.getSystemResources(resourceName));
8 Properties props = new Properties();
9 while (urls.hasMoreElements()) {
10 URL url = urls.nextElement();
11 URLConnection con = url.openConnection();
12 ResourceUtils.useCachesIfNecessary(con);
13 InputStream is = con.getInputStream();
14 try {
15 if (resourceName.endsWith(XML_FILE_EXTENSION)) {
16 props.loadFromXML(is);
17 }
18 else {
19 props.load(is);
20 }
21 }
22 finally {
23 is.close();
24 }
25 }
26 return props;
27 }
loadAllProperties方法,首先会根据类加载器去获取指定的资源(也就是我们调用的时候,传递的resourceName参数值)。然后判断资源的后缀是否为xml,如果后缀是xml则使用xml方式加载资源,否则都是用Properties方式进行资源的加载。
注意:虽然上述的代码我们指定的资源名称是: META-INF/shareniu-single.factories,但是上述的类加载器不仅扫描我们项目的META-INF/shareniu-single.factories,还会扫描当前类加载所加载的jar包中的META-INF/shareniu-single.factories文件。
了解了上述代码的处理逻辑之后,我们看一下 xml方式如何定义,shareniu.xml定义内容如下:
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
3 <properties>
4 <comment>shareniu xml 配置文件 </comment>
5 <entry key="username">shareniu</entry>
6 <entry key="url">http://www.shareniu.com/</entry>
7 </properties>
运行上述的属性工具类,控制台的输出信息如下:
{url=http://www.shareniu.com/, username=shareniu}
了解了 XML以及 properties 的定义以及获取方式之后,接下来学习 SpringFactoriesLoader类就简单的多了。
首先,看一下 SpringFactoriesLoader类定义的方法如下所示:
1. loadFactoryNames:加载指定的factoryClass并进行实例化。
2. loadSpringFactories:加载指定的factoryClass。
3. instantiateFactory:对指定的factoryClass进行实例化。
通过上文可知: loadFactoryNames方法内部直接调用loadSpringFactories方法,loadSpringFactories方法则会调用instantiateFactory方法。
loadSpringFactories方法内部会加载META-INF/spring.factories文件,这里加载的文件不仅包含项目中的,还包换我们项目环境所依赖的jar包中的META-INF/spring.factories文件。
1.现在,我们写一个简单的测试类,加载 spring.factories文件,实例代码如下:
spring.factories文件的内容如下所示:
com.example.demo.ch3.IShareniu=/
com.example.demo.ch3.ShareniuA,/
com.example.demo.ch3.ShareniuB
其中: IShareniu为接口,ShareniuA以及ShareniuB实现了IShareniu接口。结构如下图所示:
2. 自定义测试类并调用 SpringFactoriesLoader类中的相关方法,如下所示:
1 public class DemoApplication {
2 public static void main(String[] args) {
3 List<String> loadFactoryNames = SpringFactoriesLoader.loadFactoryNames(IShareniu.class, null);
4 System.out.println(loadFactoryNames);
5 }
6 }
自行上述代码,程序的输出信息如下:
[com.example.demo.ch3.ShareniuA, com.example.demo.ch3.ShareniuB]
通过上述的代码可知,我们确实完成了自身项目中 META-INF/spring.factories文件的属性读取。
那我们能否能够通过 Spring框架实例化这些类呢?答案是肯定的?实例代码如下:
1 List<IShareniu> loadFactories = SpringFactoriesLoader.loadFactories(IShareniu.class, null);
2 System.out.println(loadFactories);
自行上述代码,程序的输出信息如下:
[com.example.demo.ch3.ShareniuA@53fd30, com.example.demo.ch3.ShareniuB@cbc42f]
loadFactories方法返回的已经是实例化完毕的对象了。
接下来,我们看一下 SpringFactoriesLoader类中的loadFactories方法,如下所示:
1 public static <T> List<T> loadFactories(Class<T> factoryClass, @Nullable ClassLoader classLoader) {
2 Assert.notNull(factoryClass, "'factoryClass' must not be null");
3 ClassLoader classLoaderToUse = classLoader;
4 if (classLoaderToUse == null) {
5 classLoaderToUse = SpringFactoriesLoader.class.getClassLoader();
6 }
7 List<String> factoryNames = loadFactoryNames(factoryClass, classLoaderToUse);
8 if (logger.isTraceEnabled()) {
9 logger.trace("Loaded [" + factoryClass.getName() + "] names: " + factoryNames);
10 }
11 List<T> result = new ArrayList<>(factoryNames.size());
12 for (String factoryName : factoryNames) {
13 result.add(instantiateFactory(factoryName, factoryClass, classLoaderToUse));
14 }
15 AnnotationAwareOrderComparator.sort(result);
16 return result;
17 }
loadFactories方法首先获取类加载器,然后调用loadFactoryNames方法获取所有的制定资源的名称集合、其次调用instantiateFactory方法实例化这些资源类并将其添加到result集合中。最后调用AnnotationAwareOrderComparator.sort方法进行集合的排序。
loadFactoryNames方法核心代码如下:
18 public static final String FACTORIES_RESOURCE_LOCATION = "META-INF/spring.factories";
19 private static Map<String, List<String>> loadSpringFactories(@Nullable ClassLoader classLoader) {
20 MultiValueMap<String, String> result = cache.get(classLoader);
21 if (result != null)
22 return result;
23 try {
24 Enumeration<URL> urls = (classLoader != null ?
25 classLoader.getResources(FACTORIES_RESOURCE_LOCATION) :
26 ClassLoader.getSystemResources(FACTORIES_RESOURCE_LOCATION));
27 result = new LinkedMultiValueMap<>();
28 while (urls.hasMoreElements()) {
29 URL url = urls.nextElement();
30 UrlResource resource = new UrlResource(url);
31 Properties properties = PropertiesLoaderUtils.loadProperties(resource);
32 for (Map.Entry<?, ?> entry : properties.entrySet()) {
33 List<String> factoryClassNames = Arrays.asList(
34 StringUtils.commaDelimitedListToStringArray((String) entry.getValue()));
35 result.addAll((String) entry.getKey(), factoryClassNames);
36 }
37 }
38 cache.put(classLoader, result);
39 return result;
40 }
41 catch (IOException ex) {
42 }
43 }
loadSpringFactories方法直接加载所有的META-INF/spring.factories文件内容,其内部还是调用PropertiesLoaderUtils.loadProperties方法进行处理。该方法前面我们也详细的演示了,再次不再累赘。
唯一需要了解的是,这个地方使用了缓存策略。
instantiateFactory方法的核心逻辑如下:
1 private static <T> T instantiateFactory(String instanceClassName, Class<T> factoryClass, ClassLoader classLoader) {
2 try {
3 Class<?> instanceClass = ClassUtils.forName(instanceClassName, classLoader);
4 if (!factoryClass.isAssignableFrom(instanceClass)) {
5 throw new IllegalArgumentException(
6 }
7 return (T) ReflectionUtils.accessibleConstructor(instanceClass).newInstance();
8 }
9 catch (Throwable ex) {
10 throw new IllegalArgumentException("Unable to instantiate factory class: " + factoryClass.getName(), ex);
11 }
12 }
直接调用了ClassUtils.forName方法,然后调用ReflectionUtils.accessibleConstructor方法进行实例对象进行对象的实例化工作,原来这里直接使用了反射技术进行对象的实例化工作。原来如此。
至此, XML以及 properties 的定义以及获取方式, SpringFactoriesLoader类的使用以及原理已经讲解完毕。
欢迎关注我的微信公众号,第一时间获得博客更新提醒,以及更多 成体系 的Java相关原创技术干货。
扫一扫下方二维码或者长按识别二维码,即可关注。
作者:分享牛 出处: http://blog.csdn.net/qq_30739519 本博客中未标明转载的文章归作者 分享牛 所有
,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。