代码实例
package com.guor.ClientNew;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Retention(RetentionPolicy.RUNTIME)//注解可以保留到程序运行时，加载到JVM中
@Target(ElementType.TYPE)//给一个类型进行注解，比如类、接口、枚举
@Inherited //子类继承父类时，注解会起作用
public @interface Desc {
enum Color {
White, Grayish, Yellow
}
// 默认颜色是白色的
Color c() default Color.White;
}
5、@Repeatable
Repeatable 自然是可重复的意思。@Repeatable 是 Java 1.8 才加进来的，所以算是一个新的特性。
什么样的注解会多次应用呢？通常是注解的值可以同时取多个。
在生活中一个人往往是具有多种身份，如果我把每种身份当成一种注解该如何使用？？？
先声明一个Persons类用来包含所有的身份
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Persons {
Person[] value();
}
这里@Target是声明Persons注解的作用范围，参数ElementType.Type代表可以给一个类型进行注解，比如类，接口，枚举。
@Retention是注解的有效时间，RetentionPolicy.RUNTIME是指程序运行的时候。
Person注解：
@Repeatable(Persons.class)
public @interface Person{
String role() default “”;
}
@Repeatable括号内的就相当于用来保存该注解内容的容器。
声明一个Man类，给该类加上一些身份。
@Person(role=“CEO”)
@Person(role=“husband”)
@Person(role=“father”)
@Person(role=“son”)
public class Man {
String name=“”;
}
在主方法中访问该注解：
public static void main(String[] args) {
Annotation[] annotations = Man.class.getAnnotations();
System.out.println(annotations.length);
Persons p1=(Persons) annotations[0];
for(Person t:p1.value()){
System.out.println(t.role());
}
}
下面的代码结果输出相同，但是可以先判断是否是相应的注解，比较严谨。
if(Man.class.isAnnotationPresent(Persons.class)) {
Persons p2=Man.class.getAnnotation(Persons.class);
for(Person t:p2.value()){
System.out.println(t.role());
}
}
运行结果：
四、注解的属性
注解的属性也叫做成员变量，注解只有成员变量，没有方法。注解的成员变量在注解的定义中以“无参的方法”形式来声明，其方法名定义了该成员变量的名字，其返回值定义了该成员变量的类型。
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
int id();
String msg();
}
上面代码中定义了TestAnnotation这个注解中拥有id和msg两个属性。在使用的时候，我们应该给他们进行赋值。
赋值的方式是在注解的括号内以value=“”形式，多个属性之前用，隔开。
@TestAnnotation(id=3,msg=“hello annotation”)
public class Test {
}
需要注意的是，在注解中定义属性时它的类型必须是 8 种基本数据类型外加 类、接口、注解及它们的数组。
注解中属性可以有默认值，默认值需要用 default 关键值指定。比如：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
public int id() default -1;
public String msg() default “江疏影”;
}
TestAnnotation 中 id 属性默认值为 -1，msg 属性默认值为 江疏影。
它可以这样应用。
@TestAnnotation()
public class Test {}
因为有默认值，所以无需要再在 @TestAnnotation 后面的括号里面进行赋值了，这一步可以省略。
另外，还有一种情况。如果一个注解内仅仅只有一个名字为 value 的属性时，应用这个注解时可以直接接属性值填写到括号内。
public @interface Check {
String value();
}
上面代码中，Check 这个注解只有 value 这个属性。所以可以这样应用。
@Check(“hi”)
int a;
这和下面的效果是一样的
@Check(value=“hi”)
int a;
最后，还需要注意的一种情况是一个注解没有任何属性。比如
public @interface Perform {}
那么在应用这个注解的时候，括号都可以省略。
@Perform
public void testMethod(){}
五、Java预置的注解
学习了上面相关的知识，我们已经可以自己定义一个注解了。其实 Java 语言本身已经提供了几个现成的注解。
1、@Override
这个大家应该很熟悉了，提示子类要复写父类中被 @Override 修饰的方法
2、@Deprecated
加上这个注解之后，表示此方法或类不再建议使用，调用时会出现删除线，但不代表不能用，只是说，不推荐使用，因为有更好的方法可以调用。
那么直接删掉不就完了？
因为在一个项目中，工程比较大，代码比较多，而在后续的开发过程中，可能之前的某个方法实现的并不是很合理，这个时候要重新写一个方法，而之前的方法还不能随便删，因为别的地方可能在调用它，所以加上这个注解，就OK啦！
package com.guor.ClientNew;
import java.util.ArrayList;
import java.util.List;
public class Hero {
@Deprecated
public void say(){
System.out.println(“nothing has to say!”);
}
public void speak(){
System.out.println(“i have a dream!”);
}
public void addItems(String item){
List items = new ArrayList();
items.add(item);
System.out.println("i am "+items);
}
}
3、@SuppressWarnings
阻止警告的意思。
该批注的作用是给编译器一条指令，告诉它对被批注的代码元素内部的某些警告保持静默。
注：这个注解有很多参数，这里就不多做赘述了，如有需要，请自行百度！
4、@SafeVarargs
参数安全类型注解。
它的目的是提醒开发者不要用参数做一些不安全的操作，它的存在会阻止编译器产生unchecked这样的警告。
在声明具有模糊类型（比如：泛型）的可变参数的构造函数或方法时，Java编译器会报unchecked警告。鉴于这种情况，如果程序猿断定声明的构造函数和方法的主体no problem，可使用@SafeVarargs进行标记，这样Java编译器就不会报unchecked警告了！
先看看@SafeVarargs在Java SE中的声明：
package java.lang;
import java.lang.annotation.*;
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.CONSTRUCTOR, ElementType.METHOD})
public @interface SafeVarargs {}
由Java源代码声明我们了解到：@SafeVarargs注解，只能用于标记构造函数和方法，由于保留策略声明为RUNTIME，所以此注解可以在运行时生效。
@SafeVarargs注解，只能用于static或final的方法。
代码实例：
泛型参数的方法，不加注解的情况：
package com.guor.ClientNew;
public class SafeVarargsAnnotation {
private S[] args;
public SafeVarargsAnnotation(S… args){
this.args = args;
}
public void loopPrintArgs(S… args){
for (S arg : args){
System.out.println(arg);
}
}
public final void printSelfArgs(S… args){
for (S arg : this.args) {
System.out.println(arg);
}
}
public static void loopPrintInfo(T… infos){
for(T info:infos){
System.out.println(info);
}
}
public static void main(String[] args) {
SafeVarargsAnnotation.loopPrintInfo(“A”,“B”,“C”);
}
}
注解的正确使用方式：
package com.guor.ClientNew;
public class SafeVarargsAnnotation {
private S[] args;
//构造函数可以使用@SafeVarargs标记
@SafeVarargs
public SafeVarargsAnnotation(S… args){
this.args = args;
}
//此处不能使用@SafeVarargs，因为此方法未声明为static或final方法，
// 如果要抑制unchecked警告，可以使用@SuppressWarnings注解
@SuppressWarnings(“unchecked”)
public void loopPrintArgs(S… args){
for (S arg : args){
System.out.println(arg);
}
}
//final方法可以使用@SafeVarargs标记
@SafeVarargs
public final void printSelfArgs(S… args){
for (S arg : this.args) {
System.out.println(arg);
}
}
//static方法可以使用@SafeVarargs标记
@SafeVarargs
public static void loopPrintInfo(T… infos){
for(T info:infos){
System.out.println(info);
}
}
public static void main(String[] args) {
SafeVarargsAnnotation.loopPrintInfo(“A”,“B”,“C”);
}
}
5、@FunctionalInterface
Java 8为函数式接口引入了一个新注解@FunctionalInterface，主要用于编译级错误检查，加上该注解，当你写的接口不符合函数式接口定义的时候，编译器会报错。
它们主要用在Lambda表达式和方法引用（实际上也可认为是Lambda表达式）上。
如定义了一个函数式接口如下：
@FunctionalInterface
interface GreetingService
{
void sayMessage(String message);
}
那么就可以使用Lambda表达式来表示该接口的一个实现(注：JAVA 8 之前一般是用匿名类实现的)：
GreetingService greetService1 = message -> System.out.println("Hello " + message);
六、注解与反射
1、注解通过反射获取
首先可以通过 Class 对象的 isAnnotationPresent() 方法判断它是否应用了某个注解。
public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {}
2、getAnnotations() 方法
public Annotation[] getAnnotations() {}
前一种方法返回指定类型的注解，后一种方法返回注解到这个元素上的所有注解。
3、代码实例：
① 没加注解的时候：
package com.guor.Annotation;
public class Test {
public static void main(String[] args) {
boolean hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);
if(hasAnnotation){
TestAnnotation testAnnotation = Test.class.getAnnotation(TestAnnotation.class);
System.out.println(“id:”+testAnnotation.id());
System.out.println(“msg:”+testAnnotation.msg());
}
}
}
屁都没有！
② 加上注解
package com.guor.Annotation;
@TestAnnotation
public class Test {
public static void main(String[] args) {
boolean hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);
if(hasAnnotation){
TestAnnotation testAnnotation = Test.class.getAnnotation(TestAnnotation.class);
System.out.println(“id:”+testAnnotation.id());
System.out.println(“msg:”+testAnnotation.msg());
}
}
}
这个正是 TestAnnotation 中 id 和 msg 的默认值。
上面的例子只是检阅出了注解在类上的注解，其实属性、方法上的注解也是一样的。同样还是要假手与反射。
最后：学习总结——MyBtis知识脑图（纯手绘xmind文档）
学完之后，若是想验收效果如何，其实最好的方法就是可自己去总结一下。比如我就会在学习完一个东西之后自己去手绘一份xmind文件的知识梳理大纲脑图，这样也可方便后续的复习，且都是自己的理解，相信随便瞟几眼就能迅速过完整个知识，脑补回来。下方即为我手绘的MyBtis知识脑图，由于是xmind文件，不好上传，所以小编将其以图片形式导出来传在此处，细节方面不是特别清晰。但可给感兴趣的朋友提供完整的MyBtis知识脑图原件（包括上方的面试解析xmind文档）
除此之外，前文所提及的Alibaba珍藏版mybatis手写文档以及一本小小的MyBatis源码分析文档——《MyBatis源码分析》等等相关的学习笔记文档，也皆可分享给认可的朋友！
n hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);
if(hasAnnotation){
TestAnnotation testAnnotation = Test.class.getAnnotation(TestAnnotation.class);
System.out.println(“id:”+testAnnotation.id());
System.out.println(“msg:”+testAnnotation.msg());
}
}
}
这个正是 TestAnnotation 中 id 和 msg 的默认值。
上面的例子只是检阅出了注解在类上的注解，其实属性、方法上的注解也是一样的。同样还是要假手与反射。
最后：学习总结——MyBtis知识脑图（纯手绘xmind文档）
学完之后，若是想验收效果如何，其实最好的方法就是可自己去总结一下。比如我就会在学习完一个东西之后自己去手绘一份xmind文件的知识梳理大纲脑图，这样也可方便后续的复习，且都是自己的理解，相信随便瞟几眼就能迅速过完整个知识，脑补回来。下方即为我手绘的MyBtis知识脑图，由于是xmind文件，不好上传，所以小编将其以图片形式导出来传在此处，细节方面不是特别清晰。但可给感兴趣的朋友提供完整的MyBtis知识脑图原件（包括上方的面试解析xmind文档）
[外链图片转存中…(img-FR1Mr02a-1714511019718)]
除此之外，前文所提及的Alibaba珍藏版mybatis手写文档以及一本小小的MyBatis源码分析文档——《MyBatis源码分析》等等相关的学习笔记文档，也皆可分享给认可的朋友！
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
