Magento2 API 服务合同设计模式 依赖注入 介绍

公共接口和API

什么是公共界面？

一个公共接口是一组代码，第三方开发者可以调用，实现或构建一个 插件 。Magento保证在没有重大版本更改的情况下，此代码在后续版本中不会更改。

模块的公共接口 标有@api注释。

。

什么是API？

应用程序编程接口（API）是模块提供给其他模块的一组接口及其实现。

API类型

以下项目被视为API类型：

• 目录结构
• 配置文件结构
• 活动
• 客户端API
• 提供者 API （SPI）

目录结构和配置文件结构是API的类型，因为 扩展 开发人员使用它们。开发人员编写配置，并将其 静态文件 放在指定的文件夹中; 因此，如果配置文件结构或目录结构在后续版本中发生更改，则模块和扩展可能会中断。

服务合同设计模式

在编程社区中，设计模式是编写代码的推荐方式，包括何时使用或不使用模式。将 设计模式 视为具有条件的最佳实践。

服务契约的设计模式告诉您要定义哪些类型的接口，以及定义和实现这些接口的方式和位置。

服务合同数据接口现在是可变的。

接口类型和位置

一个 服务合同 必须定义数据接口，保持数据的完整性和服务接口，其中隐藏服务请求者的业务逻辑。

数据接口定义函数，这些函数返回有关数据实体的信息，返回搜索结果，设置验证规则并返回验证结果。您必须在模块的Api / Data子目录中 定义服务协定的数据接口 。

服务接口包括管理，存储库和 元数据 接口。您必须在模块的Api子目录中定义服务协定的服务接口。

数据接口

在模块的Api / Data子目录中定义数据接口。

例如，Customer模块的数据接口位于/ app / code / Magento / Customer / Api / Data子目录中。

数据搜索结果界面

将搜索条件传递给getList()呼叫时，将返回搜索结果界面以及搜索结果。

您必须为每个数据实体定义一个接口以 进行类型提示。也就是说，getItems()函数 CustomerSearchResultsInterface返回一个CustomerInterface数据实体数组。在GroupSearchResultsInterface，该getItems()函数返回一个GroupInterface数据实体数组。

服务接口

服务接口包括几个接口子类型：

• 存储库接口
• 管理界面
• 元数据接口

对于文件名和编码标准，请遵循定义的PHP编码标准。

将服务接口放在模块的顶级Api目录中。

存储库接口

存储库接口提供对持久数据实体的访问。

例如，Customer模块的持久数据实体包括Customer，Address和Group。因此，Customer模块的存储库接口是：

• CustomerRepositoryInterface
• AddressRepositoryInterface
• GroupRepositoryInterface

存储库接口必须提供以下功能：

功能	描述
save(data entity interface)	如果未指定ID，则创建记录。 如果指定了ID，则更新指定ID的记录。
get(id)	按ID执行数据库查找。 返回数据实体接口，例如CustomerInterface或AddressInterface。
getList(search criteria)	执行搜索与指定搜索条件匹配的所有数据实体。 返回一个搜索结果界面，可以访问该组匹配项。
delete(data entity interface)	删除指定的实体。实体包含密钥（ID）。
deleteById(id)	按键（ID）删除指定的实体。

每个数据实体都有一个相应的接口。因此，get()例如，相应接口中的函数可以返回确切的类型。

管理界面

管理界面提供与存储库无关的管理功能。例如：

接口	描述
AccountManagementInterface	定义createAccount()，changePassword()，activate()，和isEmailAvailable()功能。
AddressManagementInterface	定义validate()验证地址的函数。

依赖注入

Magento 2使用依赖注入来替换MageMagento 1.x中类提供的功能。

依赖注入是一种设计模式，它允许对象A将其依赖关系声明为提供这些依赖关系的外部对象B. A声明的依赖关系通常是类接口，而依赖关系B提供的依赖关系是这些接口的具体实现。

