Laravel 程式架構設計思路:使用動作類

来源:https://www.cnblogs.com/summerblue/archive/2018/06/07/9148713.html
-Advertisement-
Play Games

當我們談論到應用程式的架構的時候,經常會問到一個經典的問題,那就是“這段代碼應該放在哪裡比較好”。 因為 Laravel 是一個相當靈活的框架,所以要回答這個問題其實沒那麼容易。我應該把我的業務邏輯寫在 Model 層,還是 Controller 層,或者是其他地方? 當你的應用程式僅有一個接入點, ...


file

當我們談論到應用程式的架構的時候,經常會問到一個經典的問題,那就是“這段代碼應該放在哪裡比較好”。 因為 Laravel 是一個相當靈活的框架,所以要回答這個問題其實沒那麼容易。我應該把我的業務邏輯寫在 Model 層,還是 Controller 層,或者是其他地方?

當你的應用程式僅有一個接入點,把業務邏輯寫在 Controller 層是可以的。但是現在更普遍的的情形是,有很多接入點去調用相同的功能模塊。

比如說,太多數的應用程式都有用戶註冊的功能,它的流程是調用一個控制器然後返回一個註冊成功或者失敗的視圖。假如這個應用程式還有移動端,那就很可能要提供一套針對移動端用戶註冊的 API ,因為它需要返回的數據格式是 JSON 。而且利用 Laravel 的 artisan 命令來創建用戶也很常見,尤其是在項目前期的開發階段。

file

上面這兩段代碼可能看起來沒有什麼問題的,但是,隨著業務邏輯的增加,就會顯得代碼很冗餘。舉個例子,如果你需要新用戶註冊完之後,增加給用戶發送郵件通知的功能,你必須要再上面兩個控制器中都添加發送郵件的代碼。但是如果要保持代碼的簡潔優雅,我們可以把這些業務邏輯寫到其他地方。

對於“把業務邏輯代碼寫到哪裡”的這個問題,你去任何論壇都可以得到一個普遍的答案,那就是 “使用一個 service 層,然後在 controller 層調用這個服務類”。是的,沒錯,問題是我們應該怎麼設計 service 類?是創建一個 UserService 類來實現所有跟用戶用戶有關的業務邏輯,然後把這個類註入到需要用到的 Controller 層?或者是還有其他方案?

避免神類的坑

首先,可以嘗試為一個特定的模型創建一個單一類,其中包含所有的代碼。例如:

file

看起來很完美:我們可以任何控制器中申明或者使用 create/delete 方法,並且得到我們想要的結果。但是,這種實現有什麼問題呢? 那就是我們在解決問題的過程通常很少使用單一的模型 

比如說,當我們給一個用戶創建了賬號的時候,也要同時給用戶單獨創建一個 blog 。如果按照當前的方式去實現這個流程,我們就必須創建一個 BlogService 類,然後將其依賴註入到 UserService 類。

file

顯而易見,隨著應用程式的業務的增長,將會有幾十到上百個 service 類,其中的一些 service 類需要依賴 5 到 6 個其他 service 類,最終的結果就是,出現代碼的冗餘跟混亂的局面,而這個局面是我們想不惜一切代價去避免的。

介紹單動作類

那麼,如果不是用一個單一的服務類加上幾個方法,我們決定把它分成幾個類?下麵是我最近每一個項目都採用的方法,結果很不錯,推薦給大家。

首先,讓我們拋棄過於籠統和模糊的服務術語,來瞭解一下我們的新動作類,並定義它們是什麼以及它們可以做什麼。

  • 一個動作類,應該有一個能夠說明其功能的名字,比如:CreateOrder, ConfirmCheckout, DeleteProduct, AddProductToCart等。
  • 它應該有且只有一個公共方法,作為 API 。理想的情況下,應該是相同的方法名,像 handle() 或者 execute() 。如果需要對我們的動作類實現某種適配器模式,這是非常方便的。
  • 它必須對請求和響應不可知。它不處理請求,也不發送響應。這樣的職責應該由控制器來承擔。
  • 它可以依賴其它的動作類。
  • 如果有任何事情阻止它執行和/或返回期望的值,那麼它必須通過拋出一個 Exception 來強制執行相關的業務邏輯,並且讓調用者(或者 Laravel 的 ExceptionHandler )來承擔如何呈現/響應異常的責任。

創建我們的 CreateUser 動作類

現在,讓我們看看前面的例子,並用一個單動作類來重構它,我們將命名為 CreateUser 。

file

你或許想知道當郵箱地址已經被占用時,該方法為什麼會拋出了異常。 這難道不是請求驗證來保證的嗎?當然可以。然而,在動作類內部來執行業務邏輯不是更好嗎?這樣使得邏輯變得易於理解和調試。

讓我們看看使用我們動作類之後的控制器代碼,如下:

file

