[转]J2SE 5.0的三种内置注释类型

晚上才真正的理解了这个；
google 有了这个：

[b]J2SE 5.0的三种内置注释类型 [/b]

注解(annotation)是J2SE 5.0的新内容，它给我们提供了很好的编程支持，下面介绍一下其内置的三种注解类型：

1. @Override

@Override用在多态情况下，比如：


[code]
public abstract class Animal{
public void say(){
System.out.println("annimal is saying");
}
}

public class Cat extends Animal{
@Override
public void say(){
System.out.println("miao, miao");
}
}[/code]


通过@Override来告诉java编译器，say方法是重载的父类的方法，这样，当父类的say方法签名改名的话，比如增加了一些参数，那么子类的Cat中的say方法编译时就会报错，说没有正确的重载父类方法，所以，@Override可以帮我们验证程序的正确性，这一点，很有用。

2. @Deprecated

@Deprecated的意思和JavaDoc中的@deprecated注释在本质上是一样的，使用如下：


[code]
public class DeprecatedExample {
@Deprecated
public static void badMethod() { }
}

public class DeprecatedUser {
public static void main(String[] args){
DeprecatedExample.badMethod();
}
}[/code]

上面的代码如果用javac进行编译的话，会打印出如下信息:
Note: DeprecatedUser.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
1 error
如果你按提示重新加-Xlint进行编译，你就可以得到错误的详细信息：
% javac -Xlint:deprecation
DeprecatedUser.java:3: warning: [deprecation] badMethod() in DeprecatedExample
has been deprecated
DeprecatedExample.badMethod();

需要注意的是：和javadoc中的@deprecated相比，@Deprecated并没有强大多少，因为它不支持参数，而@deprecated后面还可以跟字符串来给一些相关的信息，但@Deprecated做不到，但它提供了运行时自省的功能，来提示错误，所以建议@Deprecated和@deprecated同时使用。

3. @SuppressWarnings

顾名思义，就是抑制警告信息的出现，使用如下：
[code]
public class DeprecatedExample2{
@Deprecated
public static void foo() { }
}

public class DeprecatedUser2 {
@SuppressWarnings(value={"deprecation"})
public static void main(String[] args) {
DeprecatedExample2.foo();
}
}[/code]
上述@SuppressWarnings(value={"deprecation"})的作用就是抑制编译器报deprecation的错。
@SuppressWarnings(value={"deprecation"})只支持一个参数，是数组类型，所以你可以不用加value, 写成：@SuppressWarnings({"deprecation"})；当想抑制多个类型的警告信息时，可写：@SuppressWarnings({"unchecked","fallthrough",deprecation"}).

注意：在JDK1.5.0 release中，@SuppressWarnings还没有得到完全支持，会在以后支持，但Sun并没有给出具体的时间。

[url=http://www.blogjava.net/robin/archive/2006/01/01/26283.html]original text[/url]