当前位置： 首页 > news >正文

廊坊网站建站建设网站建设的总体目标考核指标

news 2025/9/16 11:09:57
廊坊网站建站建设,网站建设的总体目标考核指标,小程序开发公司价格表,淘宝网站怎么做会话保持的介绍 在SpringBoot项目中，接口中的日期和时间类型的参数，配置格式。 日期格式 接口中常用的日期时间格式有两种： 字符串（比如：yyyy-MM-dd HH:mm:ss）时间戳（比如：1696839876955&a…

介绍

在SpringBoot项目中，接口中的日期和时间类型的参数，配置格式。

日期格式

接口中常用的日期时间格式有两种：

  1. 字符串（比如：yyyy-MM-dd HH:mm:ss）
  2. 时间戳（比如：1696839876955）

这两种方式各有优势。

  • 字符串格式表示时间，直观清晰，便于识别出时间。但是，字符串格式存在时区问题，需要在字段中描述出时区（SpringMVC的默认时间格式中带有时区），或者前后端规定好默认时区，比如东八区（GMT+8）。
  • 时间戳，用数字表示时间，准确定位时间，不存在时区问题。缺点是，不够直观，无法直接识别出时间戳对应的具体时间（需要转换），不便于从接口直接判断时间是否正确，测试比较费时费力。

格式配置

日期参数的格式，可以配置。分为：全局配置和局部配置。

  • 全局配置：作用于项目全局的时间参数。
  • 局部配置：只作用于配置的字段，覆盖全局配置，其余字段不受影响。

全局配置

Query时间入参，使用字符串

配置

spring:mvc:format:# Query参数，时间格式（转换 java.util.Date）date: yyyy-MM-dd HH:mm:ss

Query参数实体示例

Query参数，使用 java.util.Date 类型接收。

