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
- @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
- @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() {...}