java web和java有什么區別 后端開發完接口才給出接口文檔,合理嗎?你怎么看?
后端開發完接口才給出接口文檔,合理嗎?你怎么看?一個非常好的問題。我是一個web應用程序架構師,多年來一直致力于回答這個問題。歡迎跟我來了解更多。后端提供接口文檔為時已晚,這是合理和不合理的。根據具體
后端開發完接口才給出接口文檔,合理嗎?你怎么看?
一個非常好的問題。我是一個web應用程序架構師,多年來一直致力于回答這個問題。歡迎跟我來了解更多。
后端提供接口文檔為時已晚,這是合理和不合理的。根據具體情況,總有解決辦法。讓我談談我的觀點。
不合理:成熟的技術團隊重視功能設計,在編寫代碼之前有完整的技術文檔和功能定義。即使在TDD測試驅動的開發模式下,測試數據已經準備好了,那么接口邏輯就已經確定了接口文檔是否編寫好了,理清它們是很自然的。
-第一,主觀原因。原因是多方面的,比如趕進度,沒有時間,不懶得寫,甚至在開發前沒有仔細設計,在做的時候也有變化。真的沒有好辦法。
-客觀原因:需求在變化,功能在變化,接口也在變化。所以,如果你寫了一個文件,它的自然更新和維護?天哪?
有解決方案嗎?建議嘗試:[1]swagger接口文檔,將文檔集成到代碼中,集成維護文檔和修改代碼,在修改代碼邏輯的同時方便修改文檔描述。
2、郵遞員界面測試工具,導入導出JSON文件,高效的團隊合作。Postman支持各種請求方法和配置環境變量,對返回的結果進行測試和驗證,支持批量自動操作,可與自動構建系統集成。
怎么看待一些后端程序員不寫接口文檔,老是以很忙為借口搪塞?
不寫接口文檔,一般很忙。或者沒有時間整理文件。
對于前端和后端的對接,前端開發人員一般需要后端人員提供接口文檔,而現在招搖過市的文檔完全可以提供這個功能。在許多情況下,后端開發人員集成了一個swagger并自動生成相應的文檔。
您可以給后端開發人員一定的時間來學習swagger或將swagger集成到項目中。
Service層和Dao層真的有必要每個類都加上接口嗎?
這主要取決于您的項目:
例如,如果項目中使用hibernate,以后可能會切換到mybatis,那么Dao需要使用該接口。這不會影響上層代碼的更改。
另一個例子是,項目是一個單一的應用程序。任何代碼修改都需要重新編譯整個項目,因此不需要接口。如果項目是由模塊編譯和部署的,那么可以使用接口解耦。假設修改了Dao,只需要重新編譯和部署Dao模塊,而不影響上層模塊。
此外,如果項目團隊中有許多新手,簡單的代碼結構可能更合適。復雜項目結構的學習成本較高。
如果工程進度非常緊迫,我們可以用簡單粗暴的方式用經濟成本來說明原因。
使用接口的成本是不使用接口的成本(包括后續維護成本)。
如果項目變化很大,部署了模塊,項目不急,使用接口的成本比不使用接口的成本低,雖然早期不使用接口似乎更簡單;相反,不使用接口的成本低,而且連框架都不能用~
畢竟工具是提高效率的,那你為什么不能和自己相處呢!