歡迎光臨
每天分享高質量文章

SpringBoot | 第六章:常用註解介紹及簡單使用

(點選上方公眾號,可快速關註)


來源:oKong ,

blog.lqdev.cn/2018/07/16/springboot/chapter-six/

前言

之前幾個章節,大部分都是算介紹springboot的一些外圍配置,比如日誌配置等。這章節開始,開始總結一些關於springboot的綜合開發的知識點。由於SpringBoot本身是基於Spring和SpringMvc等各類spring家族的一個解決方案,可快速進行集合。故相關知識點其實大部分都是基於spring或者springmvc既有的知識點的。本章節,主要講解的是關於web開發及springboot獨有的一些常用註解進行說明。

常用註解

@SpringBootApplication

前幾章,在系統啟動類裡面,都加入了此啟動註解,此註解是個組合註解,包括了@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan註解。

  • @SpringBootConfiguration 繼承至@Configuration,對於熟悉spring的開發者而言,此標註當前類是配置類,並會將當前類內宣告的一個或多個以@Bean註解標記的方法的實體納入到srping容器中,並且實體名就是方法名。

  • @EnableAutoConfiguration 這個註解就是springboot能自動進行配置的魔法所在了。主要是透過此註解,能所有符合自動配置條件的bean的定義載入到spring容器中,比如根據spring-boot-starter-web ,來判斷你的專案是否需要添加了webmvc和tomcat,就會自動的幫你配置web專案中所需要的預設配置。具體的使用,會在後期自定義實現一個自動啟動類時,會講解到它的一些機制。此章節就不深入了,只需要它是這個用途即可,一般上也單獨使用不要這個註解,但比如需要排除一些無需自動配置的類時,可利用exclude進行排除。

  • @ComponentScan 這個熟悉spring的開發者也應該熟悉,會掃描當前包及其子包下被@Component,@Controller,@Service,@Repository等註解標記的類並納入到spring容器中進行管理。

@Controller 和 @RestController

@RestController 是Spring4之後加入的註解,原來在@Controller中傳回json需要@ResponseBody來配合,如果直接用@RestController替代@Controller就不需要再配置@ResponseBody,預設傳回json格式。而@Controller是用來建立處理http請求的物件,一般結合@RequestMapping使用。

@RequestMapping

一個用來處理請求地址對映的註解,可用於類或方法上。用於類上,表示類中的所有響應請求的方法都是以該地址作為父路徑。

常用屬性(摘抄至網路):

value, method;

  • value: 指定請求的實際地址,指定的地址可以是URI Template 樣式(後面將會說明);

  • method: 指定請求的method型別, GET、POST、PUT、DELETE等;


consumes,produces;


  • consumes: 指定處理請求的提交內容型別(Content-Type),例如application/json, text/html;

  • produces: 指定傳回的內容型別,僅當request請求頭中的(Accept)型別中包含該指定型別才傳回;

params,essay-headers;

  • params: 指定request中必須包含某些引數值是,才讓該方法處理。

  • essay-headers: 指定request中必須包含某些指定的essay-header值,才能讓該方法處理請求。

常用的基本上就value和method了。其簡化註解有

@GetMapping 等同於 @RequestMapping(method = RequestMethod.GET)

@PostMapping 等同於 @RequestMapping(method = RequestMethod.POST)

@PutMapping 等同於 @RequestMapping(method = RequestMethod.PUT)

@DeleteMapping 等同於 @RequestMapping(method = RequestMethod.DELETE)

@PatchMapping 等同於 @RequestMapping(method = RequestMethod.PATCH)

@RequestBody和@ResponseBody

  • @RequestBody註解允許request的引數在reqeust體中,常常結合前端POST請求,進行前後端互動。

  • @ResponseBody註解支援將的引數在reqeust體中,通常傳回json格式給前端。

@PathVariable、@RequestParam、@RequestAttribute

@PathVariable用來接收引數,如/path/001,可接收001作為引數

@RequestParam 用來接收URL中的引數,如/param?id=001,可接收001作為引數

@RequestAttribute用於訪問由過濾器或攔截器建立的、預先存在的請求屬性,效果等同與request.getAttrbute().

@Component、@Service、@Repository

這三者都是申明一個單例的bean類並納入spring容器中,後兩者其實都是繼承於@Component。

  • @Component 最普通的元件,可以被註入到spring容器進行管理

  • @Repository 作用於持久層

  • @Service 作用於業務邏輯層

通常一些類無法確定是使用@Service還是@Component時,註解使用@Component,比如redis的配置類等

@ModelAttribute

主要是系結請求引數到指定物件上。此註解可被用於方法、引數上。

  • 運用在引數上,會將客戶端傳遞過來的引數按名稱註入到指定物件中,並且會將這個物件自動加入ModelMap中,便於View層使用;

  • 運用在方法上,會在每一個@RequestMapping標註的方法前執行,如果有傳回值,則自動將該傳回值加入到ModelMap中;

由於現在都採用前後端分離開發,故此註解相對用的較少了,但對於一些在每次請求前需要進行一些額外操作時。使用此註解依然是個選擇,比如進行統一的業務校驗等,但使用此註解實現類似功能時需要註意,使用非同步呼叫時,比如callable或者DeferredResult時,被此註解的方法會執行兩次,因為非同步請求時,是掛起另一個執行緒去重新執行,對於配置了攔截器而已,它們的執行順序為

preHandle —->afterConcurrentHandlingStarted —-> Controller—->preHandler—-> postHandler —-> afterCompletion

攔截器的相關知識點會在下章進行說明,這裡只是特殊說明下。解決方案的話可簡單根據DispatcherType型別進行判斷,非同步時對應型別為:ASYNC,第一次請求正常為:REQUEST。

總結

本章節主要是闡述了在web開發時一些常用的註解,但比如一些像@autowired、@resource、@Qualifier等在此就不列舉了,這些都比較簡單。對於開發者而言這些基本上都瞭解。

最後

目前網際網路上很多大佬都有springboot系列教程,如有雷同,請多多包涵了。本文是作者在電腦前一字一句敲的,每一步都是實踐的。若文中有所錯誤之處,還望提出,謝謝。

系列


【關於投稿】


如果大家有原創好文投稿,請直接給公號傳送留言。


① 留言格式:
【投稿】+《 文章標題》+ 文章連結

② 示例:
【投稿】《不要自稱是程式員,我十多年的 IT 職場總結》:http://blog.jobbole.com/94148/

③ 最後請附上您的個人簡介哈~



看完本文有收穫?請轉發分享給更多人

關註「ImportNew」,提升Java技能

贊(0)

分享創造快樂