Download the PHP package hehex/hehep-hcontainer without Composer

hehep-hcontainer

介绍

hehep-hcontainer 是一个 di容器,提供类的实例化工具组件
支持注释注解
支持PHP原生注解
支持类属性,构造参数依赖注入
支持AOP切面
支持Bean作用域

安装

• 直接下载:

• gitee下载:

• github下载:

• 命令安装：

• 依赖包

  如果需要注释注解,则需要安装doctrine
  composer require "doctrine/annotations"
  如是PHP8,可以使用PHP原生注解,或两者同时使用

Bean组件

常规定义Bean

基本示例

注解定义bean

• 注解说明

通过@Bean注解器对bean进行描述,注解器属性与"常规定义Bean"一致
基本格式如下
@Bean("user") 定义bean id的属性
@Bean("user",_scope="app") 定义bean 作用域属性
@Bean("user",_scope=true,_onProxy=true)

• 示例代码

注册Bean

实例化Bean

Bean作用域

• 说明

bean 默认只有一种作用域,即永久作用域,如需实现其他作用域容器,则可通过
设置作用域容器事件来实现,比如需实现"request" 请求级别的作用域,则需要设置request对应的容器获取事件

• 示例代码

绑定类或接口

依赖注入

构造函数注入

• 说明

  构造函数参数有三种方式注入Bean
  方式1:定义参数类型为Bean类
  方式2:定义参数默认值为\,xxx 为指定的bean标识
  方式3:定义参数默认值为\,xxx 为指定的bean标识

• 定义参数类型方式注入

• 定义参数默认值方式注入

• 定义参数默认值方式延迟注入

属性赋值注入

属性注入对应的属性必须是public属性

属性注入Bean

• 说明

  以\<ref::bean别名>默认值的方式注入Bean对象
  以Ref注解的方式注入Bean对象

• 示例代码

Bean代理

• 说明

  代理概念:在用户端与目标类之间插入一个中间类,用户端通过中间类操作目标类(中间类继承目标类,中间类删除所有属性,重写目标类所有方法)
  代理流程:
  开启代理后,先创建代理类对象存储在容器中,当在调用代理方法或使用属性时都触发目标类对象的创建，目标对象存储在“代理事件”对象中,
  基本流程:客户端->代理类->代理事件->创建目标对象->目标方法
  AOP基本流程:客户端->代理类->代理事件->创建目标对象->AOP切面->目标方法
  开启代理:Bean定义配置_onProxy=true,AOP相关注解(After,Before等等),延迟注入(lazy),即会自动进入代理模式 解决问题:代理模式实现AOP切面功能,间接实现了"延迟注入",解决了相互依赖导致的死循环问题

• Bean定义代理示例代码

• Bean注解代理示例代码

• AOP注解示例代码

• 延迟注入示例代码

延迟注入

• 说明

  由于在注入的过程中,容易出现相互依赖而导致的死循环问题,延迟注入的方式有效的解决此问题,
  延迟注入会自动开启代理模式,如果Bean已经开启过代理模式，注入的是Bean单例代理对象,如Bean 未开启代理模式,则创建新的代理对象

• Bean定义方式

• 注解方式

扫描文件

• 说明

  开启扫描后,程序会自动查找指定命名空间下的所有类文件,并收集注解信息,同时将收集到的注解信息交给对应的注解处理器来处理业务，
  比如与Bean相关的注解器Bean,Ref都被指定由"hehe\core\hcontainer\annotation\BeanProcessor"来处理

扫描规则

注解处理器

• 说明

  注解处理器作用:专门用于处理收集到的注解信息
  注解处理器基类:都必须继承"hehe\core\hcontainer\ann\base\AnnotationProcessor"类
  优先处理器:如果想优先执行某个处理器,则可以将此处理器添加到"优先处理器"集合中
  重置处理器:如想重写某个处理器的规则,则可以将此处理器添加到"重置处理器"集合中

• 定义注解处理器

• 注册(优先/重置)处理器

• 注解与处理器绑定

  可通过"hehe\core\hcontainer\ann\base\Annotation"注解器将"注解器"与"注解处理器"绑定
  Annotation格式:@Annotation("注解处理器类路径")

AOP方法拦截

• 说明

  切面(aspect):AOP切面通俗点讲就是拦截类方法调用,在调用目标方法之前或之后设置拦截点，并在拦截点插入行为业务,比如日志,获取缓存数据等
  实现原理:在执行创建目标对象时动态的生成代理类，通过代理类操作目标类
  通知点(advice):目标方法之前,之后,异常时切入业务行为的位置点
  拦截点表达式(pointcut):目标方法或匹配方法名的正则表达

默认通知点位置

定义"业务行为"

• 说明

  每个"业务行为"方法都会传入"拦截点上下文"（PointcutContext）对象,其属性如下
  advice:拦截点位置,如after,before
  target:目标对象
  method:目标方法
  parameters:目标方法传入的参数
  methodResult:执行目标方法后返回的结果
  exception:执行目标方法时抛出的异常对象

• 示例代码

定义目标类

注解

注解主要用于收集用户在代码中自定义的数据,并交由注解处理器处理业务

定义注解处理器

定义注解处理器请参考扫描-注解处理器

定义注解器

• 说明

  定义注解器时，必须为其绑定注解处理器
  可通过"hehe\core\hcontainer\annotation\Annotation"注解器将"注解器"与"注解处理器"绑定
  Annotation格式:@Annotation("注解处理器类路径")

• 代码示例

• 注解器使用示例

PHP原生注解

• 说明

  原生注解与注释注解的用户基本一致,格式如下

  [注解器("第一个构造参数值")]

  [注解器("第一个构造参数值",属性名称1:属性值1,属性名称2:属性值2)]

  [注解器(属性名称1:属性值1,属性名称2:属性值2)]

  [注解器(array(属性名称1=>属性值1,属性名称2=>属性值2))]

• 定义原生注解器

• 原生注解器使用示例

获取注解对象

默认注解器列表

• Bean注解

  标识此类为bean对象
  类路径:hehe\core\hcontainer\annotation\Bean

• Proxy注解

  标识此类启用了代理,同时会生成代理对象,一般用于切面
  类路径:hehe\core\hcontainer\annotation\Proxy

• Ref注解

  标识类属性为bean对象
  类路径:hehe\core\hcontainer\annotation\Ref

• After注解

  标识aop切面,在目标方法执行之后切入“业务行为”
  类路径:hehe\core\hcontainer\aop\annotation\After
  示例:@After("业务行为类路径"),@After("业务行为类路径@方法"),@After("业务行为类路径@@静态方法")

• Before注解

  标识aop切面,在目标方法执行之前切入“业务行为”
  类路径:hehe\core\hcontainer\aop\annotation\Before 示例:与@After格式一致

• Around注解

  标识aop切面,在目标方法执行之前与之后切入“业务行为”
  类路径:hehe\core\hcontainer\aop\annotation\Around
  示例:与@After格式一致

• AfterThrowing注解

  标识aop切面,在目标方法执行抛出异常时切入“业务行为”
  类路径:hehe\core\hcontainer\aop\annotation\AfterThrowing
  示例:与@After格式一致

• AfterReturning注解

  aop切面注解器,用于在执行目标方法之后,无论是否发生异常,都会切入“业务行为”,类似异常的finally
  类路径:hehe\core\hcontainer\aop\annotation\AfterReturning
  示例:与@After格式一致