Spring MVC数据格式化（Formatter）

Spring MVC 框架的 Formatter 与 Converter<S, T> 一样，也是一个可以将一种数据类型转换成另一种数据类型的接口。不同的是，Formatter 的源类型必须是 String 类型，而 Converter 的源类型可以是任意数据类型。Formatter 更适合 Web 层，而 Converter 可以在任意层中。所以对于需要转换表单中的用户输入的情况，应该选择 Formatter，而不是 Converter。

在 Web 应用中由 HTTP 发送的请求数据到控制器中都是以 String 类型获取，因此在 Web 应用中选择 Formatter 比选择 Converter<S, T> 更加合理。

内置的格式化转换器

Spring MVC 提供了几个内置的格式化转换器，具体如下。

• NumberFormatter：实现 Number 与 String 之间的解析与格式化。
• CurrencyFormatter：实现 Number 与 String 之间的解析与格式化（带货币符号）。
• PercentFormatter：实现 Number 与 String 之间的解析与格式化（带百分数符号）。
• DateFormatter：实现 Date 与 String 之间的解析与格式化。

自定义格式化转换器

自定义格式化转换器就是编写一个实现 org.springframework.format.Formatter 接口的 Java 类。该接口声明如下。

*   public interface  Formatter

这里的 T 表示由字符串转换的目标数据类型。该接口有 parse 和 print 两个接口方法，自定义格式化转换器类必须覆盖它们。

*   public T  parse(String  s, java.util.Locale  locale)
*   public String  print(T  object, java.util.Locale  locale)

parse 方法的功能是利用指定的 Locale 将一个 String 类型转换成目标类型，print 方法与之相反，用于返回目标对象的字符串表示。

示例

下面通过具体应用讲解自定义格式化转换器的用法，本节示例基于《@Controller和@RequestMapping注解》一节中的 springmvcDemo2 程序。

1. 创建实体类

创建 net.biancheng.po 包，并在该包中创建 User 实体类，代码如下。

1.  package net.biancheng.po;

3.  import java.util.Date;

5.  public class  User {
6.  private String  name;
7.  private Integer  age;
8.  private Double  height;
9.  private Date  createDate;
10.  /**省略setter和getter方法*/
11.  }

2. 创建控制器类

创建 net.biancheng.controller 包，并在该包中创建 FormatterController 控制器类，代码如下。

1.  package net.biancheng.controller;

3.  import org.springframework.stereotype.Controller;
4.  import org.springframework.ui.Model;
5.  import org.springframework.web.bind.annotation.RequestMapping;

7.  import net.biancheng.po.User;

9.  @Controller
10.  public class  FormatterController {
11.  @RequestMapping("/formatter")
12.  public String  myFormatter(User  us, Model  model) {
13.  model.addAttribute("user", us);
14.  return "showUser";
15.  }
16.  }

3. 创建自定义格式化转换器类

创建 net.biancheng.formatter 包，并在该包中创建 MyFormatter 的自定义格式化转换器类，代码如下。

1.  package net.biancheng.formatter;

3.  import java.text.ParseException;
4.  import java.text.SimpleDateFormat;
5.  import java.util.Date;
6.  import java.util.Locale;

8.  import org.springframework.format.Formatter;
9.  import org.springframework.stereotype.Component;

11.  @Component
12.  public class  MyFormatter implements Formatter {
13.  SimpleDateFormat  dateFormat = new SimpleDateFormat("yyyy-MM-dd");

15.  public String  print(Date  object, Locale  arg1) {
16.  return dateFormat.format(object);
17.  }

19.  public Date  parse(String  source, Locale  arg1) throws ParseException {
20.  return dateFormat.parse(source); // Formatter只能对字符串转换
21.  }
22.  }

4. 注册格式化转换器

在 springmvc-servlet.xml 配置文件中注册格式化转换器，具体代码如下：

1.  
 
 
2.  

5. 创建相关视图

创建添加用户页面 addUser.jsp，代码如下。

1.  <%@ page language="java" contentType="text/html; charset=UTF-8"
2.  pageEncoding="UTF-8"%>
3.  
4.  
5.  
6.  
7.  
8.  
9.  
10.  
11.  用户名：
12.  

13.  年龄：
14.  

15.  身高：
16.  

17.  创建日期：
18.  

19.  
20.  
21.  
22.  

创建信息显示页面 showUser.jsp，代码如下。

1.  <%@ page language="java" contentType="text/html; charset=UTF-8"
2.  pageEncoding="UTF-8"%>
3.  
4.  
5.  
6.  
7.  
8.  
9.  

11.  您创建的用户信息如下：
12.  

13.  
 
 
14.  用户名：${user.name }
15.  

16.  年龄：${user.age }
17.  

18.  身高：${user.height }
19.  

20.  创建日期：${user.createDate }

22.  
23.  

6. 测试运行

访问地址：http://localhost:8080/springmvcDemo2/addUser。