溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

發(fā)布時(shí)間:2021-12-17 13:44:34 來(lái)源:億速云 閱讀:478 作者:iii 欄目:開(kāi)發(fā)技術(shù)

本篇內(nèi)容主要講解“@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決”,感興趣的朋友不妨來(lái)看看。本文介紹的方法操作簡(jiǎn)單快捷,實(shí)用性強(qiáng)。下面就讓小編來(lái)帶大家學(xué)習(xí)“@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決”吧!

問(wèn)題起源

使用SpringCloud構(gòu)建項(xiàng)目時(shí),使用Swagger生成相應(yīng)的接口文檔是推薦的選項(xiàng),Swagger能夠提供頁(yè)面訪問(wèn),直接在網(wǎng)頁(yè)上調(diào)試后端系統(tǒng)的接口, 非常方便。最近卻遇到了一個(gè)有點(diǎn)困惑的問(wèn)題,演示接口示例如下(原有功能接口帶有業(yè)務(wù)實(shí)現(xiàn)邏輯,這里簡(jiǎn)化了接口):

/**
* @description: 演示類
* @author: Huang Ying
**/
@Api(tags = "演示類")
@RestController
@Slf4j
public class DemoController {

@ApiOperation(value = "測(cè)試接口")
@ApiImplicitParams({
@ApiImplicitParam(name = "uid", value = "用戶ID", paramType = "query", dataType = "Long")
})
@RequestMapping(value = "/api/json/demo", method = RequestMethod.GET)
public String auth(@RequestParam(value = "uid") Long uid) {
System.out.println(uid);
return "the uid: " + uid;
}
}

問(wèn)題出在接口參數(shù)uid的必填性上,@RequestParam注解里require默認(rèn)為true,要求必填,但@ApiImplicitParam注解里require默認(rèn)為false,要求非必填,該業(yè)務(wù)接口在進(jìn)行功能聯(lián)調(diào)時(shí),uid居然能得到一個(gè)null值,按照一般認(rèn)知習(xí)慣@ApiImplicitParam注解的主要作用是生成接口文檔,不應(yīng)該對(duì)@RequestParam的屬性有侵入性才對(duì),目前反饋的bug,讓我懷疑@ApiImplicitParam是不是會(huì)侵入@RequestParam的require屬性?

框架選型、版本及主要功能

項(xiàng)目搭建

SpringBoot版本:2.1.6.RELEASESpringCloud版本:Greenwich.SR3

業(yè)務(wù)模塊

SpringCloud業(yè)務(wù)模塊使用的swagger:

swagger bootstrap ui 1.9.6 增強(qiáng)swagger ui樣式spring4all-swagger 1.9.0.RELEASE 配置化swagger參數(shù),免去代碼開(kāi)發(fā)

業(yè)務(wù)網(wǎng)關(guān)

SpringCloud業(yè)務(wù)網(wǎng)關(guān)使用的swagger:

knife4j 2.0.1 增強(qiáng)swagger ui樣式(網(wǎng)關(guān)用gateway搭建,swagger使用knife4j-spring-boot-starter依賴,可以聚合業(yè)務(wù)模塊的swagger文檔)

此次的范圍只針對(duì)SpringCloud業(yè)務(wù)模塊,暫時(shí)不涉及業(yè)務(wù)網(wǎng)關(guān)的Swagger文檔。

測(cè)試工具

測(cè)試工具目前有兩個(gè):swagger doc:使用瀏覽器進(jìn)行訪問(wèn),如下圖:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

postman:手動(dòng)配置接口參數(shù),示例:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

案例實(shí)戰(zhàn)

接口測(cè)試1

接口示例如開(kāi)篇所示,我們先使用如下接口,全部使用默認(rèn)值,即@ApiImplicitParam的required為false,@RequestParam的required為true:

