php – 我应该使用@return self,this还是当前的类?

我有一个返回当前对象的方法,我该如何记录?

/**
 * set something
 *
 * @return this
 */
public function setSomething(){
            // ...
    return $this;
}

或者我应该@return self或@return Current_Class_Name?

这个问题不是“主要基于意见”(并且应该重新开放)的原因:符合标准和IDE类型提示支持.

解决方法:

@return Current_Class_Name肯定会起作用,我更喜欢它.

@return self也可以用于某些程序.

@return这很糟糕,因为这不是一个类型名称.

上一篇:如何用Java文档记录我的Java方法?


下一篇:java – 如何自动化REST API文档(Jersey实现)