定义您自己的注释

您可以使用 @interface 注释来创建自己的注释定义。

过程

请使用 @interface 注释来定义自己的注释定义:
  • 注释定义类似于接口定义
  • 注释方法声明既没有参数,也没有 throws 子句,并且将返回下列元素之一:
    • 原语
    • 字符串
    • 类
    • 枚举
    • 先前提及的类型的阵列
  • 方法可以具有缺省值
    public @interface CreatedBy{
         String name();
         String date();
         boolean contractor() default false;
    }          
    @CreatedBy(name = "Mary Smith",date="02/02/2008")
    public class MyClass{....}         

结果

元注释:元注释(注释的注释)提供了有关如何使用注释的更多信息:
  • @Target
    • 限制使用注释
    • 单个自变量必须来自于枚举元素类型
      • {TYPE, FIELD,METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE}
  • @Retention
    • 指示用于保留注释信息的位置
    • 单个自变量必须来自于枚举保留策略
      • {SOURCE, CLASS, RUNTIME}
  • @Documented
    • 适用于要包括在 Javadoc 中的注释的标记
  • @Inherited
    • 适用于要由子类型继承的类型注释的标记
其他内置注释:
  • @Overrides
    • 应用于方法
    • 指示编译器在该方法实际不覆盖某个超类方法时生成错误。
  • @Deprecated
    • 应用于方法
    • 指示编译器在外部使用该方法时生成警告
  • @SuppressWarnings
    • 应用于类型或方法
    • 指示编译器禁止对该元素及其所有子元素发出警告
      @Deprecated
      public void oldMethod() {...}
      
      @SupressWarnings
      public void yesIknowIuseDeprecatedMethods() {...}
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tdefiningannotations.html