package com.example.web.exception.query;import com.example.core.validation.phone.query.PhoneQuery;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springdoc.api.annotations.ParameterObject;import java.util.Date;@Data
@ParameterObject
@Schema(name = "用户Query")
public class UserQuery {// 其他字段@Schema(description = "开始时间", example = "2023-01-01 08:30:00")private Date beginTime;@Schema(description = "结束时间", example = "2023-12-31 17:00:00")private Date endTime;}

接口调用成功

日期格式正确，接口调用成功。

在这里插入图片描述

打印日志：

查询用户列表。userQuery=UserQuery(name=null, phone=null, beginTime=Sun Jan 01 08:30:00 GMT+08:00 2023, endTime=Sun Dec 31 17:00:00 GMT+08:00 2023, beginDate=null, endDate=null)，pageQuery=PageQuery(pageNumber=1, pageSize=10)

接口调用失败

接口输入必须符合格式，否则会调用失败（报出异常）。
在这里插入图片描述

Body时间入参和响应时间出参

默认响应中的时间参数，会转换成字符串，默认时间格式举例：

2023-10-10T01:31:03.279+00:00

配置

目标格式为：yyyy-MM-dd HH:mm:ss，东八区。

spring:jackson:# Body参数和响应，时间格式（转换 java.util.Date）date-format: yyyy-MM-dd HH:mm:sstime-zone: GMT+8

Body时间入参：UserEditParam

package com.example.web.response.model.param;import com.example.core.validation.phone.strict.Phone;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;import javax.validation.constraints.Email;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotEmpty;
import java.util.Date;@Data
@Schema(name = "编辑用户Param")
public class UserEditParam {// 其他字段@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "开始日期", example = "2023-01-01")private Date beginDate;@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "结束日期", example = "2023-12-31")private Date endDate;}

效果

接口调用：
在这里插入图片描述
控制台打印参数：

新增用户，Post请求。param=UserAddParam(name=张三, phone=18612345678, email=zhangsan@example.com, beginTime=Sun Jan 01 08:30:00 CST 2023, endTime=Sun Dec 31 17:00:00 CST 2023)

响应时间出参：UserVO

package com.example.web.model.vo;import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;import java.util.Date;@Data
@Schema(name = "用户VO")
public class UserVO {// 其他字段@Schema(description = "开始时间", example = "2023-01-01 01:20:30")private Date beginTime;@Schema(description = "结束时间", example = "2023-01-01 01:20:30")private Date endTime;}

效果

在这里插入图片描述

响应时间出参：时间戳

配置

spring:jackson:serialization:# 时间字段（java.util.Date），返回时间戳。注意，此配置会覆盖掉 spring.jackson.date-format 。write-dates-as-timestamps: true

效果

响应时间出参，为时间戳格式。

在这里插入图片描述

局部配置

Query时间入参：局部格式

Query时间入参，如果某个字段需要的时间格式和全局不相同，可以配置这个字段的自定义的入参格式。

使用注解：@DateTimeFormat

配置示例

package com.example.web.exception.query;import com.example.core.validation.phone.query.PhoneQuery;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
import org.springdoc.api.annotations.ParameterObject;
import org.springframework.format.annotation.DateTimeFormat;import java.util.Date;@Data
@ParameterObject
@Schema(name = "用户Query")
public class UserQuery {// 其他字段@DateTimeFormat(pattern = "yyyy-MM-dd")@Schema(description = "开始日期", example = "2023-01-01")private Date beginDate;@DateTimeFormat(pattern = "yyyy-MM-dd")@Schema(description = "结束日期", example = "2023-12-31")private Date endDate;}

效果

在这里插入图片描述

Body时间入参：局部格式

使用注解：@JsonFormat

配置示例

package com.example.web.response.model.param;import com.example.core.validation.phone.strict.Phone;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;import javax.validation.constraints.Email;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotEmpty;
import java.util.Date;@Data
@Schema(name = "编辑用户Param")
public class UserEditParam {// 其他字段@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "开始日期", example = "2023-01-01")private Date beginDate;@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "结束日期", example = "2023-12-31")private Date endDate;}

效果

在这里插入图片描述

编辑用户，PUT请求。id=1234567890123456789，param=UserEditParam(name=张三, phone=18612345678, email=zhangsan@example.com, beginDate=Sun Jan 01 00:00:00 CST 2023, endDate=Sun Dec 31 00:00:00 CST 2023)

问题

注意：如下图传递参数，接口也能调用成功。
接口收到的参数，只包含年月日。

编辑用户，PUT请求。id=1234567890123456789，param=UserEditParam(name=张三, phone=18612345678, email=zhangsan@example.com, beginDate=Sun Jan 01 00:00:00 CST 2023, endDate=Sun Dec 31 00:00:00 CST 2023)

在这里插入图片描述

在这里插入图片描述

响应时间出参：局部格式

使用注解：@JsonFormat

配置示例

package com.example.web.model.vo;import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;import java.util.Date;@Data
@Schema(name = "用户VO")
public class UserVO {// 其他字段@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "开始日期", example = "2023-01-01")private Date beginDate;@JsonFormat(pattern = "yyyy-MM-dd")@Schema(description = "结束日期", example = "2023-12-31")private Date endDate;}

效果

在这里插入图片描述

http://www.yayakq.cn/news/205057/

相关文章：

  • 张裕网站建设的目标我的家乡网站建设模板
  • 网站排版用什么软件做微信封面模板下载网站
  • 百斯特网站建设阳山县网站住房和建设局
  • 建网站需要软件PHP网站开发与管理设计心得
  • 特色的合肥网站建设郴州网站建设哪家比较好
  • php网站开发实例电子版wordpress 发送邮件
  • 设计找图网站做做网页
  • 微网站建设企划书尤溪建设局网站
  • 网站开发第三方登录设计wordpress 自动采集插件
  • 给人做logo的网站仿门户网站源码
  • 网站空间后台网站更改模板 seo
  • 普陀集团网站建设学校的网站是怎么建设的
  • 淘宝联盟做网站wordpress打不开仪表盘
  • 合肥企业网站建设专家中南路网站建设公司
  • 绵阳低价网站建设网站弹窗特效
  • 爱站工具有加超人下拉系统深圳专业营销网站公司
  • 给企业做网站 工作网站开发环境的配置
  • 各家建站平台要建设一个网站需要准备些什么
  • 行业电子网站建设小程序推广方式有哪些
  • 免费行情网站软件淘宝店铺买卖
  • 如何建设网站功能设计公文写作网站
  • 免费网站一级a做爰在免费线看工信部门备案网站
  • 中山企业手机网站建设建筑工程招标
  • 那些网站做的比较好东莞市正度网络科技有限公司
  • 网站后台排版厦门过路费网站
  • 工程建设与设计期刊网站wordpress检测不到更新
  • 建设银行企业网站失败商务网站开发公司
  • 做网站哪家好 要钱包括哪些内容
  • 怎样做网站的外链开发公司成本管理
  • 巴南区网站建设代理服务器软件