Java中註解的型別如下：

Java包含5種常見的註解。

@Target：修改類的方法，型別等；

@Retention：修飾註解的作用時間，比如執行時（source，class，runtime）；

@Documented：修飾的註解能夠儲存到JavaDoc中；

@Inherited：簡單理解為：帶有該註解的類可以繼承父類的註解。

2、RequestMapping的學習

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

主要變數值：Value, name, path, params, headers, consumes, produces, method

下面是原始碼：

package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.util.concurrent.Callable;

import org.springframework.core.annotation.AliasFor;

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {

	String name() default "";
	@AliasFor("path")
	String[] value() default {};
	@AliasFor("value")
	String[] path() default {};
	RequestMethod[] method() default {};
	String[] params() default {};
	String[] headers() default {};
	String[] consumes() default {};
	String[] produces() default {};

}
 

RequestMapping是一個介面，其中定義的方法

1）name：為本次對映指定一個名詞，這個預設的情況是“”。本質就是起名字。

2）Value：請求的路徑的實際地址，比如福利金批次的查詢路徑。

@RequestMapping("/action/act")
@RequestMapping(value = "/function/list",method = RequestMethod.GET)

Value指定的地址可以是URI Template 模式，包含的三種模式：

A） 可以指定為普通的具體值，如上面的value值；

B)  可以指定為含有某變數的一類值(URI Template Patterns with Path Variables)。比如：value="/batch/{varValue}"，而varValue可以在後臺程式碼中賦值。

@RequestMapping(value="/funtion/{list}", method=RequestMethod.GET)
public String findOwner(@PathVariable String ownerId, Model model) {
  Owner owner = ownerService.findOwner(list);  
  model.addAttribute("list", owner);  
  return "vaule值"; 
}

C) 可以指定為含正則表示式的一類值( URI Template Patterns with Regular Expressions);

@RequestMapping("/spring-web/{symbolicName:[a-z-]+}-{version:\d\.\d\.\d}.{extension:\.[a-z]}")
  public void handle(@PathVariable String version, @PathVariable String extension) {    
    // ...
  }
}

3）path：

原始碼分析：

	@AliasFor("path")
	String[] value() default {};
	@AliasFor("value")
	String[] path() default {};

從Spring 4.2開始引入了@AliasFor註解，可以實現屬性的別名，如value本身並沒有特定的含義，而path會更加具體，能見名知義，通俗說可以認為兩者在使用中是一樣的如：@RequestMapping("/xiaocui")} 與 @RequestMapping(path="/xiaocui")相同。

4）params：

原始碼解釋：

The parameters of the mapped request, narrowing the primary mapping.

對映請求的引數，收窄請求範圍。可以限制客戶端傳送到伺服器的請求引數為某些特定值或不為某些值。

直譯：就是允許某些值為引數，且其值滿足的條件。

//請求的引數必須包含id=215與name不等於xiaocui
@RequestMapping(value = "/paramsTest",params = {"id=215","name!=xiaocui"})

5）headers：

指定請求的屬性中必須包含某些特定的headers值。請求的頭部，作用域稍微大一些的。

//請求頭部資訊中必須包含Host=localhost:8088
@RequestMapping(value = "/headersTest",headers = "Host=localhost:8088")

在上述請求過程中，引數必須包含headers，且值為host和port的指定值。另外，在新增引數是，使用的是物件的addAttribute()方法。

6）consumes：（暫定）

指定處理請求的提交內容型別（Content-Type），例如application/json, text/html，收窄請求範圍，如果使用者傳送的請求內容型別不匹配則方法不會響應請求。

//請求內容型別必須為text/html，注意瀏覽器預設沒有指定Content-type
@RequestMapping(value = "/consumesTest",consumes = "text/html")

7）produces：（暫定）

指定返回的內容型別，僅當request請求頭中的(Accept)型別中包含該指定型別才返回，方法才處理客戶端的請求否則會報406錯誤。

//客戶端接收json且編碼為utf-8，多數瀏覽器Accept設定的為*/*，接收任意型別
@RequestMapping(value = "/producesTest",produces="application/json; charset=UTF-8")

8）method：

指定請求的method型別，包含：GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE, TRACE。

呼叫的RequestMethod列舉類，原始碼：

public enum RequestMethod {

	GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE

}

3、總結

1）@RequestMapping：用於處理請求地址對映的註解。

2）屬性記憶表格：