@RequestParam

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

以下示例显示了如何执行此操作:

  • Java

@Controller
@RequestMapping("/pets")
public class EditPetForm {

  // ...

  @GetMapping
  public String setupForm(@RequestParam("petId") int petId, Model model) { (1)
    Pet pet = this.clinic.loadPet(petId);
    model.addAttribute("pet", pet);
    return "petForm";
  }

  // ...

}
1 使用 @RequestParam 绑定 petId

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

如果目标方法参数类型不是 String,则自动应用类型转换。 参见 类型转换

将参数类型声明为数组或列表允许解析同一参数名称的多个参数值。

@RequestParam 注解声明为 Map<String, String>MultiValueMap<String, String> 时, 如果在注解中没有指定参数名称,则映射将填充每个给定参数名称的请求参数值。

注意,使用 @RequestParam 是可选的(例如,设置其属性)。 默认情况下,任何作为简单值类型的参数(由 BeanUtils#isSimpleProperty 确定), 并且未被任何其他参数解析器解析的参数,都被视为如同用 @RequestParam 注解一样。