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。