Annotation(一)——注解开发介绍

<p>在编程中，一直强调的一点就是注释的编写，注释的规范等等。尤其是越是核心，程序越复杂，逻辑越多的清空下，注释的编写对我们以后的阅读代码，维护软件起着至关重要的作用。一款软件有着好的注释，相当于一个中国人阅读一篇带着汉语翻译的英文文章，其阅读速度是事半功倍的效果。但是今天想要总结的却不是代码中的注释需要注意的问题，而是JDK5.0以后提供的一种新特性。</p>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 一， Annotation(注解)，其实就是对类，方法，属性进行的一种标示，一种注释（注意，这个里注释不是为了让我们开发或维护人员阅读更方便，而是为JVM看呢），通过这些标示，Java虚拟机可以完成这些标示对应的功能。例如使用框架开发时，我们都是通过配置文件进行对象关系组合映射等功能，而通过注解我们可以完全代替配置文件的编写。</p>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;二，Annotation的作用：</p>
	<blockquote dir="ltr">
	<p>编写文档：通过代码里标识的元数据生成文档。</p>
	<p>代码分析：通过代码里标识的元数据对代码进行分析。</p>
	<p>编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查。&nbsp;</p>
	</blockquote>
	<p>&nbsp;</p>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 三，JDK内置的几个常用注解：</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 1，@Override:此注解能够实现编译时检查，当某方法前边添加此注解时，表示此方法为重写父类中的方法。如果此方法不是父类的方法，例如我们本来想重写toString呢，却写成了tostring，则编译无法通过，会提示错误。</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2,@Deprecated:此注解是对不应该，或者将要淘汰的方法进行标识，当编程人员使用时就会给予提示。这个功能在一些基础jar包，规范，框架等的中我们经常可以看到，还保留这些方法是为了兼容前边的一些版本，有一过度的阶段。看下边的这种效果应该都见过：</p>
	<p>&nbsp;</p>
	<p align="center"><img src="http://img.blog.csdn.net/20140327220627250?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbGl1amlhaGFuNjI5NjI5/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt="" /></p>
	<div align="left">&nbsp;</div>
	<p>&nbsp;</p>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; 3，@SuppressWanings:此注解表示去除一些警告，但是里边需要我们制定参数，我们来看一下一些常用的参数：</p>
	<div>
	<p>&nbsp;</p>
	<p>&nbsp;</p>
	<p>&nbsp;</p>
	<p>&nbsp;</p>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
	<table border="1" cellspacing="0" cellpadding="0">
	<tbody>
	<tr>
	<td>参数名称&nbsp;</td>
	<td>&nbsp;
	<p>参数解释</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Unused</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>没有被访问过的元素，去除警告</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Unchecked</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>执行了未检查的转换时的警告，例如当使用集合时没有用泛型来指定集合保存的类型</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Fallthrough</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>当Switch程序块直接通往下一种情况二没有Break时的警告</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Path</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>在类路径，源文件路径等中有不存在的路径时的警告</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Serial</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>当在可序列化的类上缺少serialVersionUID定义时的警告</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>Finally</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>任何finally子句不能正常完成时的警告</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>All</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>关于上边所有情况的警告</p>
	&nbsp;</td>
	</tr>
	</tbody>
	</table>
	</div>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4, 当然我们也可以通过@interface进行自定义注解的定义，我们可以像@SuppressWanings一样向里边添加参数，利用@Target注解来指定其使用范围；@Documented表示此注解是否文档化，就是当我们生成文档时，是否生成进去；@Inherited标注继承，控制此注释是否会影响到子类等等。看一下自定注解的简单例子：</p>
	<blockquote dir="ltr">
	<p>@Target({ElementType.METHOD,ElementType.CONSTRUCTOR})</p>
	<p>@Documented</p>
	<p>@Inherited</p>
	<p>public@interfaceNewAnnotation&nbsp;{</p>
	<p>String value();//在写注解的时候value参数中value=可以省略，其它参数名不能省</p>
	<p>}</p>
	</blockquote>
	<p>&nbsp;&nbsp;</p>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 也就是说后边这几个注解是用来给注解做注解的，也就是注解的注解。当然了这些JDK为我们提供的一些常见的注解。而在实际开发中我们都是通过对类，对方法添加注解来代替配置文件的编程，从而从开发效率上大大提高了。</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;最后看一下通过注解开发和配置文件开发的对比吧：</p>
	<div>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
	<table border="1" cellspacing="0" cellpadding="0">
	<tbody>
	<tr>
	<td>&nbsp;</td>
	<td>&nbsp;
	<p>配置文件的开发</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>注解方式开发</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>优点</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>1，遵循OCP开发原则，修改配置文件即可进行功能扩展</p>
	&nbsp;
	<p>2，集中管理对象和对象之间的组合关系，易于阅读</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>1，开发速度快</p>
	&nbsp;
	<p>2，编译期间容易发现错误的出处</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>缺点</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>1，开发速度相对较慢；</p>
	&nbsp;
	<p>2，编译时很难检查出错误，运行中的错误很难定位，调试难度较大。</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>1，管理分散，基本每个类上都有；</p>
	&nbsp;
	<p>2，扩展功能时，没有遵循OCP开发原则。</p>
	&nbsp;</td>
	</tr>
	<tr>
	<td>&nbsp;
	<p>何时选择</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>如果客户需求进行发生变化，那么采用配置文件的方式会好一些。有利于扩展。</p>
	&nbsp;</td>
	<td>&nbsp;
	<p>如果客户需求不会频繁发生变化。那么使用注解非常好，开发效率快</p>
	&nbsp;</td>
	</tr>
	</tbody>
	</table>
	</div>
	<p>&nbsp;</p>
	<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;总而言之，注解开发是当今的一个开发趋势，因为它的开发效率高，谁都想着在最短的时间内创造最大的价值。但是使用还需慎重考虑，根据实际情况进行选择。这里简单介绍了注解的基础，下边主要将在使用框架开发中，如何利用注解帮助我们提高效率</p>