|
对于最新稳定版本,请使用 Spring Framework 7.0.6! |
@RequestParam
你可以使用 @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>,且注解中未指定参数名称时,
该 Map 将使用请求中每个给定参数名对应的参数值进行填充。
请注意,使用 @RequestParam 是可选的(例如,用于设置其属性)。
默认情况下,任何属于简单值类型(由
BeanUtils#isSimpleProperty
确定)且未被其他任何参数解析器解析的参数,都会被当作已使用 @RequestParam 注解处理。