编程语言
首页 > 编程语言> > 利用@see、@link增强程序可读性

利用@see、@link增强程序可读性

作者:互联网

诸多原因,我们的程序往往解释不了它自己。

即使程序可以解释自己,那么,谁会用它?它跟谁有关系?  这些就用到了@see @link了。

 

@see的用法:

@see com.....XXXClass

@see com.....XXXClass#XXXMethod

 

使用@see为class添加注释

/**
 * 描    述:企业开票申请单的状态枚举
 * @see com.emax.zhenghe.rpcapi.modules.bill.vo.EnterpriseInvoiceApplyVO#billStatus
 * 创 建 者: zhang.gz
 * 创建时间: 2021-5-20 17:56
 */
@Getter
@AllArgsConstructor
public enum InvoiceApplyStatusEnum {
    。。。
}

 

使用@link为class的成员属性添加注释

public class EnterpriseOnlineAuthVO {
    
    。。。
    
    /**
     * 认证类型 {@link com.emax.zhenghe.common.enums.OnlineAuthTypeEnum}
     */
    private String authType;
    
    。。。
    
}

 

标签:可读性,XXXClass,emax,see,link,com,class
来源: https://www.cnblogs.com/buguge/p/14799415.html