使用Spring中的PropertyPlaceholderConfigurer读取文件

目录

• 一. 简介
• 二. XML 方式
• 三. Java 编码方式

一. 简介

• 大型项目中，我们往往会对我们的系统的配置信息进行统一管理，一般做法是将配置信息配置与一个cfg.properties 的文件中，然后在我们系统初始化的时候，系统自动读取 cfg.properties 配置文件中的 key value（键值对），然后对我们系统进行定制的初始化。

• 那么一般情况下，我们使用 的 java.util.Properties, 也就是 java 自带的。往往有一个问题是，每一次加载的时候，我们都需要手工的去读取这个配置文件，一来编码麻烦，二来代码不优雅，往往我们也会自己创建一个类来专门读取，并储存这些配置信息。

• 对于 web 项目来说，可以通过相对路径得到配置文件的路径，而对于可执行项目，在团队开发中就需要根据各自的环境来指定 properties 配置文件的路径了。对于这种情况可以将配置文件的路径放在 java 虚拟机 JVM 的自定义变量(运行时参数)中，例如：-Ddev.config=/dev.properties 寻找的是本机根目录下

• Spring中提供着一个 PropertyPlaceholderConfigurer，这个类是 BeanFactoryPostProcessor 的子类。其主要的原理在是。Spring容器初始化的时候，会读取 xml 或者 annotation 对 Bean 进行初始化。初始化的时候，这个 PropertyPlaceholderConfigurer 会拦截 Bean 的初始化，初始化的时候会对配置的 ${pname} 进行替换，根据我们 Properties 中配置的进行替换。从而实现表达式的替换操作 。

二. XML 方式

方式1

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <!-- 对于读取一个配置文件采取的方案 -->
        <!--<property name="location" value="classpath:db.properties"/>-->

        <!--对于读取多个配置文件采取的方案-->
        <property name="locations">
            <list>
                <value>classpath:db.properties</value>
                <value>classpath:db2.properties</value>
            </list>
        </property>
    </bean>
</beans>

#db.properties
jdbc.driverClass==net.sourceforge.jtds.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?
jdbc.username=anqi
jdbc.password=123456

#db2.properties
name=anqi
age=23

import org.junit.Test; import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;  

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration("classpath:spring-context.xml")
public class TestPropertyPlaceHoder2 {
  @Value("${jdbc.username}")
  private String username;
  @Value("${jdbc.password}")
  private String password;
  @Value("${name}")
  private String name;
  @Value("${age}")
  private int age;      

  @Test
  public void testResource() {
    System.out.println("username: " + username);
    System.out.println("password: " + password);
    System.out.println("name: " + name);
    System.out.println("age: " + age);
  }
}
/* username: anqi     password: 123456     name: anqi     age: 23 */

方式2

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	<context:property-placeholder location="classpath:db.properties,classpath:db2.properties"/>  

</beans>

注意：我们知道不论是使用 PropertyPlaceholderConfigurer 还是通过 context:property-placeholder 这种方式进行实现，都需要记住，Spring框架不仅仅会读取我们的配置文件中的键值对，而且还会读取 Jvm 初始化的一下系统的信息。有时候，我们需要将配置 Key 定一套命名规则 ，例如

 jdbc.username
 jdbc.password

同时，我们也可以使用下面这种配置方式进行配置，这里我配 NEVER 的意思是不读取系统配置信息。

<context:property-placeholder location="classpath:db.properties,classpath:db2.properties"
         system-properties-mode="NEVER"/>  

SYSTEM_PROPERTIES_MODE_FALLBACK：在解析一个占位符的变量的时候。假设不能获取到该变量的值。就会拿系统属性来尝试，
SYSTEM_PROPERTIES_MODE_OVERRIDE：在解析一个占位符的时候。会先用系统属性来尝试，然后才会用指定的属性文件，
SYSTEM_PROPERTIES_MODE_NEVER：从来都不会使用系统属性来尝试。

三. Java 编码方式

采取编码的方式显然更加灵活，当我们在做一个项目时，在线下本地跑和在服务器线上跑时，需要的参数肯定有诸多不同，我们可以通过 xml java 编码的方式来指定采用哪一个配置方案，同一个配置方案中也可以将线上配置文件的地址放在前面，没有线上配置文件就采用本地配置的方式来运行项目。

spring-context.xml

<bean>
    <!-- 配置 preoperties文件的加载类  -->
    <bean class="com.anqi.testPropertyPlaceHoder.PropertiesUtil">
        <!-- 配置方案1 优先级更高 配置方案1找不到 key 才会去配置方案 2 里面找-->
        <property name="locations">
            <list>
                <!-- 这里支持多种寻址方式：classpath 和 file -->
                <!-- 推荐使用file的方式引入，这样可以将配置和代码分离 -->
                <!--<value>file:/conf/localpro.properties</value>-->
                <value>classpath:db.properties</value>
                <value>classpath:db2.properties</value>
            </list>
        </property>
        <!-- 配置方案2  -->
        <property name="programConfig">
            <list>
                <value>classpath:db3.properties</value>
            </list>
        </property>
    </bean>
</beans>

db.properties

