当前位置：首页 > article >正文

3. IoC 与DI

article 2024/10/26 23:57:29

一、定义

IoC，即控制反转，把对象的调用权交给容器，通过容器来实现对象的装配和管理。
DI，即依赖注入，对象之间依赖关系由容器在运行期决定，由容器动态的将依赖关系注入到对象之中。
DI，是对IoC更完善的描述。

二、疑问

谁依赖谁？【对象实例化依赖容器】
为什么要依赖？【对象实例化通过容器自动得到外部依赖】
谁注入谁？【容器注入对象的依赖到对象中】
注入了什么？【注入了对象的外部依赖】

三、 Hyperf的依赖注入的实现

由hyperf/di 组件提供功能支持
更符合长生命周期的应用使用
提供了注解、注解注入、AOP
基于 PSR-11 实现，可独立应用于其它框架

四、注入方式

通过构造方法注入
通过#[Inject]注解注入

五、注入类型

简单对象注入
抽象对象注入
工厂对象注入

六、实例

① 【简单对象注入】

假设存在一个UserService类，在IndexController类中引用它

<?php
// UserService类
namespace App\Service;
class UserService {
  public fucntion getInfoById(int $id) {
    // 假设存在一个 Info  实体
    return (new Info())-> fill($id);
  } 
}

1. 构造函数的形式

构造函数定义依赖类的 Typehint
IndexController 在被DI容器创建时，会自动注入相关依赖

<?php
// IndexController
namespace App\Controller;
class IndexController {
  private $userService;
  
  public function __construct(UserService $userService) {
    $this->userService = $userService;
  }
  
  public function index() {
    return $this->userService->getInfoById(1);
  }
}

2. Inject注解的形式

在类成员属性上定义 #[Inject] 注解和 @var，完成依赖注入

<?php
namespace App\Controller;
use App\Service\UserSerice;
use Hyperf\Di\Annotation\Inject;
class IndexController {

  #[Inject]
  private UserService $userService;
  
  public function index() {
    return $this->userService->getInfoById(1);
  }
}

②【抽象对象注入】

1. 定义一个接口类 UserServiceInterface

UserService 实现接口类

<?php
namespace App\Service;

// UserServiceInterface 接口类
interface UserServiceInterface {
  public function getInfoById(int $id);
}

// UserService 实现类
class UserService implements UserServiceInterface {
  public function getInfoById(int $id) {
    return (new Info())->fill($id);
  }
}

2. 在对应的位置，进行接口类与实现类的关系绑定

<?php
// 在 config/dependencies.php 内
use App\Service\UserServiceInterface;
use App\Service\UserService;
return [
  'dependencies' => [
    UserServiceInterface::class =>UserService::class,
  ],
];

3. 通过以接口类作为 Typehint 注入对应的实现类

<?php
namespace App\Controller;

use App\Service\UserServiceInterface;
use Hyperf\Di\Annotation\Inject;

class IndexController {
  
  /**
   * @var UserServiceInterface
   */
  #[Inject]
  private $userService;
  
  public function index() {
    return $this-<userService->getInfoById(1);
  }
}

③【工厂对象注入】

通过容器来创建一个复杂类，如构造函数需要接收参数的，参数应是应用参数，而不是动态的请求参数。

DI管理的对象是单例

<?php
namespace App\Service;

class UserService inplements userServiceInterface {
  
  private $enableCache;
  
  public function __construct(bool $enableCache) {
    $this->enableCache = $enableCache;
  }
  
  public function getInfoById(int $id) {
    return (new Info())->fill($id);
  }
}

通过工厂类创建复杂的对象

定义一个工厂类，在__invoke()方法内实现对象的创建并返回
make() 函数创建短声明周期对象

<?php
namespace App\Service;
use Hyperf\Contract\ConfigInterface;
use Psr\Container\ContainerInterface;

class UserServiceFactory {
  // __invoke() 方法写成对象的生产
  // 方法参数会自动注入一个当前的容器实例
  // 通过$container对象可以取出hyperf\Di容器中的任意对象
  public function __invoke(ContainerInterface $container) {
    $config = $container->get(ConfigInterface::class);
    // 假设对应的配置的 key 为 cache.enable
    $enableCache = $config->get('cache.enable', false);
    // make(string $name, array $parameters=[]) 方法 等同于 new，使用 make() 方法是为了允许 AOP 的介入，而直接 new 会导致 AOP 无法正常介入流程
    return make(UserService::class, compact('enableCache'));
  }
}

调整接口类与工厂类的关系，注入的即为由工厂类创建的对象

<?php
// 在 config/dependencies.php 内
use App\Service\UserServiceInterface;
use App\Service\UserServiceFactory;
return [
  'dependencies' => [
    UserServiceInterface::class =>UserServiceFactory::class,
  ],
];