源碼剖析@ApiImplicitParam對@RequestParam的required屬性的侵入性

来源:https://www.cnblogs.com/huangying2124/archive/2020/07/09/13270358.html
-Advertisement-
Play Games

問題起源 使用SpringCloud構建項目時，使用Swagger生成相應的介面文檔是推薦的選項，Swagger能夠提供頁面訪問，直接在網頁上調試後端系統的介面， 非常方便。最近卻遇到了一個有點困惑的問題，演示介面示例如下（原有功能介面帶有業務實現邏輯，這裡簡化了介面）： /** * @descri ...


問題起源

使用SpringCloud構建項目時，使用Swagger生成相應的介面文檔是推薦的選項，Swagger能夠提供頁面訪問，直接在網頁上調試後端系統的介面， 非常方便。最近卻遇到了一個有點困惑的問題，演示介面示例如下（原有功能介面帶有業務實現邏輯，這裡簡化了介面）：

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

	@ApiOperation(value = "測試介面")
	@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;
	}
}

問題出在介面參數uid的必填性上，@RequestParam註解里require預設為true，要求必填，但@ApiImplicitParam註解里require預設為false，要求非必填，該業務介面在進行功能聯調時，uid居然能得到一個null值，按照一般認知習慣@ApiImplicitParam註解的主要作用是生成介面文檔，不應該對@RequestParam的屬性有侵入性才對，目前反饋的bug，讓我懷疑@ApiImplicitParam是不是會侵入@RequestParam的require屬性？

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

項目搭建

SpringBoot版本：2.1.6.RELEASE
SpringCloud版本：Greenwich.SR3

業務模塊

SpringCloud業務模塊使用的swagger:

swagger bootstrap ui 1.9.6 增強swagger ui樣式
spring4all-swagger 1.9.0.RELEASE 配置化swagger參數，免去代碼開發

業務網關

SpringCloud業務網關使用的swagger:

knife4j 2.0.1 增強swagger ui樣式（網關用gateway搭建，swagger使用knife4j-spring-boot-starter依賴，可以聚合業務模塊的swagger文檔）

此次的範圍只針對SpringCloud業務模塊，暫時不涉及業務網關的Swagger文檔。

測試工具

測試工具目前有兩個：
swagger doc：使用瀏覽器進行訪問，如下圖：

postman：手動配置介面參數，示例：

案例實戰

介面測試1

介面示例如開篇所示，我們先使用如下介面，全部使用預設值，即@ApiImplicitParam的required為false，@RequestParam的required為true：

@ApiOperation(value = "測試介面")
@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的結果：

看postman的結果：

介面測試2

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

看swagger的結果：

通過調試瀏覽器可以發現，為空校驗是js完成的，js判斷為空後，並未發起請求到後端，這樣我們可以認為swagger內@ApiImplicitParam的required參數生效了。

介面測試3

在前面我們使用postman測試介面時，發現參數項是空的，我們加上參數，但不寫值測試後，結果讓人詫異：

並且無論@ApiImplicitParam的required值如何修改，結果都是一樣的，肯定有一個地方是搞錯了，導致我們誤判。

後來仔細查閱資料，發現是我們對@RequestParam的required參數理解錯了，這個required為true的含義是：介面參數名一定要存在，但參數後面有沒有值它管不著。拿剛剛的例子來說：

這兩個請求是通過的：
localhost:8080/api/json//demo?uid
localhost:8080/api/json//demo?uid=

只有這種請求是不通過的：
localhost:8080/api/json//demo?

小結論

經過上述三個介面的測試場景，我們至少可以明確3點：

  1. @ApiImplicitParam的required參數不會對@RequestParam的required值造成侵入，它們倆不相關。
  2. @ApiImplicitParam的required參數會影響swagger doc的js邏輯判斷，為空校驗是在js層面上完成的。
  3. @RequestParam的required參數預設情況下只會校驗是否有該參數名，不校驗它是否有值。

源碼剖析

swagger部分

上一節當中提及swagger讀取@ApiImplicitParam註解的required參數，最終會體現在js上，通過瀏覽器F12的追蹤，定位到swaggerbootstrapui.js文件上，這裡摘抄部分源碼：

# 點擊發送按鈕時，逐行讀取參數信息，並提取required參數
 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){
            //必須,驗證value是否為空
            if(value==null||value==""){
                validateflag=true;
                var des=trdata["name"]
                //validateobj={message:des+"不能為空"};
                validateobj={message:des+i18n.message.debug.fieldNotEmpty};
                return false;
            }
        }
    }

}

SpringCloud業務模塊部分

swagger前端js驗證通過可以向後臺發送請求，或者使用postman向後臺系統發送請求時，開始進入後臺的一系列過濾器、Servlet處理，東西還不少：

// 實際的業務方法部分
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)

// 請求參數的提取、控制部分
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)

// 下麵是各種基礎Web服務組件的過濾器等，暫時不關心
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)

聚集重點在請求參數的讀取校驗方面，首先看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 {

    // 留意此方法調用
	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 + "]");
	}
	// 後面暫時省略
}

getNamedValueInfo方法的實現如下：

/**
 * 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;
}

進入createNamedValueInfo(parameter)方法時，這部分代碼如下：

@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;
	}
}

這段代碼很關鍵，這裡只讀取@RequestParam註解，不會讀@ApiImplicitParam註解，所以@ApiImplicitParam註解不會影響@RequestParam的屬性，並且無論是從swagger doc過來的請求，還是postman過來的請求，都執行這一段代碼，最終讀取註解的結果用CurrenctHashMap存儲，key的格式是method 'xxx' parameter y，xxx為方法名，y為參數的順序號，如method 'auth' parameter 0，基本上可以保證唯一性。

階段性總結

源碼閱讀到這裡，基本上可以驗證前面提及的小結論的前2條，引用一下：

  1. @ApiImplicitParam的required參數不會對@RequestParam的required值造成侵入，它們倆不相關。
  2. @ApiImplicitParam的required參數會影響swagger doc的js邏輯判斷，為空校驗是在js層面上完成的。
  3. @RequestParam的required參數預設情況下只會校驗是否有該參數名，不校驗它是否有值。

前面2個問題已經從源碼中找到解釋，來看第3個問題：如果參數設置required=true，但只是要求參數名存在，如果此欄位是Long類型或Integer類型，寫成uid=或'uid'，也能通過校驗，最終進入方法後，還是得手動寫代碼進行為空校驗，這顯然不是我們想要的結果？該如何解決呢？

請求參數data bind的問題

接上一節，如果這樣通用的參數，得挨個判斷是否為空，這樣的做法就有點難受了，有沒有更好的解決辦法呢？預期的實現效果是欄位加上require=true後，Long類型或其他數值類型可以把""，null過濾掉，要不然require還有什麼意義呢？

解決方法有兩個思路：

  1. POST請求方法中將多個參數封裝到一個POJO類里，用@RequestBody聲明，POJO類中可以使用@Validator框架的@NotNull等註解，併在參數前聲明@Valid。
  2. 自定義參數綁定規則擴展。

方案2更通用一些，適用GET、POST請求，並且原有的單個參數聲明無需封裝到POJO類里。

官網本身提供自定義參數綁定的擴展，見https://docs.spring.io/spring/docs/5.1.8.RELEASE/spring-framework-reference/web.html#mvc-ann-initbinder

官網的例子是在指定的Controller類中使用@InitBinder註解，影響範圍僅限該Controller類，示例如下：

@InitBinder
public void initBinder(WebDataBinder binder) {
	/*
	 * 註冊對於String類型參數對象的屬性進行trim操作的編輯器,
	 * 構造參數代表空串是否轉為null，false，則將null轉為空串。
	 */
	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));
}

由於此次面臨的問題是全模塊@RequestParam的值的問題，需要做一個全局的配置，此時需要新增一個類，並使用@ControllerAdvice註解，代碼如下：

@ControllerAdvice
public class CustomWebBindingInitializer implements WebBindingInitializer {

	@InitBinder
	@Override
	public void initBinder(WebDataBinder binder) {
		/*
		 * 註冊對於String類型參數對象的屬性進行trim操作的編輯器,
		 * 構造參數代表空串是否轉為null，false，則將null轉為空串。
		 */
		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實例初始化的傳的false參數。

重啟應用，看一下效果：

擴展DataBinder後相關源碼閱讀

都已經到這兒了，再加把勁把相關的源碼看一下，還是在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 {
		    // 在這裡對參數進行轉換
			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方法一路跟下去，中間省略一些調用，最終到達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));
	}
}

仔細看allowEmpty變數，針對Long類型的參數，我們擴展數據綁定時，該變數設置的是false，表示不接受空值，試驗中我們傳的值是空串，那麼這裡的條件分支判斷就必須對空串轉換成數值，執行Long.valueOf("")結果報出運行時異常java.lang.NumberFormatException，告知客戶端參數不對，這是期望的結果。

總結

本篇以實際的研發排錯過程為出發點，剛開始自己也以為@ApiImplicitParam對@RequestParam的required屬性的有侵入性，覺得詫異便深入源碼論證自己的想法，經閱讀源碼後發現事實並不是這樣，是剛開始我們對required的理解有誤。既然required的作用非常有限，那麼肯定能找到通用的解決方案避免手動寫代碼對所有參數進行為空判斷，這些解決一個問題後，發現新的問題，再繼續解決，最終得到的結果，分析若有不詳盡之處，請指正，謝謝。

