YUIDocs 等文档工具允许您使用@class
注释块中的标签来识别和描述类(对象类)。每个标识的类都需要一个@static
或@constructor
标记,定义如下:
@constructor
- 表示该类是可实例化的(使用 new 关键字创建)。@static
- 表示您不应使用 new 实例化该类。您可以静态调用所有类的方法。
在 Ember 中,您经常使用extend()
. 据我所知,这不会创建类的新实例。然而,许多这些定义(例如路由的控制器)是单例的,即使您使用extend()
它们来定义它们。
因此,我的问题是:在 ember 应用程序中记录类的哪些常见情况下,您会使用@constructor
vs@static
吗?这样的例子是:
- 初始化器
- 路由器
- 适配器
- 序列化器
- 转型
- 路线
- 商店
- 楷模
- 控制器
- 意见
- 组件
- 混合
我在这里不包括 Handlebars 助手,因为我相信它们实际上是方法,而不是类,但如果我错了,我会纠正这个问题。