Java注解Annotation

导语

这里只是简单讲解一下Annotation，以后讲到反射的时候，再细讲如何自定义Annotation。

主要内容

• Annotation的作用
• 三种内置的Annotation的使用

具体内容

对于软件程序的开实际上经过了三个发展过程：

• 第一个过程：将所有与配置相关的内容直接写到代码之中。
• 第二个过程：将配置与程序代码独立，程序在运行的时候根据配置文件进行操作。
  • 最严重的问题：一个项目里面配置文件过多，根本就无法查询错误。
• 第三个过程：配置信息对用户而言无用，而且胡乱的修改还会导致程序的错误，所以可以将配置信息写回到程序里面，但是利用一些明显的标记来区分配置信息与程序。

Annotation是JDK1.5最大的特色，利用注解的形式来实现程序的不同功能实现。
在JavaSE里面支持自定义Annotation的开发，并且摘借了三个最为常用的基础Annotation：@Override、@Deprecated、@SuppressWamings。

准确的覆写：@Override

如果在输出对象的时候希望其可以返回需要的内容，那么一定要进行toString()方法的覆写。

范例：使用@Override

public class Book {
    @Override
    public String toString() {
        return "这是一本书！";
    }
}

错误代码

public class Book {
    @Override
    public String tostring() {  // 因为S变为小写，不是覆写，所以使用@Override会报错
        return "这是一本书！";
    }
}

所以此时为了告诉编译器，toString()应该是覆写的方法，那么就可以加上“@Override”，明确告诉编译器，这个方法是覆写，如果不是就会报错。

声明过期操作@Deprecated

比如说，现在有一个类中有一个fun()方法，后来发现fun方法有些不足，这时候开发者有两个选择：

• 选择一：直接取消掉fun()方法，同时给出新的fun2方法。
• 选择二：在新版本的开发包里面保存fun()方法，但是通过某途径告诉用户fun()方法有些问题，并提供fun2()方法供开发者使用。

这个时候可以使用“@Deprecated”来进行声明。

范例：使用@Deprecated

public class Book {
    @Deprecated
    public void fun() {}
}

public class TestDemo {
    public static void main(String args[]) {
        Book book = new Book();
        book.fun();
    }
}

在编译器中，在fun()方法会被中划线标记。
利用此操作可以很好的实现方法功能的新旧交替。

压制警告：@SuppressWamings

可以压制多个警告。

范例：观察警告

public class Book {
    private T title;
    public void setTitle(T title) {
        this.title = title;
    }
}

public class TestDemo {
    public static void main(String args[]) {
        Book book = new Book();  // 这里有警告
        book.setTitle("Hello");  // 这里有警告
    }
}

如果现在是开发者故意留下的这个警告信息，但是又不希望总是提示警告，就可以选择压制警告。

范例：压制警告

public class Book {
    private T title;
    public void setTitle(T title) {
        this.title = title;
    }
}

public class TestDemo {
    @SuppressWarnings("rawtypes", "unchecked")
    public static void main(String args[]) {
        Book book = new Book();  // 这里有警告
        book.setTitle("Hello");  // 这里有警告
    }
}

现在相当于取消了警告的提示信息。

总结

清楚三个Java的Annotation作用。

更多内容戳这里（整理好的各种文集）