Laravel程序架构设计思路之使用动作类


Posted in PHP onJune 07, 2018

前言

当我们谈论到应用程序的架构的时候,经常会问到一个经典的问题,那就是“这段代码应该放在哪里比较好”。 因为 Laravel 是一个相当灵活的框架,所以要回答这个问题其实没那么容易。我应该把我的业务逻辑写在 Model 层,还是 Controller 层,或者是其他地方?

当你的应用程序仅有一个接入点,把业务逻辑写在 Controller 层是可以的。但是现在更普遍的的情形是,有很多接入点去调用相同的功能模块。

比如说,太多数的应用程序都有用户注册的功能,它的流程是调用一个控制器然后返回一个注册成功或者失败的视图。假如这个应用程序还有移动端,那就很可能要提供一套针对移动端用户注册的 API ,因为它需要返回的数据格式是 JSON 。而且利用 Laravel 的 artisan 命令来创建用户也很常见,尤其是在项目前期的开发阶段。

Laravel程序架构设计思路之使用动作类

上面这两段代码可能看起来没有什么问题的,但是,随着业务逻辑的增加,就会显得代码很冗余。举个例子,如果你需要新用户注册完之后,增加给用户发送邮件通知的功能,你必须要再上面两个控制器中都添加发送邮件的代码。但是如果要保持代码的简洁优雅,我们可以把这些业务逻辑写到其他地方。

对于“把业务逻辑代码写到哪里”的这个问题,你去任何论坛都可以得到一个普遍的答案,那就是 “使用一个 service 层,然后在 controller 层调用这个服务类”。是的,没错,问题是我们应该怎么设计 service 类?是创建一个 UserService 类来实现所有跟用户用户有关的业务逻辑,然后把这个类注入到需要用到的 Controller 层?或者是还有其他方案?

避免神类的坑

首先,可以尝试为一个特定的模型创建一个单一类,其中包含所有的代码。例如:

看起来很完美:我们可以任何控制器中申明或者使用 create/delete 方法,并且得到我们想要的结果。但是,这种实现有什么问题呢? 那就是我们在解决问题的过程通常很少使用单一的模型 。

比如说,当我们给一个用户创建了账号的时候,也要同时给用户单独创建一个 blog 。如果按照当前的方式去实现这个流程,我们就必须创建一个 BlogService 类,然后将其依赖注入到 UserService 类。

Laravel程序架构设计思路之使用动作类

显而易见,随着应用程序的业务的增长,将会有几十到上百个 service 类,其中的一些 service 类需要依赖 5 到 6 个其他 service 类,最终的结果就是,出现代码的冗余跟混乱的局面,而这个局面是我们想不惜一切代价去避免的。

介绍单动作类

那么,如果不是用一个单一的服务类加上几个方法,我们决定把它分成几个类?下面是我最近每一个项目都采用的方法,结果很不错,推荐给大家。

首先,让我们抛弃过于笼统和模糊的服务术语,来了解一下我们的新动作类,并定义它们是什么以及它们可以做什么。

  • 一个动作类,应该有一个能够说明其功能的名字,比如:CreateOrder, ConfirmCheckout, DeleteProduct, AddProductToCart等。
  • 它应该有且只有一个公共方法,作为 API 。理想的情况下,应该是相同的方法名,像 handle() 或者 execute() 。如果需要对我们的动作类实现某种适配器模式,这是非常方便的。
  • 它必须对请求和响应不可知。它不处理请求,也不发送响应。这样的职责应该由控制器来承担。
  • 它可以依赖其它的动作类。
  • 如果有任何事情阻止它执行和/或返回期望的值,那么它必须通过抛出一个 Exception 来强制执行相关的业务逻辑,并且让调用者(或者 Laravel 的 ExceptionHandler )来承担如何呈现/响应异常的责任。

创建我们的 CreateUser 动作类

现在,让我们看看前面的例子,并用一个单动作类来重构它,我们将命名为 CreateUser 。

Laravel程序架构设计思路之使用动作类

你或许想知道当邮箱地址已经被占用时,该方法为什么会抛出了异常。 这难道不是请求验证来保证的吗?当然可以。然而,在动作类内部来执行业务逻辑不是更好吗?这样使得逻辑变得易于理解和调试。

让我们看看使用我们动作类之后的控制器代码,如下:

Laravel程序架构设计思路之使用动作类

现在,无论我们做什么修改,用户注册过程都会由 API 和 Web 版本处理,优雅整洁。

动作类的嵌套

假如,我们需要一个动作类将 1000 个用户导入我们的应用中。我们可以写一个动作类,并且继续使用上文的 CreateUser 类:

Laravel程序架构设计思路之使用动作类

非常整洁,不是吗?我们可以通过将其嵌入在 Collection::map() 方法中来重用 CreateUser 代码,然后返回所有新建用户的集合。当邮件被占用的时候,我们可以通过返回 Null Object 或者在 Log 文件中记录一下,你应该已经想到了。

动作类的装饰

现在,假设我们想在日志中记录每一个新注册的用户。我们可以将代码写在动作类内部,也可以使用装饰者模式。

Laravel程序架构设计思路之使用动作类

然后,我们可以使用 Laravel 的 IoC 容器将 LogCreateUser 类绑定到 CreateUser 类,所有每当我们需要一个后者的实例时,前者都会注入进来:

Laravel程序架构设计思路之使用动作类

