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