Spring中你不得不知的各种Utils

可以评论但没有必要
427 阅读4分钟

在Java开发过程中，我们会用到很多工具类来为我们项目开发做工作，同样，Spring板块中，也有很多工具类，他们有些是专门提供给了框架使用，有些也是提供了外接使用方法。使用适当的工具，让项目事半功倍。

前言

Spring的工具类都是以Utils结尾，所以要查看这些工具类，只需要在API文档中查询所有*Utils即可，可以看到有多达几十个。其中有我们非常熟悉的org.springframework.util.StringUtils

有用到过的org.springframework.aop.support.AopUtils，还有可能没有听过的org.springframework.core.annotation.AnnotatedElementUtils等等。后面我们会选择十来个有用的Utils，给大家展示一下Spring中的工具类的有用和常用方法。

org.springframework.core.io.support.PropertiesLoaderUtils 我们今天第一个介绍的是PropertiesLoaderUtils，这个工具类主要是针对Properties文件的加载操作，在Spring对.properties文件和.factories文件的操作都有使用到。

先来简单看看这个类提供的有用方法： • Properties loadProperties(Resource resource) throws IOException：从一个资源文件加载Properties；

• Properties loadProperties(EncodedResource resource) throws IOException：加载资源文件，传入的是提供了编码的资源类（EncodedResource）；和上面方法基本一致；

• void fillProperties(Properties props, Resource resource) throws IOException：从一个资源类中加载资源，并填充到指定的Properties对象中； • void fillProperties(Properties props, EncodedResource resource) throws IOException：从一个编码资源类中加载资源，并填充到指定的Properties对象中；和上面方法基本一致；

• Properties loadAllProperties(String resourceName) throws IOException：根据资源文件名称，加载并合并classpath中的所有资源文件；

• Properties loadAllProperties(String resourceName, ClassLoader classLoader) throws

IOException：从指定的ClassLoader中，根据资源文件名称，加载并合并classpath中的所有资源文件； 方法不是很多，而且共性较大，我们就从最简单的Properties loadProperties(Resource resource)开始。 loadProperties

测试方法很简单，我们首先准备一个test.properties文件，放到resources下面：

key=value key2=\u4E2D\u6587

完成代码：

@Test public void testLoadPropertiesResource() throws Exception { Properties ret = PropertiesLoaderUtils .loadProperties(new ClassPathResource("test.properties")); assertEquals("value", ret.getProperty("key")); assertEquals("中文", ret.getProperty("key2")); }

测试完成。没有太大难度； 但是，其实Properties对象不仅仅支持.properties文件，还支持XML格式的资源配置文件。先来看看Properties对象对XML类型资源文件的DTD定义

(java.sun.com/dtd/propert…)：

那么我们就可以有以下测试。创建一个text.xml文件在classpath下：

一些自定义说明 value 中文

完成测试代码：

@Test public void testLoadPropertiesResourceXml() throws Exception { Properties ret = PropertiesLoaderUtils .loadProperties(new ClassPathResource("test.xml")); assertEquals("value", ret.getProperty("key")); assertEquals("中文", ret.getProperty("key2")); }

测试通过。当然，我们是非常不建议使用XML的方式来做配置的。 接下来使用EncodeResource来测试，EncodeResource在Resource上增加了字符编码设置。同样使用之前的

test.properties： @Test public void testLoadPropertiesEncodedResource() throws Exception { Properties ret = PropertiesLoaderUtils.loadProperties( new EncodedResource(new ClassPathResource("test.properties"), "UTF-8")); assertEquals("value", ret.getProperty("key")); assertEquals("中文", ret.getProperty("key2")); }

可以看到，只是在之前的ClassPathResource基础之上包装了UTF-8字符编码的EncodeResource； loadAllProperties loadProperties方法，从当前classpath下加载properties文件，如果使用loadAllProperties，可以从当前classpath下加载所有的相同名称的properties文件，并执行合并。 来完成一个测试。把上一个例子中的test.properties文件保留，放到src/main/resources中；然后在src/test/resources目录下再创建一个test.properties文件，内容为：

key3=value 测试代码：

@Test public void testLoadAllPropertiesString() throws Exception { Properties ret = PropertiesLoaderUtils .loadAllProperties("test.properties"); assertEquals("value", ret.getProperty("key")); assertEquals("value", ret.getProperty("key3")); }

执行测试通过；可以看到，main下的test.properties和test下的test.properties都被识别并执行了合并；那如果在test/resources中的test.properties中增加

key=update

再次执行测试，仍然通过，说明在多个配置文件中如果有重复key，最近的classpath为准（比如当前应用的properties内容会优先于jar包中的properties） 但是，如果这种情况下，使用loadProperties方法，那么只会加载到test/resources中的test.properties；这个结果可以对loadAllProperties有更深刻理解。 fillProperties fillProperties方法其实是loadProperties方法的真正调用方法。先来看看测试代码：

@Test

public void testFillPropertiesPropertiesResource() throws Exception { Resource res = new ClassPathResource("test.properties"); Properties ret = new Properties(); PropertiesLoaderUtils.fillProperties(ret, res); assertEquals("value", ret.getProperty("key")); }

使用非常简单。 我们来看一下loadProperties方法的源代码：

/**

  • Load properties from the given EncodedResource,
  • potentially defining a specific encoding for the properties file.
  • @see #fillProperties(java.util.Properties, EncodedResource) */

public static Properties loadProperties(EncodedResource resource)

throws IOException { Properties props = new Properties(); fillProperties(props, resource); return props; } 可以看到，其实调用的就是fileProperties方法，而这个方法的实现其实也很简单： public static void fillProperties(Properties props, EncodedResource resource) throws IOException {

fillProperties(props, resource, new DefaultPropertiesPersister());

} 代理给了fillProperties(Properties props, EncodedResource resource, PropertiesPersister persister)方法；只是最后一个参数是一个PropertiesPersister，抽取了一个统一的从XML或者properties资源加载和装载接口；来看看具体实现（我只保留了最基本的关键代码）：

static void fillProperties(Properties props, EncodedResource resource, PropertiesPersister persister)

throws IOException {
InputStream stream = null;

Reader reader = null;

try 
{
    
    String filename = resource.getResource().getFilename();
    
    //如果是XML文件，
    
    if (filename != null && 
    
    filename.endsWith(XML_FILE_EXTENSION)) {
        stream = resource.getInputStream();
        persister.loadFromXml(props, stream);
    }
    
    else {
        stream = resource.getInputStream();
        persister.load(props, stream);
    }
    
}finally {
    //close方法
}

}

可以看到，其实就是调用了PropertiesPersister的loadFromXml和load方法来分别加载XML或properties； 如果再往下看，有兴趣的童鞋可以看看DefaultPropertiesPersister的相关的这两个方法，其实核心还是使用Properties对象的load和loadFromXML方法完成的。

小结

propertiesloaderutils提供了加载的便捷操作，并且在spring工具类中还有更多utils，持续关注了解最新讲解！

avatar
文章
阅读
粉丝