Definindo suas próprias anotações

É possível usar a anotação @interface para criar sua própria definição de anotação.

Procedimento

Use a anotação @interface para definir sua própria definição de anotação:
  • As definições de anotações se parecem com as definições de interfaces
  • As declarações dos métodos de anotações não possuem parâmetros ou cláusulas throws e exibem um dos elementos a seguir:
    • primitives
    • Cadeia
    • Classe
    • enum
    • uma matriz dos tipos mencionados anteriormente
  • Os métodos podem ter valores padrão
    public @interface CreatedBy{
         String name();
         String date();
         boolean contractor() default false;
    }          
    @CreatedBy(name = "Mary Smith",date="02/02/2008")
    public class MyClass{....}         

Resultados

Meta-anotações: As meta-anotações (anotações de anotações) fornecem informações adicionais sobre como uma anotação pode ser utilizada:
  • @Target
    • Restringe a utilização de uma anotação
    • O argumento único deve vir de Enum ElementType
      • {TYPE, FIELD,METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE}
  • @Retention
    • Indica onde as informações sobre a anotação são mantidas
    • O argumento único deve vir de Enum RetentionPolicy
      • {SOURCE, CLASS, RUNTIME}
  • @Documented
    • Marcador para anotações que devem ser incluídas em Javadoc
  • @Inherited
    • Marcador dos tipos de anotações que devem ser herdados por subtipos
Outras Anotações Integradas:
  • @Overrides
    • Aplicada a um método
    • Indica que o compilador gera um erro se o método não substituir realmente um método de superclasse.
  • @Deprecated
    • Aplicada a um método
    • Indica que o compilador gera um aviso quando o método é utilizado externamente
  • @SuppressWarnings
    • Aplicada a um tipo ou um método
    • Indica que o compilador suprime os avisos desse elemento e de todos os subelementos
      @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