本文我們來梳理一下Spring的那些註解，如下圖所示，大概從幾方面列出了Spring的一些註解：
聊聊Spring家族中的那幾百個註解
如果此圖看不清楚也沒事，請運行下面的代碼輸出所有的結果。
Spring目前的趨勢是使用註解結合Java代碼而不是配置來定義行爲、屬性、功能、規則和擴展點，因此梳理註解也是梳理Spring功能點的很好的方式，全面的梳理可以補足我們知識點的漏洞。
查找所有註解
首先，我們來創建一個項目，使用SPRING INITIALIZR生成一個引入Spring各種組件的項目模板，然後引入如下工具包：
<dependency>
<groupId>org.reflections</groupId>
<artifactId>reflections</artifactId>
<version>0.9.11</version>
</dependency>
通過這個反射工具包，我們可以創建一個Spring Boot應用程序，以一行代碼打印出所有Spring框架的註解：
import org.reflections.Reflections;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;
import java.lang.annotation.Annotation;
@Component
public class ScanAnnotationRunner implements CommandLineRunner { @Override
public void run(String... args)
throws Exception {
new Reflections("org.springframework")
.getSubTypesOf(Annotation.class)
.stream()
.map(clazz->clazz.getName())
.sorted()
.forEach(System.out::println);
}
}
輸出結果，下面我們逐一進行梳理其中的一些重要註解。
001
org.springframework.beans.factory.annotation.Autowired
002
org.springframework.beans.factory.annotation.Configurable
003
org.springframework.beans.factory.annotation.Lookup
004
org.springframework.beans.factory.annotation.Qualifier
005
org.springframework.beans.factory.annotation.Required
006
org.springframework.beans.factory.annotation.Value
007
org.springframework.boot.SpringBootConfiguration
008
org.springframework.boot.autoconfigure.AutoConfigurationPackage
009
org.springframework.boot.autoconfigure.AutoConfigureAfter
010
org.springframework.boot.autoconfigure.AutoConfigureBefore
011
org.springframework.boot.autoconfigure.AutoConfigureOrder
012
org.springframework.boot.autoconfigure.EnableAutoConfiguration
013
org.springframework.boot.autoconfigure.ImportAutoConfiguration
014
org.springframework.boot.autoconfigure.SpringBootApplication
015
org.springframework.boot.autoconfigure.condition.ConditionalOnBean
016
org.springframework.boot.autoconfigure.condition.ConditionalOnClass
017
org.springframework.boot.autoconfigure.condition.ConditionalOnCloudPlatform
018
org.springframework.boot.autoconfigure.condition.ConditionalOnExpression
019
org.springframework.boot.autoconfigure.condition.ConditionalOnJava
020
org.springframework.boot.autoconfigure.condition.ConditionalOnJndi
021
org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean
022
org.springframework.boot.autoconfigure.condition.ConditionalOnMissingClass
023
org.springframework.boot.autoconfigure.condition.ConditionalOnNotWebApplication
024
org.springframework.boot.autoconfigure.condition.ConditionalOnProperty
025
org.springframework.boot.autoconfigure.condition.ConditionalOnResource
026
org.springframework.boot.autoconfigure.condition.ConditionalOnSingleCandidate
027
org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication
028
org.springframework.boot.autoconfigure.data.ConditionalOnRepositoryType
029
org.springframework.boot.autoconfigure.domain.EntityScan
030
org.springframework.boot.autoconfigure.flyway.FlywayDataSource
031
org.springframework.boot.autoconfigure.liquibase.LiquibaseDataSource
032
org.springframework.boot.autoconfigure.quartz.QuartzDataSource
033
org.springframework.boot.autoconfigure.web.ConditionalOnEnabledResourceChain
034
org.springframework.boot.autoconfigure.web.servlet.ConditionalOnMissingFilterBean
035
org.springframework.boot.context.properties.ConfigurationProperties
036
org.springframework.boot.context.properties.ConfigurationPropertiesBinding
037
org.springframework.boot.context.properties.DeprecatedConfigurationProperty
038
org.springframework.boot.context.properties.EnableConfigurationProperties
039
org.springframework.boot.context.properties.NestedConfigurationProperty
040
org.springframework.boot.convert.DataSizeUnit
041
org.springframework.boot.convert.Delimiter
042
org.springframework.boot.convert.DurationFormat
043
org.springframework.boot.convert.DurationUnit
044
org.springframework.boot.jackson.JsonComponent
045
org.springframework.boot.web.server.LocalServerPort
046
org.springframework.boot.web.servlet.ServletComponentScan
047
org.springframework.cache.annotation.CacheConfig
048
org.springframework.cache.annotation.CacheEvict
049
org.springframework.cache.annotation.CachePut
050
org.springframework.cache.annotation.Cacheable
051
org.springframework.cache.annotation.Caching
052
org.springframework.cache.annotation.EnableCaching
053
org.springframework.context.annotation.Bean
054
org.springframework.context.annotation.ComponentScan
055
org.springframework.context.annotation.ComponentScan$Filter
056
org.springframework.context.annotation.ComponentScans
057
org.springframework.context.annotation.Conditional
058
org.springframework.context.annotation.Configuration
059
org.springframework.context.annotation.DependsOn
060
org.springframework.context.annotation.Description
061
org.springframework.context.annotation.EnableAspectJAutoProxy
062
org.springframework.context.annotation.EnableLoadTimeWeaving
063
org.springframework.context.annotation.EnableMBeanExport
064
org.springframework.context.annotation.Import
065
org.springframework.context.annotation.ImportResource
066
org.springframework.context.annotation.Lazy
067
org.springframework.context.annotation.Primary
068
org.springframework.context.annotation.Profile
069
org.springframework.context.annotation.PropertySource
070
org.springframework.context.annotation.PropertySources
071
org.springframework.context.annotation.Role
072
org.springframework.context.annotation.Scope
073
org.springframework.context.event.EventListener
074
org.springframework.core.annotation.AliasFor
075
org.springframework.core.annotation.Order
076
org.springframework.format.annotation.DateTimeFormat
077
org.springframework.format.annotation.NumberFormat
078
org.springframework.jmx.export.annotation.ManagedAttribute
079
org.springframework.jmx.export.annotation.ManagedMetric
080
org.springframework.jmx.export.annotation.ManagedNotification
081
org.springframework.jmx.export.annotation.ManagedNotifications
082
org.springframework.jmx.export.annotation.ManagedOperation
083
org.springframework.jmx.export.annotation.ManagedOperationParameter
084
org.springframework.jmx.export.annotation.ManagedOperationParameters
085
org.springframework.jmx.export.annotation.ManagedResource
086
org.springframework.lang.NonNull
087
org.springframework.lang.NonNullApi
088
org.springframework.lang.NonNullFields
089
org.springframework.lang.Nullable
090
org.springframework.lang.UsesJava7
091
org.springframework.lang.UsesJava8
092
org.springframework.lang.UsesSunHttpServer
093
org.springframework.lang.UsesSunMisc
094
org.springframework.objenesis.instantiator.annotations.Instantiator
095
org.springframework.scheduling.annotation.Async
096
org.springframework.scheduling.annotation.EnableAsync
097
org.springframework.scheduling.annotation.EnableScheduling
098
org.springframework.scheduling.annotation.Scheduled
099
org.springframework.scheduling.annotation.Schedules
100
org.springframework.stereotype.Component
101
org.springframework.stereotype.Controller
102
org.springframework.stereotype.Indexed
103
org.springframework.stereotype.Repository
104
org.springframework.stereotype.Service
105
org.springframework.validation.annotation.Validated
有關注解
Java的Annotation註解（類似於C#的Attribute特性），說白了就是給代碼打上標籤的能力。我們可以配置這個標籤的保留階段，僅源代碼，源代碼+字節碼，源代碼+字節碼+運行時。通過引入註解，我們可以簡單快速賦予代碼生命力，大大提高代碼可讀性和擴展性。註解本身不具有任何能力，只是一個標籤，但是我們可以定義各種標籤然後實現各種標籤處理器來對類、方法、屬性甚至參數等進行功能擴展、功能開啓、屬性定義、行爲定義、規則定義、關聯處理、元數據定義等等。在實現各種框架的時候，我們經常會自定義標籤方便框架使用者僅僅通過在合適的地方引入合適的註解來啓用（或自定義）框架的一些能力並應用到我們的程序中。
不僅僅是框架的作者會大量使用註解，在之前的系列文章中我們也多次自定義註解，我們有通過定義@Metrics註解配合Spring AOP來爲程序啓動打點、日誌、異常等功能，我們有通過定義@Sign註解配合Spring MVC的ResponseBodyAdvice進行數據簽名功能，我們還經常會定義各種自定義註解配合Spring MVC的HandlerMethodArgumentResolver進行權限的校驗等等功能。採用這種模式，我們的核心業務邏輯可以保持清晰乾淨，通過註解配合AOP賦予代碼額外的能力。
你可能會說，註解還是有侵入性，我們需要耦合框架定義的那些註解，這個問題其實是無解的，100%無侵入性也代表了可讀性的降低，代碼的功能和能力應當聚合在一起，這也就是爲什麼Spring現在也不建議採用XML來做配置。Java核心類庫並沒有什麼註解，好在Spring已經有了大量註解，而Spring也變爲了Java開發的標準，所以其實我們很多時候如果希望自己的框架（RPC啥的）完全沒有侵入性的話可以借用Spring的那些註解@Autowired、@Controller、@Service等註解，配合各種包的規範其實我們可以對目標元素的功能識別個八九不離十，完全有可能實現0侵入的功能增強。
有關如何實現自定義註解不贅述，這裏我們簡單回顧一下幾個元註解（註解的註解）：
A. @Documented：將會在被此註解註解的元素的javadoc文檔中列出註解，一般都打上這個註解沒壞處
B. @Target：註解能被應用的目標元素，比如類、方法、屬性、參數等等，需要仔細思考
C. @Retention：僅在源碼保留，還是保留到編譯後的字節碼，還是到運行時也去加載，超過90%的應用會在運行時去解析註解進行額外的處理，所以大部分情況我們都會設置配置爲RetentionPolicy.RUNTIME
D. @Inherited：如果子類沒有定義註解的話，能自動從父類獲取定義了繼承屬性的註解，比如Spring的@Service是沒有繼承特性的，但是@Transactional是有繼承特性的，在OO繼承體系中使用Spring註解的時候請特別注意這點，理所當然認爲註解是能被子類繼承的話可能會引起不必要的Bug，需要仔細斟酌是否開啓繼承
E. @Repeatable：Java 8 引入的特性，通過關聯註解容器定義可重複註解，小小語法糖提高了代碼可讀性，對於元素有多個重複註解其實是很常見的事情，比如某方法可以是A角色可以訪問也可以是B角色可以訪問，某方法需要定時任務執行，要在A條件執行也需要在B條件執行
F. @Native：是否在.h頭文件中生成被標記的字段，除非原生程序需要和Java程序交互，否則很少會用到這個元註解
現在我們來從幾個方面逐一溫習一下Spring的那些常用的值得關注的註解。
Spring核心註解
A. 首先來看一下各種stereotype：按分類定義了由Spring管理的各種組件，@Controller定義表現層組件，@Service定義業務邏輯層組件，@Repository定義數據訪問層資源庫組件，@Component定義其它組件（比如訪問外部服務的組件），之前也說過了隨着這些註解功能無區別，但是對組件進行合適的分類意義重大，不僅僅增加可讀性而且方便我們通過AOP對不同類型的組件進行更多自動增強
B.再來看看IOC相關的一些註解：@Autowired自動裝配不用多說了；@Required用於在setter方法標記屬性值需要由Spring進行裝配，對於目前版本的Spring這個註解已經廢棄，現在Spring更推薦使用構造方法注入；@Qualifier用於通過給Bean定義修飾語來注入相應的Bean，和@Autowired一起使用相當於@Resource的效果，當然還有一種常見用法是嵌入其它註解用於對Bean進行區分，然後配合@Autowired一起使用，參見後面提到的Spring Cloud的@LoadBalanced註解；@Value用於注入屬性配置或SpEL表達式（前者是我們常見用法，後者可以從其它對象獲取值，功能更強大一點）；@Lookup可以實現方法注入，如果我們的類是單例的，但是又希望Spring注入的依賴的對象是Prototype生命週期（每次new一個出來）的，這個時候可以通過此註解進行方法注入
C. 然後來看一下有關事務的幾個註解：@EnableTransactionManagement用於開啓事務管理，使用Spring Boot如果引入Spring Data的話不需要手動開啓（不過建議大家在使用事務的時候還是通過日誌來驗證事務管理是否生效）；@Transactional大家都知道用於開啓事務以及設置傳播性、隔離性、回滾條件等；@TransactionalEventListener用於配置事務的回調方法，可以在事務提交前、提交後、完成後以及回滾後幾個階段接受回調事件。
D. @Order註解可以設置Spring管理對象的加載順序，在之前介紹AOP的文章中我們看到有的時候我們必須通過設置合理的@Order來合理安排切面的切入順序避免一些問題，還有在一些業務場景中，我們往往會去定義一組類似於Filter的@Component，然後會從容器獲得一組Bean，這個時候業務組件的運行順序往往會比較重要，也可以通過這個方式進行排序
E. @AliasFor註解可以設置一組註解屬性相互作爲別名，對於有歧義的時候會使代碼更清晰，此外還有一個用途是創建複合註解，Spring MVC的@GetMapping註解就是基於@RequestMapping這個註解創建的複合註解，我們可以很方便得通過這種方式來實現註解的繼承
Spring上下文註解
A. 首先來看一下配置相關的一些註解：@Configuration用於標註配置類，啓用Java配置方式的Bean配置；@Bean用於配置一個Bean；@ComponentScan（@ComponentScans用於配置一組@ComponentScan，Java 8可以直接使用重複註解特性配置多個@ComponentScan）用於掃描包方式配置Bean；@PropertySource以及 @PropertySources用於導入配置文件；@Conditional用於設置關聯的條件類，在合適的時候啓用Bean的配置（Spring Boot自動配置根基）；@Import用於導入其它配置類； @ImportResource用於導入非Java配置方式的XML配置；@Profile用於指定在合適的Profile下啓用配置；@Lazy用於告知容器延遲到使用的時候實例化Bean（默認情況下容器啓動的時候實例化Bean來檢查所有的問題）；@Description用於給Bean設置描述；@Scope用於設置Bean的生命週期；@Primary用於在定義了多個Bean的時候指定首選的Bean
B. 其它一些註解包括：@EventListener用於設置回調方法監聽Spring制定的以及自定義的各種事件；@EnableAspectJAutoProxy用於開啓支持AspectJ的 @Aspect切面配置支持，使用Spring Boot引入了AOP啓動器的話不需要顯式開啓
Spring Web註解
Spring MVC的各種註解對應了Spring MVC各方面的功能，下面我們來了解一下：
A. 首先是三個定義了Bean特殊生命週期的複合註解：@RequestScope、@SessionScope和 @ApplicationScope。在Web應用中，我們可能需要Bean跟隨請求、會話和應用程序的聲明週期來進行創建，這個時候可以直接使用這三個快捷的複合註解
B. 接下去可以看到各種 @XXXMapping的註解，分別用於配置HandlerMethod匹配到不同的Http Method，當然不使用這些快捷的註解也是可以的，直接使用@RequestMapping然後手動設置method
C. @ResponseStatus可以用到方法上也可以用到異常上，前者會直接使請求得到指定的響應代碼或原因（可以配合@ExceptionHandler使用），後者可以實現遇到指定異常的時候給出指定的響應代碼或原因，@ResponseBody我們實現Restful接口的時候（@RestController）最常用了，把返回內容（序列化後）輸出到請求體
D. Spring MVC給了我們各種註解方便我們從HTTP請求各種地方獲取參數，@RequestBody從請求體（處理複雜數據，比如JSON），@RequestHeader從請求頭，@CookieValue從cookie中，@SessionAttribute從會話中，@RequestAttribute從請求的Attribute中（比如過濾器和攔截器手動設置的一些臨時數據），@RequestParam從請求參數（處理簡單數據，鍵值對），@PathVariable從路徑片段，@MatrixAttribute矩陣變量允許我們採用特殊的規則在URL路徑後加參數（分號區分不同參數，逗號爲參數增加多個值）
E. @ControllerAdvice是一個重要註解，允許我們在集中的地方配置控制器（有@RequestMapping的方法）相關的增強（@RestControllerAdvice也是差不多的，只是相當於爲@ExceptionHandler加上了@ResponseBody）。那麼可以應用哪些增強呢？首先是可以用 @ExceptionHandler進行統一的全局異常處理；第二是 @InitBinder用來設置WebDataBinder，WebDataBinder用來自動綁定前臺請求參數到Model中；第三是 @ModelAttribute讓全局的@RequestMapping都能獲得在此處設置的鍵值對。當然，這裏說的@InitBinder和@ExceptionHandler也可以不定義在@ControllerAdvice內部（作爲全局開啓），定義在Controller內部應用到某個Controller也是可以的
F. 其它還有一些註解比如：@CrossOrigin可以用到Controller或Method上（需要配合@RequestMapping）設置細粒度的跨域行爲
在之前的文章中我們也提到，對於Spring MVC，定義自己的註解應用到參數、方法、控制器上，配合HandlerMethodArgumentResolver、XXAdvise、以及Interceptor實現具體的功能來使用太太常見了，幾乎所有的非業務橫切關注點，我們都不應該在方法實現中重複任何一行代碼。
Spring Boot註解
A. 來看一下上下文相關的註解：@ConfigurationProperties很常用（配合 @EnableConfigurationProperties註解來設置需要啓用的配置類），用來自定義配置類和配置文件進行關聯；@DeprecatedConfigurationProperty用於標記廢棄的配置以及設置替代配置和告知廢棄原因；@ConfigurationPropertiesBinding用於指定自定義的轉換器用於配置解析的時的類型轉換； @NestedConfigurationProperty用於關聯外部的類型作爲嵌套配置類
B. 再看看自動配置相關的註解，自動配置是Spring Boot最重要的特性，在之前的系列文章中我有提到一個觀點，IOC是好事情，但是把組件內部的一些默認配置以及組件和組件的組裝交給外部用戶來配置其實是不合理的，組件應當可以自動進行自我配置實現開箱急用，只有需要自定義組件的時候纔要求外部來進行個性化配置：@EnableAutoConfiguration註解可以啓用自動配置，Spring Boot應用程序一般我們會直接使用複合註解@SpringBootApplication；@AutoConfigureOrder（值越小優先級越高）、@AutoConfigureAfter、@AutoConfigureBefore用於設置自動配置類加載順序，以及精確控制加載依賴關係，有的時候我們的自動配置需要相互依賴或者會相互干擾，需要手動調節
C. 最後來看一下十幾種配置條件，用好這些註解是實現完善的自動配置的關鍵：@ConditionalOnBean用於僅當容器中已經包含指定的Bean類型或名稱時才匹配條件；@ConditionalOnClass僅當classpath上存在指定類時條件匹配；@ConditionalOnCloudPlatform僅當指定的雲平臺處於活動狀態時條件匹配；@ConditionalOnExpression依賴於SpEL表達式的值的條件元素的配置註解；@ConditionalOnJava基於應用運行的JVM版本的條件匹配；@ConditionalOnJndi基於JNDI可用和可以查找指定位置的條件匹配；@ConditionalOnMissingBean僅當容器中不包含指定的Bean類型或名稱時條件匹配；@ConditionalOnMissingClass僅當classpath上不存在指定類時條件匹配；@ConditionalOnNotWebApplication 僅當不是WebApplicationContext（非Web項目）時條件匹配，對應 @ConditionalOnWebApplication；@ConditionalOnProperty是檢查指定的屬性是否具有指定的值；@ConditionalOnResource表示僅當 classpath 上存在指定資源時條件匹配；@ConditionalOnSingleCandidate僅當容器中包含指定的Bean類並且可以判斷只有單個候選者時條件匹配。其實所有這些實現原理都是擴展SpringBootCondition抽象類（實現之前提到的Condition接口），我們完全可以實現自己的條件註解（配合 @Conditional註解關聯到自己實現的SpringBootCondition）
Spring Cloud註解
在介紹本系列文章的第一篇中我們就提到了，Spring Cloud整齊劃一通過各種EnableXXX註解開啓某個功能，這裏就不對這些註解進行說明了，使用Spring Boot組件的功能非常簡單，基本就是引POM+EnableXXX+設置配置文件三部曲。
A. 首先是 Netflix包下的一些註解，各種EnableXXX就不說了，參考前一篇文章，之前沒介紹過 @RibbonClient，這個註解用來爲負載均衡客戶端做一些自定義的配置，可以進一步配置或自定義從哪裏獲取服務端列表、負載均衡策略、Ping也就是服務鑑活策略等等
B. client包下的 @SpringCloudApplication之前文章中我們也沒有使用到，這是一個複合註解就是 @SpringBootApplication+ @EnableDiscoveryClient+ @EnableCircuitBreaker，Spring Cloud那堆東西很多，還是自己親手定義一個一個功能的註解來的踏實； @LoadBalanced註解用於和RestTemplate配合使用構成一個負載均衡的Http客戶端，實現原理上其實這個註解是一個@Qualifier註解，Spring會爲所有@LoadBalanced的RestTemplate加入一個LoadBalancerInterceptor（實現ClientHttpRequestInterceptor）實現負載均衡
C. sleuth包下面的註解和鏈路跟蹤相關，比較常用的是通過 @SpanName手動設置span的名稱，其它註解對於業務開發並不常用
總結
好了，寫了本文我發現我看到@已經Markdown的**就眼花，請點贊支持。本文我們通過代碼打印出了大部分Spring相關的註解，你也可以通過這個方式熟悉其它框架的註解（畢竟註解是框架賦予我們各種便捷功能的一個重要入口，對註解瞭解個八九成也往往可以對框架賦予我們的豐富功能瞭解六七成）。然後我們梳理了一下Spring相關的各種註解，其中主要需要關注的是幾方面：
元註解，也就是註解的註解
Spring容器相關的一些註解，包括@Qualifier、@AliasFor、@Order等看似不重要但其實很重要的註解
Spring Java配置相關的一些註解，包括條件註解
Spring Boot自動配置相關的一些註解
很多註解可以同時應用到類型、方法、參數上，有的時候應用到不同的地方作用會略微不一樣，這個需要重點關注
我們知道註解其實只是一個標識，註解如何起作用背後的實現原理還是比較多樣的，你可以進一步結合本文介紹的Spring的各種註解探尋一下背後實現的原理。