Java注释Override、Deprecated、SuppressWarnings详解

        }</span></span></div>

Deprecated

        }

        

        class Class2 extends Class1
        <span >{
        public void myMethod()<span >{}

        } 

        </span></span></span></span></div>

public void myMethod()
{
  List<String> wordList = new ArrayList<String>();
  wordList.add("foo");
}

另外一种方法就是使用@SuppressWarnings。
@SuppressWarnings (value={"unchecked"})
public void myMethod()
{
  List wordList = new ArrayList();
  wordList.add("foo");
}
要注意的是SuppressWarnings和前两个注释不一样。这个注释有一个属性。当然，还可以抑制其它警告，如:
@SuppressWarnings (value={"unchecked", "fallthrough"})

        public void myMethod()
        <span >{
        }</span></div>

        public MyEnum.value1() <span >{}

        public String value2() <span >{}

        }

        

        @MyAnnotation(value1=MyAnnotation.MyEnum.A, value2 = “xyz”)
        public void myMethod()
        <span >{
        }</span></span></span></span></span></div>

        @MyAnnotation // 错误的使用

        public class Class1
        <span >{
        @MyAnnotation // 正确的使用

        public void myMethod1() <span >{}

        }</span></span></span></span></div>

        </span></span></div>

        @Retention(RetentionPolicy.CLASS)
        @interface MyAnnotation2 <span >{}

        

        @Retention(RetentionPolicy.RUNTIME)
        @interface MyAnnotation3 <span >{}</span></span></span></div>

        @MyAnnotation
        class Class1
        <span >{
        public void myMethod() <span >{ }

        }</span></span></span></div>

        生成的文档：
        @MyAnnotation // 这行是在加上@Documented后被加上的

        class Class1extends java.lang.Object
        </span></div>

        @MyAnnotation
        public class ParentClass <span >{}

        public class ChildClass extends ParentClass <span >{ }

        

        在以上代码中ChildClass和ParentClass一样都已被MyAnnotation注释了。 </span></span></span></div>

    这个注释是一个标记注释。所谓标记注释，就是在源程序中加入这个标记后，并不影响程序的编译，但有时编译器会显示一些警告信息。 
    
    那么Deprecated注释是什么意思呢？如果你经常使用eclipse等IDE编写java程序时，可能会经常在属性或方法提示中看到这个词。如果某个类成员的提示中出现了个词，就表示这个并不建议使用这个类成员。因为这个类成员在未来的JDK版本中可能被删除。之所以在现在还保留，是因为给那些已经使用了这些类成员的程序一个缓冲期。如果现在就去了，那么这些程序就无法在新的编译器中编译了。 

    说到这，可能你已经猜出来了。Deprecated注释一定和这些类成员有关。说得对！使用Deprecated标注一个类成员后，这个类成员在显示上就会有一些变化。在eclipse中非常明显。让我们看看图1有哪些变化。 


图1 加上@Deprecated后的类成员在eclipse中的变化

    从上图可以看出，有三个地方发生的变化。红色框里面的是变化的部分。 
    1. 方法定义处 
    2. 方法引用处 
    3. 显示的成员列表中 

    发生这些变化并不会影响编译，只是提醒一下程序员，这个方法以后是要被删除的，最好别用。 

    Deprecated注释还有一个作用。就是如果一个类从另外一个类继承，并且override被继承类的Deprecated方法，在编译时将会出现一个警告。如test.java的内容如下： 

        }

        

        class Class2 extends Class1
        <span >{
        public void myMethod()<span >{}

        } 

        </span></span></span></span></div>

这是一个类中的方法。编译它，将会得到如下的警告。 

    注意：Testannotation.java 使用了未经检查或不安全的操作。 
    注意：要了解详细信息，请使用 -Xlint:unchecked 重新编译。 

    这两行警告信息表示List类必须使用范型才是安全的，才可以进行类型检查。如果想不显示这个警告信息有两种方法。一个是将这个方法进行如下改写： 

三、如何自定义注释 

    注释的强大之处是它不仅可以使java程序变成自描述的，而且允许程序员自定义注释。注释的定义和接口差不多，只是在interface前面多了一个“@”。 

上面的代码是一个最简单的注释。这个注释没有属性。也可以理解为是一个标记注释。就象Serializable接口一样是一个标记接口，里面未定义任何方法。 

    当然，也可以定义有属性的注释。 

可以按如下格式使用MyAnnotation 

看了上面的代码，大家可能有一个疑问。怎么没有使用value，而直接就写”abc”了。那么”abc”到底传给谁了。其实这里有一个约定。如果没有写属性名的值，而这个注释又有value属性，就将这个值赋给value属性，如果没有，就出现编译错误。 

    除了可以省略属性名，还可以省略属性值。这就是默认值。 

可以直接使用MyAnnotation 

        public void myMethod()
        <span >{
        }</span></div>

        public MyEnum.value1() <span >{}

        public String value2() <span >{}

        }

        

        @MyAnnotation(value1=MyAnnotation.MyEnum.A, value2 = “xyz”)
        public void myMethod()
        <span >{
        }</span></span></span></span></span></div>

        @MyAnnotation // 错误的使用

        public class Class1
        <span >{
        @MyAnnotation // 正确的使用

        public void myMethod1() <span >{}

        }</span></span></span></span></div>

        </span></span></div>

        @Retention(RetentionPolicy.CLASS)
        @interface MyAnnotation2 <span >{}

        

        @Retention(RetentionPolicy.RUNTIME)
        @interface MyAnnotation3 <span >{}</span></span></span></div>

        @MyAnnotation
        class Class1
        <span >{
        public void myMethod() <span >{ }

        }</span></span></span></div>

        生成的文档：
        @MyAnnotation // 这行是在加上@Documented后被加上的

        class Class1extends java.lang.Object
        </span></div>

        @MyAnnotation
        public class ParentClass <span >{}

        public class ChildClass extends ParentClass <span >{ }

        

        在以上代码中ChildClass和ParentClass一样都已被MyAnnotation注释了。 </span></span></span></div>