40 個(gè) Spring Boot 常用注解
一、Spring Web MVC 與 Spring Bean 注解
Spring Web MVC 注解
@RequestMapping
@RequestMapping注解的主要用途是將Web請(qǐng)求與請(qǐng)求處理類(lèi)中的方法進(jìn)行映射。Spring MVC和Spring WebFlux都通過(guò)RquestMappingHandlerMapping和RequestMappingHndlerAdapter兩個(gè)類(lèi)來(lái)提供對(duì)@RequestMapping注解的支持。
@RequestMapping注解對(duì)請(qǐng)求處理類(lèi)中的請(qǐng)求處理方法進(jìn)行標(biāo)注；@RequestMapping注解擁有以下的六個(gè)配置屬性：
value:映射的請(qǐng)求URL或者其別名 method:兼容HTTP的方法名 params:根據(jù)HTTP參數(shù)的存在、缺省或值對(duì)請(qǐng)求進(jìn)行過(guò)濾 header:根據(jù)HTTP Header的存在、缺省或值對(duì)請(qǐng)求進(jìn)行過(guò)濾 consume:設(shè)定在HTTP請(qǐng)求正文中允許使用的媒體類(lèi)型 product:在HTTP響應(yīng)體中允許使用的媒體類(lèi)型
提示：在使用@RequestMapping之前，請(qǐng)求處理類(lèi)還需要使用@Controller或@RestController進(jìn)行標(biāo)記
下面是使用@RequestMapping的兩個(gè)示例：
@RequestMapping還可以對(duì)類(lèi)進(jìn)行標(biāo)記，這樣類(lèi)中的處理方法在映射請(qǐng)求路徑時(shí)，會(huì)自動(dòng)將類(lèi)上@RequestMapping設(shè)置的value拼接到方法中映射路徑之前，如下：
@RequestBody
@RequestBody在處理請(qǐng)求方法的參數(shù)列表中使用，它可以將請(qǐng)求主體中的參數(shù)綁定到一個(gè)對(duì)象中，請(qǐng)求主體參數(shù)是通過(guò)HttpMessageConverter傳遞的，根據(jù)請(qǐng)求主體中的參數(shù)名與對(duì)象的屬性名進(jìn)行匹配并綁定值。此外，還可以通過(guò)@Valid注解對(duì)請(qǐng)求主體中的參數(shù)進(jìn)行校驗(yàn)。下面是一個(gè)使用@RequestBody的示例：
@GetMapping
@GetMapping注解用于處理HTTP GET請(qǐng)求，并將請(qǐng)求映射到具體的處理方法中。具體來(lái)說(shuō)，@GetMapping是一個(gè)組合注解，它相當(dāng)于是@RequestMapping(method=RequestMethod.GET)的快捷方式。下面是@GetMapping的一個(gè)使用示例：
@PostMapping
@PostMapping注解用于處理HTTP POST請(qǐng)求，并將請(qǐng)求映射到具體的處理方法中。@PostMapping與@GetMapping一樣，也是一個(gè)組合注解，它相當(dāng)于是@RequestMapping(method=HttpMethod.POST)的快捷方式。下面是使用@PostMapping的一個(gè)示例：
@PutMapping
@PutMapping注解用于處理HTTP PUT請(qǐng)求，并將請(qǐng)求映射到具體的處理方法中，@PutMapping是一個(gè)組合注解，相當(dāng)于是@RequestMapping(method=HttpMethod.PUT)的快捷方式。下面是使用@PutMapping的一個(gè)示例：
@DeleteMapping
@DeleteMapping注解用于處理HTTP DELETE請(qǐng)求，并將請(qǐng)求映射到刪除方法中。@DeleteMapping是一個(gè)組合注解，它相當(dāng)于是@RequestMapping(method=HttpMethod.DELETE)的快捷方式。下面是使用@DeleteMapping的一個(gè)示例：
@PatchMapping
@PatchMapping注解用于處理HTTP PATCH請(qǐng)求，并將請(qǐng)求映射到對(duì)應(yīng)的處理方法中。@PatchMapping相當(dāng)于是@RequestMapping(method=HttpMethod.PATCH)的快捷方式。下面是一個(gè)簡(jiǎn)單的示例：
@ControllerAdvice
@ControllerAdvice是@Component注解的一個(gè)延伸注解，Spring會(huì)自動(dòng)掃描并檢測(cè)被@ControllerAdvice所標(biāo)注的類(lèi)。@ControllerAdvice需要和@ExceptionHandler、@InitBinder以及@ModelAttribute注解搭配使用，主要是用來(lái)處理控制器所拋出的異常信息。首先，我們需要定義一個(gè)被@ControllerAdvice所標(biāo)注的類(lèi)，在該類(lèi)中，定義一個(gè)用于處理具體異常的方法，并使用@ExceptionHandler注解進(jìn)行標(biāo)記。此外，在有必要的時(shí)候，可以使用@InitBinder在類(lèi)中進(jìn)行全局的配置，還可以使用@ModelAttribute配置與視圖相關(guān)的參數(shù)。使用@ControllerAdvice注解，就可以快速的創(chuàng)建統(tǒng)一的，自定義的異常處理類(lèi)。下面是一個(gè)使用@ControllerAdvice的示例代碼：
@ResponseBody
@ResponseBody會(huì)自動(dòng)將控制器中方法的返回值寫(xiě)入到HTTP響應(yīng)中。特別的，@ResponseBody注解只能用在被@Controller注解標(biāo)記的類(lèi)中。如果在被@RestController標(biāo)記的類(lèi)中，則方法不需要使用@ResponseBody注解進(jìn)行標(biāo)注。@RestController相當(dāng)于是@Controller和@ResponseBody的組合注解。下面是使用該注解的一個(gè)示例
@ExceptionHandler
@ExceptionHander注解用于標(biāo)注處理特定類(lèi)型異常類(lèi)所拋出異常的方法。當(dāng)控制器中的方法拋出異常時(shí)，Spring會(huì)自動(dòng)捕獲異常，并將捕獲的異常信息傳遞給被@ExceptionHandler標(biāo)注的方法。下面是使用該注解的一個(gè)示例：
@ResponseStatus
@ResponseStatus注解可以標(biāo)注請(qǐng)求處理方法。使用此注解，可以指定響應(yīng)所需要的HTTP STATUS。特別地，我們可以使用HttpStauts類(lèi)對(duì)該注解的value屬性進(jìn)行賦值。下面是使用@ResponseStatus注解的一個(gè)示例：
@PathVariable
@PathVariable注解是將方法中的參數(shù)綁定到請(qǐng)求URI中的模板變量上。可以通過(guò)@RequestMapping注解來(lái)指定URI的模板變量，然后使用@PathVariable注解將方法中的參數(shù)綁定到模板變量上。特別地，@PathVariable注解允許我們使用value或name屬性來(lái)給參數(shù)取一個(gè)別名。下面是使用此注解的一個(gè)示例：
模板變量名需要使用“{ }”進(jìn)行包裹，如果方法的參數(shù)名與URI模板變量名一致，則在@PathVariable中就可以省略別名的定義。下面是一個(gè)簡(jiǎn)寫(xiě)的示例：
提示：如果參數(shù)是一個(gè)非必須的，可選的項(xiàng)，則可以在@PathVariable中設(shè)置require = false
@RequestParam
@RequestParam注解用于將方法的參數(shù)與Web請(qǐng)求的傳遞的參數(shù)進(jìn)行綁定。使用@RequestParam可以輕松的訪(fǎng)問(wèn)HTTP請(qǐng)求參數(shù)的值。下面是使用該注解的代碼示例：
該注解的其他屬性配置與@PathVariable的配置相同，特別的，如果傳遞的參數(shù)為空，還可以通過(guò)defaultValue設(shè)置一個(gè)默認(rèn)值。示例代碼如下：
@Controller
@Controller是@Component注解的一個(gè)延伸，Spring會(huì)自動(dòng)掃描并配置被該注解標(biāo)注的類(lèi)。此注解用于標(biāo)注Spring MVC的控制器。下面是使用此注解的示例代碼：
@RestController
@RestController是在Spring 4.0開(kāi)始引入的，這是一個(gè)特定的控制器注解。此注解相當(dāng)于@Controller和@ResponseBody的快捷方式。當(dāng)使用此注解時(shí)，不需要再在方法上使用@ResponseBody注解。下面是使用此注解的示例代碼：
@ModelAttribute
通過(guò)此注解，可以通過(guò)模型索引名稱(chēng)來(lái)訪(fǎng)問(wèn)已經(jīng)存在于控制器中的model。下面是使用此注解的一個(gè)簡(jiǎn)單示例：
與@PathVariable和@RequestParam注解一樣，如果參數(shù)名與模型具有相同的名字，則不必指定索引名稱(chēng)，簡(jiǎn)寫(xiě)示例如下：
特別地，如果使用@ModelAttribute對(duì)方法進(jìn)行標(biāo)注，Spring會(huì)將方法的返回值綁定到具體的Model上。示例如下：
在Spring調(diào)用具體的處理方法之前，被@ModelAttribute注解標(biāo)注的所有方法都將被執(zhí)行。
@CrossOrigin
@CrossOrigin注解將為請(qǐng)求處理類(lèi)或請(qǐng)求處理方法提供跨域調(diào)用支持。如果我們將此注解標(biāo)注類(lèi)，那么類(lèi)中的所有方法都將獲得支持跨域的能力。使用此注解的好處是可以微調(diào)跨域行為。使用此注解的示例如下：
@InitBinder
@InitBinder注解用于標(biāo)注初始化WebDataBinider的方法，該方法用于對(duì)Http請(qǐng)求傳遞的表單數(shù)據(jù)進(jìn)行處理，如時(shí)間格式化、字符串處理等。下面是使用此注解的示例：
二、Spring Bean 注解
在本小節(jié)中，主要列舉與Spring Bean相關(guān)的4個(gè)注解以及它們的使用方式。
@ComponentScan
@ComponentScan注解用于配置Spring需要掃描的被組件注解注釋的類(lèi)所在的包。可以通過(guò)配置其basePackages屬性或者value屬性來(lái)配置需要掃描的包路徑。value屬性是basePackages的別名。此注解的用法如下：
@Component
@Component注解用于標(biāo)注一個(gè)普通的組件類(lèi)，它沒(méi)有明確的業(yè)務(wù)范圍，只是通知Spring被此注解的類(lèi)需要被納入到Spring Bean容器中并進(jìn)行管理。此注解的使用示例如下：
@Service
@Service注解是@Component的一個(gè)延伸（特例），它用于標(biāo)注業(yè)務(wù)邏輯類(lèi)。與@Component注解一樣，被此注解標(biāo)注的類(lèi)，會(huì)自動(dòng)被Spring所管理。下面是使用@Service注解的示例：
@Repository
@Repository注解也是@Component注解的延伸，與@Component注解一樣，被此注解標(biāo)注的類(lèi)會(huì)被Spring自動(dòng)管理起來(lái)，@Repository注解用于標(biāo)注DAO層的數(shù)據(jù)持久化類(lèi)。此注解的用法如下：
三、Spring Dependency Inject 與 Bean Scops注解
Spring DI注解
@DependsOn
@DependsOn注解可以配置Spring IoC容器在初始化一個(gè)Bean之前，先初始化其他的Bean對(duì)象。下面是此注解使用示例代碼：
@Bean
@Bean注解主要的作用是告知Spring，被此注解所標(biāo)注的類(lèi)將需要納入到Bean管理工廠中。@Bean注解的用法很簡(jiǎn)單，在這里，著重介紹@Bean注解中initMethod和destroyMethod的用法。示例如下：
Scops注解
@Scope
@Scope注解可以用來(lái)定義@Component標(biāo)注的類(lèi)的作用范圍以及@Bean所標(biāo)記的類(lèi)的作用范圍。@Scope所限定的作用范圍有：singleton、prototype、request、session、globalSession或者其他的自定義范圍。這里以prototype為例子進(jìn)行講解。當(dāng)一個(gè)Spring Bean被聲明為prototype（原型模式）時(shí)，在每次需要使用到該類(lèi)的時(shí)候，Spring IoC容器都會(huì)初始化一個(gè)新的改類(lèi)的實(shí)例。在定義一個(gè)Bean時(shí)，可以設(shè)置Bean的scope屬性為prototype：scope=“prototype”,也可以使用@Scope注解設(shè)置，如下：
@Scope(value=ConfigurableBeanFactory.SCOPE_PROPTOTYPE)下面將給出兩種不同的方式來(lái)使用@Scope注解，示例代碼如下：
@Scope 單例模式
當(dāng)@Scope的作用范圍設(shè)置成Singleton時(shí)，被此注解所標(biāo)注的類(lèi)只會(huì)被Spring IoC容器初始化一次。在默認(rèn)情況下，Spring IoC容器所初始化的類(lèi)實(shí)例都為singleton。同樣的原理，此情形也有兩種配置方式，示例代碼如下：
四、容器配置注解
@Autowired
@Autowired注解用于標(biāo)記Spring將要解析和注入的依賴(lài)項(xiàng)。此注解可以作用在構(gòu)造函數(shù)、字段和setter方法上。
作用于構(gòu)造函數(shù)
下面是@Autowired注解標(biāo)注構(gòu)造函數(shù)的使用示例：
作用于setter方法
下面是@Autowired注解標(biāo)注setter方法的示例代碼：
作用于字段
@Autowired注解標(biāo)注字段是最簡(jiǎn)單的，只需要在對(duì)應(yīng)的字段上加入此注解即可，示例代碼如下：
@Primary
當(dāng)系統(tǒng)中需要配置多個(gè)具有相同類(lèi)型的bean時(shí)，@Primary可以定義這些Bean的優(yōu)先級(jí)。下面將給出一個(gè)實(shí)例代碼來(lái)說(shuō)明這一特性：
輸出結(jié)果：
this is send DingDing method message.@PostConstruct與@PreDestroy
值得注意的是，這兩個(gè)注解不屬于Spring,它們是源于JSR-250中的兩個(gè)注解，位于common-annotations.jar中。@PostConstruct注解用于標(biāo)注在Bean被Spring初始化之前需要執(zhí)行的方法。@PreDestroy注解用于標(biāo)注Bean被銷(xiāo)毀前需要執(zhí)行的方法。下面是具體的示例代碼：
@Qualifier
當(dāng)系統(tǒng)中存在同一類(lèi)型的多個(gè)Bean時(shí)，@Autowired在進(jìn)行依賴(lài)注入的時(shí)候就不知道該選擇哪一個(gè)實(shí)現(xiàn)類(lèi)進(jìn)行注入。此時(shí)，我們可以使用@Qualifier注解來(lái)微調(diào)，幫助@Autowired選擇正確的依賴(lài)項(xiàng)。下面是一個(gè)關(guān)于此注解的代碼示例：
五、Spring Boot注解
@SpringBootApplication
@SpringBootApplication注解是一個(gè)快捷的配置注解，在被它標(biāo)注的類(lèi)中，可以定義一個(gè)或多個(gè)Bean，并自動(dòng)觸發(fā)自動(dòng)配置Bean和自動(dòng)掃描組件。此注解相當(dāng)于@Configuration、@EnableAutoConfiguration和@ComponentScan的組合。在Spring Boot應(yīng)用程序的主類(lèi)中，就使用了此注解。示例代碼如下：
@SpringBootApplicationpublic class Application{public static void main(String [] args){SpringApplication.run(Application.class,args);}}
@EnableAutoConfiguration
@EnableAutoConfiguration注解用于通知Spring，根據(jù)當(dāng)前類(lèi)路徑下引入的依賴(lài)包，自動(dòng)配置與這些依賴(lài)包相關(guān)的配置項(xiàng)。
@ConditionalOnClass與@ConditionalOnMissingClass
這兩個(gè)注解屬于類(lèi)條件注解，它們根據(jù)是否存在某個(gè)類(lèi)作為判斷依據(jù)來(lái)決定是否要執(zhí)行某些配置。下面是一個(gè)簡(jiǎn)單的示例代碼：
@Configuration@ConditionalOnClass(DataSource.class)class MySQLAutoConfiguration {//...}
@ConditionalOnBean與@ConditionalOnMissingBean
這兩個(gè)注解屬于對(duì)象條件注解，根據(jù)是否存在某個(gè)對(duì)象作為依據(jù)來(lái)決定是否要執(zhí)行某些配置方法。示例代碼如下：
@Bean(name="dataSource")LocalContainerEntityManagerFactoryBean entityManagerFactory(){//...}@Bean@ConditionalOnMissingBeanpublic MyBean myBean(){//...}
@ConditionalOnProperty
@ConditionalOnProperty注解會(huì)根據(jù)Spring配置文件中的配置項(xiàng)是否滿(mǎn)足配置要求，從而決定是否要執(zhí)行被其標(biāo)注的方法。示例代碼如下：
@Bean(name="alipay",havingValue="on")Alipay alipay(){return new Alipay();}
@ConditionalOnResource
此注解用于檢測(cè)當(dāng)某個(gè)配置文件存在使，則觸發(fā)被其標(biāo)注的方法，下面是使用此注解的代碼示例：
(resources = "classpath:website.properties")Properties addWebsiteProperties(){//...}
@ConditionalOnWebApplication與@ConditionalOnNotWebApplication
這兩個(gè)注解用于判斷當(dāng)前的應(yīng)用程序是否是Web應(yīng)用程序。如果當(dāng)前應(yīng)用是Web應(yīng)用程序，則使用Spring WebApplicationContext,并定義其會(huì)話(huà)的生命周期。下面是一個(gè)簡(jiǎn)單的示例：
@ConditionalOnWebApplicationHealthCheckController healthCheckController(){//...}
@ConditionalExpression
此注解可以讓我們控制更細(xì)粒度的基于表達(dá)式的配置條件限制。當(dāng)表達(dá)式滿(mǎn)足某個(gè)條件或者表達(dá)式為真的時(shí)候，將會(huì)執(zhí)行被此注解標(biāo)注的方法。
@Bean@ConditionalException()LocalFileStore store(){//...}
@Conditional
@Conditional注解可以控制更為復(fù)雜的配置條件。在Spring內(nèi)置的條件控制注解不滿(mǎn)足應(yīng)用需求的時(shí)候，可以使用此注解定義自定義的控制條件，以達(dá)到自定義的要求。下面是使用該注解的簡(jiǎn)單示例：
(CustomConditioanl.class)CustomProperties addCustomProperties(){//...}
總結(jié)
本次課程總結(jié)了Spring Boot中常見(jiàn)的各類(lèi)型注解的使用方式，讓大家能夠統(tǒng)一的對(duì)Spring Boot常用注解有一個(gè)全面的了解。
由于篇幅的原因，關(guān)于Spring Boot不常用的一些注解，將在下一次分享中進(jìn)行補(bǔ)充和說(shuō)明。
關(guān)注公眾號(hào)：Java后端編程，回復(fù)下面關(guān)鍵字
要Java學(xué)習(xí)完整路線(xiàn)，回復(fù) 路線(xiàn)
缺Java入門(mén)視頻，回復(fù)： 視頻
要Java面試經(jīng)驗(yàn)，回復(fù) 面試
缺Java項(xiàng)目，回復(fù)： 項(xiàng)目
進(jìn)Java粉絲群： 加群
PS：如果覺(jué)得我的分享不錯(cuò)，歡迎大家隨手點(diǎn)贊、在看。
（完） 加我"微信" 獲取一份 最新Java面試題資料 請(qǐng)備注：666，不然不通過(guò)～
最近好文
1、GitHub 近兩萬(wàn) Star，可一鍵生成前后端代碼
最近面試BAT，整理一份面試資料《Java面試BAT通關(guān)手冊(cè)》，覆蓋了Java核心技術(shù)、JVM、Java并發(fā)、SSM、微服務(wù)、數(shù)據(jù)庫(kù)、數(shù)據(jù)結(jié)構(gòu)等等。 獲取方式：關(guān)注公眾號(hào)并回復(fù) java 領(lǐng)取，更多內(nèi)容陸續(xù)奉上。 明天見(jiàn)(??ω??)??