`@RequestParam`

你可以使用 @RequestParam 註解將查詢引數繫結到控制器中的方法引數。以下程式碼片段展示了其用法：

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`。

import org.springframework.ui.set

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

	// ...

	@GetMapping
	fun setupForm(@RequestParam("petId") petId: Int, model: Model): String { (1)
		val pet = clinic.loadPet(petId)
		model["pet"] = pet
		return "petForm"
	}

	// ...
}

1	使用 `@RequestParam`。

Servlet API 的“請求引數”概念將查詢引數、表單資料和多部分資料合併為一個。然而，在 WebFlux 中，每個都透過 ServerWebExchange 單獨訪問。儘管 @RequestParam 僅繫結到查詢引數，但你可以使用資料繫結將查詢引數、表單資料和多部分資料應用於命令物件。

預設情況下，使用 @RequestParam 註解的方法引數是必需的，但你可以透過將 @RequestParam 的必需標誌設定為 false，或者透過使用 java.util.Optional 包裝器宣告引數來指定方法引數是可選的。

如果目標方法引數型別不是 String，則會自動應用型別轉換。請參閱型別轉換。

當 @RequestParam 註解在 Map<String, String> 或 MultiValueMap<String, String> 引數上宣告時，該對映將填充所有查詢引數。

請注意，使用 @RequestParam 是可選的——例如，為了設定其屬性。預設情況下，任何簡單值型別（由 BeanUtils#isSimpleProperty 確定）且未被任何其他引數解析器解析的引數都被視為已使用 @RequestParam 註解。