iis服务器助手广告广告
返回顶部
首页 > 资讯 > 后端开发 > Python >Java中@DateTimeFormat和@JsonFormat注解介绍
  • 817
分享到

Java中@DateTimeFormat和@JsonFormat注解介绍

Python 官方文档:入门教程 => 点击学习

摘要

目录1.@DateTimeFORMat注解1.1@DateTimeFormat注解简介1.2@DateTimeFormat注解的功能1.3@DateTimeFormat注解的注意点1

1.@DateTimeFormat注解

1.1@DateTimeFormat注解简介

@DateTimeFormat注解是由spring提供的一个注解,位于Spring和核心组件之一的context组件。对应的所需依赖如下:

# SpringBoot对应的依赖
	<dependency>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-starter-WEB</artifactId>
	</dependency>

# Spring对应的依赖
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
        </dependency>

双击shift快捷键,全局搜索DateTimeFormat,查看外部库,DateTimeFormat本质上是一个接口

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})
public @interface DateTimeFormat {
   String style() default "SS";

   ISO iso() default ISO.NONE;

   String pattern() default "";

   String[] fallbackPatterns() default {};
    
   enum ISO {
      DATE,
      TIME,
      DATE_TIME,
      NONE
   }
}

1.2@DateTimeFormat注解的功能

@DateTimeFormat注解的功能是将一个日期字符串转化为对应的Date类型,主要处理前端时间类型与后端pojo对象中的成员变量进行数据绑定,在注解属性patttern中所约束的时间格式并不会影响后端返回前端的时间类型数据格式。。

DateTimeFormat接口的pattern属性:

pattern属性类型为String类型,用于格式化字段或方法参数的自定义模式。默认为空字符串,表示没有指定自定义模式字符串。

当然也可以使用自定义日期模式字符串,如yyyy-MM-dd HH:mm:ss

1.3@DateTimeFormat注解的注意点

  • @DateTimeFormat注解既可以作用于pojo类型的属性上,也可以作用于方法参数上。
  • 前端传入的时间类型的字符串要和pattern属性所规定的规则相同。
  • @DateTimeFormat注解只能处理非JSON数据格式的字符串(如url-String格式、Form-Data格式),如果要处理JSON数据格式,就需要采用@RequestBody注解,@RequestBody就是获取请求体中的内容(即JSON字符串),再通过JSON解析库(如Jackson、FatJosn)将JSON字符串转换为pojo对象。

​ 两种JSON解析库所需依赖:

        <!--       fastjson所需依赖 -->
		<dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.54</version>
        </dependency>

​ Jackson由于是Spring提供的,所以它所需的依赖就在Spring依赖中。

  • @DateTimeFormat注解只是解析日期字符串转为Date类型,转换后的日期格式并不会受到@DateTimeFormat注解中pattern属性的约束。

1.4@DateTimeFormat功能演示

1.4.1类型转换异常情况测试

pojo层

@Data
@NoArgsConstructor
@AllArgsConstructor
@ToString
public class User {
    private String username;
    private Date birthday;
}

controller层

@Slf4j
@RestController
@RequestMapping("/datetimeFormatTest")
public class DatetimeFormatTest {

    @GetMapping("/exception")
    public User dft1(User user){
      log.info( "用户信息是:" + user);
      return user;
    }
}

用ApiFox进行接口测试,传输的数据格式为url路径传参

请求400,查看控制台日志信息

报错信息:即String类型转换为Date类型失败

Failed to convert property value of type ‘java.lang.String’ to required type ‘java.util.Date’ for property ‘birthday’; nested exception is org.springframework.core.convert

1.4.2接收url路径传参格式测试

pojo层

@Data
@NoArgsConstructor
@AllArgsConstructor
@ToString
public class User {
    private String username;
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date birthday;
}

用ApiFox进行接口测试,传输的数据格式为url路径传参

​ 查看响应情况和控制台输出情况:可以发现@DateTimeFormat注解对日期字符串进行了解析,转换为对应的Date类型

但是要注意@DateTimeFormat注解只是解析日期字符串转为Date类型,转换后的日期格式并不会受到@DateTimeFormat注解中pattern属性的约束。

​ 响应的JSON字符串数据如下:

image-20221101094616306

1.4.3接收Form-Data数据格式测试

pojo和controller都不变

用ApiFox进行接口测试,传输的数据格式为Form-Data类型

image-20221101100039452

测试结果:

image-20221101100453834

响应的JSON字符串数据如下:

image-20221101100026884

1.4.4接收JSON数据格式测试

​ 接受JSON数据格式时,在接收参数时,通过@RequestBody获取请求体中的内容(即JSON字符串),再通过JSON解析库(如Jackson、FatJosn)将JSON字符串转换为pojo对象

  • pojo层不变
  • controller层

​ 通过FastJson处理JSON数据,fastjson默认使用的序列化格式就是:

DEFFAULT_DATE_FORMAT = “yyyy-MM-dd HH:mm:ss”;