这允许代码的松散耦合，因为对象A不再需要关心初始化它自己的依赖性。对象B基于配置或期望的行为决定向对象A提供哪些实现。

这是扩展开发人员理解的一个重要概念，因为它构成了Magento如何组成其类的基础。

依赖倒置原则

遵循依赖性反转原则并在代码中使用抽象来减少代码依赖性。这意味着您的高级类应该使用低级类的接口，而不是直接使用它们。

当Magento更改这些接口的底层实现时，在代码中使用接口可以降低不兼容性错误的风险。它还可以让您专注于类的功能而不是它的实现方式。

由于Magento代码库遵循此原则，因此您可以使用该di.xml文件将自己的Magento接口实现映射到依赖类或服务。

对象管理器

这ObjectManager是一个Magento服务类，它在引导过程开始时实例化对象。

Magento使用类构造函数签名来检索有关对象的构造函数依赖项的信息。构造类时，对象管理器将类的依赖项（在di.xml文件中定义）注入到类构造函数中。

由于对象管理器间接提供其服务，因此您的类不应依赖于ObjectManager对象本身。唯一的例外是具有复杂逻辑和集成测试的自定义工厂，需要进行环境设置。

编译依赖项

Magento使用其代码编译工具收集所有类依赖关系信息并将其存储在文件中。在类创建过程中，对象管理器使用此信息在应用程序中创建具体对象。

代码库中不存在的服务类，

例如: proxies, factories, and interceptors 在代码或配置中声明的，是在编译器的帮助下生成的。

Magento中使用的注入类型

以下代码示例突出显示了Magento中使用的两种依赖注入：

namespace Magento\Backend\Model\Menu;
class Builder
{
    /**
     * @param \Magento\Backend\Model\Menu\Item\Factory $menuItemFactory
     * @param \Magento\Backend\Model\Menu $menu
     */
    public function __construct(
        Magento\Backend\Model\Menu\Item\Factory $menuItemFactory,  // Service dependency
        Magento\Backend\Model\Menu $menu  // Service dependency
    ) {
        $this->_itemFactory = $menuItemFactory;
        $this->_menu = $menu;
    }

    public function processCommand(\Magento\Backend\Model\Menu\Builder\CommandAbstract $command) // API param
    {
        // processCommand Code
    }
}

　　

• 构造函数注入在代码示例中，Builder类在其构造函数中声明其对Factory和Menu类的依赖性。Magento使用di.xml文件来确定要注入Builder类的实现。可选的依赖项可选依赖项是您的类用于特定方法和方案的对象。如果实例化类的代价很高，并且您的类并不总是使用它，请考虑使用代理。必须对对象的所有可选和必需依赖项使用构造函数依赖项注入。
• 方法注入在代码示例中，Builder类还依赖于CommandAbstract类的processCommand（）方法。方法注入涉及将依赖项作为方法参数传递，以在类逻辑中使用它。当对象需要对无法注入的依赖项执行操作时，请使用方法注入。

依赖类型

注入

可注入对象是通过依赖注入获得的单件服务对象。对象管理器使用di.xml文件中的配置来创建这些对象并将它们注入构造函数。

只要依赖关系链不循环回原始可注入对象，可注入对象就可以依赖于构造函数中的其他可注入对象。

Newable /非注入

新的或不可注射的对象是不能注入的对象。它们是通过每次需要时创建一个新的类实例获得的。

瞬态对象（例如需要来自用户或数据库的外部输入的对象）属于此类别。如果您尝试注入这些对象，您将收到一个不完整的，不正确的对象或无法创建该对象的错误。

例如，您不能依赖于模型对象，例如Product，因为您需要提供产品ID或显式请求新的空实例来获取Product对象。由于您无法在构造函数签名中指定此数据，因此Magento无法注入此对象。

为了解决这个限制，可注入对象可以依赖于生成可新对象的工厂。