Lumen框架—升级改造之路-仓储层

仓储层与逻辑层搭建 

Lumen官方文档:https://lumen.laravel.com/docs/5.5

我的项目地址:https://github.com/BusinessL/big-lumen

1.Lumen基础框架中,并不包含仓储层,与业务逻辑层,所以我们在app文件夹下,新建两个文件夹(Repositories、Services)。另外新建Models文件夹,用来存放数据源文件。

Lumen框架—升级改造之路-仓储层

别害怕在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() 等。

Lumen框架—升级改造之路-仓储层

 仓储层建立

仓储层与逻辑层搭建一节中,我已经创建了Repositories文件夹,这个文件夹用来存放仓储文件。再重申一下,仓储的定义,它是数据访问层,与底层MySQL、Oracle等进行数据交互。

底层的数据层是多变的,我们这里根据依赖倒置原则(Dependence Inversion Principle),是程序要依赖于抽象接口(interface),不要依赖于具体实现。简单的说就是要求对抽象进行编程,不要对实现进行编程,这样就降低了客户与实现模块间的耦合。

下面我们在仓储Repositories文件夹中,再新建两个文件夹用来存放接口及其实现,取名为ContractsEloquents。Contracts存放接口,Eloquents用来存放接口的实现。

Lumen框架—升级改造之路-仓储层

首先,我们在仓储层中,新建一个BASE接口文件(BaseInterface)与它的抽象类实现(BaseEloquent),可以在其中定义通用方法,具体参见我的代码库https://github.com/BusinessL/big-lumen

BaseInterface文件内容如下所示:

<?php

namespace App\Repositories\Contracts;

use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Model; interface BaseInterface
{
/**
* 更新
*/
  public function update(array $where, array $attributes);
}

  

  BaseEloquent内容如下所示

<?php

namespace App\Repositories\Eloquents;

use App\Repositories\Contracts\BaseInterface;

abstract class BaseEloquent implements BaseInterface
{
/**
* Instance that extends Illuminate\Database\Eloquent\Model
*
* @var Model
*/
protected $model; /**
* Constructor
*/
public function __construct()
{ 
    $this->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绑定方法。

示例代码如下:

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class RepositoriesServiceProvider extends ServiceProvider
{
/**
* Indicates if loading of the provider is deferred.
*
* @var bool
*/
protected $defer = true; /**
* Register any application services.
*
* @return void
*/
public function register()
{
$this->app->bind(
\App\Repositories\Contracts\UserInterface::class,
\App\Repositories\Eloquents\UserEloquent::class
);
}
}

  

好了,现在我们就可以定义每个model的数据访问文件,继承BaseEloquent并实现相应的接口了。

下一节,来讲解下逻辑层,控制器如何使用逻辑,逻辑如何使用仓储。

上一篇:FastAdmin 将会员模块升级为基础模块的升级指导


下一篇:Mac 删除/卸载 自己安装的python