jdbc.driverClass==net.sourceforge.jtds.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?
jdbc.username=anqi jdbc.
password=123456
pro=1
version=db1

db2.properties

name=anqi
age=23
pro=2
version=db2

db3.properties

pro=3

dev.properties

company=abc version=dev.config

读取配置的工具类

import org.springframework.beans.factory.config.PropertyPlaceholderConfigurer;
import org.springframework.core.io.FileSystemResource;
import org.springframework.core.io.Resource;

import java.io.File;
import java.io.IOException;
import java.util.*;

public class PropertiesUtil extends PropertyPlaceholderConfigurer {

    private static Resource electResource;

    private static Properties configProperties = new Properties();
    private static Properties programProperties = new Properties();

    public PropertiesUtil() {}

		/**
      * 根据 spring-context 配置文件中的配置,来将项目下对应的 properties 文件加载到系统中
      * 并且经过特殊处理 db2.properties 不允许覆盖掉 db1.properties 中相同的 key
      * @param locations
  		*/
      public void setLocations(Resource... locations) {
  				List<Resource> existResourceList = new ArrayList<>();

  				Resource devConfig = getDevConfig();
          if (devConfig != null) {
              existResourceList.add(devConfig);
          }

          Resource resource;
          for(int i = 0; i < locations.length; ++i) {
              resource = locations[i];
              if (resource.exists()) {
                  existResourceList.add(resource);
                  //dev db.properties db2.properties
              }
          }

        Collections.reverse(existResourceList);
        //db2.properties db.properties dev

        if (!existResourceList.isEmpty()) {
            electResource = existResourceList.get(existResourceList.size() - 1);
            //dev
        }

        try {
      		configProperties.load(electResource.getURL().openStream());
      		if (existResourceList != null && existResourceList.size() > 1) {
          	for(int i = existResourceList.size() - 2; i >= 0; --i) {
              	Properties backupConfig = new Properties();
                //从后往前加载 db1 db2
              backupConfig.load(((Resource)existResourceList.get(i)).getURL().openStream());

              Iterator iterator = backupConfig.keySet().iterator();

              //通过后面新添加的 db3.properties、db4.peoperties 进行更新 db.properties
              //添加没有的 key 不能覆盖前面的 key
              while(iterator.hasNext()) {
                  Object key = iterator.next();
                  if (!configProperties.containsKey(key)) {
                      configProperties.put(key, backupConfig.get(key));
                  }
              }
          	}
      		}
    	} catch (IOException e) {
        	e.printStackTrace();
    	}
    }

  		/**
        * 将 programConfig 的配置方案加载到 programeConfig 中
        * （即将 db3.properties 加载到 programeConfig）
        * 包含运行时方案（运行时配置优先级最高）会覆盖 key 相同的 value
        * @param locations
        */
      public void setProgramConfig (Resource... locations){

          List<Resource> existResourceList = new ArrayList<>();

          Resource resource;
          for(int i = 0; i < locations.length; ++i) {
              resource = locations[i];
              if (resource.exists()) {
                  existResourceList.add(resource);
              }
          }

        if (!existResourceList.isEmpty()) {
            try {
                Iterator<Resource> iterator = existResourceList.iterator();
                while (iterator.hasNext()) {
                    resource = iterator.next();
                    programProperties.load(resource.getURL().openStream());
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        Resource devConfig = getDevConfig();
        if (devConfig != null) {
            try {
                Properties devProperties = new Properties();
                devProperties.load(devConfig.getURL().openStream());
                Iterator iterator = devProperties.keySet().iterator();

                while(iterator.hasNext()) {
                    Object key = iterator.next();
                    programProperties.put(String.valueOf(key),
                            devProperties.getProperty(String.valueOf(key), ""));
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    /**
			* 在运行期间传入配置参数（可以将配置文件放在本机或服务器上）
			* @return
  		*/
      private static Resource getDevConfig() {
          String s = System.getProperty("dev.config", "");
          File devConfig = new File(s);
          return !s.trim().equals("") && devConfig.exists() && devConfig.isFile() ?
                      new FileSystemResource(s) : null;
      }

    /**
      * 外部访问 properties 配置文件中的某个 key
      * @param key
      * @return
 			*/
      public static String get(String key){
  				return programProperties.containsKey(key) ?
              programProperties.getProperty(key) : configProperties.getProperty(key);
      }

    	public static void show() {
        System.out.println("db_1 keys: "+configProperties.keySet());
        System.out.println("db_2 keys: "+programProperties.keySet());
    }
}

测试类

package com.anqi.testPropertyPlaceHoder;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class TestPropertyPlaceHoder  {
    public static void main(String[] args) {
        ApplicationContext al = new ClassPathXmlApplicationContext("classpath:spring-context.xml");
        PropertiesUtil.show();
        System.out.println(PropertiesUtil.get("version")); 

        //-Ddev.config=/dev.properties 传入运行时参数
        System.out.println(PropertiesUtil.get("company"));
        System.out.println(PropertiesUtil.get("pro"));
        //db_1 keys: [name, jdbc.password, version, company, jdbc.url, pro, jdbc.driverClass, jdbc.username, age]
        //db_2 keys: [company, version, pro]
        //dev.config
        //abc
        //3
    }
}