1. 程式人生 > >Spring中與Spring相關的註解

Spring中與Spring相關的註解

# 一、Spring的常用元件類註解
## @Component
    被該註解所修飾的類是一個普通的spring bean類,該註解可以替代@Controller、@Service、@Repository.在不確定具體的bean的時候,可以選擇使用@Component註解,但是一般不建議使用。
## @Controller
    被@Controller修飾的類是一個控制器元件類,對應框架的控制層
## @Service
    被@Service標註的類是一個業務邏輯元件類,對應框架的業務層
## @Repository
    被@Repository標註的類是一個DAO元件類,對應框架的持久層
### 目前這幾種註解是出鏡率比較高的元件類註解,這四種註解實質上是屬於同一類註解,用法相同,功能相同,區別就在於標識元件的型別。需要注意的是:1、被註解的Java類當做Bean例項,Bean例項的名稱預設是Bean類的首字母小寫,其他部分不變,@Service也可以自定義Bean名稱,但是必須是唯一的。2、儘量使用對應元件註解的類去替代@Component註解,因為在spring的各個版本中,@Controller、@Service、@Repository會攜帶更多的語義;3、指定了某些類可以作為Spring Bean類使用後,最好還需要讓spring搜尋指定路徑,在spring中加入如下配置:
### <!-- 自動掃描指定包及其子包下的所有類 -->
### <context:Component-scan base-package="com.itheima.*" />

# 二、在裝配Bean的時常用註解
## @Autowired:屬於spring的org.springframework.beans.factory.annotation包下,可用於為類的屬性、構造器、方法進行注值,預設情況下,被該註解修飾的bean是必須存在的,如果想實現不管這個類是否存在都可以正常注入的話,就需要設定該註解的一個屬性值,required的值為false就行了。如果在容器中存在多個相同型別的Bean,那麼啟動容器時會報找不到指定型別Bean的異常,在這個時候就需要結合@Qualified註解進行限定,指定注入的bean的名稱。
## @Resource:不屬於spring的註解,而是來自於JSR-250位於Java.annotation包下,使用該annotation為目標bean指定協作的Bean。該註解中有兩個比較重要的屬性,name和type屬性,name屬性指定byName(即按名稱注入),如果沒有指定該屬性值,當標註在欄位上,就預設取欄位的名稱作為bean名稱去尋找依賴物件,當註解標註在setter方法上,即預設取屬性名作為bean名稱尋找依賴物件。還有一點就是,如果@Resource註解沒有指定name屬性,並且按照預設的名稱仍然找不到依賴物件時,那麼就會退回到按照型別來注入,但是一旦指定了name屬性,就只能按照名稱裝配。
## @PostConstruct 和 @PreDestory方法,實現初始化和銷燬bean之前進行的操作

# SpringMvc常用註解
## 1、在Web模組中常用到的註解:
 - @Controller:在springmvc中,被該註解標識的類會作為與前端作互動的控制層元件,通過服務介面定義的提供訪問應用程式的一種行為,解釋使用者的輸入,並將其轉換為一個模型然後將檢視呈現給使用者。它還可以自動檢測定義在類路徑下的元件(配置檔案中配置掃描路徑)並自動註冊。
 - @RequestMapping:使用該註解,可以將url對映到整個處理類或特定的處理請求的方法,可以只用萬用字元。
```
@Controller
@RequestMapping("/happy")
public class HappyController  {

  @Autowired
  private HappyService happyService;

  @RequestMapping(/hello/*)
  public void sayHello(){
        //請求為 /happy/hello/* 都會進入這個方法!
        //例如:/happy/hello/123   /happy/hello/adb
        //可以通過get/post 請求
  }
  @RequestMapping(value="/haha",method=RequestMethod.GET)
  public void sayHaHa(){
  //只能通過get請求
  }
...
}
```
通過上面的程式碼可以看出,@RequestMapping既可以用在類級別,也可以用在方法級別,當它定義在類級別的時候,標明該控制器所處理的請求都將被對映到這個路徑下。另外,@RequestMapping中可以使用method屬性,如果指定了method屬性的值,那麼就只能使用指定的請求方法,如果沒有指定的話,那麼就可以使用HTTP的get/post方法了。
 - @RequestParam:這個註解是使用在方法的形參上的,主要用途就是將請求的引數繫結到方法的形參上,有一個required屬性,預設情況下是true,就是必須要傳引數,如果想該形參可傳可不傳引數的話,就將屬性值設定為false即可。
