spring propertyplaceholderconfigurer的使用

Spring的框架中为您提供了一个 BeanFactoryPostProcessor 的实作类别： org.springframework.beans.factory.config.PropertyPlaceholderConfigurer。藉由这个类别，您可以将一些组态设定，移出至.properties档案中，如此的安排可以让XML定义档负责系统相关设定，而.properties档可以作为客户根据需求，自定义一些相关的参数。 
来看一个Bean定义档的实际例子： 

beans-config.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE beans PUBLIC "-//SPRING/DTD BEAN/EN" 
    "http://www.springframework.org/dtd/spring-beans.dtd"> 

<beans>  
      <bean id="configBean" 
 class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">           <property name="location">               <value>hello.properties</value>           </property>       </bean> 

      <bean id="helloBean" class="onlyfun.caterpillar.HelloBean"> 
          <property name="helloWord"> 
              <value>${onlyfun.caterpillar.helloWord}</value> 
          </property> 
      </bean>
</beans>

假设在helloBean中有许多依赖注入的属性，这些都是比较不常变动的属性，而其中helloWord会经常变动，可以透过hello.properties来简单的设定，而这个资讯已设定在configBean的location属性中： 
hello.properties 

onlyfun.caterpillar.helloWord=Welcome!

在helloBean的helloWord属性中，${onlyfun.caterpillar.helloWord}将会被hello.properties的helloWord所取代。 

如果有多个.properties档案，则可以透过locations属性来设定，例如： 
beans-config.xml 

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE beans PUBLIC "-//SPRING/DTD BEAN/EN" 
    "http://www.springframework.org/dtd/spring-beans.dtd"> 

<beans>  
      <bean id="configBean" 
    class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">           <property name="locations"> 
              <list>                  <value>hello.properties</value> 
                  <value>welcome.properties</value> 
                  <value>other.properties</value>     
              </list>
          </property>           </bean> 

      <bean id="helloBean" class="onlyfun.caterpillar.HelloBean"> 
          <property name="helloWord"> 
              <value>${onlyfun.caterpillar.helloWord}</value> 
          </property> 
          ...
      </bean>
</beans>

PropertyPlaceholderConfigurer类就是bean factory post-processor的一种，它的作用是一个资源属性的配置器，能够将BeanFactory的里定义的内容放在一个以.propertis后缀的文件中。 
例如－－－spring-context.xml－－－－ 

<bean id="propertyConfigurer"   class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
         <property name="locations">
             <list>
                 <value>/WEB-INF/jdbc.properties</value>
             </list>
         </property>
 </bean>
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName"><value>${driver}</value></property>
    <property name="url"><value>jdbc:${dbname}</value></property>
</bean>

而实际的jdbc.propertis文件是 
jdbc.driverClassName=org.hsqldb.jdbcDriver 
jdbc.url=jdbc:hsqldb:hsql://production:9002 
jdbc.username=sa 
jdbc.password=root 
而jdbc.propertis是怎样引用的呢： 将上边一段配置注册在web.xml中就可以了 

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring-context.xml</param-value>
</context-param> 当然，不要忘了spring的监听器注册
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>

这样，一个简单的数据源就设置完毕了。 
实际上，PropertyPlaceholderConfigurer起的作用就是将占位符指向的数据库配置信息放在bean中定义 
的工具。

当存在多个Properties文件时，配置就需使用locations了：(2) 

<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
    <property name="locations"> 
       <list> 
          <value>classpath:/spring/properties/jdbc.properties</value> 
          <value>/WEB-INF/conf/spring/system.properties</value> 
        </list> 
    </property> 
</bean> 

接下来我们要使用多个PropertyPlaceholderConfigurer来分散配置，达到整合多工程下的多个分散的Properties文件，其配置如下：(3) 

<bean id="propertyConfigurerForProject1" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
    <property name="order" value="1" /> 
    <property name="ignoreUnresolvablePlaceholders" value="true" /> 
    <property name="location"> 
       <value>classpath:/spring/include/dbQuery.properties</value> 
    </property> 
</bean> 

<bean id="propertyConfigurerForProject2" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
    <property name="order" value="2" /> 
    <property name="ignoreUnresolvablePlaceholders" value="true" /> 
    <property name="locations"> 
      <list> 
         <value>classpath:/spring/properties/jdbc.properties</value> 
         <value>/WEB-INF/conf/spring/system.properties</value> 
      </list> 
    </property> 
</bean>

其中order属性代表其加载顺序，而ignoreUnresolvablePlaceholders为是否忽略不可解析的Placeholder，如配置了多个PropertyPlaceholderConfigurer，则需设置为true 

2、PropertyOverrideConfigurer 
与PropertyPlaceholderConfigurer 不同的是: PropertyOverrideConfigurer 利用属性文 
件的相关信息，覆盖XML 配置文件中定义。即PropertyOverrideConfigurer 允许XML 配 
置文件中有默认的配置信息。 
如果PropertyOverrideConfigurer 的属性文件有对应配置信息，则XML 文件中的配 
置信息被覆盖:否则，直接使用XML 文件中的配置信息。使用PropertyOverrideConfigurer 
属性文件的格式如下: 
beanName.property=value 
beanName 是属性占位符企图覆盖的bean 名， property 是企图覆盖的属性名。看如 
下配置文件: 
<?xml version="1.0" encoding="gb2312"?> 
<'一指定Spring 配置文件的dtd> 
<lDOCTYPE beans PUBL工C "-//SPR工NG//DTD BEAN//EN" 
''http://www.springframework.org/dtd/spring-beans.dtd''> 
<!… Spring 配置文件的根元素> 
<beans> 
<' 配置一个属性占位符beanoApplictionContext能自动识别PropertyPlaceholderConfigurer bean --> 
<bean id="propertyOverrider" 
class= "org.springframework.beans.factory.config.PropertyOverrideConfigurer"> 
<property name="locations"> 
<list> 
<value>dbconn.properties</value> 
<!-如果有多个属性文件，依次在下面列出来一〉 
</list> 
</property> 
</bean> 
<'…配置本地的DBCP 数据源一〉 
<bean id="dataSource" 
class="org.springframework.jdbc.datasource.DriverManager 
DataSource" destroy-method="close"> 
<property name="driverClassName" value="dd"/> 
<property name="url" value="xx"/> 
<property name="username" value="dd"/> 
<property name="password" value="dd"/> 
</bean> 
</beans> 
容器自动注册propertyOverriderbean，读取dbconn.properties 文件中的属性，并用于 
覆盖目标bean 的属性。其配置文件中dataSourcebean 的属性完全是随意输入的，最终被 
属性文件的配置覆盖，其属性文件如下: 
dataSource.driverClassName=com.mysql.jdbc.Driver 
dataSource.url=jdbc:mysql://wonder:3306/j2ee 
dataSource.username=root 
dataSource.password=32147 

注意属性文件的格式必须是: 
beanName.property=value 
也就是说， dataSource必须是容器中真实存在的bean 名，否则程序将出错。 
注意:仅仅察看XML 定义文件，程序无法知道BeanFactory定义是否被覆盖;当有 
多个PorpertyOverrideConfigurer对同一个bean 属性定义了覆盖，则最后一个覆盖有效。