@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
Kotlin
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"
	}

	// ...

}
2 使用 @RequestParam`绑定`petId

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

如果目标方法参数类型不是 String,则会自动应用类型转换。请参阅 Type Conversion

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

当将 @RequestParam 注解声明为 Map<String, String>MultiValueMap<String, String>,而未在注解中指定参数名称时,该映射会使用给定每个参数名称的请求参数值进行填充。

请注意,@RequestParam 的使用是可选的(例如,设置其属性)。默认情况下,任何不是由任何其他参数解析器解析的简单值类型参数(由 BeanUtils#isSimpleProperty 确定)将被视为已通过 @RequestParam 加注。