一. 依赖
   
⏹若使用的是SpringBoot
<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId>
	<version>2.0.0</version>
</dependency>
- 
     
 2.0.0
 
 以上的版本就支持
 
 JSR310
 
 时间规范。
⏹若使用的是Spring
<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis-spring</artifactId>
	<version>2.0.5</version>
</dependency>
<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis</artifactId>
	<version>3.5.5</version>
</dependency>
- 
     Mybatis在
 
 3.4.5
 
 版本(2017.8月份发布)之后,就内置了对jsr310的支持。
    
    
    二. 前台
   
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>JSR310日期测试</title>
</head>
<body>
    <button id="btn1">点击发送请求</button>
</body>
<script th:src="@{/js/public/jquery-3.6.0.min.js}"></script>
<script th:inline="javascript">
	$("#btn1").click(function() {
		
		// 各种时间格式
		const data = {
			date1: "2020/03/07 12:10:01",
			date2: "2020-03-06",
			date3: "12:10",
			date5: "202003",
			dateA: "2020/03/07",
			dateB: "2020年03月07日",
			dateC: "20200307",
		}
		
	    $.ajax({
	        url: "/test03/jsr310date",
	        type: 'POST',
	        data: JSON.stringify(data),
	        contentType: 'application/json;charset=utf-8',
	        success: function (data, status, xhr) {
	            console.log(data);
	        }
	    });
	});
</script>
</html>
    
    
    三. Controller,Form,Service
   
⏹Controller
import javax.annotation.Resource;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;
@Controller
@RequestMapping("/test03")
public class Test03Controller {
	
	@Resource
	private Test03Service service;
	@GetMapping("/init")
	public ModelAndView init() {
		
		ModelAndView modelAndView = new ModelAndView();
		modelAndView.setViewName("test03");
		return modelAndView;
	}
	
	@PostMapping("/jsr310date")
	@ResponseBody
	public Test03Entity jsr310date(@RequestBody Test03Form form) throws Exception {
		
		return service.jsr310date(form);
	}
}
⏹Form
- 
     后台使用LocalDate等时间类型接收前台数据时,需要使用
 
 @JsonFormat
 
 注解来指定数据格式。
- 
     
 @JsonFormat
 
 注解能指定前台向后台传入的数据类型,同时后台向前台返回的数据格式也会受其影响。
- 
     若不想在每个字段上都添加
 
 @JsonFormat
 
 注解来指定格式,可以使用全局日期格式转换器,
 
 详情请参考这篇博客:
 
 SpringBoot Java8日期全局日期格式转换器
 
 。
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.YearMonth;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
@Data
public class Test03Form {
	
	@JsonFormat(pattern = "yyyy/MM/dd HH:mm:ss")
	private LocalDateTime date1;
	
	// yyyy-MM-dd 格式的日期字符串,可自动封装到LocalDate中
	private LocalDate date2;
	
	@JsonFormat(pattern = "HH:mm")
	private LocalTime date3;
	
	private Instant date4;
	
	// 年月时间格式也可直接封装
	@JsonFormat(pattern = "yyyyMM")
	private YearMonth date5;
	
	// yyyy-MM-dd 格式之外的日期字符串,需要通过@JsonFormat注解指定格式
	@JsonFormat(pattern = "yyyy/MM/dd")
	private LocalDate dateA;
	
	// 约束前端和后端的数据格式
	@JsonFormat(pattern = "yyyy年MM月dd日") 
	private LocalDate dateB;
	
	@JsonFormat(pattern = "yyyyMMdd")
	private LocalDate dateC;	
}
⏹Service
- 向数据库中插入数据后,再查询插入的数据,返回前台查看效果。
import java.time.Instant;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class Test03Service {
	
	@Autowired
	private TestMapper03 mapper;
	@Transactional(rollbackFor = Exception.class)
	public Test03Entity jsr310date(Test03Form form) {
		
		form.setDate4(Instant.now());
		mapper.insertData(form);
		// 查询插入数据库中的数据
		return mapper.selectData();
	}
}
    
    
    四. 数据库类型
   
⏹使用的是Mysql数据库,其中实体类属性和DB字段类型的对应关系如下
| 实体类属性 | DB字段类型 | 
|---|---|
| LocalDateTime | datetime | 
| LocalDate | date | 
| LocalTime | time | 
| Instant | timestamp | 
     
   
    
    
    五. 效果
   
- 
     因为date4是时间戳类型,所以返回到前台的数据格式为:
 
 "2023-09-15T01:22:18Z"
 
- 
     在前台时间戳可以通过
 
 new Date("2023-09-15T01:22:18Z")
 
 来转换为Date类型。
 
   
 
版权声明:本文为feyehong原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
