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

@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>,并且在注解中没有指定参数名称时,则该映射将使用每个给定参数名称的请求参数值进行填充。spring-doc.cadn.net.cn

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