```
@RequestMapping("/happy")
  public String sayHappy(
  @RequestParam(value = "name", required = false) String name,
  @RequestParam(value = "age", required = true) String age) {
  //age引數必須傳 ,name可傳可不傳
  ...
  }
```
 - @PathVariable:該註解主要是用於做動態繫結使用,讓形參的值變成可供使用的URL變數。詳情看以下程式碼:
```
@RequestMapping(value="/happy/{dayid}",method=RequestMethod.GET)
public String findPet(@PathVariable String dayid, Model mode) {
//使用@PathVariable註解繫結 {dayid} 到String dayid
}
```
    @PathVariable中的引數可以是任意的簡單型別,如int、long、Date等,Spring會自動將其轉換成合適的型別或者丟擲TypeMismatchException異常,也可以註冊支援額外的資料型別。另外,它也支援正則表示式,這就決定了它超強的屬性,它能在路徑模板中使用佔位符,可以設定特定的字首匹配和字尾匹配,自定義格式等。
 - @RequestBody:該註解是指方法形參應該被繫結到HTTP請求的Body上。

```
@RequestMapping(value = "/something", method = RequestMethod.PUT)
public void handle(@RequestBody String body,@RequestBody User user){
   //可以繫結自定義的物件型別
}
```
 - @ResponseBody:和上面的那個註解類似,它是將返回的型別直接輸入到HTTP response body 上,我們一般在輸出json格式的資料時會使用到這個註解。

```
    @RequestMapping(value = "/happy", method =RequestMethod.POST)
@ResponseBody
public String helloWorld() {    
return "Hello World";//返回String型別
}
```
 - @RestController:控制器實現了REST的API,只服務於json、xml或其他自定義的型別內容。使用該註解主要是建立REST型別的控制器,和@Controller類似。使用該註解可以避免讓開發人員重複去寫@RequestMapping和@ResponseBody註解。
 - @ModelAttribute:@ModelAttribute可以作用在方法或方法引數上,當它作用在方法上時,標明該方法的目的是新增一個或多個模型屬性(model attributes)。 該方法支援與@RequestMapping一樣的引數型別,但並不能直接對映成請求。控制器中的@ModelAttribute方法會在@RequestMapping方法呼叫之前而呼叫。@ModelAttribute方法有兩種風格:一種是新增隱形屬性並返回它。另一種是該方法接受一個模型並新增任意數量的模型屬性。使用者可以根據自己的需要選擇對應的風格。
# 三、Spring的事務模組註解
## 1、常用註解:在處理dao或service層的事務操作時,比如刪除失敗時的事務回滾,使用@Transactional作為註解,但是需要在配置檔案啟用,新增如下配置:

```
<!-- 開啟註解方式宣告事務 -->
    <tx:annotation-driven transaction-manager="transactionManager" />
```

 事務傳播行為型別 | 說明
---|---
PROPAGATION_REQUIRED | 如果當前沒有事務,就新建一個事務,如果已經存在一個事務,加入到這個事務中,這是最常見的選擇。
PROPAGATION_SUPPORTS | 支援當前事務,如果當前沒有事務,就以非事務方式執行。
PROPAGATION_MANDATORY | 使用當前事務,如果沒有事務就丟擲異常。
PROPAGATION_REQUIRES_NEW | 新建事務,如果當前存在事務,把當前事務掛起。
PROPAGATION_NOT_SUPPORTED | 以非事務方式執行操作,如果當前存在事務,就把當前事務掛起。
PROPAGATION_NEVER | 以非事務方式執行,如果當前存在事務,就丟擲異常。
PROPAGATION_NESTED | 如果當前存在事務,則在巢狀事務內執行。如果當前沒有事務,則執行和PROPAGATION_REQUIRED類似的操作。

## 總結幾種事務相關屬性:

readOnly : 事務的讀寫屬性,取true或者false,true為只讀、預設為false

rollbackFor : 回滾策略,當遇到指定異常時回滾。譬如上例遇到異常就回滾 

timeout (補充的) : 設定超時時間,單位為秒 

## 事務的隔離級別
isolation : 設定事務隔離級別,列舉型別,一共五種

型別 | 說明
---|---
DEFAULT | 採用資料庫預設隔離級別
READ_UNCOMMITTED | 讀未提交的資料(會出現髒讀取)
READ_COMMITTED | 讀已提交的資料(會出現幻讀,即前後兩次讀的不一樣)
REPEATABLE_READ | 可重複讀,會出現幻讀
SERIALIZABLE 序列化 | (對資源消耗較大,一般不使用)