注解 & Aspect


这个图是基于丝路项目的流程逻辑, 并不和下边的类相符, 下边的类是用 Hyperf 原生进行定义的

注解

Class 注解

注解是将一系列的数据进行关联的一种方式
类的注解以及生成的数据(全部)

1
2
3
4
5
6
7
8
9
10
11
12
array(2) {
["App\Service\AnClass\ClassAllIn"]=>
object(App\Annotation\AnClass)#25 (1) {
["name"]=>
string(5) "allin"
}
["App\Service\AnClass\ClassQ"]=>
object(App\Annotation\AnClass)#49 (1) {
["name"]=>
string(1) "q"
}
}

这里有一个注解类, 两个注解实现类
这里表明注册在 class 中可用, 传入的参数代表可以将参数初始化到 公共变量中, 在变量初始化的时候是进行如此设定的

1
2
3
4
5
6
7
8
9
10
11
12
# file : AbstractAnnotation.php
# 初始化
public function __construct($value = null)
{
if (is_array($value)) {
foreach ($value as $key => $val) {
if (property_exists($this, $key)) {
$this->{$key} = $val;
}
}
}
}
1
2
3
4
5
6
7
8
# file : ClassQ.php
# 使用
/**
* @AnClass(name="q")
*/
class ClassQ
{
}

注解的传参 : Url : https://hyperf.wiki/2.1/#/zh-cn/annotation?id=%E6%B3%A8%E8%A7%A3%E5%8F%82%E6%95%B0%E4%BC%A0%E9%80%92

  • 传递主要的单个参数 @DemoAnnotation("value")
  • 传递字符串参数 @DemoAnnotation(key1="value1", key2="value2")
  • 传递数组参数 @DemoAnnotation(key={"value1", "value2"})
    1
    2
    3
    4
    5
    6
    7
    8
    /**
    * @Annotation
    * @Target({"CLASS"})
    */
    class AnClass extends AbstractAnnotation
    {
    public string $name = '';
    }

property (属性)

将属性/方法/定义传参

1
2
3
4
5
6
7
8
9
10
[
[
["class"]=> "App\Service\Annotation\PropertyAllIn"
["property"]=> "actionName"
["annotation"]=>
object(App\Annotation\AnProperty)#22 (1) {
["name"]=> "allin"
}
]
]

Method(方法)

1
2
3
4
5
6
7
8
9
[
"App\Annotation\AnMethodByParams"=>
object(App\Annotation\AnMethodByParams)#24 (2) {
["method"]=> "allin"
["params"]=> [
[0]=> string(2) "id"
]
}
]

注解的分类

切面单独独立出来

_@_Annotation

注解的标识

_@_Target

注解的解析位置 CLASS, METHOD, PROPERTY, ALL

_@_Constants

常量数据

_@_Inject

标记属性, Hyperf 会自动注入对应的对象和值

_@_AutoController 以及控制器相关的代码

路由的注解
_@_Controller : 表明当前类是一个控制器类
@RequestMapping(path=”index”, methods=”get,post”) : 定义路由访问, 路径是控制器 + 当前定义的 path
_@_GetMapping : Get 方法
_@_PostMapping : Post
_@_PutMapping : Put
_@_PatchMapping : Patch 方法(对资源进行部分修改)
_@_DeleteMapping : Delete 删除

_@_Listener

切面 (Aspect)

通过动态代理等技术实现程序功能的统一维护的一种技术.
使用 Aop 扩展业务逻辑, 并使耦合度降低, 提高程序的可重用性

Socket

@SocketIONamespace(“/“)

socket 命名空间定义, 这里的命名空间和 socket.io 指定的相符, 也可以通过相关的路由来添加

_@_Event

以方法名作为事件名来分发事件, 如果写在控制器中则自动进行方法的映射.


原文地址 : 注解 & Aspect
本站是作者语雀文档的镜像站, 如对文章有任何疑问请移步语雀进行 提问

作者

Duoli

发布于

2022-04-20

更新于

2022-08-24

许可协议

评论