查看spring源码可以看出spring支持转换的数据类型：
org.springframework.beans.PropertyEditorRegistrySupport:

[java]view plaincopyprint?
/** 
 * Actually register the default editors for this registry instance. 
 */  
private void createDefaultEditors() {  
    this.defaultEditors = new HashMap<Class, PropertyEditor>(64);  
  
    // Simple editors, without parameterization capabilities.  
    // The JDK does not contain a default editor for any of these target types.  
    this.defaultEditors.put(Charset.class, new CharsetEditor());  
    this.defaultEditors.put(Class.class, new ClassEditor());  
    this.defaultEditors.put(Class[].class, new ClassArrayEditor());  
    this.defaultEditors.put(Currency.class, new CurrencyEditor());  
    this.defaultEditors.put(File.class, new FileEditor());  
    this.defaultEditors.put(InputStream.class, new InputStreamEditor());  
    this.defaultEditors.put(InputSource.class, new InputSourceEditor());  
    this.defaultEditors.put(Locale.class, new LocaleEditor());  
    this.defaultEditors.put(Pattern.class, new PatternEditor());  
    this.defaultEditors.put(Properties.class, new PropertiesEditor());  
    this.defaultEditors.put(Resource[].class, new ResourceArrayPropertyEditor());  
    this.defaultEditors.put(TimeZone.class, new TimeZoneEditor());  
    this.defaultEditors.put(URI.class, new URIEditor());  
    this.defaultEditors.put(URL.class, new URLEditor());  
    this.defaultEditors.put(UUID.class, new UUIDEditor());  
  
    // Default instances of collection editors.  
    // Can be overridden by registering custom instances of those as custom editors.  
    this.defaultEditors.put(Collection.class, new CustomCollectionEditor(Collection.class));  
    this.defaultEditors.put(Set.class, new CustomCollectionEditor(Set.class));  
    this.defaultEditors.put(SortedSet.class, new CustomCollectionEditor(SortedSet.class));  
    this.defaultEditors.put(List.class, new CustomCollectionEditor(List.class));  
    this.defaultEditors.put(SortedMap.class, new CustomMapEditor(SortedMap.class));  
  
    // Default editors for primitive arrays.  
    this.defaultEditors.put(byte[].class, new ByteArrayPropertyEditor());  
    this.defaultEditors.put(char[].class, new CharArrayPropertyEditor());  
  
    // The JDK does not contain a default editor for char!  
    this.defaultEditors.put(char.class, new CharacterEditor(false));  
    this.defaultEditors.put(Character.class, new CharacterEditor(true));  
  
    // Spring’s CustomBooleanEditor accepts more flag values than the JDK’s default editor.  
    this.defaultEditors.put(boolean.class, new CustomBooleanEditor(false));  
    this.defaultEditors.put(Boolean.class, new CustomBooleanEditor(true));  
  
    // The JDK does not contain default editors for number wrapper types!  
    // Override JDK primitive number editors with our own CustomNumberEditor.  
    this.defaultEditors.put(byte.class, new CustomNumberEditor(Byte.class, false));  
    this.defaultEditors.put(Byte.class, new CustomNumberEditor(Byte.class, true));  
    this.defaultEditors.put(short.class, new CustomNumberEditor(Short.class, false));  
    this.defaultEditors.put(Short.class, new CustomNumberEditor(Short.class, true));  
    this.defaultEditors.put(int.class, new CustomNumberEditor(Integer.class, false));  
    this.defaultEditors.put(Integer.class, new CustomNumberEditor(Integer.class, true));  
    this.defaultEditors.put(long.class, new CustomNumberEditor(Long.class, false));  
    this.defaultEditors.put(Long.class, new CustomNumberEditor(Long.class, true));  
    this.defaultEditors.put(float.class, new CustomNumberEditor(Float.class, false));  
    this.defaultEditors.put(Float.class, new CustomNumberEditor(Float.class, true));  
    this.defaultEditors.put(double.class, new CustomNumberEditor(Double.class, false));  
    this.defaultEditors.put(Double.class, new CustomNumberEditor(Double.class, true));  
    this.defaultEditors.put(BigDecimal.class, new CustomNumberEditor(BigDecimal.class, true));  
    this.defaultEditors.put(BigInteger.class, new CustomNumberEditor(BigInteger.class, true));  
  
    // Only register config value editors if explicitly requested.  
    if (this.configValueEditorsActive) {  
        StringArrayPropertyEditor sae = new StringArrayPropertyEditor();  
        this.defaultEditors.put(String[].class, sae);  
        this.defaultEditors.put(short[].class, sae);  
        this.defaultEditors.put(int[].class, sae);  
        this.defaultEditors.put(long[].class, sae);  
    }  
}  