@Slf4j
@RestController
@RequestMapping("/datetimeFormatTest")
public class DatetimeFormatTest {
    @GetMapping("/exception")
    public User dft1(@RequestBody String userMsg) {
        JSONObject jsonObject = new JSONObject();
        User user = JSONObject.parseObject(userMsg, User.class);
        log.info("用户信息是:" + user);
        return user;
    }
}

用ApiFox进行接口测试,传输的数据格式为JSON类型

image-20221101100403098

测试结果:

image-20221101134006337

​ 响应的JSON字符串数据如下:

image-20221101134015537

使用JSON解析库Jackson进行解析JSON数据

controller层

@GetMapping("/exception")
public User dft1(@RequestBody String userMsg) {
    ObjectMapper objectMapper = new ObjectMapper();
    User user = null;
    try {
        user = objectMapper.readValue(userMsg, User.class);
    } catch (JsonProcessingException e) {
        e.printStackTrace();
    }
    log.info("用户信息是:" + user);
    return user;
}

用ApiFox进行接口测试,传输的数据格式为JSON类型

image-20221101100403098

测试结果

​ 控制台报错,错误信息提示反序列化失败,因为jackson默认的日期反序列不支持yyyy-MM-dd HH:mm:ss 这种格式,而是默认"yyyy-MM-dd’T’HH:mm:ss.SSSX",所以反序列化失败。

image-20221101134337151

​ 这就引出了今天要介绍的另一个注解@JsonFormat

2.@JsonFormat注解

2.1@JsonFormat注解简介

​ @JsonFormat注解是由Jackson提供的一个注解,位于Jackson的annotation包中,本身也是一个接口

image-20221101140321883

所对应的依赖如下:

<!--Jackson包-->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>

​ SpringBoot的web依赖默认内置的有Jackson相应依赖。

image-20221101140228746

2.2@JsonFormat注解的功能

@JsonFormat注解的功能是处理请求中的JSON日期字符串和查询数据库中的日期类型。即可约束时间类型的请求格式和响应格式。

JsonFormat接口的pattern属性:

pattern属性类型为String类型,用于格式化字段或方法参数的自定义模式。默认为空字符串,表示没有指定自定义模式字符串。

当然也可以使用自定义日期模式字符串,如yyyy-MM-dd HH:mm:ss

JsonFormat接口的timezone属性:

东八区([UTC]/[GMT]+08:00)是比[世界协调时间](UTC)/[格林尼治时间](GMT)快8小时的时区,我国就是属于东八区,所以要指定时区为"GTM+8"

2.3@JsonFormat注解的注意点

  • @JsonFormat只能作用在实体类上,不能作用于方法参数上。
  • @JsonFormat会根据pattrn属性约束日期格式,在返回数据时会返回约束日期格式,这点和@DateTimeFormat不同
  • @JsonFormat注解需要先通过@RequestBody将入参参数映射到实体后,@JsonFormat注解才能去对时间格式进行约束;

2.4@JsonFormat功能演示

pojo层

@Data
@NoArgsConstructor
@AllArgsConstructor
@ToString
public class User {
    private String username;
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GTM+8")
    private Date birthday;
}

controller层

@Slf4j
@RestController
@RequestMapping("/datetimeFormatTest")
public class DatetimeFormatTest {

