摘要:效率專精系列善用統(tǒng)一描述語言提升開發(fā)效率分鐘搞定環(huán)境配置與使用考慮到篇幅較長的文檔反復(fù)修改的情況,要快速找到修改點(diǎn)比較困難。
之前零零散散寫了幾篇文章,主要是實(shí)際開發(fā)過程中一些效率痛點(diǎn)和相應(yīng)的改善方法。今天抽空溫故知新,把之前的內(nèi)容串起來,做了個(gè)小總結(jié),即《效率專精系列》小系列的總集篇。
回顧項(xiàng)目開發(fā)流程開發(fā)一個(gè)新項(xiàng)目時(shí),開發(fā)流程大概分成以下幾步:
設(shè)計(jì)方案,并落地成設(shè)計(jì)文檔
設(shè)計(jì)方案評審
任務(wù)分拆
和上下游規(guī)定接口(服務(wù)、前后端等)
代碼開發(fā)
開發(fā)自測
上下游聯(lián)調(diào)(服務(wù)、前后端等)
提交QA測試
效率可改進(jìn)的點(diǎn) S1. 設(shè)計(jì)方案,并落地成設(shè)計(jì)文檔公司內(nèi)部使用Wiki(XConfluence)管理所有文檔,由于互聯(lián)網(wǎng)產(chǎn)品的大部分開發(fā)模式都偏向于面向數(shù)據(jù)庫編程,設(shè)計(jì)文檔里ER圖是展現(xiàn)設(shè)計(jì)的重要工具。但是繪制ER圖是個(gè)挺費(fèi)勁的活,不是說自帶的draw.io組件不好用,而是說ER圖和代碼(Sql語句或Java代碼)不能互相轉(zhuǎn)化,兩者的內(nèi)容格式高度重合,卻只能人工轉(zhuǎn)化。
目前我的方式是先在Intellij Idea中寫好持久化對象(PO),用POJO to Text插件把POJO轉(zhuǎn)化為文本并復(fù)制到系統(tǒng)剪切板中,然后復(fù)制到ER圖里,節(jié)省了重復(fù)錄入類名和字段名的時(shí)間。
舉個(gè)栗子,PO類的自定義文本形式為“PO id updateTime”。
Class PO { private int id; private Date updateTime; //getter/setter }S4. 和上下游規(guī)定接口(服務(wù)、前后端等)/ S6. 開發(fā)自測
上下游服務(wù)之間有很完善的并行開發(fā)方案,即基于接口的開發(fā),通過帶有版本號的jar包來解耦雙方具體實(shí)現(xiàn)的開發(fā)。但如果是前后端之間規(guī)定接口,一般需要先寫接口文檔,再寫代碼,與上面類似,其中很多內(nèi)容需要人工重復(fù)錄入,比如說URI、Param、Header、Body體等。
利用API統(tǒng)一描述語言OpenAPI和相應(yīng)的工具Swagger2可在文檔和代碼之間搭起一座橋梁。另外該工具也可節(jié)約自測中的部分錄入工作,如錄入U(xiǎn)RL和Param。
【效率專精系列】善用API統(tǒng)一描述語言提升RestAPI開發(fā)效率
5分鐘搞定Swagger2環(huán)境配置與使用
考慮到篇幅較長的文檔反復(fù)修改的情況,要快速找到API修改點(diǎn)比較困難。
目前我的方式是利用版本管理和文本比較功能:比方說把API文檔和代碼一起放在git倉庫,或者使用其他帶版本管理的文檔庫;使用git倉庫自帶的文本比較功能,或者在線的代碼比較網(wǎng)站。
文本比較網(wǎng)站 | 去除前導(dǎo)空格 | 分享給他人 | 其他 |
---|---|---|---|
www.diffnow.com | 可以 | 可以 | 界面風(fēng)格原始 |
www.diffchecker.com | 不可以 | 可以 | |
www.newjson.com/Static/Tools/Diff.html | 可以 | 不可以 |
互聯(lián)網(wǎng)公司常見的ORM組件不再是重型的Hibernate,而是輕量級的Mybatis(其實(shí)都不算ORM了,最多是Sql模板)。Mybatis中我認(rèn)為最繁瑣的工作就是寫業(yè)務(wù)Sql了,基本上是getXXXByYYYZZZ這種形式,要么再加上分頁,類型特征十分明顯。
目前我的方式是利用Intellij Idea的Mybatis插件,把Mybatis Mapper類中的Java接口轉(zhuǎn)化成對應(yīng)的Sql語句。在不考慮優(yōu)化的情況下,這種類型的Sql如果能自動生成就能節(jié)約不少人力,畢竟Sql語句比Java接口聲明長多了。
【效率專精系列】善用插件提升MyBatis開發(fā)效率S7. 上下游聯(lián)調(diào)(服務(wù)、前后端等)
通常上下游都把自己的分支部署到beta環(huán)境來進(jìn)行聯(lián)調(diào),存在分支沖突的風(fēng)險(xiǎn);而且如果代碼質(zhì)量不高的話聯(lián)調(diào)過程中需要反復(fù)更新代碼,由于beta環(huán)境不支持熱部署,更新代碼的時(shí)間成本很高。
目前我的方式是不管是Rpc服務(wù)還是URL,把聯(lián)調(diào)放在雙方的本地機(jī)器上進(jìn)行,這樣熱更新、熱部署都沒問題了。
【效率專精系列】Beta環(huán)境不需要,本地聯(lián)調(diào)拯救開發(fā)效率小詩云
【效率專精系列】幾種常見的JVM熱部署技術(shù)及實(shí)現(xiàn)難點(diǎn)淺談
身在互聯(lián)網(wǎng),加班易,不加班難,且行且珍惜。
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://m.hztianpu.com/yun/70511.html
摘要:目前團(tuán)隊(duì)中前后端聯(lián)調(diào)是較之個(gè)人單獨(dú)開發(fā)相對耗時(shí)的一個(gè)環(huán)節(jié),主要體現(xiàn)在環(huán)境下的部署時(shí)間較長。本文的目的是通過將聯(lián)調(diào)本地化,減少部分枯燥勞動以及無效的等待時(shí)間,提高團(tuán)隊(duì)的開發(fā)效率。不需要更改的為外部,保持即可。 目前團(tuán)隊(duì)中前后端聯(lián)調(diào)是較之個(gè)人單獨(dú)開發(fā)相對耗時(shí)的一個(gè)環(huán)節(jié),主要體現(xiàn)在: beta環(huán)境下的部署時(shí)間較長。首先部署beta需要經(jīng)過push分支、合并沖突、build、部署四個(gè)步驟。...
摘要:其標(biāo)準(zhǔn)為前身是,提供強(qiáng)大的在線編輯功能,包括語法高亮錯(cuò)誤提示自動完成實(shí)時(shí)預(yù)覽,并且支持用戶以格式撰寫導(dǎo)入導(dǎo)出轉(zhuǎn)換文檔。 團(tuán)隊(duì)內(nèi)部RestAPI開發(fā)采用設(shè)計(jì)驅(qū)動開發(fā)的模式,即使用API設(shè)計(jì)文檔解耦前端和后端的開發(fā)過程,雙方只在聯(lián)調(diào)與測試時(shí)耦合。在實(shí)際開發(fā)和與前端合作的過程中,受限于眾多因素的影響,開發(fā)效率還有進(jìn)一步提高的空間。本文的目的是優(yōu)化工具鏈支持,減少一部分重復(fù)和枯燥的勞動。 現(xiàn)狀...
摘要:通過插件更優(yōu)雅地生成和的樣板代碼通過插件不污染地實(shí)現(xiàn)優(yōu)雅分頁。使用步驟引入依賴,在或的配置中進(jìn)行配置。提供語法提示自動補(bǔ)全錯(cuò)誤提示導(dǎo)航功能。該插件提供了類似的功能,根據(jù)接口的方法名推斷含義,然后在中直接生成對應(yīng)的。 團(tuán)隊(duì)使用Mybatis作為數(shù)據(jù)庫訪問框架。不同于Hibernate這種采用經(jīng)典面向?qū)ο笏枷朐O(shè)計(jì)的ORM框架,Mybatis是面向過程的,它只做了過程到SQL語句的映射。兩者...
摘要:人生中的每一件事都取決于我們自己的時(shí)間,你身邊有些朋友也許遙遙領(lǐng)先于你,有些朋友也許落后于你,但凡事都有它自己的節(jié)奏因此,無論當(dāng)下如何,保持一顆平靜的心,從容對待。愿你始終相信,一切都會準(zhǔn)時(shí)到來的。不言而喻的是信心對完成任務(wù)的作用很大。 《別讓任何人打亂你的生活節(jié)奏》完美人生 就是 18歲成人 22歲大學(xué)畢業(yè),25歲工作穩(wěn)定,30歲之前買房結(jié)婚生子,35歲之后人生軌跡就會定型…… 可是...
閱讀 2334·2019-08-30 15:56
閱讀 3163·2019-08-30 13:48
閱讀 1185·2019-08-30 10:52
閱讀 1552·2019-08-29 17:30
閱讀 477·2019-08-29 13:44
閱讀 3711·2019-08-29 12:53
閱讀 1181·2019-08-29 11:05
閱讀 2723·2019-08-26 13:24