AppServiceProvider.php

这使得使用配置或环境变量来控制日志记录功能的激活或停用更为方便:

Laravel程序架构设计思路之使用动作类

AppServiceProvider.php

总结

使用这个方法似乎会需要很多的类。当然,用户注册仅仅是一个简单的例子,旨在保证代码的简短清晰。一旦项目的复杂度开始增长,动作类的真正的价值就越来越明显,因为你清晰的知道代码所在及其界定。

使用单动作类的好处:

  • 小巧而单一的逻辑域能够防止代码重复并提高代码的可重用性,保持稳定。
  • 易于针对各种场景进行独立测试。
  • 富有意义的命名在大型项目中更容易阅读。
  • 易于装饰。
  • 整个项目的一致性:防止代码分布在 Controllers、Models 等。

当然,这个方法是基于我过去几年使用 Laravel 的一些经验和我在一些项目中的实践。这对我真的很有用,现在我甚至在一些中小型项目中使用。

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

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对三水点靠木的支持。

PHP 相关文章推荐
php5新改动之短标记启用方法
Sep 11 PHP
php adodb介绍
Mar 19 PHP
php排序算法(冒泡排序,快速排序)
Oct 09 PHP
php实现根据字符串生成对应数组的方法
Sep 22 PHP
PHP带节点操作的无限分类实现方法详解
Nov 09 PHP
Yii框架分页实现方法详解
May 20 PHP
PHP实现深度优先搜索算法(DFS,Depth First Search)详解
Sep 16 PHP
thinkPHP中U方法加密传递参数功能示例
May 29 PHP
PHP Primary script unknown 解决方法总结
Aug 22 PHP
解决windows上php xdebug 无法调试的问题
Feb 19 PHP
PHP函数用法详解【初始化、嵌套、内置函数等】
Jun 02 PHP
深入解析PHP底层机制及相关原理
Dec 11 PHP
laravel手动创建数组分页的实现代码
Jun 07 #PHP
thinkPHP框架实现生成条形码的方法示例
Jun 06 #PHP
使用PHP访问RabbitMQ消息队列的方法示例
Jun 06 #PHP
PHP简单实现记录网站访问量功能示例
Jun 06 #PHP
Laravel框架实现利用监听器进行sql语句记录功能
Jun 06 #PHP
Laravel框架实现利用中间件进行操作日志记录功能
Jun 06 #PHP
PHP实现的curl批量请求操作示例
Jun 06 #PHP
You might like
PHP 在线翻译函数代码
2009/05/07 PHP
php数组相加 array(“a”)+array(“b”)结果还是array(“a”)
2012/09/19 PHP
PHP弹出对话框技巧详细解读
2015/09/26 PHP
使用 JavaScript 进行函数式编程 (一) 翻译
2015/10/02 Javascript
JS实现选项卡实例详解
2015/11/17 Javascript
noty ? jQuery通知插件全面解析
2016/05/18 Javascript
JavaScript String(字符串)对象的简单实例(推荐)
2016/08/31 Javascript
EasyUI Datebox 日期验证之开始日期小于结束时间
2017/05/19 Javascript
easyui-datagrid开发实践(总结)
2017/08/02 Javascript
webpack进阶——缓存与独立打包的用法
2017/08/02 Javascript
详解升级react-router 4 踩坑指南
2017/08/14 Javascript
详解Vue2.0 事件派发与接收
2017/09/05 Javascript
关于Mac下安装nodejs、npm和cnpm的教程
2018/04/11 NodeJs
JS弹窗 JS弹出DIV并使整个页面背景变暗功能的实现代码
2018/04/21 Javascript
angular2 ng2-file-upload上传示例代码
2018/08/23 Javascript
js中的this的指向问题详解
2019/08/29 Javascript
js HTML DOM EventListener功能与用法实例分析
2020/04/27 Javascript
[01:15:45]DOTA2上海特级锦标赛B组小组赛#1 Alliance VS Spirit第一局
2016/02/26 DOTA
[03:08]TI9战队档案 - Vici Gaming
2019/08/20 DOTA
一道python走迷宫算法题
2018/01/22 Python
Python_查看sqlite3表结构,查询语句的示例代码
2019/07/17 Python
python判断自身是否正在运行的方法
2019/08/08 Python
python中pandas库中DataFrame对行和列的操作使用方法示例
2020/06/14 Python
Keras 切换后端方式(Theano和TensorFlow)
2020/06/19 Python
Django实现内容缓存实例方法
2020/06/30 Python
Python 爬取淘宝商品信息栏目的实现
2021/02/06 Python
matplotlib之pyplot模块坐标轴标签设置使用(xlabel()、ylabel())
2021/02/22 Python
CSS3 画基本图形,圆形、椭圆形、三角形等
2016/09/20 HTML / CSS
伦敦剧院门票:London Theatre Direct
2018/11/21 全球购物
LN-CC英国:伦敦时尚生活的缩影
2019/09/01 全球购物
帮一个朋友写的求职信
2014/08/09 职场文书
会员卡清退活动总结
2014/08/27 职场文书
地震捐款倡议书
2014/08/29 职场文书
2014迎国庆演讲稿
2014/09/19 职场文书
SpringCloud的JPA连接PostgreSql的教程
2021/06/26 Java/Android
vue ref如何获取子组件属性值
2022/03/31 Vue.js