深入理解Java：注解（Annotation）基本概念 - JAVA

}
}

class Orange extends Fruit {
@Override
public void displayName(){
System.out.println("水果的名字是：桔子");
}
}

class Apple extends Fruit {
@Override
public void displayname(){
System.out.println("水果的名字是：苹果");
}
}　 Orange 类编译不会有任何问题，Apple 类在编译的时候会提示相应的错误。@Override注解只能用于方法，不能用于其他程序元素。
--------------------------------------------------------------------------------

@Deprecated，标记已过时：

　　同样Deprecated也是一个标记注解。当一个类型或者类型成员使用@Deprecated修饰的话，编译器将不鼓励使用这个被标注的程序元素。而且这种修饰具有一定的 “延续性”：如果我们在代码中通过继承或者覆盖的方式使用了这个过时的类型或者成员，虽然继承或者覆盖后的类型或者成员并不是被声明为 @Deprecated，但编译器仍然要报警。

　　值得注意，@Deprecated这个annotation类型和javadoc中的 @deprecated这个tag是有区别的：前者是java编译器识别的，而后者是被javadoc工具所识别用来生成文档（包含程序成员为什么已经过时、它应当如何被禁止或者替代的描述）。

　　在java5.0，java编译器仍然象其从前版本那样寻找@deprecated这个javadoc tag，并使用它们产生警告信息。但是这种状况将在后续版本中改变，我们应在现在就开始使用@Deprecated来修饰过时的方法而不是 @deprecated javadoc tag。

　　下面一段程序中使用了@Deprecated注解标示方法过期，同时在方法注释中用@deprecated tag 标示该方法已经过时，代码如下：

class AppleService {
public void displayName(){
System.out.println("水果的名字是：苹果");
}

/**
* @deprecated 该方法已经过期，不推荐使用
*/
@Deprecated
public void showTaste(){
System.out.println("水果的苹果的口感是：脆甜");
}

public void showTaste(int typeId){
if(typeId==1){
System.out.println("水果的苹果的口感是：酸涩");
}
else if(typeId==2){
System.out.println("水果的苹果的口感是：绵甜");
}
else{
System.out.println("水果的苹果的口感是：脆甜");
}
}
}

public class FruitRun {

/**
* @param args
*/
public static void main(String[] args) {
Apple apple=new Apple();
apple.displayName();

AppleService appleService=new AppleService();
appleService.showTaste();
appleService.showTaste(0);
appleService.showTaste(2);
}

}　　AppleService类的showTaste() 方法被@Deprecated标注为过时方法，在FruitRun类中使用的时候，编译器会给出该方法已过期，不推荐使用的提示。

--------------------------------------------------------------------------------

SuppressWarnnings，抑制编译器警告：

　　@SuppressWarnings 被用于有选择的关闭编译器对类、方法、成员变量、变量初始化的警告。在java5.0，sun提供的javac编译器为我们提供了-Xlint选项来使编译器对合法的程序代码提出警告，此种警告从某种程度上代表了程序错误。例如当我们使用一个generic collection类而又没有提供它的类型时，编译器将提示出"unchecked warning"的警告。通常当这种情况发生时，我们就需要查找引起警告的代码。如果它真的表示错误，我们就需要纠正它。例如如果警告信息表明我们代码中的switch语句没有覆盖所有可能的case，那么我们就应增加一个默认的case来避免这种警告。
　　有时我们无法避免这种警告，例如，我们使用必须和非generic的旧代码交互的generic collection类时，我们不能避免这个unchecked warning。此时@SuppressWarning就要派上用场了，在调用的方法前增加@SuppressWarnings修饰，告诉编译器停止对此方法的警告。
　　SuppressWarning不是一个标记注解。它有一个类型为String[]的成员，这个成员的值为被禁止的警告名。对于javac编译器来讲，被-Xlint选项有效的警告名也同样对@SuppressWarings有效，同时编译器忽略掉无法识别的警告名。
　　annotation语法允许在annotation名后跟括号，括号中是使用逗号分割的name=value对用于为annotation的成员赋值。实例如下：

public class FruitService {

@SuppressWarnings(value={ "rawtypes", "unchecked" })
public static List getFruitList(){
List fruitList=new ArrayList();
return fruitList;
}

@SuppressWarnings({ "rawtypes", "unchecked" })
public static List getFruit(){
List fruitList=new ArrayList();
return fruitList;
}

@SuppressWarnings("unused")
public static void main(String[] args){
List strList=new ArrayList();
}
}　　在这个例子中SuppressWarnings annotation类型只定义了一个单一的成员

深入理解Java：注解（Annotation）基本概念 (二)