Java增加自定義注解進行校驗入?yún)⒃斀?/h1>
更新時間:2023年04月13日 09:46:45 作者:奔跑的毛球
這篇文章主要為大家詳細(xì)介紹了Java如何通過增加自定義注解實現(xiàn)校驗入?yún)⒐δ?,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起了解一下
背景
客戶使用我們系統(tǒng)的時候,查詢不帶任何查詢條件,查詢就返回全部數(shù)據(jù),500多萬條數(shù)據(jù)啊,然后直接導(dǎo)出,數(shù)據(jù)量龐大,接口超時,這可苦了我們這些開發(fā)人員,一邊優(yōu)化,一邊挨噴。這么多數(shù)據(jù)就算導(dǎo)成功了,Excel也打不開呀。迫不得已,決定強制讓客戶至少傳入一個參數(shù)進行查詢來緩解服務(wù)器以及開發(fā)人員的壓力。
首先想到的,最簡單的,就是增加一個靜態(tài)方法,在每個方法入口調(diào)一下,來校驗以及拋出錯誤。但是轉(zhuǎn)念一想,更優(yōu)美的解決方案是在調(diào)用的方法上加一個注解,使用注解來完成這個功能,這豈不是很棒。
再一句話說下需求:
增加注解對入?yún)⑦M行校驗,保證至少有一個參數(shù)不為空,若是有時間參數(shù),則起始時間和結(jié)束時間之間的距離不能超過30天。
接下來,Show Time
注解類
這里有三個參數(shù),分別是三個參數(shù)名稱,起始時間參數(shù)名稱,結(jié)束時間參數(shù)名稱,需要校驗的參數(shù)名稱
@Target({ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface VerifyParameters {
/**
* 起始時間參數(shù)名稱
*/
String startTimeParamName() default "startTime";
/**
* 結(jié)束時間參數(shù)名稱
*/
String endTimeParamName() default "endTime";
/**
* 需要校驗的參數(shù)名稱
*/
String paramName() default "";
}
注解的Aspect類
這里貼一個完整的,目的是有的小伙伴想用的話,貼過去就能用。
@Component
@Aspect
public class VerifyParametersAspect {
private static final Logger logger = LoggerFactory.getLogger(VerifyParametersAspect.class);
/**
* 切點
*/
@Pointcut("@annotation(com.guava.mall.app.annotation.VerifyParameters)")
public void serviceAspect() {
}
/**
* service 方法前調(diào)用
*
* @param joinPoint
*/
@Before("serviceAspect()")
public void doBeforeService(JoinPoint joinPoint) {
try {
//獲取方法參數(shù)名
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
//獲取方法
Method method = signature.getMethod();
//獲取參數(shù)名
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
String[] parameterNames = u.getParameterNames(method);
Map<String, Object> params = new HashMap<>(8);
params = getParamMap(joinPoint, method, parameterNames, params);
//獲取注解
VerifyParameters verifyParameters = method.getAnnotation(VerifyParameters.class);
//參數(shù)名
String paramName = verifyParameters.paramName();
Object o = params.get(paramName);
ValidationUtils.validate(o == null, "參數(shù)不能為空");
ValidationUtils.validate(!atLeastOnePropertyNotNull(o), "請至少輸入一個查詢條件進行查詢和導(dǎo)出");
//開始時間和結(jié)束時間的參數(shù)名
String s = verifyParameters.startTimeParamName();
String e = verifyParameters.endTimeParamName();
Map<?, ?> map = JSONUtils.bean2Map(o);
Object startTime = map.get(s);
Object endTime = map.get(e);
if (startTime != null || endTime != null) {
ValidationUtils.validate(startTime == null || endTime == null, "開始時間和結(jié)束時間必須同時存在");
ValidationUtils.validate(Integer.parseInt(String.valueOf(endTime)) - Integer.parseInt(String.valueOf(startTime)) > 30 * 24 * 60 * 60, "時間間隔不能超過一個月");
}
} catch (NumberFormatException ex) {
logger.error(ex.getMessage(), ex);
}
}
private Map<String, Object> getParamMap(JoinPoint joinPoint, Method method, String[] parameterNames, Map<String, Object> params) {
int i = 0;
if (parameterNames != null && parameterNames.length > 0) {
for (String parameterName : parameterNames) {
params.put(parameterName, joinPoint.getArgs()[i]);
i++;
}
}
return params;
}
public static boolean atLeastOnePropertyNotNull(Object obj) {
for (Field field : obj.getClass().getDeclaredFields()) {
//忽略serialVersionUID
if ("serialVersionUID".equals(field.getName())) {
continue;
}
field.setAccessible(true);
try {
if (field.get(obj) != null && !field.get(obj).toString().isEmpty()) {
return true;
}
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
return false;
}
/**
* 方法后調(diào)用
*/
@After("serviceAspect()")
public void doAfterInService(JoinPoint joinPoint) {
}
}
然后,解釋一下
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
這是我們的第一行代碼,這里的joinPoint對象表示應(yīng)用建議的程序執(zhí)行點,getSignature()方法則會返回正在執(zhí)行的方法的方法簽名,簽名里就包含了該方法名稱、返回類型和參數(shù)類型。然后再強制轉(zhuǎn)換成MethodSignature對象,便于訪問方法相關(guān)的信息。
MethodSignature是一個對象,它表示正在執(zhí)行的方法的簽名,包括方法名稱、返回類型和參數(shù)類型。它是Spring AOP框架中的一個類,用于在切面中獲取方法的信息。
Method method = signature.getMethod();獲取方法
這個則是從MethodSignature中獲取到了正在執(zhí)行的方法信息。
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
LocalVariableTableParameterNameDiscoverer是一個類,它可以用于在運行時獲取方法參數(shù)的名稱。它是Spring框架中的一個類,通常與反射一起使用,以便在運行時獲取有關(guān)方法參數(shù)的信息。
通過 String[] parameterNames = u.getParameterNames(method); 可以獲取到目前方法的入?yún)⒚Q。
getParamMap(); 方法則會返回一個key是參數(shù)名稱,value是參數(shù)本身的map對象。 我們可以從中取出我們需要的那個參數(shù)對象。
VerifyParameters verifyParameters = method.getAnnotation(VerifyParameters.class);
上邊這行代碼則會獲取到方法上注解的注解對象本身,和我們傳入的參數(shù)值,因為每個方法的入?yún)⒉槐M相同,里邊時間的字段也不盡相同,需要主動傳入來做處理。
這里再解釋下atLeastOnePropertyNotNull()方法,這個方法的作用是判斷參數(shù)內(nèi)的屬性是否至少有一個不為空,這里我們忽略了serialVersionUID。
serialVersionUID是Java中的一個序列化機制,用于在反序列化期間驗證發(fā)送方和接收方的對象是否具有兼容的序列化版本。如果發(fā)送方和接收方的serialVersionUID不同,則反序列化將失敗。如果未指定serialVersionUID,則Java運行時將根據(jù)類的特定方面自動生成它。
之后的方法就很簡單了,拿出值根據(jù)我們的需要做處理即可
controller
再看看是如何使用的吧,添加@VerifyParameters注解,傳入時間的屬性名稱,和需要校驗的參數(shù)名稱,這里傳入?yún)?shù)名稱的原因是,可能和我這里一樣還有其他的參數(shù)影響,而我們只想校驗我們需要的參數(shù)。
@ApiOperation(value = "查詢列表")
@GetMapping("/test")
@VerifyParameters(startTimeParamName = "beginTime", endTimeParamName = "endTime",paramName = "orderRequest")
public Page<Map<String, Object>> findOrderTestList(Pageable pageable, ERPOrderRequest orderRequest) {
log.info("模擬邏輯處理");
return null;
}
這樣我們就實現(xiàn)了通過一個自定義注解對方法的入?yún)⑦M行了校驗,在取到入?yún)⒑头椒ǖ母鱾€值之后,我們其實可以做各種各樣的操作,各位小伙伴可以任意發(fā)揮。
到此這篇關(guān)于Java增加自定義注解進行校驗入?yún)⒃斀獾奈恼戮徒榻B到這了,更多相關(guān)Java自定義注解校驗入?yún)?nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
-
SpringBoot?Profile多環(huán)境配置方式
這篇文章主要介紹了SpringBoot?Profile多環(huán)境配置方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教 2022-06-06
-
Springboot接收POST請求,數(shù)據(jù)為json類型問題
在使用Spring框架中,當(dāng)處理POST請求且內(nèi)容為JSON類型時,應(yīng)使用@RequestBody注解而非@RequestParam,通過@RequestBody可以將JSON數(shù)據(jù)綁定到一個Map對象中,然后通過Map的get方法來獲取需要的參數(shù) 2022-10-10
-
springboot版本升級以及解決springsecurity漏洞的問題
這篇文章主要介紹了springboot版本升級以及解決springsecurity漏洞的問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教 2024-08-08
-
SpringBoot集成Druid監(jiān)控頁面最小化配置操作
這篇文章主要介紹了SpringBoot集成Druid監(jiān)控頁面最小化配置操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧 2020-09-09
-
jackson json序列化實現(xiàn)首字母大寫,第二個字母需小寫
這篇文章主要介紹了jackson json序列化實現(xiàn)首字母大寫,第二個字母需小寫方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教 2021-06-06
-
SpringBoot配置Access-Control-Allow-Origin教程
文章介紹了三種配置Spring Boot跨域訪問的方法:1. 使用過濾器;2. 在WebConfig配置文件中設(shè)置;3. 通過注解配置,作者分享了個人經(jīng)驗,并鼓勵讀者支持腳本之家 2025-03-03
最新評論
背景
客戶使用我們系統(tǒng)的時候,查詢不帶任何查詢條件,查詢就返回全部數(shù)據(jù),500多萬條數(shù)據(jù)啊,然后直接導(dǎo)出,數(shù)據(jù)量龐大,接口超時,這可苦了我們這些開發(fā)人員,一邊優(yōu)化,一邊挨噴。這么多數(shù)據(jù)就算導(dǎo)成功了,Excel也打不開呀。迫不得已,決定強制讓客戶至少傳入一個參數(shù)進行查詢來緩解服務(wù)器以及開發(fā)人員的壓力。
首先想到的,最簡單的,就是增加一個靜態(tài)方法,在每個方法入口調(diào)一下,來校驗以及拋出錯誤。但是轉(zhuǎn)念一想,更優(yōu)美的解決方案是在調(diào)用的方法上加一個注解,使用注解來完成這個功能,這豈不是很棒。
再一句話說下需求:
增加注解對入?yún)⑦M行校驗,保證至少有一個參數(shù)不為空,若是有時間參數(shù),則起始時間和結(jié)束時間之間的距離不能超過30天。
接下來,Show Time
注解類
這里有三個參數(shù),分別是三個參數(shù)名稱,起始時間參數(shù)名稱,結(jié)束時間參數(shù)名稱,需要校驗的參數(shù)名稱
@Target({ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface VerifyParameters {
/**
* 起始時間參數(shù)名稱
*/
String startTimeParamName() default "startTime";
/**
* 結(jié)束時間參數(shù)名稱
*/
String endTimeParamName() default "endTime";
/**
* 需要校驗的參數(shù)名稱
*/
String paramName() default "";
}注解的Aspect類
這里貼一個完整的,目的是有的小伙伴想用的話,貼過去就能用。
@Component
@Aspect
public class VerifyParametersAspect {
private static final Logger logger = LoggerFactory.getLogger(VerifyParametersAspect.class);
/**
* 切點
*/
@Pointcut("@annotation(com.guava.mall.app.annotation.VerifyParameters)")
public void serviceAspect() {
}
/**
* service 方法前調(diào)用
*
* @param joinPoint
*/
@Before("serviceAspect()")
public void doBeforeService(JoinPoint joinPoint) {
try {
//獲取方法參數(shù)名
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
//獲取方法
Method method = signature.getMethod();
//獲取參數(shù)名
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
String[] parameterNames = u.getParameterNames(method);
Map<String, Object> params = new HashMap<>(8);
params = getParamMap(joinPoint, method, parameterNames, params);
//獲取注解
VerifyParameters verifyParameters = method.getAnnotation(VerifyParameters.class);
//參數(shù)名
String paramName = verifyParameters.paramName();
Object o = params.get(paramName);
ValidationUtils.validate(o == null, "參數(shù)不能為空");
ValidationUtils.validate(!atLeastOnePropertyNotNull(o), "請至少輸入一個查詢條件進行查詢和導(dǎo)出");
//開始時間和結(jié)束時間的參數(shù)名
String s = verifyParameters.startTimeParamName();
String e = verifyParameters.endTimeParamName();
Map<?, ?> map = JSONUtils.bean2Map(o);
Object startTime = map.get(s);
Object endTime = map.get(e);
if (startTime != null || endTime != null) {
ValidationUtils.validate(startTime == null || endTime == null, "開始時間和結(jié)束時間必須同時存在");
ValidationUtils.validate(Integer.parseInt(String.valueOf(endTime)) - Integer.parseInt(String.valueOf(startTime)) > 30 * 24 * 60 * 60, "時間間隔不能超過一個月");
}
} catch (NumberFormatException ex) {
logger.error(ex.getMessage(), ex);
}
}
private Map<String, Object> getParamMap(JoinPoint joinPoint, Method method, String[] parameterNames, Map<String, Object> params) {
int i = 0;
if (parameterNames != null && parameterNames.length > 0) {
for (String parameterName : parameterNames) {
params.put(parameterName, joinPoint.getArgs()[i]);
i++;
}
}
return params;
}
public static boolean atLeastOnePropertyNotNull(Object obj) {
for (Field field : obj.getClass().getDeclaredFields()) {
//忽略serialVersionUID
if ("serialVersionUID".equals(field.getName())) {
continue;
}
field.setAccessible(true);
try {
if (field.get(obj) != null && !field.get(obj).toString().isEmpty()) {
return true;
}
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
return false;
}
/**
* 方法后調(diào)用
*/
@After("serviceAspect()")
public void doAfterInService(JoinPoint joinPoint) {
}
}然后,解釋一下
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
這是我們的第一行代碼,這里的joinPoint對象表示應(yīng)用建議的程序執(zhí)行點,getSignature()方法則會返回正在執(zhí)行的方法的方法簽名,簽名里就包含了該方法名稱、返回類型和參數(shù)類型。然后再強制轉(zhuǎn)換成MethodSignature對象,便于訪問方法相關(guān)的信息。
MethodSignature是一個對象,它表示正在執(zhí)行的方法的簽名,包括方法名稱、返回類型和參數(shù)類型。它是Spring AOP框架中的一個類,用于在切面中獲取方法的信息。
Method method = signature.getMethod();獲取方法
這個則是從MethodSignature中獲取到了正在執(zhí)行的方法信息。
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
LocalVariableTableParameterNameDiscoverer是一個類,它可以用于在運行時獲取方法參數(shù)的名稱。它是Spring框架中的一個類,通常與反射一起使用,以便在運行時獲取有關(guān)方法參數(shù)的信息。
通過 String[] parameterNames = u.getParameterNames(method); 可以獲取到目前方法的入?yún)⒚Q。
getParamMap(); 方法則會返回一個key是參數(shù)名稱,value是參數(shù)本身的map對象。 我們可以從中取出我們需要的那個參數(shù)對象。
VerifyParameters verifyParameters = method.getAnnotation(VerifyParameters.class);
上邊這行代碼則會獲取到方法上注解的注解對象本身,和我們傳入的參數(shù)值,因為每個方法的入?yún)⒉槐M相同,里邊時間的字段也不盡相同,需要主動傳入來做處理。
這里再解釋下atLeastOnePropertyNotNull()方法,這個方法的作用是判斷參數(shù)內(nèi)的屬性是否至少有一個不為空,這里我們忽略了serialVersionUID。
serialVersionUID是Java中的一個序列化機制,用于在反序列化期間驗證發(fā)送方和接收方的對象是否具有兼容的序列化版本。如果發(fā)送方和接收方的serialVersionUID不同,則反序列化將失敗。如果未指定serialVersionUID,則Java運行時將根據(jù)類的特定方面自動生成它。
之后的方法就很簡單了,拿出值根據(jù)我們的需要做處理即可
controller
再看看是如何使用的吧,添加@VerifyParameters注解,傳入時間的屬性名稱,和需要校驗的參數(shù)名稱,這里傳入?yún)?shù)名稱的原因是,可能和我這里一樣還有其他的參數(shù)影響,而我們只想校驗我們需要的參數(shù)。
@ApiOperation(value = "查詢列表")
@GetMapping("/test")
@VerifyParameters(startTimeParamName = "beginTime", endTimeParamName = "endTime",paramName = "orderRequest")
public Page<Map<String, Object>> findOrderTestList(Pageable pageable, ERPOrderRequest orderRequest) {
log.info("模擬邏輯處理");
return null;
}這樣我們就實現(xiàn)了通過一個自定義注解對方法的入?yún)⑦M行了校驗,在取到入?yún)⒑头椒ǖ母鱾€值之后,我們其實可以做各種各樣的操作,各位小伙伴可以任意發(fā)揮。
到此這篇關(guān)于Java增加自定義注解進行校驗入?yún)⒃斀獾奈恼戮徒榻B到這了,更多相關(guān)Java自定義注解校驗入?yún)?nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
SpringBoot?Profile多環(huán)境配置方式
這篇文章主要介紹了SpringBoot?Profile多環(huán)境配置方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-06-06
Springboot接收POST請求,數(shù)據(jù)為json類型問題
在使用Spring框架中,當(dāng)處理POST請求且內(nèi)容為JSON類型時,應(yīng)使用@RequestBody注解而非@RequestParam,通過@RequestBody可以將JSON數(shù)據(jù)綁定到一個Map對象中,然后通過Map的get方法來獲取需要的參數(shù)2022-10-10
springboot版本升級以及解決springsecurity漏洞的問題
這篇文章主要介紹了springboot版本升級以及解決springsecurity漏洞的問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-08-08
SpringBoot集成Druid監(jiān)控頁面最小化配置操作
這篇文章主要介紹了SpringBoot集成Druid監(jiān)控頁面最小化配置操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-09-09
jackson json序列化實現(xiàn)首字母大寫,第二個字母需小寫
這篇文章主要介紹了jackson json序列化實現(xiàn)首字母大寫,第二個字母需小寫方式,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-06-06
SpringBoot配置Access-Control-Allow-Origin教程
文章介紹了三種配置Spring Boot跨域訪問的方法:1. 使用過濾器;2. 在WebConfig配置文件中設(shè)置;3. 通過注解配置,作者分享了個人經(jīng)驗,并鼓勵讀者支持腳本之家2025-03-03

