浅析 Laravel 底层原理:契约(Contracts)「建议收藏」

浅析 Laravel 底层原理:契约(Contracts)

大家好,又见面了,我是全栈君。

简介

Laravel 中的契约是指框架提供的一系列定义核心服务的接口(interface)。

例如,Illuminate\Contracts\Queue\Queue 契约定义了队列任务所需的方法,而 Illuminate\Contracts\Mail\Mailer 契约定义了发送电子邮件所需的方法。

框架对每个契约都提供了相应的实现。例如,Laravel 提供了具有各种驱动的队列实现和由 SwiftMailer 提供支持的邮件驱动实现。

所有的 Laravel 契约都有他们自己的 GitHub 库。这为所有可用的契约提供了一个快速参考指南,同时也可单独作为低耦合的扩展包给其他包开发者使用。

契约 VS. Facades

Laravel Facades 和辅助函数提供了一种使用 Laravel 服务的简单方法,即不需要通过类型提示并从服务容器中解析契约。在大多数情况下,每个 Facades 都有一个等效的契约。

不同于门面不需要在构造函数中进行类型提示,契约允许你在类中定义显式的依赖。一些开发者倾向于以契约这种方式明确地定义它们的依赖项,而其它开发者则更喜欢 Facades 带来的便捷。

对于大多数应用程序来说,不管是使用门面还是契约都可以。但是,如果你正在构建一个扩展包,为了方便测试,你应该强烈考虑契约。

何时使用契约

综上所述,使用契约或是 Facades 很大程度上归结于个人或者开发团队的喜好。不管是契约还是 Facades 都可以创建出健壮的、易测试的 Laravel 应用程序。如果你长期关注类的单一职责,你会注意到使用契约还是 Facades 其实没多少实际意义上的区别。

然而,你可能还是会有几个关于契约的问题。例如,为什么要使用接口?不使用接口会比较复杂吗?下面让我们谈下使用接口的原因:低耦合和简单性。

低耦合

首先,让我们来看一些高耦合缓存实现的代码。如下:

<?php


namespace App\Orders;


class Repository
{
    /**
     * 缓存实例。
     */
    protected $cache;


    /**
     * 创建一个仓库实例。
     *
     * @param  \SomePackage\Cache\Memcached  $cache
     * @return void
     */
    public function __construct(\SomePackage\Cache\Memcached $cache)
{
        $this->cache = $cache;
    }


    /**
     * 按照 Id 检索订单
     *
     * @param  int  $id
     * @return Order
     */
    public function find($id)
{
        if ($this->cache->has($id))    {
            //
        }
    }
}

在这个类中,程序与给定的缓存实现高耦合。因为我们依赖于一个扩展包的特定缓存类。一旦这个扩展包的 API 被更改了,我们的代码就必须跟着改变。

同样的,如果我们想要将底层的的缓存技术( Memcached )替换为另一种缓存技术( Redis ),那又得再次修改这个 repository 类。而 repository 类不应该了解太多关于谁提供了这些数据或是如何提供的等等。

比起上面的做法,我们可以使用一个简单的、与扩展包无关的接口来改进我们的代码:

<?php


namespace App\Orders;


use Illuminate\Contracts\Cache\Repository as Cache;


class Repository
{
    /**
     * 缓存实例。
     */
    protected $cache;


    /**
     * 创建一个仓库实例。
     *
     * @param  Cache  $cache
     * @return void
     */
    public function __construct(Cache $cache)
{
        $this->cache = $cache;
    }
}

现在,更改之后的代码没有与任何扩展包甚至是 Laravel 耦合。而契约扩展包不包含任何实现和依赖项,你可以轻松地编写任何给定契约的替代实现,来实现不修改任何关于缓存消费的代码就可以替换缓存实现。

简单性

当所有 Laravel 的服务都使用简洁的接口定义,就很容易判断给定服务提供的功能。可以将契约视为说明框架功能的简洁文档。

除此之外,当依赖的接口足够简洁时,代码的可读性和可维护性会大大提高。比起搜索一个大型复杂的类中有哪些可用的方法,不如检索一个简单、 干净的接口来参考更妥当。

如何使用契约

Laravel 中的许多类型的类都是通过 服务容器 解析出来的,包括控制器、事件监听器、中间件、任务队列,甚至路由闭包。所以,要获得一个契约的实现,你只需要在被解析的类的构造函数中添加「类型提示」即可。

