@RequestParam

你可以使用 @RequestParam 注解将 Servlet 请求参数（即查询参数或表单数据）绑定到控制器中的方法参数。

下面的例子展示了如何做到这一点：

@Controller
@RequestMapping("/pets")
public class EditPetForm {
    // ...
    @GetMapping
    public String setupForm(@RequestParam("petId") int petId, Model model) { 
        Pet pet = this.clinic.loadPet(petId);
        model.addAttribute("pet", pet);
        return "petForm";
    }
    // ...
}

默认情况下，使用该注解的方法参数是必须的，但是你可以通过将 @RequestParam 注解的 required 标志设置为 false 或者用 java.util.Optional包装器声明该参数来指定一个方法参数是可选的。

如果目标方法参数的类型不是 String，类型转换将被自动应用。参见 类型转换。

将参数类型声明为 数组 或 列表 可以解决同一参数名的多个参数值。比如：

// http://localhost:8080/list?a=1&a=3
@RequestMapping("/list")
@ResponseBody
public String test(@RequestParam String[] a) 
// ["1", "3"]

当 @RequestParam 注解被声明为 Map<String, String>或 MultiValueMap<String, String>时，如果注解中没有指定参数名，那么该 Map 将被填充为每个给定参数名的请求参数值。比如：

// http://localhost:8080/list?a=1&c=2
@RequestMapping("/list")
@ResponseBody
public String test(@RequestParam Map<String, String> maps) 
// maps 中将会把 a 和 c 参数都放进去

注意，@RequestParam 的使用是可选的（例如，设置其属性）。默认情况下，任何参数如果是一个简单的值类型（由 BeanUtils#isSimpleProperty决定），并且没有被任何其他参数解析器解析，就会被当作是用 @RequestParam 注解的。