Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

作者 | LiuBao

OpenAPI 针对时间定义了两种类型 date 和 date-time。JavaChassis 在2.0.1之前的版本只支持使用 date-time,而且必须要求使用 java.util.Date 作为运行时类型, 2.0.1 版本扩充了 date 和 date-time 的实现,开发者可以使用更加灵活的方式使用这两种类型。

使用 date

可以在 query、path、body 等参数中使用 date 类型。date 类型对应的 Java 类型为  java.time.LocalDate 。使用 Spring MVC, 分别采用如下方式定义接口:


@GetMapping(path = "/getLocalDate")

public LocalDate getLocalDate(@RequestParam("date") LocalDate date) {

return date;

}


@GetMapping(path = "/getLocalDate/{date}")

public LocalDate getLocalDatePath(@PathParam("date") LocalDate date) {

return date;

}


@PostMapping(path = "/postLocalDate")

public LocalDate postLocalDate(@RequestBody LocalDate date) {

return date;

}

其中 getLocalDatePath 接口定义生成的 swagger 描述如下:


/getLocalDate/{date}:

get:

operationId: "getLocalDatePath"

parameters:

– name: "date"

in: "path"

required: true

type: "string"

format: "date"

responses:

"200":

description: "response of 200"

schema:

type: "string"

format: "date"

可以看出,date 在网络上是通过 String 进行编码进行传输的, 格式是标准的格式, 比如 2020-02-20

使用 date-time

可以在 query、path、body 等参数中使用 date-time 类型。date 类型对应的 Java 类型为 java.time.LocalDateTime , 或者  java.util.Date 。使用 Spring MVC, 分别采用如下方式定义接口:


@GetMapping(path = "/getDate")

public Date getDate(@RequestParam("date") Date date) {

return date;

}


@GetMapping(path = "/getDatePath/{date}")

public Date getDatePath(@PathParam("date") Date date) {

return date;

}


@PostMapping(path = "/postDate")

public Date postDate(@RequestBody Date date) {

return date;

}


@GetMapping(path = "/getLocalDateTime")

public LocalDateTime getLocalDateTime(@RequestParam("date") LocalDateTime date) {

return date;

}


@GetMapping(path = "/getLocalDateTime/{date}")

public LocalDateTime getLocalDateTimePath(@PathParam("date") LocalDateTime date) {

return date;

}


@PostMapping(path = "/postLocalDateTime")

public LocalDateTime postLocalDateTime(@RequestBody LocalDateTime date) {

return date;

}


其中  getLocalDateTimePath  接口定义生成的 swagger 描述如下:


/getLocalDateTime/{date}:

get:

operationId: "getLocalDateTimePath"

parameters:

– name: "date"

in: "path"

required: true

type: "string"

format: "date-time"

responses:

"200":

description: "response of 200"

schema:

type: "string"

format: "date-time"

可以看出,date-time 在网络上是通过 String 进行编码进行传输的, 格式是标准的格式, 比如 2017-07-21T17:32:28Z 。由于 date-time 的标准格式包含特殊字符,在作为 query 或者 path 参数的时候, 需要做好 URL 编解码, 网络上传递的实际内容为  2017-07-21T17%3A32%3A28Z , 比如:  http://localhost:8082/dateTime/getLocalDateTime?date=2017-07-21T17%3A32%3A28Z ,作为 body 参数, 内容不会编解码, 是引号包含起来的 String 类型, 比如  "2017-07-21T17:32:28Z"

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

如您对开源开发微服务感兴趣

欢迎扫描下方二维码添加

ServiceComb小助手

咱们一起做点有意思的事情~

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

欢迎扫码

关注精彩!

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

您点的每个赞,我都认真当成了喜欢

点击下方“阅读原文”查看 更多ServiceComb小知识

原文 

http://mp.weixin.qq.com/s?__biz=MzUxNTEwNTg5Mg==&mid=2247488811&idx=1&sn=d605360dd218ea08ece7e5cafc662eab

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » Apache ServiceComb Java Chassis 2.0.0 新特性重磅出击:date和date-time

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址