優(yōu)秀的代碼都是如何分層的？看了直呼NB！

1.背景

說起應(yīng)用分層，大部分人都會(huì)認(rèn)為這個(gè)不是很簡(jiǎn)單嘛 就controller，service, mapper三層。看起來簡(jiǎn)單，很多人其實(shí)并沒有把他們職責(zé)劃分開，在很多代碼中,controller做的邏輯比service還多,service往往當(dāng)成透?jìng)髁?，這其實(shí)是很多人開發(fā)代碼都沒有注意到的地方，反正功能也能用，至于放哪無所謂唄。這樣往往造成后面代碼無法復(fù)用，層級(jí)關(guān)系混亂，對(duì)后續(xù)代碼的維護(hù)非常麻煩。

的確在這些人眼中分層只是一個(gè)形式，前輩們的代碼這么寫的，其他項(xiàng)目代碼這么寫的，那么我也這么跟著寫。但是在真正的團(tuán)隊(duì)開發(fā)中每個(gè)人的習(xí)慣都不同，寫出來的代碼必然帶著自己的標(biāo)簽，有的人習(xí)慣controller寫大量的業(yè)務(wù)邏輯，有的人習(xí)慣在service中之間調(diào)用遠(yuǎn)程服務(wù)，這樣就導(dǎo)致了每個(gè)人的開發(fā)代碼風(fēng)格完全不同，后續(xù)其他人修改的時(shí)候，一看，我靠這個(gè)人寫的代碼和我平常的習(xí)慣完全不同，修改的時(shí)候到底是按著自己以前的習(xí)慣改，還是跟著前輩們走，這又是個(gè)艱難的選擇，選擇一旦有偏差，你的后輩又維護(hù)你的代碼的時(shí)候，恐怕就要罵人了。

所以一個(gè)好的應(yīng)用分層需要具備以下幾點(diǎn):

方便后續(xù)代碼進(jìn)行維護(hù)擴(kuò)展。

分層的效果需要讓整個(gè)團(tuán)隊(duì)都接受

各個(gè)層職責(zé)邊界清晰

基于 Spring Boot + MyBatis Plus + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

項(xiàng)目地址：https://github.com/YunaiV/ruoyi-vue-pro

視頻教程：https://doc.iocoder.cn/video/

2.如何進(jìn)行分層

2.1阿里規(guī)范

在阿里的編碼規(guī)范中約束的分層如下:

開放接口層:可直接封裝 Service 方法暴露成 RPC 接口;通過 Web 封裝成 http 接口;進(jìn)行 網(wǎng)關(guān)安全控制、流量控制等。

終端顯示層:各個(gè)端的模板渲染并執(zhí)行顯示的層。當(dāng)前主要是 velocity 渲染，JS 渲染， JSP 渲染，移動(dòng)端展示等。

Web 層:主要是對(duì)訪問控制進(jìn)行轉(zhuǎn)發(fā)，各類基本參數(shù)校驗(yàn)，或者不復(fù)用的業(yè)務(wù)簡(jiǎn)單處理等。

Service 層:相對(duì)具體的業(yè)務(wù)邏輯服務(wù)層。

Manager 層:通用業(yè)務(wù)處理層，它有如下特征:1. 對(duì)第三方平臺(tái)封裝的層，預(yù)處理返回結(jié)果及轉(zhuǎn)化異常信息;2. 對(duì)Service層通用能力的下沉，如緩存方案、中間件通用處理;3. 與DAO層交互，對(duì)多個(gè)DAO的組合復(fù)用。

DAO 層:數(shù)據(jù)訪問層，與底層 MySQL、Oracle、Hbase 進(jìn)行數(shù)據(jù)交互。

阿里巴巴規(guī)約中的分層比較清晰簡(jiǎn)單明了，但是描述得還是過于簡(jiǎn)單了，以及service層和manager層有很多同學(xué)還是有點(diǎn)分不清楚之間的關(guān)系，就導(dǎo)致了很多項(xiàng)目中根本沒有Manager層的存在。下面介紹一下具體業(yè)務(wù)中應(yīng)該如何實(shí)現(xiàn)分層

2.2優(yōu)化分層

從我們的業(yè)務(wù)開發(fā)中總結(jié)了一個(gè)較為的理想模型,這里要先說明一下由于我們的rpc框架選用的是thrift可能會(huì)比其他的一些rpc框架例如dubbo會(huì)多出一層,作用和controller層類似

1.最上層controller和TService是我們阿里分層規(guī)范里面的第一層:輕業(yè)務(wù)邏輯，參數(shù)校驗(yàn)，異常兜底。通常這種接口可以輕易更換接口類型,所以業(yè)務(wù)邏輯必須要輕，甚至不做具體邏輯。