    @GetMapping("/exception")
    public User dft1(@RequestBody String userMsg) {
        ObjectMapper objectMapper = new ObjectMapper();
        User user = null;
        try {
            user = objectMapper.readValue(userMsg, User.class);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
        log.info("用户信息是:" + user);
        return user;
    }
}

测试结果:

image-20221101144019882

​ 响应的JSON字符串数据如下:

​ 可以发现@JsonFormat注解可以根据pattern属性对返回的数据进行约束

image-20221101144945540

3.总结

当处理的数据格式为非JSON格式(url路径传参、Form-Data)的时候适合使用@DateTimeFormat注解进行处理,就是格式化后的日期格式并不会按照属性pattern中所约束的格式响应,如果想要规定日期格式,可采用SimpleDateFormat对象进行处理。

SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String date = simpleDateFormat.format(user.getBirthday());
System.out.println(date);

image-20221101151701854

当处理的数据格式为JSON数据格式时适合使用@JsonFormat注解进行处理,在这之前需要使用@RequestBody注解获取请求体中的JSON字符串,再通过JSON解析库将JSON字符串转换为对应的POJO类型。或者是从数据库中查出对应的DateTime类型时对类型进行转换。

 

到此这篇关于Java中@DateTimeFormat和@JsonFormat注解介绍的文章就介绍到这了,更多相关@DateTimeFormat和@JsonFormat注解内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: Java中@DateTimeFormat和@JsonFormat注解介绍

本文链接: https://www.lsjlt.com/news/170667.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
  • Java中@DateTimeFormat和@JsonFormat注解介绍
    目录1.@DateTimeFormat注解1.1@DateTimeFormat注解简介1.2@DateTimeFormat注解的功能1.3@DateTimeFormat注解的注意点1...
    99+
    2022-11-13
    @datetimeformat @jsonformat注解 datetimeformat注解 @jsonformat注解
  • @DateTimeFormat 和 @JsonFormat 注解详解
    这一篇文章足以让你对Java当中Date时间上的理解更上一层楼,本篇文章主要通过代码的形式来进行试验,彻彻底底搞明白日期传参,以及日期返回参数的格式相关问题,每一个步骤都会记得特别详细! 本篇文...
    99+
    2023-10-08
    mybatis java spring boot 日期
  • 前后端时间传递之注解形式(@DateTimeFormat与@JsonFormat)
    文章目录 一、前言二、前端传后端(@DateTimeFormat)2.1 场景2.2 例子 三、后端传前端3.1 场景3.2 例子 四、java.sql包下的Date用法4.1 说...
    99+
    2023-09-13
    java spring 前端 mybatis spring boot
  • Java中注解@JsonFormat的用法详解
    目录一、@JsonFormat是什么?二、@JsonFormat参数讲解附:@JsonFormat 将枚举序列化为对象Java EnumMain Class不使用 @Jso...
    99+
    2023-01-06
    java注解@jsonformat jsonformat java注解
  • 介绍java的注解类型
    这篇文章主要介绍“介绍java的注解类型”,在日常操作中,相信很多人在介绍java的注解类型问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答”介绍java的注解类型”的疑惑有所帮助!接下来,请跟着小编一起来学习吧...
    99+
    2023-06-06
  • Java注解的介绍和使用详细讲解
    文章目录 注解注解基本介绍自定义注解元注解注解解析 注解 注解基本介绍 注解概述: Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释机制。 Java 语言中的类、构造器、方法...
    99+
    2023-08-16
    java junit 开发语言
  • SpringBoot中@Conditional注解介绍
    目录1. @Conditional 注解2. Springboot扩展1. @Conditional 注解 @Conditional注解是Spring-context模块提供了一个注...
    99+
    2024-04-02
  • java中基本注解的知识点介绍
    本篇内容主要讲解“java中基本注解的知识点介绍”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“java中基本注解的知识点介绍”吧!java.lang.Override是一个标记类型注解,它被用作...
    99+
    2023-06-20
  • Java元注解Retention代码示例介绍
    1.注解声明:通过@interface就可以声明一个注解。 @Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME...
    99+
    2024-04-02
  • java中Switch介绍
    定义形式 int i=2;          switch (i){ case 1: System.out.println("1号"); ...
    99+
    2023-09-09
    java Powered by 金山文档
  • SpringBoot @Autowired注解注入规则介绍
    目录@Autowired注解注入规则验证小结一下@Autowired注解无法自动注入的错误@Autowired注解注入规则 @Autowired - 注入默认根据类型,匹配不到则根据...
    99+
    2024-04-02
  • SpringDataJPA在Entity中常用的注解介绍
    目录首先我们常用的注解包括接下来介绍关联关系注解首先我们常用的注解包括 @Entity、@Table、@Id、@IdClass、@GeneratedValue、@Basic、@Tra...
    99+
    2024-04-02
  • springboot2中使用@JsonFormat注解不生效怎么解决
    这篇“springboot2中使用@JsonFormat注解不生效怎么解决”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“sp...
    99+
    2023-06-29
  • Kotlin中@JvmOverloads注解作用示例介绍
    在Kotlin中@JvmOverloads注解的作用:指示Kotlin编译器为此函数生成替换默认参数值的重载。 如果一个方法有N个参数,其中M个具有默认值,则会生成M个重载。 第一个...
    99+
    2024-04-02
  • springboot2中使用@JsonFormat注解不生效的解决
    目录使用@JsonFormat注解不生效本次使用的版本号解决方式@JsonFormat和@DateTimeFormat的作用使用@JsonFormat注解不生效 百度了不少解决方式,...
    99+
    2024-04-02
  • Java中抽象类和接口介绍
    目录1、抽象类1.1 什么是抽象类?1.2 抽象类属于什么类型?1.3 抽象类怎么定义?1.4 抽象方法2、接口2.1 关于接口2.2 接口怎么定义?2.3 接口基础语法总结1、抽象...
    99+
    2024-04-02
  • Java中&和&&的区别简单介绍
    & 按位运算符,逻辑运算符 && 逻辑运算符 相同点:只要有一端为假,则语句不成立 假设有三个参数 int x = 1; int y = 2; int q =...
    99+
    2024-04-02
  • C++中模板和STL介绍详解
    目录一、模板1.1.函数模板1.1.1.两种函数模板的实例化1.1.2.模板参数的匹配原则1.2.类模板二、STL总结一、模板 对于一个交换函数,虽然C++支持函数重载,我们可以对多...
    99+
    2024-04-02
  • 介绍java中Pair(配对)
    目录介绍java中Pair核心java配对实现Pair类AbstractMap.SimpleEntry 和 AbstractMap.SimpleImmutableEntryApach...
    99+
    2023-03-19
    java中Pair java配对实现
  • Java中的抽象介绍
    目录1.抽象类和抽象方法2.何时在示例中使用抽象类和抽象方法3.封装与数据抽象4.抽象的优点前言: 数据抽象是一种仅向用户显示基本细节的属性。不向用户显示琐碎或非必需的单元。例如:汽...
    99+
    2024-04-02
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作