Spring從零開始學使用系列（三）--Spring框架中@Value注解和配置管理詳解

? 如果各位老爺覺得可以，請點贊收藏評論，謝謝啦！！

? 文章中涉及到的圖片均由AI生成

? 公眾號在最下方！！！

1. 如何在Spring中使用@Value注解

1.1 基本用法

1.2提供默認值

2. 如何配置和使用PropertySourcesPlaceholderConfigurer

2.1 基本配置

2.2 處理未解析的占位符

2.3 自定義占位符前綴和后綴

3. Spring中的內置類型轉換功能如何使用

3.1 基本類型轉換

3.2 自定義類型轉換

3.3 集成Spring表達式語言（SpEL）

4. 總結

1. 如何在Spring中使用@Value注解

????????@Value注解是Spring框架中用于注入外部化屬性值的一種方式。它通常與Spring的配置文件（如application.properties或application.yml）一起使用，能夠將配置文件中的值注入到Spring Bean中，提供靈活的配置管理。以下是詳細的使用方法和示例。

1.1 基本用法

????????首先，我們來看一個簡單的示例，展示如何將配置文件中的屬性值注入到一個Spring Bean中。假設我們有一個MovieRecommender類，需要從配置文件中獲取catalog的值：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class MovieRecommender {private final String catalog;public MovieRecommender(@Value("${catalog.name}") String catalog) {this.catalog = catalog;}public String getCatalog() {return catalog;}
}

????????在這個示例中，我們使用@Value("${catalog.name}")注解將catalog.name的值注入到catalog字段中。為了使這個注入生效，我們需要在配置文件中定義catalog.name的值。例如，在application.properties文件中：

catalog.name=MovieCatalog

1.2提供默認值

????????在某些情況下，屬性值可能沒有定義。我們可以在@Value注解中提供一個默認值，以確保應用程序在缺少配置時仍能正常使用：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class MovieRecommender {private final String catalog;public MovieRecommender(@Value("${catalog.name:defaultCatalog}") String catalog) {this.catalog = catalog;}public String getCatalog() {return catalog;}
}

2. 如何配置和使用PropertySourcesPlaceholderConfigurer

????????在Spring應用程序中，PropertySourcesPlaceholderConfigurer是一個非常有用的工具，它允許我們使用占位符來引用外部化的配置值。通過使用PropertySourcesPlaceholderConfigurer，我們可以確保在Spring應用程序啟動時，所有的占位符都能被正確解析和替換。

2.1 基本配置

????????要使用PropertySourcesPlaceholderConfigurer，我們首先需要在配置類中定義一個PropertySourcesPlaceholderConfigurer bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;@Configuration
public class AppConfig {@Beanpublic static PropertySourcesPlaceholderConfigurer propertyPlaceholderConfigurer() {return new PropertySourcesPlaceholderConfigurer();}
}

? ? ? ? 使用上述配置，Spring將在初始化時加載并解析所有的占位符。如果任何占位符無法解析，將導致Spring初始化失敗。我們還可以通過自定義方法如setPlaceholderPrefix、setPlaceholderSuffix或setValueSeparator來調整占位符的行為。

2.2 處理未解析的占位符