2.Service：業(yè)務(wù)層，復(fù)用性較低，這里推薦每一個(gè)controller方法都得對(duì)應(yīng)一個(gè)service,不要把業(yè)務(wù)編排放在controller中去做，為什么呢？如果我們把業(yè)務(wù)編排放在controller層去做的話，如果以后我們要接入thrift,我們這里又需要把業(yè)務(wù)編排在做一次，這樣會(huì)導(dǎo)致我們每接入一個(gè)入口層這個(gè)代碼都得重新復(fù)制一份如下圖所示:

這樣大量的重復(fù)工作必定會(huì)導(dǎo)致我們開發(fā)效率下降，所以我們需要把業(yè)務(wù)編排邏輯都得放進(jìn)service中去做:

3.Mannager：可復(fù)用邏輯層。這里的Mannager可以是單個(gè)服務(wù)的，比如我們的cache,mq等等，當(dāng)然也可以是復(fù)合的，當(dāng)你需要調(diào)用多個(gè)Mannager的時(shí)候，這個(gè)可以合為一個(gè)Mannager，比如邏輯上的連表查詢等。如果是httpMannager或rpcMannager需要在這一層做一些數(shù)據(jù)轉(zhuǎn)換

4.DAO：數(shù)據(jù)庫訪問層。主要負(fù)責(zé)“操作數(shù)據(jù)庫的某張表，映射到某個(gè)java對(duì)象”，dao應(yīng)該只允許自己的Service訪問，其他Service要訪問我的數(shù)據(jù)必須通過對(duì)應(yīng)的Service。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

項(xiàng)目地址：https://github.com/YunaiV/yudao-cloud

視頻教程：https://doc.iocoder.cn/video/

3.分層領(lǐng)域模型的轉(zhuǎn)換

在阿里巴巴編碼規(guī)約中列舉了下面幾個(gè)領(lǐng)域模型規(guī)約:

DO（Data Object）：與數(shù)據(jù)庫表結(jié)構(gòu)一一對(duì)應(yīng)，通過DAO層向上傳輸數(shù)據(jù)源對(duì)象。

DTO（Data Transfer Object）：數(shù)據(jù)傳輸對(duì)象，Service或Manager向外傳輸?shù)膶?duì)象。

BO（Business Object）：業(yè)務(wù)對(duì)象。由Service層輸出的封裝業(yè)務(wù)邏輯的對(duì)象。

AO（Application Object）：應(yīng)用對(duì)象。在Web層與Service層之間抽象的復(fù)用對(duì)象模型，極為貼近展示層，復(fù)用度不高。

VO（View Object）：顯示層對(duì)象，通常是Web向模板渲染引擎層傳輸?shù)膶?duì)象。

Query：數(shù)據(jù)查詢對(duì)象，各層接收上層的查詢請(qǐng)求。注意超過2個(gè)參數(shù)的查詢封裝，禁止使用Map類來傳輸。

每一個(gè)層基本都自己對(duì)應(yīng)的領(lǐng)域模型，這樣就導(dǎo)致了有些人過于追求每一層都是用自己的領(lǐng)域模型，這樣就導(dǎo)致了一個(gè)對(duì)象可能會(huì)出現(xiàn)3次甚至4次轉(zhuǎn)換在一次請(qǐng)求中，當(dāng)返回的時(shí)候同樣也會(huì)出現(xiàn)3-4次轉(zhuǎn)換，這樣有可能一次完整的請(qǐng)求-返回會(huì)出現(xiàn)很多次對(duì)象轉(zhuǎn)換。如果在開發(fā)中真的按照這么來，恐怕就別寫其他的了，一天就光寫這個(gè)重復(fù)無用的邏輯算了吧。

所以我們得采取一個(gè)折中的方案:

1.允許Service/Manager可以操作數(shù)據(jù)領(lǐng)域模型，對(duì)于這個(gè)層級(jí)來說，本來自己做的工作也是做的是業(yè)務(wù)邏輯處理和數(shù)據(jù)組裝。

2.Controller/TService層的領(lǐng)域模型不允許傳入DAO層，這樣就不符合職責(zé)劃分了。

3.同理，不允許DAO層的數(shù)據(jù)傳入到Controller/TService.

4.總結(jié)

總的來說業(yè)務(wù)分層對(duì)于代碼規(guī)范是比較重要，決定著以后的代碼是否可復(fù)用，是否職責(zé)清晰，邊界清晰。

當(dāng)然這種分層其實(shí)見仁見智, 團(tuán)隊(duì)中的所有人的分層習(xí)慣也不同，所以很難權(quán)衡出一個(gè)標(biāo)準(zhǔn)的準(zhǔn)則，總的來說只要滿足職責(zé)邏輯清晰，后續(xù)維護(hù)容易，就是好的分層。

最后，如果你的團(tuán)隊(duì)有更好的分層，或者上面所描述的有什么錯(cuò)誤的地方還請(qǐng)留言指正一下。