Deprecated

Deprecated

java.lang

---

Java 5.0

@Documented @Retention(RUNTIME) annotation

This annotation type marks the annotated program element as deprecated. The Java compiler issues a warning if the annotated element is used or overrided in code that is not itself @Deprecated .

In Java 5.0, the @Deprecated annotation works in the same way as the @deprecated javadoc tag. In future releases of Java, the compiler may ignore @deprecated javadoc tag and rely only on the @Deprecated annotation.

This annotation type has source retention and does not have an @Target meta-annotation, which means it may be applied to any program element. Deprecated has an @Documented meta-annotation, meaning that the presence of an @Deprecated annotation should be a documented part of the annotated element's API.

Figure 10-16. java.lang.Deprecated

 public @interface  Deprecated  { }