@ApiOperation(value = 
"測(cè)試接口")
@ApiImplicitParams({
@ApiImplicitParam(name = "uid", value = "用戶ID", paramType = "query", dataType = "Long")
})
@RequestMapping(value = "/api/json/demo", method = RequestMethod.GET)
public String auth(@RequestParam(value = "uid") Long uid) {
System.out.println(uid);
return "the uid: " + uid;
}

看swagger的結(jié)果:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

看postman的結(jié)果:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

接口測(cè)試2

我們修改@ApiImplicitParam的required值為true,@RequestParam不變,重啟模塊@ApiImplicitParam(name = "uid", value = "用戶ID", paramType = "query", required = true, dataType = "Long")

看swagger的結(jié)果:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

通過(guò)調(diào)試瀏覽器可以發(fā)現(xiàn),為空校驗(yàn)是js完成的,js判斷為空后,并未發(fā)起請(qǐng)求到后端,這樣我們可以認(rèn)為swagger內(nèi)@ApiImplicitParam的required參數(shù)生效了。

接口測(cè)試3

在前面我們使用postman測(cè)試接口時(shí),發(fā)現(xiàn)參數(shù)項(xiàng)是空的,我們加上參數(shù),但不寫值測(cè)試后,結(jié)果讓人詫異:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

并且無(wú)論@ApiImplicitParam的required值如何修改,結(jié)果都是一樣的,肯定有一個(gè)地方是搞錯(cuò)了,導(dǎo)致我們誤判。

后來(lái)仔細(xì)查閱資料,發(fā)現(xiàn)是我們對(duì)@RequestParam的required參數(shù)理解錯(cuò)了,這個(gè)required為true的含義是:接口參數(shù)名一定要存在,但參數(shù)后面有沒(méi)有值它管不著。拿剛剛的例子來(lái)說(shuō):

這兩個(gè)請(qǐng)求是通過(guò)的:
localhost:8080/api/json//demo?uid
localhost:8080/api/json//demo?uid=

只有這種請(qǐng)求是不通過(guò)的:
localhost:8080/api/json//demo?
小結(jié)論

經(jīng)過(guò)上述三個(gè)接口的測(cè)試場(chǎng)景,我們至少可以明確3點(diǎn):

  1. @ApiImplicitParam的required參數(shù)不會(huì)對(duì)@RequestParam的required值造成侵入,它們倆不相關(guān)。

  2. @ApiImplicitParam的required參數(shù)會(huì)影響swagger doc的js邏輯判斷,為空校驗(yàn)是在js層面上完成的。

  3. @RequestParam的required參數(shù)默認(rèn)情況下只會(huì)校驗(yàn)是否有該參數(shù)名,不校驗(yàn)它是否有值。

源碼剖析

swagger部分

上一節(jié)當(dāng)中提及swagger讀取@ApiImplicitParam注解的required參數(shù),最終會(huì)體現(xiàn)在js上,通過(guò)瀏覽器F12的追蹤,定位到swaggerbootstrapui.js文件上,這里摘抄部分源碼:

# 點(diǎn)擊發(fā)送按鈕時(shí),逐行讀取參數(shù)信息,并提取required參數(shù)
paramBody.find("tr").each(function () {
   var paramtr=$(this);
   var cked=paramtr.find("td:first").find(":checked").prop("checked");
   var _urlAppendflag=true;
   //that.log(cked)
   if (cked){
       //如果選中,留意此行的required:paramtr.data("required")信息提取
       var trdata={name:paramtr.find("td:eq(2)").find("input").val(),in:paramtr.data("in"),required:paramtr.data("required"),type:paramtr.data("type"),emflag:paramtr.data("emflag"),schemavalue:paramtr.data("schemavalue")};
       //that.log("trdata....")
       //that.log(trdata);
       //獲取key
       //var key=paramtr.find("td:eq(1)").find("input").val();
       var key=trdata["name"];
       //獲取value
       var value="";
       var reqflag=false;
       // 后面代碼省略
   }
})

js上判斷該屬性required是否為true的處理,js源碼如下:

