前沿拓展:
isnull
Oracle 沒有 ISN-IsNull(視了魚底氫)
因前后端人員通過接口定義字段,返回值等對接時非??鄲?,沒有一個很好的平臺維護(hù),后端每次迭代都要寫開發(fā)文檔,需求變化,多系統(tǒng)聯(lián)調(diào)等,給前后端聯(lián)調(diào)造成阻塞。
1、后端開發(fā)文檔編寫規(guī)范
1)文檔模板統(tǒng)一使用:xxx系統(tǒng)開發(fā)文檔-模板.docx2)后端每次迭代需要編寫開發(fā)文檔,并進(jìn)行技術(shù)評審(前端、后端、測試、產(chǎn)品參與)3)文檔的命名方式:《產(chǎn)品名稱-V版本號-設(shè)計開發(fā)文檔-編寫人》4) 文檔統(tǒng)一保存5)后端必須在編寫業(yè)務(wù)代碼前,優(yōu)先設(shè)計API(Swagger),并提供給測試和前端,最大化并行迭代。6)允許特殊情況延期提供API,如:需求變化、多系統(tǒng)聯(lián)調(diào)等。
Swagger使用規(guī)范
1)后端開發(fā)人員必須使用Swagger2)API接口定義參數(shù)時,要明確備注信息和是否必須,樣例如下:public class SupplierReq {@NotEmpty(message = “姓名必填”)@ApiModelProperty(value = “員工姓名”, required = true)private String name;
@Size(min = 6, max = 64, message = “手機(jī)號或工號不能為空,長度介于6~64之間”)@ApiModelProperty(value = “手機(jī)號”, required = true)private String telephone;}3)API定義業(yè)務(wù)方法時(Controller層),使用Swagger注解@ApiOperation明確業(yè)務(wù)方法信息,樣例如下:@PostMapping(“/updateCatRateLimit”)@ApiOperation(“設(shè)置**項流控QPS”)public CommonResponse updateCatRateLimit(@RequestBody Req req) {return super.visit(() -> mcenterRateLimitService.updateCatRateLimit(req));}具體swagger詳細(xì)接口請參考:https://swagger.io/docs/
后端接口輸出太慢?
當(dāng)接到新需求,進(jìn)行產(chǎn)品需求評審–>技術(shù)文檔編寫–>數(shù)據(jù)庫設(shè)計–>業(yè)務(wù)梳理–>測試用例評審等等流程下來,很難在短時間內(nèi)給出接口,但即便如此,我也沒聽說過誰會因?yàn)楹蠖私o不出接口耽誤前端開發(fā)進(jìn)度為了更快速的輸出接口等響應(yīng),推薦api管理工具APIpost,swagger,Yapi等~
Swagger遇見Yapi一 YapiUpload
1、在IDEA->Preferences->Plugins中 輸入YapiUpload插件,點(diǎn)擊Install,重啟IDEA后可以使用。
2、配置項目在我們已經(jīng)從git同步的項目,打開.idea文件夾下的misc.xml,添加如下配置。
1
2
3
4
5
6
<component name="yapi">
<option name="projectToken">yapi中獲取項目token</option>
<option name="projectId">項目ID</option>
<option name="yapiUrl">http://mock.xx.com</option>
<option name="projectType">api</option>
</component>
完整配置如下所示:
獲取配置信息:
3、接口上傳這一步是我們?nèi)粘9ぷ鹘?jīng)常使用的**作,在我們編寫好的接口類文件中,我們只需選中類名或者選中要上傳接口的方法名右鍵選擇“UploadToYapi”,兩者的區(qū)別是,選擇類名會上傳此類中的全部接口,選擇方法名僅上**個接口,按需選擇即可。參數(shù)非空需要加入 @NotNull或@NotEmpty。如果需要將接口傳入指定目錄下,需要在類上添加注釋
批量上傳
將本地或者服務(wù)器環(huán)境生成的swagger.doc/swagger.json地址**
即可批量上傳至Yapi~
拓展知識:
isnull
假如你的aa數(shù)據(jù)庫中有個bb字段默認(rèn)為null,剛好有條數(shù)據(jù)忘寫字bb段,現(xiàn)在要查詢這條數(shù)據(jù)。sql語句:select
*
from
aa
where
bb=null;這樣寫查不到想要的結(jié)果select
*
from
aa
where
isnull(bb);這條是正確的
原創(chuàng)文章,作者:九賢生活小編,如若轉(zhuǎn)載,請注明出處:http://xiesong.cn/20251.html