Spring Boot 通過(guò) Mvc 擴(kuò)展方便進(jìn)行貨幣單位轉(zhuǎn)換的代碼詳解
由于公司是支付平臺(tái)，所以很多項(xiàng)目都涉及到金額，業(yè)務(wù)方轉(zhuǎn)遞過(guò)來(lái)的金額是單位是元，而我們數(shù)據(jù)庫(kù)保存的金額單位是分。一般金額的流向有以下幾個(gè)方向：
- 外部業(yè)務(wù)方請(qǐng)求我們服務(wù)，傳遞過(guò)來(lái)的金額單位是元，需要把元轉(zhuǎn)換成分。比如：下單接口。
- 內(nèi)部系統(tǒng)之間的流轉(zhuǎn)，不管是向下傳遞還是向上傳遞系統(tǒng)間的流程都是分，不需要扭轉(zhuǎn)。比如：調(diào)用支付引擎(向下傳遞)，支付引擎回調(diào)收單業(yè)務(wù)(向上傳遞)。
- 向業(yè)務(wù)方返回?cái)?shù)據(jù)，這個(gè)時(shí)候需要把分轉(zhuǎn)換成元。比如:商戶(hù)調(diào)用查詢(xún)訂單接口。
- 內(nèi)部系統(tǒng)的展示，這個(gè)時(shí)候需要把分轉(zhuǎn)換成元。比如：顯示收入金額的報(bào)表。
如果我們對(duì)于請(qǐng)求參數(shù)是金額類(lèi)型的參數(shù)逐一處理，這樣重復(fù)的操作就會(huì)顯得相當(dāng)?shù)牟粌?yōu)雅。對(duì)于請(qǐng)求參數(shù)我們可以使用 Spring MVC 提供的擴(kuò)展擴(kuò)展。對(duì)于金額操作我們可以分為：
- 業(yè)務(wù)方傳入金額單位為元，需要把業(yè)務(wù)方傳入的元轉(zhuǎn)換成分，可以使用 Spring MVC Restful 請(qǐng)求參數(shù)擴(kuò)展
RequestBodyAdvice接口。 - 業(yè)務(wù)方需要查詢(xún)數(shù)據(jù)，需要把數(shù)據(jù)庫(kù)保存的分轉(zhuǎn)換成元，可以使用 Spring MVC Restful 響應(yīng)參數(shù)擴(kuò)展
ResponseBodyAdvice接口。
下面我們就來(lái)看一下代碼實(shí)現(xiàn)。
1、FenToYuan.java
定義一個(gè)標(biāo)注注解，用于標(biāo)注到需要把元轉(zhuǎn)換成分的 BigDecimal 類(lèi)型的參數(shù)上面。
FenToYuan.java
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FenToYuan {
}
2、YuanToFenRequestBodyAdvice.java
實(shí)現(xiàn) Spring MVC Restful 請(qǐng)求參數(shù)擴(kuò)展類(lèi)，如果請(qǐng)求參數(shù)標(biāo)注了 @RequestBody 注解，并且請(qǐng)求參數(shù)的字段類(lèi)型為 BigDecimal 就會(huì)把傳入的參數(shù)由元轉(zhuǎn)換成分。
YuanToFenRequestBodyAdvice.java
@Slf4j
@ControllerAdvice
public class YuanToFenRequestBodyAdvice extends RequestBodyAdviceAdapter {
@Override
public boolean supports(MethodParameter methodParameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) {
return methodParameter.hasParameterAnnotation(RequestBody.class);
}
@Override
public Object afterBodyRead(Object body, HttpInputMessage inputMessage, MethodParameter parameter, Type targetType, Class<? extends HttpMessageConverter<?>> converterType) {
if(body == null) {
return null;
}
Class<?> clazz = body.getClass();
PropertyDescriptor[] propertyDescriptors = BeanUtils.getPropertyDescriptors(clazz);
for (PropertyDescriptor propertyDescriptor : propertyDescriptors) {
String name = propertyDescriptor.getName();
if("class".equals(name)){
continue;
}
Field field = ReflectionUtils.findField(clazz, name);
Class<?> fieldClazz = field.getType();
if(!fieldClazz.equals(BigDecimal.class) ){
continue;
}
if(!field.isAnnotationPresent(YuanToFen.class)) {
continue;
}
Method readMethod = propertyDescriptor.getReadMethod();
Method writeMethod = propertyDescriptor.getWriteMethod();
try {
BigDecimal yuanAmount = (BigDecimal) readMethod.invoke(body);
BigDecimal fenAmount = AmountUtils.yuan2Fen(yuanAmount);
writeMethod.invoke(body, fenAmount);
} catch (Exception e) {
log.error("amount convert yuan to fen fail", e);
}
}
return super.afterBodyRead(body, inputMessage, parameter, targetType, converterType);
}
}
3、YuanToFen.java
標(biāo)注注解，當(dāng)響應(yīng)參數(shù)需要由分轉(zhuǎn)換成元的時(shí)候，就標(biāo)注這個(gè)注解。響應(yīng)值就會(huì)把數(shù)據(jù)庫(kù)或者下游傳遞過(guò)來(lái)的金額為分的參數(shù)轉(zhuǎn)換成元。
YuanToFen.java
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface YuanToFen {
}
4、FenToYuanResponseBodyAdvice.java
當(dāng) Spring MVC 方法上標(biāo)注了 ResponseBody 或者類(lèi)上標(biāo)注了 RestController 注解時(shí)，如果響應(yīng)對(duì)象的 BigDecimal 標(biāo)注了 @YuanToFen 注解就會(huì)進(jìn)行金額分轉(zhuǎn)換成元。
FenToYuanResponseBodyAdvice.java
@Slf4j
@ControllerAdvice
public class FenToYuanResponseBodyAdvice implements ResponseBodyAdvice {
@Override
public boolean supports(MethodParameter returnType, Class converterType) {
return returnType.hasParameterAnnotation(ResponseBody.class)
|| returnType.getDeclaringClass().isAnnotationPresent(RestController.class);
}
@Override
public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {
if(body == null) {
return null;
}
Class<?> clazz = body.getClass();
PropertyDescriptor[] propertyDescriptors = BeanUtils.getPropertyDescriptors(clazz);
for (PropertyDescriptor propertyDescriptor : propertyDescriptors) {
String name = propertyDescriptor.getName();
if("class".equals(name)){
continue;
}
Field field = ReflectionUtils.findField(clazz, name);
Class<?> fieldClazz = field.getType();
if(!fieldClazz.equals(BigDecimal.class) ){
continue;
}
if(!field.isAnnotationPresent(FenToYuan.class)) {
continue;
}
Method readMethod = propertyDescriptor.getReadMethod();
Method writeMethod = propertyDescriptor.getWriteMethod();
try {
BigDecimal fenAmount = (BigDecimal) readMethod.invoke(body);
BigDecimal yuanAmount = AmountUtils.fen2yuan(fenAmount);
writeMethod.invoke(body, yuanAmount);
} catch (Exception e) {
log.error("amount convert fen to yuan fail", e);
}
}
return body;
}
}
5、AmountUtils.java
金錢(qián)工具類(lèi)，提供了金錢(qián)的元轉(zhuǎn)分以及分轉(zhuǎn)元這兩個(gè)功能。
AmountUtils.java
public abstract class AmountUtils {
/**
* 金額單位元轉(zhuǎn)分
*/
public static BigDecimal yuan2Fen(BigDecimal amount) {
if (amount == null) {
return BigDecimal.ZERO;
}
return amount.movePointRight(2).setScale(0, BigDecimal.ROUND_DOWN);
}
/**
* 金額單位分轉(zhuǎn)元
*/
public static BigDecimal fen2yuan(BigDecimal amount) {
return null2Zero(amount).movePointLeft(2).setScale(2, BigDecimal.ROUND_HALF_UP);
}
/**
* 把 null 當(dāng)作 0 處理
*/
public static BigDecimal null2Zero(Number amount) {
if (amount == null) {
return BigDecimal.ZERO;
}
if (amount instanceof BigDecimal) {
return (BigDecimal) amount;
} else {
return new BigDecimal(amount.toString());
}
}
}
6、Order.java
實(shí)體類(lèi)，用于接收請(qǐng)求對(duì)象以及響應(yīng)測(cè)試金額轉(zhuǎn)換。
Order.java
@Data
public class Order {
private String orderId;
private String productName;
@FenToYuan
@YuanToFen
private BigDecimal orderAmount;
}
7、OrderController.java
訂單控制類(lèi)，提供了兩個(gè)方法：訂單創(chuàng)建(/order/apply)標(biāo)注了 @RequestBody，會(huì)把傳入的金額由元轉(zhuǎn)換成分，然后打印到控制臺(tái)。訂單查詢(xún)(order/query) 聲明方法的類(lèi)上標(biāo)注了 @RestController ，通過(guò)關(guān)鍵字 new 創(chuàng)建一個(gè)訂單金額為 1000 分的訂單。
OrderController.java
@RestController
@RequestMapping("order")
public class OrderController {
@RequestMapping("apply")
public void apply(@RequestBody Order order) {
System.out.println(JSON.toJSONString(order));
}
@RequestMapping("query/{id}")
public Order query(@PathVariable String id) {
Order order = new Order();
order.setOrderId(id);
order.setOrderAmount(new BigDecimal("1000"));
order.setProductName("test");
return order;
}
}
8、測(cè)試
使用工具 Postman 發(fā)送 http 進(jìn)行功能測(cè)試。
8.1 元轉(zhuǎn)分測(cè)試
通過(guò) postman 請(qǐng)求 http:localhost:8080/order/apply發(fā)送以下請(qǐng)求：
控制臺(tái)打印如下：
業(yè)務(wù)方傳入金額為 1 元，控制臺(tái)打印的結(jié)果是 100 分。
8.2 測(cè)試分轉(zhuǎn)元
通過(guò) postman 請(qǐng)求 http:localhost:8080/order/query/1發(fā)送以下請(qǐng)求：
這個(gè)時(shí)候得到訂單金額為 10 元。查詢(xún)訂單的邏輯如下：
這個(gè)時(shí)候訂單的金額是 1000 分，轉(zhuǎn)換成 10 元完成了我們的目標(biāo)功能。
當(dāng)然這種方式是有一個(gè)缺陷的，就是它不能遞歸的進(jìn)行金額轉(zhuǎn)換，后面可以借鑒 Hibernate 的遞歸校驗(yàn)邏輯來(lái)進(jìn)行遞歸金額參數(shù)的轉(zhuǎn)換。
到此這篇關(guān)于Spring Boot 通過(guò) Mvc 擴(kuò)展方便進(jìn)行貨幣單位轉(zhuǎn)換的文章就介紹到這了,更多相關(guān)Spring Boot貨幣單位轉(zhuǎn)換內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
基于Java實(shí)現(xiàn)Avro文件讀寫(xiě)功能
大家好，本篇文章主要講的是基于Java實(shí)現(xiàn)Avro文件讀寫(xiě)功能，感興趣的同學(xué)趕快來(lái)看一看吧，對(duì)你有幫助的話(huà)記得收藏一下2022-02-02
關(guān)于dubbo的RPC和RESTful性能及對(duì)比
這篇文章主要介紹了關(guān)于dubbo的RPC和RESTful性能及對(duì)比，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-12-12
在Java中,我們常用List來(lái)存儲(chǔ)數(shù)據(jù),但是我們?cè)趺磁袛嗨欠癯晒?lái)了我們需要的數(shù)據(jù)呢?下面這篇文章主要給大家介紹了關(guān)于Java應(yīng)該在哪里判斷List是否為空的相關(guān)資料,需要的朋友可以參考下2022-02-02
這篇文章主要介紹了IDEA 格式化SQL代碼技巧分享，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2021-02-02
這篇文章主要為大家詳細(xì)介紹了java生成驗(yàn)證碼的步驟總結(jié)，需要的朋友可以參考下2017-04-04
這篇文章主要介紹了關(guān)于spring屬性占位符用法,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-11-11
SparkStreaming整合Kafka過(guò)程詳解
這篇文章主要介紹了SparkStreaming整合Kafka過(guò)程，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)吧2023-01-01
Java反射與Fastjson的危險(xiǎn)反序列化詳解
在?Java?中,Computer.class是一個(gè)引用,它表示了?Computer?的字節(jié)碼對(duì)象（Class對(duì)象）,這個(gè)對(duì)象被廣泛應(yīng)用于反射、序列化等操作中,那么為什么?parseObject?需要這個(gè)引用呢,帶著這個(gè)問(wèn)題我們一起通過(guò)本文學(xué)習(xí)下吧2024-07-07
本篇文章主要介紹了Spring boot集成RabbitMQ的示例代碼，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-05-05
通過(guò)jstack分析解決進(jìn)程死鎖問(wèn)題實(shí)例代碼
這篇文章主要介紹了通過(guò)jstack分析解決進(jìn)程死鎖問(wèn)題實(shí)例代碼，具有一定借鑒價(jià)值,需要的朋友可以參考下2018-01-01