spring/spring-framework
1
0
Fork 0
mirror of https://github.com/spring-projects/spring-framework.git synced 2026-09-22 14:09:25 +00:00
Code Issues Projects Releases Wiki Activity

Update Javadoc on binding flag in ModelAttribute

Browse Source 
Add clarification and mention primary use case.
This commit is contained in:
rstoyanchev
2026-03-09 14:25:47 +00:00
parent 1203ace285
commit cd0c26b6db
1 changed files with 8 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
spring-web/src/main/java/org/springframework/web/bind/annotation/ModelAttribute.java
+8 -1
View File
@@ -93,7 +93,14 @@ public @interface ModelAttribute {
* Allows data binding to be disabled directly on an {@code @ModelAttribute}
* method parameter or on the attribute returned from an {@code @ModelAttribute}
* method, both of which would prevent data binding for that attribute.
* <p>By default this is set to {@code true} in which case data binding applies.
* <p><strong>Note:</strong> This flag only controls binding via setters and
* direct binding to fields of an existing object. It does not preclude
* constructor binding, which is required to create the object and is safer
* as the constructor declares explicitly the inputs it needs.
* A typical case is where a model attribute is stored in the session, via
* {@link SessionAttributes}, and needs to be accessed again in another
* request later without further binding.
* <p>By default, this is set to {@code true} in which case data binding applies.
* Set this to {@code false} to disable data binding.
* @since 4.3
*/