資訊專欄INFORMATION COLUMN
摘要：負(fù)責(zé)把請(qǐng)求消息轉(zhuǎn)換為一個(gè)對(duì)象，也把一個(gè)對(duì)象轉(zhuǎn)換為請(qǐng)求體。也要注意，如果使用命名空間或者配置，一個(gè)更大范圍的消息轉(zhuǎn)換器被默認(rèn)注冊(cè)。如果沒有聲明這樣的參數(shù)，一個(gè)異常將會(huì)拋出。這個(gè)異常會(huì)在中處理，并返回一個(gè)錯(cuò)誤到客戶端。
??這一部分實(shí)例見項(xiàng)目的 mvc 分支下的 ParamAndBodyController.java
① 使用@RequestParam綁定請(qǐng)求參數(shù)到方法參數(shù)??使用@RequestParam注解綁定請(qǐng)求參數(shù)到你的控制器方法中的參數(shù)。下面的代碼段展示了這種用法:
/**
* 使用 @RequestParam 時(shí)，請(qǐng)求參數(shù)名要和 @RequestParam 的值一樣，而不是和方法參數(shù)名一樣
*/
@GetMapping("/find/pet")
public String findPet(@RequestParam("petId") int pid, ModelMap model)
{
System.out.println("--> petId : " + pid);
/**
* 將被放到響應(yīng)中，發(fā)送到客戶端
*/
model.addAttribute("test", "Hello World");
return "/examples/targets/test4";
}
??默認(rèn)情況下，使用這個(gè)注解的參數(shù)是必須的，但是你可以通過設(shè)置@RequestParam的required屬性為false來指定參數(shù)是可選的（如： @RequestParam(path="id", required=false)）。
??如果目標(biāo)方法的類型參數(shù)不是String類型的，將自動(dòng)應(yīng)用類型轉(zhuǎn)換。見 “方法參數(shù)和類型轉(zhuǎn)換”一節(jié).
??當(dāng)一個(gè)@RequestParam注解用在一個(gè)Map
??方法參數(shù)注解@RequestBody指定一個(gè)方法參數(shù)應(yīng)該被綁定到 HTTP 請(qǐng)求體的值。例如：
/**
* 帶有 @RequestBody 注解的參數(shù)，直接可以得到請(qǐng)求體
*/
@PutMapping("/handle")
public void handle(@RequestBody String body, Writer writer) throws IOException
{
System.out.println("--> body : " + body);
/**
* 將被放到響應(yīng)中，發(fā)送到客戶端
*/
writer.write("{ pet :" + body + " }");
}
??通過使用一個(gè)HttpMessageConverter，你能夠把請(qǐng)求體轉(zhuǎn)換為方法參數(shù)。HttpMessageConverter負(fù)責(zé)把 HTTP 請(qǐng)求消息轉(zhuǎn)換為一個(gè)對(duì)象，也把一個(gè)對(duì)象轉(zhuǎn)換為 HTTP 請(qǐng)求體。RequestMappingHandlerAdapter支持@RequestBody注解使用下面的默認(rèn)的HttpMessageConverters:
ByteArrayHttpMessageConverter轉(zhuǎn)換字節(jié)數(shù)組
StringHttpMessageConverter轉(zhuǎn)換字符串
FormHttpMessageConverter在表單數(shù)據(jù)和MultiValueMap
SourceHttpMessageConverter在請(qǐng)求體和javax.xml.transform.Source之間轉(zhuǎn)換.
??更多關(guān)于這些轉(zhuǎn)換器的信息，見消息轉(zhuǎn)換器。也要注意，如果使用MVC命名空間或者M(jìn)VCJava配置，一個(gè)更大范圍的消息轉(zhuǎn)換器被默認(rèn)注冊(cè)。更多信息見18.16.1節(jié)“使用MVC Java配置或者M(jìn)VC XML命名空間”。
??如果你打算讀寫XML，你會(huì)需要配置一個(gè)帶有指定Marshaller和Unmarshaller（在包org.springframework.oxm中）實(shí)現(xiàn)的MarshallingHttpMessageConverter。雖然下面的例子展示了怎讓直接在你的配置中做，但是如果你的應(yīng)用程序通過 MVC 命名空間或者 MVC Java 配置，你要參考18.16.1節(jié)“使用 MVC Java 配置或者 MVC XML 命名空間”。
