对于最新稳定版本,请使用 Spring Framework 7.0.6spring-doc.cadn.net.cn

@RequestParam

你可以使用 @RequestParam 注解将 Servlet 请求参数(即查询参数或表单数据)绑定到控制器中的方法参数上。spring-doc.cadn.net.cn

下面的例子展示了如何做到这一点:spring-doc.cadn.net.cn

@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 包装器声明参数,来指定该方法参数是可选的。spring-doc.cadn.net.cn

如果目标方法参数类型不是 String,则会自动应用类型转换。请参阅类型转换spring-doc.cadn.net.cn

将参数类型声明为数组或列表,可以解析同一参数名的多个参数值。spring-doc.cadn.net.cn

@RequestParam 注解被声明为 Map<String, String>MultiValueMap<String, String>,且注解中未指定参数名称时, 该 Map 将使用请求中每个给定参数名对应的参数值进行填充。spring-doc.cadn.net.cn

请注意,使用 @RequestParam 是可选的(例如,用于设置其属性)。 默认情况下,任何属于简单值类型(由 BeanUtils#isSimpleProperty 确定)且未被其他任何参数解析器解析的参数,都会被当作已使用 @RequestParam 注解处理。spring-doc.cadn.net.cn