//判斷是否required
if (trdata.hasOwnProperty("required")){
   var required=trdata["required"];
   if (required){
       if(!reqflag){
           //必須,驗(yàn)證value是否為空
           if(value==null||value==""){
               validateflag=true;
               var des=trdata["name"]
               //validateobj={message:des+"不能為空"};
               validateobj={message:des+i18n.message.debug.fieldNotEmpty};
               return false;
           }
       }
   }

}
SpringCloud業(yè)務(wù)模塊部分

swagger前端js驗(yàn)證通過(guò)可以向后臺(tái)發(fā)送請(qǐng)求,或者使用postman向后臺(tái)系統(tǒng)發(fā)送請(qǐng)求時(shí),開(kāi)始進(jìn)入后臺(tái)的一系列過(guò)濾器、Servlet處理,東西還不少:

// 實(shí)際的業(yè)務(wù)方法部分
auth:28, DemoController (com.hy.demo.controller)
invoke0:-1, NativeMethodAccessorImpl (sun.reflect)
invoke:62, NativeMethodAccessorImpl (sun.reflect)
invoke:43, DelegatingMethodAccessorImpl (sun.reflect)
invoke:498, Method (java.lang.reflect)

// 請(qǐng)求參數(shù)的提取、控制部分
doInvoke:190, InvocableHandlerMethod (org.springframework.web.method.support)
invokeForRequest:138, InvocableHandlerMethod (org.springframework.web.method.support)
invokeAndHandle:104, ServletInvocableHandlerMethod (org.springframework.web.servlet.mvc.method.annotation)
invokeHandlerMethod:892, RequestMappingHandlerAdapter (org.springframework.web.servlet.mvc.method.annotation)
handleInternal:797, RequestMappingHandlerAdapter (org.springframework.web.servlet.mvc.method.annotation)
handle:87, AbstractHandlerMethodAdapter (org.springframework.web.servlet.mvc.method)

