java.lang.Object | |
↳ | org.springframework.web.servlet.support.BindStatus |
Simple adapter to expose the bind status of a field or object. Set as a variable both by the JSP bind tag and Velocity/FreeMarker macros.
Obviously, object status representations (i.e. errors at the object level rather than the field level) do not have an expression and a value but only error codes and messages. For simplicity's sake and to be able to use the same tags and macros, the same status class is used for both scenarios.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Create a new BindStatus instance, representing a field or object status.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Find a PropertyEditor for the given value class, associated with
the property that this bound status is currently bound to.
| |||||||||||
Return the actual value of the field, i.e.
| |||||||||||
Return a suitable display value for the field, i.e.
| |||||||||||
Return the PropertyEditor for the property that this bind status
is currently bound to.
| |||||||||||
Return the first error codes for the field or object, if any.
| |||||||||||
Return the error codes for the field or object, if any.
| |||||||||||
Return the first error message for the field or object, if any.
| |||||||||||
Return the resolved error messages for the field or object,
if any.
| |||||||||||
Return an error message string, concatenating all messages
separated by the given delimiter.
| |||||||||||
Return the Errors instance (typically a BindingResult) that this
bind status is currently associated with.
| |||||||||||
Return a bind expression that can be used in HTML forms as input name
for the respective field, or
null if not field-specific. | |||||||||||
Return the bean and property path for which values and errors
will be resolved (e.g.
| |||||||||||
Return the current value of the field, i.e.
| |||||||||||
Get the '
Class ' type of the field. | |||||||||||
Return if this status represents a field or object error.
| |||||||||||
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Create a new BindStatus instance, representing a field or object status.
requestContext | the current RequestContext |
---|---|
path | the bean and property path for which values and errors will be resolved (e.g. "customer.address.street") |
htmlEscape | whether to HTML-escape error messages and string values |
IllegalStateException | if no corresponding Errors object found |
---|
Find a PropertyEditor for the given value class, associated with the property that this bound status is currently bound to.
valueClass | the value class that an editor is needed for |
---|
null
if none
Return the actual value of the field, i.e. the raw property value,
or null
if not available.
Return a suitable display value for the field, i.e. the stringified value if not null, and an empty string in case of a null value.
This value will be an HTML-escaped String if the original value
was non-null: the toString
result of the original value
will get HTML-escaped.
Return the PropertyEditor for the property that this bind status is currently bound to.
null
if none
Return the error codes for the field or object, if any. Returns an empty array instead of null if none.
Return the resolved error messages for the field or object, if any. Returns an empty array instead of null if none.
Return an error message string, concatenating all messages separated by the given delimiter.
delimiter | separator string, e.g. ", " or " " |
---|
Return the Errors instance (typically a BindingResult) that this bind status is currently associated with.
null
if noneReturn a bind expression that can be used in HTML forms as input name
for the respective field, or null
if not field-specific.
Returns a bind path appropriate for resubmission, e.g. "address.street". Note that the complete bind path as required by the bind tag is "customer.address.street", if bound to a "customer" bean.
Return the bean and property path for which values and errors will be resolved (e.g. "customer.address.street").
Return the current value of the field, i.e. either the property value
or a rejected update, or null
if not field-specific.
This value will be an HTML-escaped String if the original value already was a String.
Get the 'Class
' type of the field. Favor this instead of
'getValue().getClass()
' since 'getValue()
' may
return 'null
'.
Return if this status represents a field or object error.