????????默認情況下，PropertySourcesPlaceholderConfigurer將嘗試解析占位符，并在無法解析時使用占位符名稱作為默認值。為了嚴格控制未解析的占位符，可以配置PropertySourcesPlaceholderConfigurer使其在遇到未解析的占位符時拋出異常：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;@Configuration
public class AppConfig {@Beanpublic static PropertySourcesPlaceholderConfigurer propertyPlaceholderConfigurer() {PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();configurer.setIgnoreUnresolvablePlaceholders(false); // 設置為false以拋出異常return configurer;}
}

????????通過上述配置，如果Spring在初始化時遇到無法解析的占位符，將會拋出異常并終止啟動過程

2.3 自定義占位符前綴和后綴

????????PropertySourcesPlaceholderConfigurer允許我們自定義占位符的前綴和后綴，以便更靈活地處理不同格式的占位符。例如，我們可以使用自定義的前綴和后綴來定義占位符：

????????

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;@Configuration
public class AppConfig {@Beanpublic static PropertySourcesPlaceholderConfigurer propertyPlaceholderConfigurer() {PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();configurer.setPlaceholderPrefix("${customPrefix."); // 自定義前綴configurer.setPlaceholderSuffix("}"); // 自定義后綴return configurer;}
}

????????在這個示例中，占位符將使用${customPrefix.propertyName}的格式，而不是默認的${propertyName}格式。以下是一個實際的配置示例：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class CustomRecommender {private final String catalog;public CustomRecommender(@Value("${customPrefix.catalog.name}") String catalog) {this.catalog = catalog;}public String getCatalog() {return catalog;}
}

在application.properties文件中定義customPrefix.catalog.name的值：

customPrefix.catalog.name=CustomCatalog

????????通過這種方式，我們可以使用自定義的前綴和后綴來解析占位符，使配置文件更加靈活和可讀。

????????通過這些示例，我們可以看到，PropertySourcesPlaceholderConfigurer是一個強大的工具，能夠幫助我們靈活地處理和解析Spring應用程序中的占位符，從而更好地管理和外部化配置。

3. Spring中的內置類型轉換功能如何使用

????????Spring框架提供了強大的類型轉換功能，使得在應用程序中處理各種數據類型變得更加容易。內置的類型轉換功能可以自動處理簡單類型（如String到Integer）的轉換，并且支持更復雜的類型轉換需求。以下是詳細的使用方法和示例。

3.1 基本類型轉換

Spring能夠自動將配置文件中的String值轉換為常見的簡單類型。例如，我們可以將逗號分隔的String值轉換為String數組：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class MovieRecommender {private final String[] genres;public MovieRecommender(@Value("${genres}") String[] genres) {this.genres = genres;}public String[] getGenres() {return genres;}
}

????????在application.properties文件中定義genres的值：

genres=Action,Comedy,Thriller

????????使用上述配置，Spring將自動將逗號分隔的String值轉換為String數組并注入到genres字段中。

3.2 自定義類型轉換

有時，我們可能需要處理更復雜的類型轉換需求，例如將String轉換為自定義的對象類型。為此，我們可以創建一個自定義的Converter并注冊到Spring的ConversionService中：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;public class StringToGenreConverter implements Converter<String, Genre> {@Overridepublic Genre convert(String source) {return new Genre(source);}
}

接下來，我們需要在配置類中注冊這個自定義轉換器：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.support.DefaultFormattingConversionService;@Configuration
public class AppConfig {@Beanpublic DefaultFormattingConversionService conversionService() {DefaultFormattingConversionService conversionService = new DefaultFormattingConversionService();conversionService.addConverter(new StringToGenreConverter());return conversionService;}
}

現在，我們可以在Spring Bean中使用這個自定義轉換器進行類型轉換:

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class MovieRecommender {private final Genre genre;public MovieRecommender(@Value("${genre}") Genre genre) {this.genre = genre;}public Genre getGenre() {return genre;}
}

在application.properties文件中定義genre的值：

genre=Action
?

使用上述配置，Spring將自動將String值轉換為Genre對象并注入到genre字段中。

3.3 集成Spring表達式語言（SpEL）

Spring表達式語言（SpEL）不僅支持簡單的類型轉換，還支持更復雜的數據處理和轉換需求。我們可以在@Value注解中使用SpEL表達式進行動態值計算和注入：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;@Component
public class MovieRecommender {private final int movieCount;public MovieRecommender(@Value("#{T(java.lang.Integer).parseInt('${movie.count}') + 10}") int movieCount) {this.movieCount = movieCount;}public int getMovieCount() {return movieCount;}
}

在application.properties文件中定義movie.count的值：

movie.count=100
?

????????使用上述配置，Spring將解析SpEL表達式并將計算結果注入到movieCount字段中。在這個示例中，最終注入的值將是110（100 + 10）。

4. 總結

在本文中，我們詳細介紹了如何在Spring框架中使用@Value注解，以及如何配置和使用PropertySourcesPlaceholderConfigurer。具體內容包括：

如何在Spring中使用@Value注解
- 基本用法：通過@Value注解將外部化配置文件中的屬性值注入到Spring Bean中，例如將catalog.name屬性的值注入到MovieRecommender類的catalog字段。
- 提供默認值：在@Value注解中提供默認值，以確保在缺少配置時應用程序仍能正常工作。
如何配置和使用PropertySourcesPlaceholderConfigurer
- 基本配置：定義PropertySourcesPlaceholderConfigurer bean，確保在Spring初始化時解析所有的占位符。
- 處理未解析的占位符：配置PropertySourcesPlaceholderConfigurer使其在遇到未解析的占位符時拋出異常，從而嚴格控制配置的完整性。
- 自定義占位符前綴和后綴：通過setPlaceholderPrefix和setPlaceholderSuffix方法自定義占位符前綴和后綴，確保配置文件的靈活性和可讀性。
Spring中的內置類型轉換功能如何使用
- 基本類型轉換：Spring自動將配置文件中的String值轉換為常見的簡單類型，例如將逗號分隔的String值轉換為String數組。
- 自定義類型轉換：創建自定義的Converter并注冊到Spring的ConversionService中，實現復雜類型的自動轉換，例如將String轉換為自定義的Genre對象。
- 集成Spring表達式語言（SpEL）：使用SpEL表達式進行動態值計算和注入，實現更復雜的數據處理需求。