仓储层与逻辑层搭建
Lumen官方文档:https://lumen.laravel.com/docs/5.5
我的项目地址:https://github.com/BusinessL/big-lumen
1.Lumen基础框架中,并不包含仓储层,与业务逻辑层,所以我们在app文件夹下,新建两个文件夹(Repositories、Services)。另外新建Models文件夹,用来存放数据源文件。
别害怕在Lumen预设目录以外建立其他目录,根据SOLID的单一职责原则,class功能越多,责任也越多,因此违法单一职责原则,所以你应该将你的程式分割成更小的部分,每个部分都有它专属的功能,而不是一个class功能包山包海,所以整个架构体系不应该只有MVC三个部分,放手根据你的需求建立适当的目录,并将适当的class放到该目录,只要我们的class有namespace帮我们分类即可。
如何使用仓储层?
使用理由:在 CRUD 中,CUD 比较稳定,但 R 的部分則千变万化,大部分的业务逻辑都在描述 R 的部分,若將业务逻辑写在 controller 或 model 都不适当,会造成 controller 与 model 肥大,造成日后难以维护。
注意:使用 repository 之后,model 仅当成Eloquent class 即可,不要包含业务逻辑,仅保留以下部分 :
①基础属性:例如 $fillable、$hidden 等。
②Method: relation类的 method,例如 hasMany() 与 belongsTo() 等。
仓储层建立:
在 仓储层与逻辑层搭建一节中,我已经创建了Repositories文件夹,这个文件夹用来存放仓储文件。再重申一下,仓储的定义,它是数据访问层,与底层MySQL、Oracle等进行数据交互。
底层的数据层是多变的,我们这里根据依赖倒置原则(Dependence Inversion Principle),是程序要依赖于抽象接口(interface),不要依赖于具体实现。简单的说就是要求对抽象进行编程,不要对实现进行编程,这样就降低了客户与实现模块间的耦合。
下面我们在仓储Repositories文件夹中,再新建两个文件夹用来存放接口及其实现,取名为Contracts与Eloquents。Contracts存放接口,Eloquents用来存放接口的实现。
首先,我们在仓储层中,新建一个BASE接口文件(BaseInterface)与它的抽象类实现(BaseEloquent),可以在其中定义通用方法,具体参见我的代码库https://github.com/BusinessL/big-lumen。
BaseInterface文件内容如下所示:
BaseEloquent内容如下所示
makeModel(); } /** * Specify Model class name. * * @return mixed */ abstract public function model(); /** * 注入 * @return Model|mixed * @throws GeneralException */ public function makeModel() { $model = app()->make($this->model()); return $this->model = $model; } /** * 更新 */ public function update(array $where, array $attributes) { return $this->model->where($where)->update($attributes); } }
注意:一个类需要绑定、注册至容器中,才能被“制造”。对,一个类要被容器所能够提取,必须要先注册至这个容器。既然 Laravel 称这个容器叫做服务容器,那么我们需要某个服务,就得先注册、绑定这个服务到容器,那么提供服务并绑定服务至容器的东西,就是服务提供者(Service Provider)。如下代码使用bind绑定方法。
示例代码如下:
app->bind( \App\Repositories\Contracts\UserInterface::class, \App\Repositories\Eloquents\UserEloquent::class ); } }
好了,现在我们就可以定义每个model的数据访问文件,继承BaseEloquent并实现相应的接口了。
下一节,来讲解下逻辑层,控制器如何使用逻辑,逻辑如何使用仓储。