@RequestParam

ChatGPT-4o-mini 中英对照 @RequestParam @RequestParam

查看 Reactive 栈中的等效内容

您可以使用 @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";
    }

    // ...

}

java

• 使用 @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"
    }

    // ...

}

kotlin

• 使用 @RequestParam 绑定 petId。

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

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

将参数类型声明为数组或列表可以解决同一参数名称的多个参数值。

当 @RequestParam 注解被声明为 Map<String, String> 或 MultiValueMap<String, String>，且在注解中未指定参数名称时，映射将被填充为每个给定参数名称的请求参数值。以下示例展示了如何使用表单数据处理来实现这一点：

Java

@Controller
@RequestMapping("/pets")
class EditPetForm {

    // ...

    @PostMapping(path = "/process", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
    public String processForm(@RequestParam MultiValueMap<String, String> params) {
        // ...
    }

    // ...
}

java

Kotlin

@Controller
@RequestMapping("/pets")
class EditPetForm {

    // ...

    @PostMapping("/process", consumes = [MediaType.APPLICATION_FORM_URLENCODED_VALUE])
    fun processForm(@RequestParam params: MultiValueMap<String, String>): String {
        // ...
    }

    // ...

}

kotlin

注意，使用 @RequestParam 是可选的（例如，用于设置其属性）。默认情况下，任何被视为简单值类型的参数（由 BeanUtils#isSimpleProperty 确定）且未被其他参数解析器解析的参数，将被视为已用 @RequestParam 注解。