|
对于最新的稳定版本，请使用 Spring Framework 7.0.6! |
@RequestParam
您可以使用@注解将Servlet请求参数（即，查询参数或表单数据）绑定到控制器方法参数。
以下示例展示了如何操作：
-
Java
-
Kotlin
@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。 |
import org.springframework.ui.set
@Controller
@RequestMapping("/pets")
class EditPetForm {
// ...
@GetMapping
fun setupForm(@RequestParam("petId") petId: Int, model: Model): String { (1)
val pet = this.clinic.loadPet(petId);
model["pet"] = pet
return "petForm"
}
// ...
}| 1 | 使用 @RequestParam 来绑定 petId。 |
默认情况下，使用此注解的方法参数是必需的，但您可以通过将 @RequestParam 注解的 required 标志设置为 false，或使用 java.util.Optional 包装器声明参数来指定该方法参数为可选。
类型转换会自动应用，如果目标方法参数类型不是String。参见类型转换。
将参数类型声明为数组或列表可以解决同一参数名称的多个参数值。
当 @RequestParam 注解被声明为 Map<String, String> 或
MultiValueMap<String, String>，且注解中未指定参数名称时，系统会将每个给定参数名称的请求参数值填充到映射中。
以下示例展示了如何在表单数据处理中实现这一点：
-
Java
-
Kotlin
@Controller
@RequestMapping("/pets")
class EditPetForm {
// ...
@PostMapping(path = "/process", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
public String processForm(@RequestParam MultiValueMap<String, String> params) {
// ...
}
// ...
}@Controller
@RequestMapping("/pets")
class EditPetForm {
// ...
@PostMapping("/process", consumes = [MediaType.APPLICATION_FORM_URLENCODED_VALUE])
fun processForm(@RequestParam params: MultiValueMap<String, String>): String {
// ...
}
// ...
}请注意，使用 @RequestParam 是可选的（例如，设置其属性）。
默认情况下，任何简单值类型（由 BeanUtils#isSimpleProperty 确定）
且未被任何其他参数解析器解析的参数将被视为带有 @RequestParam 注解。