我為什么要寫這篇

近來，和不少初學Spring或Spring Boot的小伙伴私信交流了關于項目目錄結構劃分和代碼分層的問題。

很多小伙伴表示網上下載下來的開源項目看不懂，項目結構和代碼分層看得很蒙，不知道應該以一個什么樣的思路去學習和吸收別人的項目。

好，今天熬夜肝了這篇文章，和大家一起來交流探討一下，不足之處也請小伙伴們批評指正。

先看看阿里是怎么約定的

我印象中，以前在看《阿里巴巴Java開發手冊》時，好像有關于工程結構和應用分層相關的內容，于是我回翻了一下，果然有：

它這里面講的內容大概就是：關于一個正常的企業項目里一種通用的項目結構和代碼層級劃分的指導意見。

按這本書上說的，一般分為如下幾層：

• 開放接口層
• 終端顯示層
• Web 層
• Service 層
• Manager 層
• DAO 層
• 外部接口或第三方平臺

由于書中的篇幅關系，它這地方講得比較籠統了，估計初學者看了還是會懵，所以接下來結合實際項目代碼結構，來嘮一嘮具體的項目結構和代碼分層。

通常的項目結構

首先說在前面的是：這東西并沒有一套通用的標準，不同公司或者團隊的使用習慣和規范也不盡相同。

我們就以當下非常火熱的Spring Boot典型項目結構為例，創建出來的項目應該總體分為三大層：

• 項目根目錄/src/main/java：放置項目Java源代碼
• 項目根目錄/src/main/resources：放置項目靜態資源和配置文件
• 項目根目錄/src/test/java：放置項目測試用例代碼

而位于 /src/main/java目錄下的Java源代碼的組織結構大家比較關心，這地方也只能給出一個通常典型的結構，畢竟不同項目和團隊實踐不一樣，稍許有區別，但整體安排應該差不多。而且如果是多模塊的項目的話，下面的結構應該只對應其中一個模塊，其他模塊的代碼組織也大致差不多。

各個目錄詳細介紹：

然后接下來 /src/main/resources目錄，里面主要存放靜態配置文件和頁面靜態資源等東西：

當然，這地方估計有一個很多人都會糾結的關于 DTO/VO/DO等數據模型定義的區分。

這在《阿里巴巴Java開發手冊》中倒是做了一個所謂的嚴格區分，那本書上是這樣去定義的：

• DO(DataObject)：與數據庫表結構一一對應，通過DAO層向上傳輸數據源對象。
• DTO(DataTransferObject)：數據傳輸對象，Service或Manager向外傳輸的對象。
• BO(BusinessObject)：業務對象。由Service層輸出的封裝業務邏輯的對象。
• AO(ApplicationObject)：應用對象。在Web層與Service層之間抽象的復用對象模型，極為貼近展示層，復用度不高。
• VO(ViewObject)：顯示層對象，通常是Web向模板渲染引擎層傳輸的對象。
• Query：數據查詢對象，各層接收上層的查詢請求。注意超過2個參數的查詢封裝，禁止使用Map類來傳輸。

老實講，看到這么多對象的定義，我也是很蒙的。實際項目開發時，我覺得沒有必要刻意照搬去定義這么多層對象，這樣后續做對象轉換工作都能煩skr人。

出于簡單起見，我個人覺得，只要保證業務邏輯層 Service和數據庫 DAO層的操作對象嚴格劃分出來，確保互相不滲透，不混用，問題應該就不大。

比如在我上面舉例的這個項目的代碼結構中， Service層處理的對象都定義在了 dto包里，而 DAO層處理的對象都放在了 entity包里了。

項目結構劃分總結

如果從一個用戶訪問一個網站的情況來看，對應著上面的項目代碼結構來分析，可以貫穿整個代碼分層：

對應代碼目錄的流轉邏輯就是：

我想，應該看得比較清楚了吧。

所以，以后每當我們拿到一個新的項目到手時，只要按照這個思路去看別人項目的代碼，應該基本都是能理得順的。

一些注意事項

1、 Contorller層參數傳遞建議不要使用 HashMap，建議使用數據模型定義

2、 Controller層里可以做參數校驗、異常拋出等操作，但建議不要放太多業務邏輯，業務邏輯盡量放到 Service層代碼中去做

3、 Service層做實際業務邏輯，可以按照功能模塊做好定義和區分，相互可以調用

4、功能模塊 Service之間引用時，建議不要滲透到 DAO層(或者 mapper層)，基于 Service層進行調用和復用比較合理

5、業務邏輯層 Service和數據庫 DAO層的操作對象不要混用。 Controller層的數據對象不要直接滲透到 DAO層(或者 mapper層)；同理數據表實體對象 Entity也不要直接傳到 Controller層進行輸出或展示。

總結

以上是生活随笔為你收集整理的web.xml文件位于web项目的目录结构中的_看完这篇，别人的开源项目结构应该能看懂了...的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。