這幾天在寫一個內(nèi)部的小需求，需求很簡單。但是在搭建工程的時候遇到了不少問題，本來一天半能搞定所有的東西上線，但是不符合公司上線的規(guī)范要求重構(gòu)。特此記錄一下

項目結(jié)構(gòu)

大部分項目應該使用CRUD模式，只有在絕對必要的時候使用更為負載CQRS模式。

Java服務的結(jié)構(gòu)如下（假設項目名為demo):

• demo-api: HTTP 服務入口 (包括dubbo服務，controller等)
• demo-common: 公用代碼 (包括enmus,exception,utils等等)
• demo-contract: RPC服務接口(原生java不應該依賴任何東西，比如rpc服務接口，自定義的HttpRequest實體類等)
• demo-core: command操作/應該僅用于CQPS模式
• demo-domain: 領(lǐng)域?qū)ο?/li>
• demo-integration: 外部HTTP接口訪問層
• demo-logic: 業(yè)務邏輯層/用于CRUD模式
• demo-manager: 通用業(yè)務邏輯層(新增)
• demo-mq: 消息隊列接入層
• demo-repository: 數(shù)據(jù)庫訪問層/DAO層
• demo-query: 在線業(yè)務邏輯層/應該僅用于CQRS 模式
• demo-service: RPC 服務入口
• demo-task: 離線任務
• demo-tool: 工具
• docs: 文檔
• 其他: 項目特有的其他目錄

應用分層

以CRUD模式為例子

?

?

【推薦】圖中默認上層依賴于下層,箭頭關(guān)系表示可直接依賴,如:開放接口層可以依賴于Web 層,也可以直接依賴于 Service 層,依此類推:

• Open API層:可直接封裝 Service 接口暴露成 RPC 接口 ; 通過 Web 封裝成 http 接口 ; 網(wǎng)關(guān)控制層等。
• API層:主要是對訪問控制進行轉(zhuǎn)發(fā),各類基本參數(shù)校驗,或者不復用的業(yè)務簡單處理等。
• Service層: RPC接口層
• Logic層:相對具體的業(yè)務邏輯服務層。
• Manager層:通用業(yè)務處理層,它有如下特征:
• 對第三方平臺封裝的層,預處理返回結(jié)果及轉(zhuǎn)化異常信息 ;
• ?對 Logic 層通用能力的下沉,如緩存方案、中間件通用處理 ;
• ?與 DAO 層交互,對 DAO 的業(yè)務通用能力的封裝。
• DAO 層:數(shù)據(jù)訪問層,與底層 MySQL，Redis，Hbase 進行數(shù)據(jù)交互。
• 外部接口或第三方平臺:包括其它部門 RPC 開放接口,基礎平臺,其它公司的 HTTP 接口。

【參考】 ( 分層異常處理規(guī)約 ) 在 DAO 層,產(chǎn)生的異常類型有很多,無法用細粒度異常進行catch ,使用 catch(Exception e) 方式,并 throw new DAOException(e) ,不需要打印日志,因為日志在 Manager / Logic?層一定需要捕獲并打到日志文件中去,如果同臺服務器再打日志,浪費性能和存儲。在 Logic 層出現(xiàn)異常時,必須記錄日志信息到磁盤,盡可能帶上參數(shù)信息,相當于保護案發(fā)現(xiàn)場。如果 Manager 層與 Logic?同機部署,日志方式與 DAO 層處理一致,如果是單獨部署,則采用與 Logic?一致的處理方式。 API 層絕不應該繼續(xù)往上拋異常,因為已經(jīng)處于頂層,無繼續(xù)處理異常的方式,如果意識到這個異常將導致頁面無法正常渲染,那么就應該直接跳轉(zhuǎn)到友好錯誤頁面,盡量加上友好的錯誤提示信息。開放接口層要將異常處理成錯誤碼和錯誤信息方式返回。

【參考】分層領(lǐng)域模型規(guī)約:

• DO(Data Object): 與數(shù)據(jù)庫表結(jié)構(gòu)一一對應,通過 DAO 層向上傳輸數(shù)據(jù)源對象。
• DTO(Data Transfer Object): 數(shù)據(jù)傳輸對象, Logic 和 Manager 向外傳輸?shù)膶ο蟆?/li>
• BO(Business Object): 業(yè)務對象。可以由 Logic 層輸出的封裝業(yè)務邏輯的對象。
• QUERY: 數(shù)據(jù)查詢對象,各層接收上層的查詢請求。注:超過 2 個參數(shù)的查詢封裝,禁止使用 Map 類來傳輸。
• VO(View Object): 顯示層對象,通常是 Web 向前端渲染傳輸?shù)膶ο蟆?/li>

?

轉(zhuǎn)載于:https://www.cnblogs.com/WegYcx/p/8033415.html

總結(jié)

以上是生活随笔為你收集整理的工程规范的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。