// 下面是各種基礎(chǔ)Web服務(wù)組件的過(guò)濾器等,暫時(shí)不關(guān)心
doDispatch:1039, DispatcherServlet (org.springframework.web.servlet)
doService:942, DispatcherServlet (org.springframework.web.servlet)
processRequest:1005, FrameworkServlet (org.springframework.web.servlet)
doGet:897, FrameworkServlet (org.springframework.web.servlet)
service:634, HttpServlet (javax.servlet.http)
service:882, FrameworkServlet (org.springframework.web.servlet)
service:741, HttpServlet (javax.servlet.http)
internalDoFilter:231, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilter:53, WsFilter (org.apache.tomcat.websocket.server)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilter:84, SecurityBasicAuthFilter (com.github.xiaoymin.swaggerbootstrapui.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilter:53, ProductionSecurityFilter (com.github.xiaoymin.swaggerbootstrapui.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilter:124, WebStatFilter (com.alibaba.druid.support.http)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilterInternal:88, HttpTraceFilter (org.springframework.boot.actuate.web.trace.servlet)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilterInternal:99, RequestContextFilter (org.springframework.web.filter)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilterInternal:92, FormContentFilter (org.springframework.web.filter)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilterInternal:93, HiddenHttpMethodFilter (org.springframework.web.filter)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
filterAndRecordMetrics:114, WebMvcMetricsFilter (org.springframework.boot.actuate.metrics.web.servlet)
doFilterInternal:104, WebMvcMetricsFilter (org.springframework.boot.actuate.metrics.web.servlet)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
doFilterInternal:200, CharacterEncodingFilter (org.springframework.web.filter)
doFilter:109, OncePerRequestFilter (org.springframework.web.filter)
internalDoFilter:193, ApplicationFilterChain (org.apache.catalina.core)
doFilter:166, ApplicationFilterChain (org.apache.catalina.core)
invoke:202, StandardWrapperValve (org.apache.catalina.core)
invoke:96, StandardContextValve (org.apache.catalina.core)
invoke:490, AuthenticatorBase (org.apache.catalina.authenticator)
invoke:139, StandardHostValve (org.apache.catalina.core)
invoke:92, ErrorReportValve (org.apache.catalina.valves)
invoke:74, StandardEngineValve (org.apache.catalina.core)
service:343, CoyoteAdapter (org.apache.catalina.connector)
service:408, Http11Processor (org.apache.coyote.http11)
process:66, AbstractProcessorLight (org.apache.coyote)
process:853, AbstractProtocol$ConnectionHandler (org.apache.coyote)
doRun:1587, NioEndpoint$SocketProcessor (org.apache.tomcat.util.net)
run:49, SocketProcessorBase (org.apache.tomcat.util.net)
runWorker:1149, ThreadPoolExecutor (java.util.concurrent)
run:624, ThreadPoolExecutor$Worker (java.util.concurrent)
run:61, TaskThread$WrappingRunnable (org.apache.tomcat.util.threads)
run:748, Thread (java.lang)

聚集重點(diǎn)在請(qǐng)求參數(shù)的讀取校驗(yàn)方面,首先看org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver類的resolveArgument方法:

@Override
@Nullable
public final Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {

   // 留意此方法調(diào)用
NamedValueInfo namedValueInfo = getNamedValueInfo(parameter);
MethodParameter nestedParameter = parameter.nestedIfOptional();

Object resolvedName = resolveStringValue(namedValueInfo.name);
if (resolvedName == null) {
throw new IllegalArgumentException(
"Specified name must not resolve to null: [" + namedValueInfo.name + "]");
}
// 后面暫時(shí)省略
}

getNamedValueInfo方法的實(shí)現(xiàn)如下:

/**
* Obtain the named value for the given method parameter.
*/
private NamedValueInfo getNamedValueInfo(MethodParameter parameter) {
NamedValueInfo namedValueInfo = this.namedValueInfoCache.get(parameter);
if (namedValueInfo == null) {
namedValueInfo = createNamedValueInfo(parameter);
namedValueInfo = updateNamedValueInfo(parameter, namedValueInfo);
this.namedValueInfoCache.put(parameter, namedValueInfo);
}
return namedValueInfo;
}

進(jìn)入createNamedValueInfo(parameter)方法時(shí),這部分代碼如下:

@Override
protected NamedValueInfo createNamedValueInfo(MethodParameter parameter) {
RequestParam ann = parameter.getParameterAnnotation(RequestParam.class);
return (ann != null ? new RequestParamNamedValueInfo(ann) : new RequestParamNamedValueInfo());
}

/**
* NamedValueInfo的定義
* Represents the information about a named value, including name, whether it's required and a default value.
*/
protected static class NamedValueInfo {

private final String name;

private final boolean required;

@Nullable
private final String defaultValue;

public NamedValueInfo(String name, boolean required, @Nullable String defaultValue) {
this.name = name;
this.required = required;
this.defaultValue = defaultValue;
}
}

這段代碼很關(guān)鍵,這里只讀取@RequestParam注解,不會(huì)讀@ApiImplicitParam注解,所以@ApiImplicitParam注解不會(huì)影響@RequestParam的屬性,并且無(wú)論是從swagger doc過(guò)來(lái)的請(qǐng)求,還是postman過(guò)來(lái)的請(qǐng)求,都執(zhí)行這一段代碼,最終讀取注解的結(jié)果用CurrenctHashMap存儲(chǔ),key的格式是method 'xxx' parameter y,xxx為方法名,y為參數(shù)的順序號(hào),如method 'auth' parameter 0,基本上可以保證唯一性。

階段性總結(jié)

源碼閱讀到這里,基本上可以驗(yàn)證前面提及的小結(jié)論的前2條,引用一下:

  1. @ApiImplicitParam的required參數(shù)不會(huì)對(duì)@RequestParam的required值造成侵入,它們倆不相關(guān)。

  2. @ApiImplicitParam的required參數(shù)會(huì)影響swagger doc的js邏輯判斷,為空校驗(yàn)是在js層面上完成的。

  3. @RequestParam的required參數(shù)默認(rèn)情況下只會(huì)校驗(yàn)是否有該參數(shù)名,不校驗(yàn)它是否有值。

前面2個(gè)問(wèn)題已經(jīng)從源碼中找到解釋,來(lái)看第3個(gè)問(wèn)題:如果參數(shù)設(shè)置required=true,但只是要求參數(shù)名存在,如果此字段是Long類型或Integer類型,寫成uid=或’uid’,也能通過(guò)校驗(yàn),最終進(jìn)入方法后,還是得手動(dòng)寫代碼進(jìn)行為空校驗(yàn),這顯然不是我們想要的結(jié)果?該如何解決呢?

請(qǐng)求參數(shù)data bind的問(wèn)題

接上一節(jié),如果這樣通用的參數(shù),得挨個(gè)判斷是否為空,這樣的做法就有點(diǎn)難受了,有沒(méi)有更好的解決辦法呢?預(yù)期的實(shí)現(xiàn)效果是字段加上require=true后,Long類型或其他數(shù)值類型可以把"",null過(guò)濾掉,要不然require還有什么意義呢?

解決方法有兩個(gè)思路:

  1. POST請(qǐng)求方法中將多個(gè)參數(shù)封裝到一個(gè)POJO類里,用@RequestBody聲明,POJO類中可以使用@Validator框架的@NotNull等注解,并在參數(shù)前聲明@Valid。

  2. 自定義參數(shù)綁定規(guī)則擴(kuò)展。

方案2更通用一些,適用GET、POST請(qǐng)求,并且原有的單個(gè)參數(shù)聲明無(wú)需封裝到POJO類里。

官網(wǎng)本身提供自定義參數(shù)綁定的擴(kuò)展,見(jiàn)https://docs.spring.io/spring/docs/5.1.8.RELEASE/spring-framework-reference/web.html#mvc-ann-initbinder

官網(wǎng)的例子是在指定的Controller類中使用@InitBinder注解,影響范圍僅限該Controller類,示例如下:

@InitBinder
public void initBinder(WebDataBinder binder) {
/*
* 注冊(cè)對(duì)于String類型參數(shù)對(duì)象的屬性進(jìn)行trim操作的編輯器,
* 構(gòu)造參數(shù)代表空串是否轉(zhuǎn)為null,false,則將null轉(zhuǎn)為空串。
*/
binder.registerCustomEditor(String.class, new StringTrimmerEditor(false));
// 這里我還添加了其他類型的屬性編輯器,true表示允許使用"",并且將""處理為空,false表示不允許使用""
binder.registerCustomEditor(Short.class, new CustomNumberEditor(Short.class, false));
binder.registerCustomEditor(Integer.class, new CustomNumberEditor(Integer.class, false));
binder.registerCustomEditor(Long.class, new CustomNumberEditor(Long.class, false));
binder.registerCustomEditor(Float.class, new CustomNumberEditor(Float.class, false));
binder.registerCustomEditor(Double.class, new CustomNumberEditor(Double.class, false));
binder.registerCustomEditor(BigDecimal.class, new CustomNumberEditor(BigDecimal.class, false));
binder.registerCustomEditor(BigInteger.class, new CustomNumberEditor(BigInteger.class, false));
}

由于此次面臨的問(wèn)題是全模塊@RequestParam的值的問(wèn)題,需要做一個(gè)全局的配置,此時(shí)需要新增一個(gè)類,并使用@ControllerAdvice注解,代碼如下:

@ControllerAdvice
public class CustomWebBindingInitializer implements WebBindingInitializer {

@InitBinder
@Override
public void initBinder(WebDataBinder binder) {
/*
* 注冊(cè)對(duì)于String類型參數(shù)對(duì)象的屬性進(jìn)行trim操作的編輯器,
* 構(gòu)造參數(shù)代表空串是否轉(zhuǎn)為null,false,則將null轉(zhuǎn)為空串。
*/
binder.registerCustomEditor(String.class, new StringTrimmerEditor(false));
// 這里我還添加了其他類型的屬性編輯器,true表示允許使用"",并且將""處理為空,false表示不允許使用""
binder.registerCustomEditor(Short.class, new CustomNumberEditor(Short.class, false));
binder.registerCustomEditor(Integer.class, new CustomNumberEditor(Integer.class, false));
binder.registerCustomEditor(Long.class, new CustomNumberEditor(Long.class, false));
binder.registerCustomEditor(Float.class, new CustomNumberEditor(Float.class, false));
binder.registerCustomEditor(Double.class, new CustomNumberEditor(Double.class, false));
binder.registerCustomEditor(BigDecimal.class, new CustomNumberEditor(BigDecimal.class, false));
binder.registerCustomEditor(BigInteger.class, new CustomNumberEditor(BigInteger.class, false));
}

}

注意一下CustomNumberEditor實(shí)例初始化的傳的false參數(shù)。

重啟應(yīng)用,看一下效果:

@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決

擴(kuò)展DataBinder后相關(guān)源碼閱讀

都已經(jīng)到這兒了,再加把勁把相關(guān)的源碼看一下,還是在org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver類的resolveArgument方法的后半段:

@Override
@Nullable
public final Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {
   // 前面省略
if (binderFactory != null) {
WebDataBinder binder = binderFactory.createBinder(webRequest, null, namedValueInfo.name);
try {
   // 在這里對(duì)參數(shù)進(jìn)行轉(zhuǎn)換
arg = binder.convertIfNecessary(arg, parameter.getParameterType(), parameter);
}
catch (ConversionNotSupportedException ex) {
throw new MethodArgumentConversionNotSupportedException(arg, ex.getRequiredType(),
namedValueInfo.name, parameter, ex.getCause());
}
catch (TypeMismatchException ex) {
throw new MethodArgumentTypeMismatchException(arg, ex.getRequiredType(),
namedValueInfo.name, parameter, ex.getCause());

}
}

handleResolvedValue(arg, namedValueInfo.name, parameter, mavContainer, webRequest);

return arg;
}

從binder.convertIfNecessary方法一路跟下去,中間省略一些調(diào)用,最終到達(dá)org.springframework.beans.propertyeditors.CustomNumberEditor類的setAsText方法:

/**
* Parse the Number from the given text, using the specified NumberFormat.
*/
@Override
public void setAsText(String text) throws IllegalArgumentException {
if (this.allowEmpty && !StringUtils.hasText(text)) {
// Treat empty String as null value.
setValue(null);
}
else if (this.numberFormat != null) {
// Use given NumberFormat for parsing text.
setValue(NumberUtils.parseNumber(text, this.numberClass, this.numberFormat));
}
else {
// Use default valueOf methods for parsing text.
setValue(NumberUtils.parseNumber(text, this.numberClass));
}
}

仔細(xì)看allowEmpty變量,針對(duì)Long類型的參數(shù),我們擴(kuò)展數(shù)據(jù)綁定時(shí),該變量設(shè)置的是false,表示不接受空值,試驗(yàn)中我們傳的值是空串,那么這里的條件分支判斷就必須對(duì)空串轉(zhuǎn)換成數(shù)值,執(zhí)行Long.valueOf("")結(jié)果報(bào)出運(yùn)行時(shí)異常java.lang.NumberFormatException,告知客戶端參數(shù)不對(duì),這是期望的結(jié)果。

到此,相信大家對(duì)“@ApiImplicitParam對(duì)@RequestParam的required屬性侵入怎么解決”有了更深的了解,不妨來(lái)實(shí)際操作一番吧!這里是億速云網(wǎng)站,更多相關(guān)內(nèi)容可以進(jìn)入相關(guān)頻道進(jìn)行查詢,關(guān)注我們,繼續(xù)學(xué)習(xí)!

向AI問(wèn)一下細(xì)節(jié)

免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI