ApiModel 遇到的問題

2021-10-10 05:11:07 字數 770 閱讀 2191

以前使用swagger2時, 在出入參實體上新增註解@apimodel時習慣性的新增value = "***"屬性, 舊版本中一直沒有發現有什麼問題.

最近在使用swagger2:2.9.2版本時, 遇到乙個問題,swagger文件中的 入參 結構示例中的入參引數跟**的入參物件中的字段不匹配不一致, 導致介面聯調問題多

經過排查發現是因為@apimodel直接使用不規範導致的.

經過排查發現,swagger2是需要value屬性在同乙個服務全域性中保持唯一的,swagger會把所有的api中的出入參實體列在swagger文件的最下方, 如果存在多個實體的@apimodel(value = "使用者資訊")註解相同, 那麼swagger只會識別乙個, 其他的 實體 會被覆蓋, 不會被顯示, 其他被覆蓋的 實體在api被引用的地方在文件中會被識別的相同名稱的實體 替代, 導致文件展示錯亂問題

使用正確的用法:

@apimodel(description = "使用者資訊"), 如果我們能在**規範中保證實體名稱不會重複,value使用預設就好, 所以不再配置, 實體說明使用description來進行配置.

遇到的問題

1 若class cnmdevctrlprotocol virtual public cnetcomm則starttimer編譯通不過 2 activex在ie下載入多個,相當於多執行緒,所以這時候的activex不要使用全域性變數,當時如果編寫動態庫也不要使用全域性變數 3 btn灰顯或sleep...

遇到的問題

這個文章用於記錄在學習和使用c 的時候遇到的一些問題,以及解決方法,記載了一些非常零散的知識點,沒有主題。在c 11中,有一種新的方法在用new運算子申請結構體內存的同時對其初始化。其格式為 struct car car p new car 但是如果結構體中包含了字元陣列 字串 就不能使用這種格式,...

遇到的問題

今天學習遇到了不少的問題,所以學習的進度有點慢。1 jcreator 2 tomcat 的問題。我將 tomcat 裝好了,我就記得在安裝時就提示我設定使用者名稱和密碼了。可是我在訪問 是總是進不去。點選tomcat mananger 時,彈出這個對話方塊。當我輸入使用者名稱和密碼後,還是跳出這個,...