四种常用的注释
@Target({ElementType.TYPE})
表示注解作用范圍,超過這個作用范圍,編譯的時候就會報錯
@Retention(RetentionPolicy.RUNTIME)
被描述的注解在什么范圍內有效
@Documented
表明這個注解應該被 javadoc工具記錄. 默認情況下,javadoc是不包括注解的. 但如果聲明注解時指定了 @Documented,則它會被 javadoc 之類的工具處理, 所以注解類型信息也會被包括在生成的文檔中,是一個標記注解,沒有成員
點左側欄中的“DocumentAnnotation",打開DocumentAnnotation類的文檔說明,可以看到@Book標記的注解內容顯示了出來:
如果@Book注解沒有被@Document標記,那么被@Book注解標記的DocumentAnnotation類的注解信息就不會包含在java doc html文檔中:如下圖
@Inherited
如果一個類用上了@Inherited修飾的注解,那么其子類也會繼承這個注解
總結
- 上一篇: idea每次新建项目都要重新配置mave
- 下一篇: 什么是javadoc文档