需求实例引入
在实际开发中,我们会常常遇到需要对日期格式、数值格式进行转换的需求。在spring中,我们可以轻松通过注解的方式完成对数据的格式化处理,比如现在有个User POJO类:
package com.mvc.model;
import java.util.Date;
public class Person {
private String name;
@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birthday;
@NumberFormat(pattern = "#.###k")
private Long salary;
//ignore getter and setter
@Override
public String toString() {
return "Person [name=" + name + ", birthday=" + birthday + ", salary="
+ salary + "]";
}
}
我们希望通过上面两个注解,将birthdat如1995-01-01的字符串形式与java.util.Date的日期形式相互转换,将salary如15.000K的字符串形式与Long型的15000相互转换。
为了完成我们的需求,我们需要先了解如下知识。
AnnotationFormatterFactory接口
它使我们的注解与属性类型关联起来。它的定义如下:
public interface AnnotationFormatterFactory<A extends Annotation> {
//通过此方法获取(也能理解为设置)哪些属性类可以被注解A标注
Set<Class<?>> getFieldTypes();
//获取特定属性的格式化输出器
Printer<?> getPrinter(A annotation, Class<?> fieldType);
//获取特定属性格式化输入(解析)器
Parser<?> getParser(A annotation, Class<?> fieldType);
}
FormattingConversionService
继承自ConversionService,运行时类型转换和格式化服务接口,提供运行期类型转换和格式化的支持。
其对应存在一个工厂类FormattingConversionServiceFactoryBean,我们也可以通过其注册自定义转换器。它的地位相当于我们上一篇文章提到的ConversionServiceFactoryBean。我们将其装配在的conversion-service属性中。下面是我们的实例配置:
<!-- 通过:annotation-driven的conversion-service属性来装配我们的类型转换器 -->
<mvc:annotation-driven />
<bean
class="org.springframework.format.support.FormattingConversionServiceFactoryBean"
id="converters"><!-- 在属性converters注册 -->
<property name="converters">
<list>
<bean class="com.mvc.convertor.MyConvertorFactory" />
</list>
</property>
</bean>
注册完后,我们即可进行我们的web测试:
@Controller
public class PersonController {
@RequestMapping("convert")
public void convert( Person person){
System.out.println(person);
}
}
启动服务器,我们在游览器中访问:
控制台对应输出:http://localhost:8080/springMVC/convert?name=myName&birthday=1995-01-01&salary=5.000k
Person [name=myName, birthday=Sun Jan 01 00:00:00 CST 1995, salary=5]
从这里我们看出,成功完成了请求参数到User对象属性的格式化转换。
另一方面,如果我们想单独使用格式转化器,也可直接在方法入参中使用注解,看下面实例:
@RequestMapping("convert2")
public void convert2(@DateTimeFormat( pattern = "yyyy-MM-dd") Date date,@NumberFormat( pattern = "#k") Long salary ){
System.out.println(date);
System.out.println(salary);
}
启动服务器,我们在游览器中访问:http://localhost:8080/springMVC/convert?name=myName&birthday=1995-01-01&salary=50k
控制台对应输出:
Sun Jan 01 00:00:00 CST 1995