root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

javadoc

This commit is contained in:
Keith Donald 2009-06-11 14:15:52 +00:00
parent f7bf6138f8
commit dcb3448748
1 changed files with 18 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
org.springframework.context/src/main/java/org/springframework/ui/binding/support/WebBinder.java
View File

@ -17,20 +17,21 @@ package org.springframework.ui.binding.support;
import java.util.Map; import java.util.Map;
import org.springframework.ui.binding.UserValue;
import org.springframework.ui.binding.UserValues; import org.springframework.ui.binding.UserValues;
/** /**
* A binder designed for use in HTTP (web) environments. * A binder designed for use in HTTP (web) environments.
* Suited for binding user-provided HTTP query parameters to model properties. * Suited for binding user-provided HTTP query parameters to model properties.
* @author Keith Donald * @author Keith Donald
* @see #setFieldDefaultPrefix(String) * @see #setDefaultPrefix(String)
* @see #setFieldMarkerPrefix(String) * @see #setPresentPrefix(String)
*/ */
public class WebBinder extends GenericBinder { public class WebBinder extends GenericBinder {
private String fieldMarkerPrefix = "_"; private String defaultPrefix = "!";
private String fieldDefaultPrefix = "!"; private String presentPrefix = "_";
/** /**
* Creates a new web binder for the model object. * Creates a new web binder for the model object.
@ -41,19 +42,21 @@ public class WebBinder extends GenericBinder {
} }
/** /**
* Configure the prefix for determining default field values. * Configure the prefix to detect the default user value for a property when no value was submitted.
* This is used to configure a <i>default</i> {@link UserValue} for binding when no value is submitted by the client.
* Default is '!'. * Default is '!'.
*/ */
public void setFieldDefaultPrefix(String fieldDefaultPrefix) { public void setDefaultPrefix(String defaultPrefix) {
this.fieldDefaultPrefix = fieldDefaultPrefix; this.defaultPrefix = defaultPrefix;
} }
/** /**
* Configure the prefix for determining empty fields. * Configure the prefix to detect the presence of a property on the web UI when no user value for the property was actually submitted.
* This is used to configure a <i>empty</i> {@link UserValue} for binding when no other {@link #setDefaultPrefix(String) default value} is specified by the client.
* Default is '_'. * Default is '_'.
*/ */
public void setFieldMarkerPrefix(String fieldMarkerPrefix) { public void setPresentPrefix(String presentPrefix) {
this.fieldMarkerPrefix = fieldMarkerPrefix; this.presentPrefix = presentPrefix;
} }
@Override @Override
@ -62,14 +65,14 @@ public class WebBinder extends GenericBinder {
for (Map.Entry<String, ? extends Object> entry : userMap.entrySet()) { for (Map.Entry<String, ? extends Object> entry : userMap.entrySet()) {
String field = entry.getKey(); String field = entry.getKey();
Object value = entry.getValue(); Object value = entry.getValue();
if (field.startsWith(fieldDefaultPrefix)) { if (field.startsWith(defaultPrefix)) {
field = field.substring(fieldDefaultPrefix.length()); field = field.substring(defaultPrefix.length());
if (!userMap.containsKey(field)) { if (!userMap.containsKey(field)) {
values.add(field, value); values.add(field, value);
} }
} else if (field.startsWith(fieldMarkerPrefix)) { } else if (field.startsWith(presentPrefix)) {
field = field.substring(fieldMarkerPrefix.length()); field = field.substring(presentPrefix.length());
if (!userMap.containsKey(field) && !userMap.containsKey(fieldDefaultPrefix + field)) { if (!userMap.containsKey(field) && !userMap.containsKey(defaultPrefix + field)) {
value = getEmptyValue((BindingImpl) getBinding(field)); value = getEmptyValue((BindingImpl) getBinding(field));
values.add(field, value); values.add(field, value);
} }