例如,看看这个事件监听器:

<?php


namespace App\Listeners;


use App\User;
use App\Events\OrderWasPlaced;
use Illuminate\Contracts\Redis\Database;


class CacheOrderInformation
{
    /**
     * Redis 数据库实现。
     */
    protected $redis;


    /**
     * 创建事件处理器实例。
     *
     * @param  Database  $redis
     * @return void
     */
    public function __construct(Database $redis)
{
        $this->redis = $redis;
    }


    /**
     * 处理事件。
     *
     * @param  OrderWasPlaced  $event
     * @return void
     */
    public function handle(OrderWasPlaced $event)
{
        //
    }
}

当事件监听器被解析时,服务容器会读取类的构造函数上的类型提示,并注入对应的值。

浅析 Laravel 底层原理:契约(Contracts)「建议收藏」

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/111723.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)


相关推荐

  • PS2手柄遥控控制灯开关(arduino)

    PS2手柄遥控控制灯开关(arduino)PS2手柄遥控控制灯开关(arduino)使用的材料arduino板子:ps2遥控手柄;一个5V供电的LDE;连线首先按照遥控手柄底座上的英文,你会发现一共有六根线,分别是GND,VCC,DAT,CMD,CS,CL。GND连接arduino板子上的gnd,vcc连接5V或者3.3v,其他四根线可以按照代码中的引脚设置连接,也可以自己更改。代码部分#include<PS…

  • 预测大盘最准确的指标_预测大盘走势最牛的指标(经典)

    预测大盘最准确的指标_预测大盘走势最牛的指标(经典)★金融工程研究报告——国海证券2010年量化择时绩效全年盘点报告★国海证券研究所金融工程团队构建了数量化择时系统,以不定期发布《国海量化择时导报》的形式,表达国海金工团队对股市大势的研判及观点。回顾2010年波诡云谲的中国股市,该择时系统屡屡精准地对股市的阶段性趋势作出预判及风险提示,获得多方认可。量化择时系统2010年全年表现国海金工量化择时系统2010年全年表现优异,对股市大的拐点把握次次命…

  • pythoncharm怎么改字体大小_pycharm更改字体大小

    pythoncharm怎么改字体大小_pycharm更改字体大小pycharm在File->settings中设置font大小时发现size框无法输入。查了下资料点击下上面的saveas按钮创建一个信息的模块名称就可以了。

  • 扩展kmp求最长回文子串_算法-字符串之最长回文子串

    扩展kmp求最长回文子串_算法-字符串之最长回文子串上一篇KMP算法之后好几天都没有更新,今天介绍最长回文子串。首先介绍一下什么叫回文串,就是正着读和倒着读的字符顺序都是一样的,eg:level,noon。而回文子串,顾名思义,就是主串中满足回文性质的子串。求解的常规思想,就是先求出主串的所有子串,在判断是否是回文串,然后选出最长的,这一种方法的时候复杂度较高,是O(n^3),所以一般不采用这种方法,下面介绍两种方法求解。1.中心扩展法中心扩展法…

  • RPC协议及常用框架

    RPC协议及常用框架https://www.jianshu.com/p/8ba4b7b834aaRPC协议RPC:远程过程调用,原则上来说系统间跨进程的调用都属于RPC范畴RMI/HTTP/dubbo/SpringCloud/thriftRPC框架如何实现分布式环境下的远程调用在一个典型的RPC的使用场景中,包含了服务发现,负载,容错,网络传输,序列化等组件,其中RPC协议指明了程序如何进行网络传输和序列化。RPC协议的组成RPC协议的组成1.地址:服务提供者地址2.端口:.

  • mysql floor报错注入_mysql报错注入总结[通俗易懂]

    mysql floor报错注入_mysql报错注入总结[通俗易懂]最近又深刻的研究了一下mysql的报错注入,发现很多值得记录的东西,于是写了这篇博客做一个总结,目的是为了更深刻的理解报错注入报错注入原因及分类既然是研究报错注入,那我们先要弄明白为什么我们的注入语句会导致数据库报错,报错的原因我自己总结了一下,有以下几点重复数据报错,这里的重复主要有两个方面,其中之一是基于主键的唯一性:一个表主键必须是唯一的,如果一个表尝试生成两个相同的主键,就会爆出Dupli…

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号