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

仓储层与逻辑层搭建 

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文件内容如下所示：

<?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并实现相应的接口了。

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