Spring MVC 中日期格式转换的两种实用方法

发布于:2025-06-15 ⋅ 阅读:(14) ⋅ 点赞:(0)

在开发基于 Spring MVC 的 Web 应用时,日期格式的转换是一个常见的需求。用户在表单中输入的日期通常是字符串类型,而在 Java 代码中我们往往需要将其转换为 Date 类型进行处理。本文将详细介绍 Spring MVC 中两种日期格式转换的方法,包括创建过程和最终的运行结果。

方法一:使用 @DateTimeFormat 注解

1. 原理

@DateTimeFormat 注解是 Spring 框架提供的一个便捷注解,用于将字符串类型的日期转换为 Date 类型。它可以直接应用在实体类的日期属性上,Spring MVC 在接收到请求参数时会自动根据注解中指定的格式进行转换。

2. 创建过程

2.1 实体类添加注解

在 User 类的 birthday 属性上添加 @DateTimeFormat 注解,指定日期格式。示例代码如下:

package cn.tx.demo2;

import org.springframework.format.annotation.DateTimeFormat;
import java.io.Serializable;
import java.util.Date;
import java.util.List;
import java.util.Map;

public class User implements Serializable {
    // ... 其他属性 ...
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date birthday;
    // ... 其他方法 ...
}
2.2 控制器接收参数

在控制器中,当接收到包含日期参数的请求时,Spring MVC 会自动将字符串日期转换为 Date 类型。示例代码如下:

package cn.tx.demo2;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/save2.do")
    public String save2(User user) {
        System.out.println("USER:" + user);
        return "suc";
    }
}

 3.运行结果:

使用原来日期格式:

报错:因为日期格式改了 

 改成现在的格式:

成功:

 

方法二:自定义转换器 StringToDate

1. 原理

自定义转换器可以实现更复杂的日期格式转换逻辑。通过实现 org.springframework.core.convert.converter.Converter 接口,我们可以自定义字符串到 Date 类型的转换规则。

2. 创建过程

2.1 创建自定义转换器类

创建一个实现 Converter<String, Date> 接口的类,实现 convert 方法,用于将字符串类型的日期转换为 Date 类型。示例代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 启用注解驱动 -->
    <mvc:annotation-driven/>

    <!-- 配置组件扫描 -->
    <context:component-scan base-package="cn.tx.demo1"/>
    <context:component-scan base-package="cn.tx.demo2"/>

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!--配置日期类型转换器,类型转换器的组件,把日期类型转换注入到组件对象中-->
    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="cn.tx.demo2.StringToDate" />
            </set>
        </property>
    </bean>

    <!--让映射器、适配器和处理器生效(默认不配置也是可以的)-->
    <mvc:annotation-driven conversion-service="conversionService"/>
</beans>

2.3 控制器接收参数

在控制器中,同样可以正常接收包含日期参数的请求,Spring MVC 会使用自定义的转换器进行日期转换。示例代码如下:

package cn.tx.demo2;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/save3.do")
    public String save3(User user) {
        System.out.println("user:" + user);
        return "suc";
    }
}

  3. 运行结果

当用户提交包含日期参数的表单时,Spring MVC 会使用自定义的转换器将字符串日期按照指定的格式转换为 Date 类型,并赋值给 User 对象的 birthday 属性。在控制器中可以直接使用该 Date 对象进行后续处理。

总结

  • @DateTimeFormat 注解适用于简单的日期格式转换,使用方便,只需要在实体类属性上添加注解即可。
  • 自定义转换器适用于需要更复杂转换逻辑的场景,可以根据实际需求自定义转换规则。

通过以上两种方法,我们可以在 Spring MVC 中轻松实现日期格式的转换,提高开发效率。希望本文对你有所帮助!


网站公告

今日签到

点亮在社区的每一天
去签到