下面挑选一些常用的数据类型，举例说明它们的绑定方式

1. 基本数据类型(以int为例，其他类似)：
Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(int num) {  
      
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <input name=“num” value=“10” type=“text”/>  
   ……  
</form>  

表单中input的name值和Controller的参数变量名保持一致，就能完成基本数据类型的数据绑定，如果不一致可以使用@RequestParam标注实现。值得一提的是，如果Controller方法参数中定义的是基本数据类型，但是从jsp提交过来的数据为null或者””的话，会出现数据转换的异常。也就是说，必须保证表单传递过来的数据不能为null或””，所以，在开发过程中，对可能为空的数据，最好将参数数据类型定义成包装类型，具体参见下面的第二条。

2. 包装类型(以Integer为例，其他类似)：
Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(Integer num) {  
      
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <input name=“num” value=“10” type=“text”/>  
   ……  
</form>  

和基本数据类型基本一样，不同之处在于，JSP表单传递过来的数据可以为null或””，以上面代码为例，如果jsp中num为””或者表单中无num这个input，那么，Controller方法参数中的num值则为null。

3. 自定义对象类型：
Model代码：

[java]view plaincopyprint?
public class User {  
  
    private String firstName;  
  
    private String lastName;  
  
    public String getFirstName() {  
        return firstName;  
    }  
  
    public void setFirstName(String firstName) {  
        this.firstName = firstName;  
    }  
  
    public String getLastName() {  
        return lastName;  
    }  
  
    public void setLastName(String lastName) {  
        this.lastName = lastName;  
    }  
  
}  

Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(User user) {  
      
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <input name=“firstName” value=“张” type=“text”/>  
   <input name=“lastName” value=“三” type=“text”/>  
   ……  
</form>  

非常简单，只需将对象的属性名和input的name值一一对应即可。

4. 自定义复合对象类型：
Model代码：

[java]view plaincopyprint?
public class ContactInfo {  
  
    private String tel;  
  
    private String address;  
  
    public String getTel() {  
        return tel;  
    }  
  
    public void setTel(String tel) {  
        this.tel = tel;  
    }  
  
    public String getAddress() {  
        return address;  
    }  
  
    public void setAddress(String address) {  
        this.address = address;  
    }  
  
}  
  
public class User {  
  
    private String firstName;  
  
    private String lastName;  
  
    private ContactInfo contactInfo;  
  
    public String getFirstName() {  
        return firstName;  
    }  
  
    public void setFirstName(String firstName) {  
        this.firstName = firstName;  
    }  
  
    public String getLastName() {  
        return lastName;  
    }  
  
    public void setLastName(String lastName) {  
        this.lastName = lastName;  
    }  
  
    public ContactInfo getContactInfo() {  
        return contactInfo;  
    }  
  
    public void setContactInfo(ContactInfo contactInfo) {  
        this.contactInfo = contactInfo;  
    }  
  
}  

Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(User user) {  
    System.out.println(user.getFirstName());  
    System.out.println(user.getLastName());  
    System.out.println(user.getContactInfo().getTel());  
    System.out.println(user.getContactInfo().getAddress());  
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <input name=“firstName” value=“张” /><br>  
   <input name=“lastName” value=“三” /><br>  
   <input name=“contactInfo.tel” value=“13809908909” /><br>  
   <input name=“contactInfo.address” value=“北京海淀” /><br>  
   <input type=“submit” value=“Save” />  
</form>  

User对象中有ContactInfo属性，Controller中的代码和第3点说的一致，但是，在jsp代码中，需要使用“属性名(对象类型的属性).属性名”来命名input的name。

5. List绑定：
List需要绑定在对象上，而不能直接写在Controller方法的参数中。
Model代码：

[java]view plaincopyprint?
public class User {  
  
    private String firstName;  
  
    private String lastName;  
  
    public String getFirstName() {  
        return firstName;  
    }  
  
    public void setFirstName(String firstName) {  
        this.firstName = firstName;  
    }  
  
    public String getLastName() {  
        return lastName;  
    }  
  
    public void setLastName(String lastName) {  
        this.lastName = lastName;  
    }  
  
}  
  
       public class UserListForm {  
  
    private List<User> users;  
  
    public List<User> getUsers() {  
        return users;  
    }  
  
    public void setUsers(List<User> users) {  
        this.users = users;  
    }  
  
}  

Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(UserListForm userForm) {  
    for (User user : userForm.getUsers()) {  
        System.out.println(user.getFirstName() + ” – “ + user.getLastName());  
    }  
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <table>  
      <thead>  
         <tr>  
            <th>First Name</th>  
            <th>Last Name</th>  
         </tr>  
      </thead>  
      <tfoot>  
         <tr>  
            <td colspan=“2”><input type=“submit” value=“Save” /></td>  
         </tr>  
      </tfoot>  
      <tbody>  
         <tr>  
            <td><input name=“users[0].firstName” value=“aaa” /></td>  
            <td><input name=“users[0].lastName” value=“bbb” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[1].firstName” value=“ccc” /></td>  
            <td><input name=“users[1].lastName” value=“ddd” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[2].firstName” value=“eee” /></td>  
            <td><input name=“users[2].lastName” value=“fff” /></td>  
         </tr>  
      </tbody>  
   </table>  
</form>  

其实，这和第4点User对象中的contantInfo数据的绑定有点类似，但是这里的UserListForm对象里面的属性被定义成List，而不是普通自定义对象。所以，在JSP中需要指定List的下标。值得一提的是，Spring会创建一个以最大下标值为size的List对象，所以，如果JSP表单中有动态添加行、删除行的情况，就需要特别注意，譬如一个表格，用户在使用过程中经过多次删除行、增加行的操作之后，下标值就会与实际大小不一致，这时候，List中的对象，只有在jsp表单中对应有下标的那些才会有值，否则会为null，看个例子：
JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <table>  
      <thead>  
         <tr>  
            <th>First Name</th>  
            <th>Last Name</th>  
         </tr>  
      </thead>  
      <tfoot>  
         <tr>  
            <td colspan=“2”><input type=“submit” value=“Save” /></td>  
         </tr>  
      </tfoot>  
      <tbody>  
         <tr>  
            <td><input name=“users[0].firstName” value=“aaa” /></td>  
            <td><input name=“users[0].lastName” value=“bbb” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[1].firstName” value=“ccc” /></td>  
            <td><input name=“users[1].lastName” value=“ddd” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[20].firstName” value=“eee” /></td>  
            <td><input name=“users[20].lastName” value=“fff” /></td>  
         </tr>  
      </tbody>  
   </table>  
</form>  

这个时候，Controller中的userForm.getUsers()获取到List的size为21，而且这21个User对象都不会为null，但是，第2到第19的User对象中的firstName和lastName都为null。打印结果：

[java]view plaincopyprint?
aaa – bbb  
ccc – ddd  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
null – null  
eee – fff  

6. Set绑定：
Set和List类似，也需要绑定在对象上，而不能直接写在Controller方法的参数中。但是，绑定Set数据时，必须先在Set对象中add相应的数量的模型对象。
Model代码：

[java]view plaincopyprint?
public class User {  
  
    private String firstName;  
  
    private String lastName;  
  
    public String getFirstName() {  
        return firstName;  
    }  
  
    public void setFirstName(String firstName) {  
        this.firstName = firstName;  
    }  
  
    public String getLastName() {  
        return lastName;  
    }  
  
    public void setLastName(String lastName) {  
        this.lastName = lastName;  
    }  
  
}  
  
public class UserSetForm {  
  
    private Set<User> users = new HashSet<User>();  
      
    public UserSetForm(){  
        users.add(new User());  
        users.add(new User());  
        users.add(new User());  
    }  
  
    public Set<User> getUsers() {  
        return users;  
    }  
  
    public void setUsers(Set<User> users) {  
        this.users = users;  
    }  
  
}  

Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(UserSetForm userForm) {  
    for (User user : userForm.getUsers()) {  
        System.out.println(user.getFirstName() + ” – “ + user.getLastName());  
    }  
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <table>  
      <thead>  
         <tr>  
            <th>First Name</th>  
            <th>Last Name</th>  
         </tr>  
      </thead>  
      <tfoot>  
         <tr>  
            <td colspan=“2”><input type=“submit” value=“Save” /></td>  
         </tr>  
      </tfoot>  
      <tbody>  
         <tr>  
            <td><input name=“users[0].firstName” value=“aaa” /></td>  
            <td><input name=“users[0].lastName” value=“bbb” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[1].firstName” value=“ccc” /></td>  
            <td><input name=“users[1].lastName” value=“ddd” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[2].firstName” value=“eee” /></td>  
            <td><input name=“users[2].lastName” value=“fff” /></td>  
         </tr>  
      </tbody>  
   </table>  
</form>  

基本和List绑定类似。
需要特别提醒的是，如果最大下标值大于Set的size，则会抛出org.springframework.beans.InvalidPropertyException异常。所以，在使用时有些不便。暂时没找到解决方法，如果有网友知道，请回帖共享你的做法。

5. Map绑定：
Map最为灵活，它也需要绑定在对象上，而不能直接写在Controller方法的参数中。
Model代码：

[java]view plaincopyprint?
public class User {  
  
    private String firstName;  
  
    private String lastName;  
  
    public String getFirstName() {  
        return firstName;  
    }  
  
    public void setFirstName(String firstName) {  
        this.firstName = firstName;  
    }  
  
    public String getLastName() {  
        return lastName;  
    }  
  
    public void setLastName(String lastName) {  
        this.lastName = lastName;  
    }  
  
}  
  
public class UserMapForm {  
  
    private Map<String, User> users;  
  
    public Map<String, User> getUsers() {  
        return users;  
    }  
  
    public void setUsers(Map<String, User> users) {  
        this.users = users;  
    }  
  
}  

Controller代码：

[java]view plaincopyprint?
@RequestMapping(“test.do”)  
public void test(UserMapForm userForm) {  
    for (Map.Entry<String, User> entry : userForm.getUsers().entrySet()) {  
        System.out.println(entry.getKey() + “: “ + entry.getValue().getFirstName() + ” – “ +  
                                 entry.getValue().getLastName());  
    }  
}  

JSP表单代码：

[java]view plaincopyprint?
<form action=“test.do” method=“post”>  
   <table>  
      <thead>  
         <tr>  
            <th>First Name</th>  
            <th>Last Name</th>  
         </tr>  
      </thead>  
      <tfoot>  
         <tr>  
            <td colspan=“2”><input type=“submit” value=“Save” /></td>  
         </tr>  
      </tfoot>  
      <tbody>  
         <tr>  
            <td><input name=“users[‘x’].firstName” value=“aaa” /></td>  
            <td><input name=“users[‘x’].lastName” value=“bbb” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[‘y’].firstName” value=“ccc” /></td>  
            <td><input name=“users[‘y’].lastName” value=“ddd” /></td>  
         </tr>  
         <tr>  
            <td><input name=“users[‘z’].firstName” value=“eee” /></td>  
            <td><input name=“users[‘z’].lastName” value=“fff” /></td>  
         </tr>  
      </tbody>  
   </table>  
</form>  

打印结果：

[java]view plaincopyprint?
x: aaa – bbb  
y: ccc – ddd  
z: eee – fff  

[@Controller]4 详解@ModelAttribute

2012/09/212012/09/21 Mingmin

[@Controller]4 详解@ModelAttribute – howareyouo的专栏 – 博客频道 – CSDN.NET.

A、@ModelAttribute

Annotation that binds a method parameter or method return value to a named model attribute, exposed to a web view. Supported for RequestMapping annotated handler classes.

在被@RequestMapping注释的处理器类中，这个注释可以绑定一个方法参数或绑定一个方法的返回值到一个命名的模型属性，提供给一个视图。

Can be used to expose command objects to a web view, using specific attribute names, through annotating corresponding parameters of a RequestMapping annotated handler method).

可以用于把一个command对象提供给web视图，使用指定的属性名称，在被@RequestMapping注释的处理器方法中注释相关参数。

Can also be used to expose reference data to a web view through annotating accessor methods ina controller class which is based on RequestMapping annotated handler methods, with such accessor methods allowed to have any arguments that RequestMapping supports for handler methods, returning the model attribute value to expose.

可以用于提供数据给一个web视图，通过注释处理器方法，这个方法允许有任何参数，返回的模型属性值被提供。

A.1、@ ModelAttribute的属性

value

The name of the model attribute to bind to.

绑定的模型属性的名称。

The default model attribute name is inferred from the declared attribute type (i.e. the method parameter type or method return type), based on the non-qualified class name: e.g. “orderAddress” for class “mypackage.OrderAddress”, or “orderAddressList” for “List<mypackage.OrderAddress>”.

默认的模型属性名称自动判断声明的属性类型（如，方法参数类型或方法返回类型）。如这个值是orderAddress，就对于当前包. OrderAddress。

B、@ModelAttribute注释一个方法

An @ModelAttribute on a method indicates the purpose of that method is to add one or more model attributes. Such methods support the same argument types as @RequestMapping methods but cannot be mapped directly to requests. Instead @ModelAttribute methods in a controller are invoked before @RequestMapping methods, within the same controller.

被@ModelAttribute注释的方法表示这个方法的目的是增加一个或多个模型(model)属性。这个方法和被@RequestMapping注释的方法一样也支持@RequestParam参数，但是它不能直接被请求映射。实际上，控制器中的@ModelAttribute方法是在同一控制器中的@RequestMapping方法被调用之前调用的。

@ModelAttribute methods are used to populate the model with commonly needed attributes for example to fill a drop-down with states or with pet types, or to retrieve a command object like Account in order to use it to represent the data on an HTML form.

被@ModelAttribute注释的方法用于填充model属性，例如，为下拉菜单填充内容，或检索一个command对象（如，Account），用它来表示一个HTML表单中的数据。

A controller can have any number of @ModelAttribute methods. All such methods are invoked before @RequestMapping methods of the same controller.

一个控制器可以有任意数量的@ModelAttribute方法。所有这些方法都在@RequestMapping方法被调用之前调用。

Note the two styles of @ModelAttribute methods. In the first, the method adds an attribute implicitly by returning it. In the second, the method accepts a Model and adds any number of model attributes to it.

有两种类型的@ModelAttribute方法。一种是：加入只一个属性，用方法的返回类型隐含表示。另一种是：方法接受一个Model类型的参数，这个model可以加入任意多个model属性。

B.1、@ModelAttribute注释void返回值的方法

举例说明

@Controller

public class HelloWorldController {

@ModelAttribute

public void populateModel(@RequestParam String abc, Model model) {

model.addAttribute(“attributeName”, abc);

}

@RequestMapping(value = “/helloWorld”)

public String helloWorld() {

return “helloWorld”;

}

这个例子，在获得请求/helloWorld 后，populateModel方法在helloWorld方法之前先被调用，它把请求参数（/helloWorld?abc=text）加入到一个名为attributeName的model属性中，在它执行后helloWorld被调用，返回视图名helloWorld和model已由@ModelAttribute方法生产好了。

这个例子中model属性名称和model属性对象有model.addAttribute()实现，不过前提是要在方法中加入一个Model类型的参数。

B.2、@ModelAttribute注释返回具体类的方法

举例说明

@ModelAttribute

public Account addAccount(@RequestParam String number) {

return accountManager.findAccount(number);

}

这种情况，model属性的名称没有指定，它由返回类型隐含表示，如这个方法返回Account类型，那么这个model属性的名称是account。

这个例子中model属性名称有返回对象类型隐含表示，model属性对象就是方法的返回值。它无须要特定的参数。

B.3、@ModelAttribute(value=””)注释返回具体类的方法

举例说明

@Controller

public class HelloWorldController {

@ModelAttribute(“attributeName”)

public String addAccount(@RequestParam String abc) {

return abc;

}

@RequestMapping(value = “/helloWorld”)

public String helloWorld() {

return “helloWorld”;

}

这个例子中使用@ModelAttribute注释的value属性，来指定model属性的名称。model属性对象就是方法的返回值。它无须要特定的参数。

B.4、@ModelAttribute和@RequestMapping同时注释一个方法

举例说明

@Controller

public class HelloWorldController {

@RequestMapping(value = “/helloWorld.do”)

@ModelAttribute(“attributeName”)

public String helloWorld() {

return “hi”;

}

这时这个方法的返回值并不是表示一个视图名称，而是model属性的值，视图名称由RequestToViewNameTranslator根据请求“/helloWorld.do”转换为helloWorld。Model属性名称有@ModelAttribute(value=””)指定。

C、@ModelAttribute注释一个方法的参数

An @ModelAttribute on a method argument indicates the argument should be retrieved from the model. If not present in the model, the argument should be instantiated first and then added to the model.Once present in the model, the argument’s fields should be populated from all request parameters that have matching names. This is known as data binding in Spring MVC, a very useful mechanism that saves you from having to parse each form field individually.

@ModelAttribute注释方法的一个参数表示应从模型model中取得。若在model中未找到，那么这个参数将先被实例化后加入到model中。若在model中找到，则请求参数名称和model属性字段若相匹配就会自动填充。这个机制对于表单提交数据绑定到对象属性上很有效。

B.1、从model中获取

It may already be in the model due to an @ModelAttribute method in the same controller

参数的值从当前控制器的@ModelAttribute方法提供的model属性中获取。

举例说明

@Controller

public class HelloWorldController {

@ModelAttribute(“user”)

public User addAccount() {

return new User(“jz”,“123”);

}

@RequestMapping(value = “/helloWorld”)

public String helloWorld(@ModelAttribute(“user”) User user) {

user.setUserName(“jizhou”);

return “helloWorld”;

}

在这个例子里，@ModelAttribute(“user”) User user注释方法参数，参数user的值来源于addAccount()方法中的model属性。

B.2、从URI template变量中获取

B.3、从Form表单或URL参数中获取

举例说明

@Controller

public class HelloWorldController {

@RequestMapping(value = “/helloWorld”)

public String helloWorld(@ModelAttribute User user) {

return “helloWorld”;

}

注意这时候这个User类一定要有没有参数的构造函数。

Computer Science 101

One-Stop Knowledge Shop For Coding Problems

Category: Uncategorized

浅谈 SpringMVC 数据绑定

[@Controller]4 详解@ModelAttribute