【菜鸟学习笔记】Java/Spring注解

看代码的时候经常遇到一些注解，之前没见过或者不大清楚具体作用。查了一下意思和用法之后，整理记录在这篇笔记里面，以后遇到新的不熟悉的注解，也会整理到一起。

1. @RestController

   之前都是用的@Controller，这两个都是注解Controller的，查了一下两者区别。
   简单说来，@RestController = @ResponseBody ＋ @Controller。
   啥意思呢，之前用@Controller，可以配合视图解析器InternalResourceViewResolver指定返回页面。但是如果用json，xml或自定义mediaType内容返回则需要在返回类型前加上@ResponseBody。但是如果用的是@RestController注解，则不需要多此一举了。相应的，它却不能指定返回页面了。

2. @SuppressWarnings

   这是Java的一个注解，作用是取消警告，啥意思呢，写完代码，编译器会先帮你检查一下，对于一些他觉得是问题的地方会给予一些警告信息，如果你确定一些地方不是问题，则可以加上这个注解，告诉编译器对这个警告保持沉默。
   一般常见到的有：
   @SuppressWarnings(“unused”),@SuppressWarnings(“unchecked”),@SuppressWarnings(“rawtypes”)等。
   如果要取消多个类型的怎么写呢？括号里写多个就行了。比如：
   @SuppressWarnings(“unused”,”unchecked”)。
   那如果所有警告都不想看见呢？
   @SuppressWarnings(“all”)就搞定了。

   以下是查到的一些@SuppressWarnings可以取消的警告：

   关键字	用途	解释
   all	to suppress all warnings	抑制所有警告
   boxing	to suppress warnings relative to boxing/unboxing operations	抑制装箱、拆箱操作时候的警告
   cast	to suppress warnings relative to cast operations	抑制映射相关的警告
   dep-ann	to suppress warnings relative to deprecated annotation	抑制启用注释的警告
   deprecation	to suppress warnings relative to deprecation	抑制过期方法警告
   fallthrough	to suppress warnings relative to missing breaks in switch statements	抑制确在switch中缺失breaks的警告
   finally	to suppress warnings relative to finally block that don’t return	抑制finally模块没有返回的警告
   hiding	to suppress warnings relative to locals that hide variable	忽略隐藏变量的局部变量
   incomplete-switch	to suppress warnings relative to missing entries in a switch statement (enum case)	忽略没有完整的switch语句
   nls	to suppress warnings relative to non-nls string literals	忽略非nls格式的字符
   null	to suppress warnings relative to null analysis	忽略对null的操作
   rawtypes	to suppress warnings relative to un-specific types when using generics on class params	使用generics时忽略没有指定相应的类型
   restriction	to suppress warnings relative to usage of discouraged or forbidden references	忽略不鼓励或禁止使用的引用
   serial	to suppress warnings relative to missing serialVersionUID field for a serializable class	忽略在serializable类中没有声明serialVersionUID变量
   static-access	to suppress warnings relative to incorrect static access	抑制不正确的静态访问方式警告
   synthetic-access	to suppress warnings relative to unoptimized access from inner classes	抑制子类没有按最优方法访问内部类的警告
   unchecked	to suppress warnings relative to unchecked operations	抑制没有进行类型检查操作的警告
   unqualified-field-access	to suppress warnings relative to field access unqualified	抑制没有权限访问的域的警告
   unused	to suppress warnings relative to unused code	抑制没被使用过的代码的警告

3. @Retention
   用来说明该注解类的生命周期。它有以下三个参数：

   RetentionPolicy.SOURCE	注解只保留在源文件中
   RetentionPolicy.CLASS	注解保留在class文件中，在加载到JVM虚拟机时丢弃
   RetentionPolicy.RUNTIME	注解保留在程序运行期间，此时可以通过反射获得定义在某个类上的所有注解

4. @Target
   用来说明该注解可以被声明在那些元素之前，他也可以有参数。如下：

   ElementType.TYPE	说明该注解只能被声明在一个类前
   ElementType.FIELD	说明该注解只能被声明在一个类的字段前
   ElementType.METHOD	说明该注解只能被声明在一个类的方法前
   ElementType.PARAMETER	说明该注解只能被声明在一个方法参数前
   ElementType.CONSTRUCTOR	说明该注解只能声明在一个类的构造方法前
   ElementType.LOCAL_VARIABLE	说明该注解只能声明在一个局部变量前
   ElementType.ANNOTATION_TYPE	说明该注解只能声明在一个注解类型前
   ElementType.PACKAGE	说明该注解只能声明在一个包名前