搞了一陣子C++，以前感覺C++很牛，現在怎麼覺得這東西這麼落後了，很多理念完全跟不上時代，關鍵相容性讓人抓狂了。。。只能說一切為了效率。。。

               來看看spring-boot，完全是魔術啊，覺得spring的腦洞真大啊，來說一下今天的主角@ConfigurationProperties。

       概述

                我們知道，從spring-boot開始，已經支援yml檔案形式的配置，@ConfigurationProperties的大致作用就是通過它可以把properties或者yml配置直接轉成物件。

       配置檔案轉成物件

          Relaxed binding

                 用@ConfigurationProperties是支援“鬆綁定”的，我們不必每個字都和配置中的key一致。官網給出了兩個例子，e.g. context-path binds to contextPath和e.g. PORT binds to port

   集合的處理

                如果在配置中需要配置集合的話，我們需要使用“-”符號

                比如：

poolConfig: 
      - maxIdle: 8
      - minIdle: 0
      - maxActive: 8
      - maxWait: -1
 

          元資料（Meta-data）

                 @ConfigurationProperties還支援spring元資料，可以在resource下建立META-INF資料夾，然後建立檔案additional-spring-configuration-metadata.json。裡面的資料格式必須滿足spring的元資料格式http://docs.spring.io/spring-boot/docs/1.5.3.RELEASE/reference/htmlsingle/#configuration-metadata

                  接下來我們來看個例子

                  yml配置如下：

spring: 
  redis: 
    dbIndex: 0
    hostName: 192.168.58.133
    password: nmamtf
    port: 6379
    timeout: 0
    poolConfig: 
      - maxIdle: 8
      - minIdle: 0
      - maxActive: 8
      - maxWait: -1

                   

                    定義被轉換的物件

@Component
@ConfigurationProperties(prefix="spring.redis")  
public class RedisProps {

	private int dbIndex;
	@NotNull
	private String hostname;
	private String password;
	@NotNull
	private int port;
	private long timeout;
	private List<Map<String,String>> poolConfig;
	
	public int getDbIndex() {
		return dbIndex;
	}
	public void setDbIndex(int dbIndex) {
		this.dbIndex = dbIndex;
	}
	public String getHostname() {
		return hostname;
	}
	public void setHostname(String hostname) {
		this.hostname = hostname;
	}
	public String getPassword() {
		return password;
	}
	public void setPassword(String password) {
		this.password = password;
	}
	public int getPort() {
		return port;
	}
	public void setPort(int port) {
		this.port = port;
	}
	public long getTimeout() {
		return timeout;
	}
	public void setTimeout(long timeout) {
		this.timeout = timeout;
	}
	public List<Map<String, String>> getPoolConfig() {
		return poolConfig;
	}
	public void setPoolConfig(List<Map<String, String>> poolConfig) {
		this.poolConfig = poolConfig;
	}
	
}

                 這樣該物件的成員變數會被自動賦值，可以在其他地方進行注入

        直接注入配置到java config中

                  如果你嫌上面還麻煩，那麼接下來的這個功能絕對讓你驚豔。

                  該功能在官方文件是沒有提到的，我們可以把@ConfigurationProperties和@Bean和在一起使用。

                  舉個例子，我們需要用@Bean配置一個Config物件，Config物件有a，b，c成員變數需要配置，那麼我們只要在yml或properties中定義了a=1,b=2,c=3，然後通過@ConfigurationProperties就能把值注入進Config物件中。這是魔術嗎？

                  下面我用實際的程式碼舉個例子

                   yml配置檔案修改如下

server:
  port: 8080

spring: 
  redis: 
    dbIndex: 0
    hostName: 192.168.58.133
    password: nmamtf
    port: 6379
    timeout: 0
    poolConfig: 
      maxIdle: 8
      minIdle: 0
      maxActive: 8
      maxWait: -1

                       接著我們用@ConfigurationProperties來配置redis

@Configuration  
@EnableAutoConfiguration
public class RedisConfig {
	
    @Bean  
    @ConfigurationProperties(prefix="spring.redis.poolConfig")  
    public JedisPoolConfig getRedisConfig(){  
        JedisPoolConfig config = new JedisPoolConfig();
        return config;  
    }  
      
    @Bean  
    @ConfigurationProperties(prefix="spring.redis")  
    public JedisConnectionFactory getConnectionFactory(){  
        JedisConnectionFactory factory = new JedisConnectionFactory();  
        factory.setUsePool(true);
        JedisPoolConfig config = getRedisConfig();  
        factory.setPoolConfig(config);  
        return factory;  
    }  
      
      
    @Bean  
    public RedisTemplate<?, ?> getRedisTemplate(){  
        RedisTemplate<?,?> template = new StringRedisTemplate(getConnectionFactory());  
        return template;  
    }  
	
}

                注意，其中JedisConnectionFactory中包含dbIndex，hostName，password，port，timeout，poolConfig幾個成員變數。JedisPoolConfig包含maxIdle，minIdle，maxActive，maxWait幾個成員變數。

       @ConfigurationProperties和@Value比較

                它們兩個都能把配置檔案的值直接注入到程式碼，那麼它們的區別是什麼呢，怎麼選擇呢，直接拿官方的表格一下就清楚了

Feature	@ConfigurationProperties	@Value