ApiBoot - ApiBoot Http Converter 使用文档
ApiBoot是一款基于SpringBoot1.x,2.x的接口服务集成基础框架, 内部提供了框架的封装集成、使用扩展、自动化完成配置,让接口开发者可以选着性完成开箱即用, 不再为搭建接口框架而犯愁,从而极大的提高开发效率。
FastJson
是阿里巴巴提供的一款Json
格式化插件。
ApiBoot
提供了FastJson
驱动转换接口请求的Json
字符串数据,添加该依赖后会自动格式化时间(格式:YYYY-MM-DD HH:mm:ss)、空对象转换为空字符串返回、空Number转换为0等,还会自动装载ValueFilter
接口的实现类来完成自定义的数据格式转换。
引入Http Converter
ApiBoot Http Converter
使用非常简单,只需要在pom.xml
添加如下依赖:
<!--ApiBoot Http Converter--> <dependency> <groupId>org.minbox.framework</groupId> <artifactId>api-boot-starter-http-converter</artifactId> </dependency>
ApiBoot
所提供的依赖都不需要添加版本号,具体查看ApiBoot版本依赖
相关配置
ApiBoot Http Converter
通过使用SpringBoot
内置的配置参数名来确定是否开启,在SpringBoot
内可以通过spring.http.converters.preferred-json-mapper
来修改首选的Json
格式化插件,SpringBoot
已经提供了三种,分别是:gson
、jackson
、jsonb
,当我们配置该参数为fastJson
或不进行配置
就会使用ApiBoot Http Converter
提供的fastJson
来格式化转换Json
返回数据。
如下所示:
spring: http: converters: # 不配置默认使用fastJson preferred-json-mapper: fastJson
自定义ValueFilter
ValueFilter
是FastJson
的概念,用于自定义转换实现,比如:自定义格式化日期、自动截取小数点等。
下面提供一个ValueFilter
的简单示例,具体的使用请参考FastJson
官方文档。
ValueFilter示例
在使用ValueFilter
时一般都会搭配一个对应的自定义@Annotation
来进行组合使用,保留自定义小数点位数的示例如下所示:
创建 BigDecimalFormatter Annotation
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) public @interface BigDecimalFormatter { /** * 小数位数,默认保留两位 * @return */ int scale() default 2; }
创建 BigDecimal ValueFilter
public class BigDecimalValueFilter implements ValueFilter { /** * logback */ Logger logger = LoggerFactory.getLogger(BigDecimalValueFilter.class); /** * @param object 对象 * @param name 对象的字段的名称 * @param value 对象的字段的值 */ @Override public Object process(Object object, String name, Object value) { if (ValidateTools.isEmpty(value) || !(value instanceof BigDecimal)) { return value; } return convertValue(object, name, value); } /** * 转换值 * * @param object 字段所属对象实例 * @param name 字段名称 * @param value 字段的值 * @return */ Object convertValue(Object object, String name, Object value) { try { /** * 反射获取field */ Field field = object.getClass().getDeclaredField(name); /** *判断字段是否存在@BigDecimalFormatter注解 */ if (field.isAnnotationPresent(BigDecimalFormatter.class)) { BigDecimalFormatter bigDecimalFormatter = field.getAnnotation(BigDecimalFormatter.class); // 执行格式化 BigDecimal decimal = (BigDecimal) value; System.out.println(bigDecimalFormatter.scale()); // 保留小数位数,删除多余 value = decimal.setScale(bigDecimalFormatter.scale(), BigDecimal.ROUND_DOWN).doubleValue(); } } catch (Exception e) { logger.error("格式化BigDecimal字段出现异常:{}", e.getMessage()); } return value; } }
使用 BigDecimalFormatter Annotation
@BigDecimalFormatter private BigDecimal decimalValue;
本章源码地址:https://github.com/hengboy/api-boot/tree/master/api-boot-samples/api-boot-sample-http-converter
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
ApiBoot - ApiBoot Alibaba Oss 使用文档
ApiBoot是一款基于SpringBoot1.x,2.x的接口服务集成基础框架, 内部提供了框架的封装集成、使用扩展、自动化完成配置,让接口开发者可以选着性完成开箱即用, 不再为搭建接口框架而犯愁,从而极大的提高开发效率。 `ApiBoot`添加快速集成`Aliyun`的对象存储服务`Oss`,提供常用的文件操作方法,当然也提供自定义扩展,以致于满足绝大数业务场景,并且通过扩展可以实现上传文件进度条、下载文件进度条、存储空间操作、静态网站托管、访问日志、防盗链、分片上传、追加上传、断点续传等等。 ### 引入ApiBoot Alibaba Oss 在`pom.xml`配置文件内添加依赖,如下所示: ```xml org.minbox.frameworkapi-boot-starter-alibaba-oss ``` `ApiBoot`所提供的依赖都不需要添加版本号,具体查看[ApiBoot版本依赖](https://github.com/hengboy/api-boot/blob/master/README.md#%E6%B7%BB%E5%8A%A0%E7%89%88%E6%9C%A...
- 下一篇
好程序员技术分析JavaScript闭包特性详解
好程序员技术分析JavaScript闭包特性详解,今天来总结一下js闭包的那些事,以及遇到的坑和解决方法,希望对你有所帮助。是的,没看错标题,重要的事情要说三篇,JavaScript闭包。首先先简要总结闭包特性:函数的局部变量在函数返回之后仍然可用栈上的内存空间在函数返回之后仍在存在,不被回收给个例子。下面这段代码会返回一个函数的引用:function sayHello2(name) { var text = 'Hello ' + name; // Local variable var sayAlert = function() { alert(text); } return sayAlert; }say2 = sayHello2('Bob');say2(); // alerts "Hello Bob"对于这段代码,C程序员可能会认为sayAlert和say2一样,都是指向一个函数的指针。但实际上它俩有一个重要区别: 在JavaScript中,你可以认为一个函数的指针变量同时拥有两个指针。一个指向这个函数,另一个隐藏的指针指向一个闭包。重点在于你的函数内是否引用的外部变量。在Jav...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
-
Docker使用Oracle官方镜像安装(12C,18C,19C)
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- CentOS8编译安装MySQL8.0.19
- Docker快速安装Oracle11G,搭建oracle11g学习环境
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- MySQL8.0.19开启GTID主从同步CentOS8
- CentOS7,8上快速安装Gitea,搭建Git服务器
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
推荐阅读
最新文章
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- CentOS6,CentOS7官方镜像安装Oracle11G
- SpringBoot2整合Redis,开启缓存,提高访问速度
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- SpringBoot2配置默认Tomcat设置,开启更多高级功能
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- SpringBoot2整合MyBatis,连接MySql数据库做增删改查操作
- Hadoop3单机部署,实现最简伪集群
- MySQL8.0.19开启GTID主从同步CentOS8
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果