現在,無論我們做什麼修改,用戶註冊過程都會由 API 和 Web 版本處理,優雅整潔。

動作類的嵌套

假如,我們需要一個動作類將 1000 個用戶導入我們的應用中。我們可以寫一個動作類,並且繼續使用上文的 CreateUser 類:

file

非常整潔,不是嗎?我們可以通過將其嵌入在 Collection::map() 方法中來重用 CreateUser 代碼,然後返回所有新建用戶的集合。當郵件被占用的時候,我們可以通過返回 Null Object 或者在 Log 文件中記錄一下,你應該已經想到了。

動作類的裝飾

現在,假設我們想在日誌中記錄每一個新註冊的用戶。我們可以將代碼寫在動作類內部,也可以使用裝飾者模式。

file

然後,我們可以使用 Laravel 的 IoC 容器將 LogCreateUser 類綁定到 CreateUser 類,所有每當我們需要一個後者的實例時,前者都會註入進來:

file

AppServiceProvider.php

這使得使用配置或環境變數來控制日誌記錄功能的激活或停用更為方便:

file

AppServiceProvider.php

總結

使用這個方法似乎會需要很多的類。當然,用戶註冊僅僅是一個簡單的例子,旨在保證代碼的簡短清晰。一旦項目的複雜度開始增長,動作類的真正的價值就越來越明顯,因為你清晰的知道代碼所在及其界定。

使用單動作類的好處:

  • 小巧而單一的邏輯域能夠防止代碼重覆並提高代碼的可重用性,保持穩定。
  • 易於針對各種場景進行獨立測試。
  • 富有意義的命名在大型項目中更容易閱讀。
  • 易於裝飾。
  • 整個項目的一致性:防止代碼分佈在 Controllers、Models 等。

當然,這個方法是基於我過去幾年使用 Laravel 的一些經驗和我在一些項目中的實踐。這對我真的很有用,現在我甚至在一些中小型項目中使用。

如果你有不同的方法,我非常期待讀一讀。

更多現代化 PHP 知識,請前往 Laravel / PHP 知識社區


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • br標簽,如何在html中換行,可以使用br標簽 1.br標簽的作用:換行 2.br標簽的格式:<br> 3.br標簽的註意點: 3.1多個br標簽可以連續使用,使用了多個br標簽就會換多少行 3.2由於HTML的作用就是用來給文本添加語義,而br標簽的語義是不另起一個段落換行,而在企業開發中一般情 ...
  • 我們在之前已經瞭解過,如果想添加一個圖片,需要寫出以下代碼: <img src="logo.png"> 其實想給src屬性賦值有兩種方式: 相對路徑就是每次都從.html文件所在的文件夾開始查找,我們稱之為相對路徑 1.1 同級 同級就是圖片和.html文件存儲在同一個文件夾中 格式: src="Q ...
  • JDBC:(Java database connectivity) 目的:將Java語言和資料庫解耦和,使得一套Java程式能對應不同的資料庫。 方法:sun公司制定了一套連接資料庫的介面(API)。這套API叫做JDBC,JDBC的介面的實現類由資料庫廠家負責編寫,打包成jar包進行發佈,這些ja ...
  • 本節主要闡述如下兩個問題: 1、Dubbo自定義標簽實現。 2、dubbo通過Spring載入配置文件後,是如何觸發註冊中心、服務提供者、服務消費者按照Dubbo的設計執行相關的功能。 ...
  • Java開源生鮮電商平臺-商品價格的設計與架構(源碼可下載) 說明:Java開源生鮮電商平臺-商品價格的設計與架構,主要是對商品的價格進行研究與系統架構. 一、常見的電商價格 市場價(List Price):這個價格僅是用於顯示,用於襯托網站銷售價格的優惠程度; 銷售價(Sales Price):亦 ...
  • Time Limit: 1000/1000 MS (Java/Others) Memory Limit: 32768/32768 K (Java/Others)Total Submission(s): 2677 Accepted Submission(s): 1208 Problem Descrip ...
  • 發奮忘食,樂以忘優,不知老之將至。———《論語》 前面幾篇已經介紹了關於線程安全和同步的相關知識,那麼有了這些概念,我們就可以開始著手設計線程安全的類。本文將介紹構建線程安全類的幾個方法,並說明他的區別。 我要講的這幾個構建線程安全類的方式是: 另外,在設計線程安全類的過程中,我們需要考慮下麵三個基 ...
  • 題目描述 計算積分 結果保留至小數點後6位。 數據保證計算過程中分母不為0且積分能夠收斂。 輸入輸出格式 輸入格式: 一行,包含6個實數a,b,c,d,L,R 輸出格式: 一行,積分值,保留至小數點後6位。 輸入輸出樣例 輸入樣例#1: 複製 1 2 3 4 5 6 輸出樣例#1: 複製 2.732 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...