專註Java高併發、分散式架構，更多技術乾貨分享與心得，請關註公眾號：Java架構社區
可以掃左邊二維碼添加好友，邀請你加入Java架構社區微信群共同探討技術
Java架構社區


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 我：CSS垂直居中還有什麼另類方法？求職者：不太瞭解了
    今天面試了一個前端實習生，我問了一個比較簡單的問題，就是css如何實現元素垂直居中的問題，但是要說出多種方案。其實他說的不錯，基本上說到了flex佈局，grid佈局等下麵提到的佈局。還不錯，但是這幾種都是已經經常用的，老生常談，但是我想聽到他說一種用的比較少的解決方案，瞭解一下他學習的深度和廣度。但 ...
  • 2019 Web前端的薪資是多少？月薪30000的前端都是什麼樣？
    許多同學是不是還在徘徊、猶豫、糾結的階段，想學怕學不好，甚至不知從何入手，下麵這篇文章幫助想轉行前端及想學好Web前端開發的同學們解決心中的困惑。 1HTML的學習 超文本標記語言(HyperTextMark-up Language簡稱HTML)是一個網頁的骨架，無論是靜態網頁還是動態網頁，最終返回 ...
  • 前端埋點
    前端埋點主要是為了服務運營人員採集用戶行為數據，進行後續的數據分析工作。 前端監控和埋點能做什麼 數據監控（用戶行為） pv，uv 記錄操作系統 用戶在每一個頁面的停留時間(離開頁面，進入頁面) 用戶進入的入口 用戶在相應頁面的觸發行為，點擊按鈕 性能監控 (js中的performance) 用戶的 ...
  • 自學Web前端開發需具備哪些技能?（企業要求）？
    綜合來講，Web前端培訓分為HTML5+CSS3、JS交互設計、移動端、伺服器、前端框架、小程式六大模塊，下麵就為大傢具體介紹每個階段學什麼。 第一階段前端核心基礎，讓學員掌握前端基礎知識包括HTML5與CSS的基礎知識和代碼的撰寫會學習PC端網站佈局以及jQuery框架。 第二階段HTML5 + ...
  • 2020 Web前端的薪資是多少？月薪30000的前端都是什麼樣？
    web前端現在是一個很熾手可熱的職業，現在前端工程師到底能賺多少錢？月薪3000和30000的工程師到底差在哪？前端的待遇為什麼這麼高? 今天我們來具體分析一下。 web前端的薪資是多少？ 我們先用三個數據瞭解一下。 web前端在北京地區的薪資： 北京前端開發工程師平均工資：¥ 18690/月，取自 ...
  • 蒲公英 · JELLY技術周刊 Vol.13 跟 VSCode 學習如何開發大型 IDE 項目
    開發一個 IDE 很難麽？這或許是件很難的事情，但當我們參考 VSCode 的技術構架來看，整個開發流程就會平滑順暢很多，從內核開發、代碼編輯器、視圖結構到插件系統，在這整個技術構架中我們可以看到很多一個 IDE 開發中需要註意的方方面面。如果你對 VSCode 深入研究過，相信可以從中頗受啟發，在 ...
  • 圖形處理：給 Canvas 文本填充線性漸變
    作者：凹凸曼 - Barrior 在 Canvas 中對文本填充水平或垂直的線性漸變可以輕易實現，而帶角度的漸變就複雜很多；就好像下麵這樣，假設文本矩形寬為 W, 高為 H, 左上角坐標為 X, Y。 猜想與答案 給出兩個答案： 正確答案是圖二，因為這樣得出來的坐標生成的漸變最緊接文本矩形邊界，它的 ...
  • Mybatis的sql映射
    Mybatis的sql映射 添加： boolean addUser(User user); <insert id="addUser" parameterType="User"> insert into Users(uname,upass) values(#{uname},#{upass}) </in ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類