【09章Java注解】让你全面认识这未来潜力巨大的「注解」

❤写在前面
❤博客主页：努力的小鳴人
❤系列专栏：JavaSE超详总结😋
❤欢迎小伙伴们，点赞👍关注🔎收藏🍔一起学习！
❤如有错误的地方，还请小伙伴们指正！🌹

🔥系列传送门：
【08章Java枚举类】简单易懂的enum
【07章Java常用类】盘点 Java常用类
【06章多线程】Java语言的重头戏【热榜】
【05章Java异常处理】一篇短文教你玩转Java异常处理【热榜】
【附章2Java面向对象编程】盘点关键字详解 this、super、final【热榜】
【04章Java面向对象编程(下)】面向对象编程的必杀技【热榜】
【04章Java面向对象编程(中)】解密 继承性和多态性【热榜】
【04章Java面向对象编程(上)】万事万物皆对象的初体验【全站热榜第二】
更多请看>>>Java基础学习😋

---

一、注解

Annotation
未来的开发模式都是基于注解的

🔥注解概述

注解其实就是代码里的特殊标记，
这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理

1. 注解像修饰符一样被使用, 可用于修饰包,类, 构造器, 方法, 成员变量, 参数, 局部变量的声明
2. 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等
3. 在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等

框架 = 注解 + 反射 + 设计模式

二、常见注解

🔥生成文档相关的注解

●@author 标明开发该类模块的作者，多个作者之间使用,分割
●@version 标明该类模块的版本
●@see 参考转向，也就是相关主题
●@since 从哪个版本开始增加的
●@param 对方法中某参数的说明，如果没有参数就不能写
 格式要求：@param 形参名 形参类型 形参说明
●@return 对方法返回值的说明，如果方法的返回值类型是void就不能写
 格式要求：@return 返回值类型 返回值说明
●@exception 对方法可能抛出的异常进行说明 ，如果方法没有用throws显式抛出的异常就不能写
 格式要求：@exception 异常类型 异常说明
代码：

package com.annotation.javadoc;
/**
* @author shkstart
* @version 1.0
* @see Math.java
*/
public class JavadocTest {
		/**
		* 程序的主方法，程序的入口
		* @param args String[] 命令行参数
		*/
		public static void main(String[] args) {
		}
		/**
		* 求圆面积的方法
		* @param radius double 半径值
		* @return double 圆的面积
		*/
		public static double getArea(double radius){
		return Math.PI * radius * radius;
	}
}

🔥在编译时进行格式检查

JDK内置的三个基本注解

1. @Override: 限定重写父类方法, 该注解只能用于方法
2. @Deprecated: 表示所修饰的元素(类, 方法等)已过时，通常是因所修饰结构危险或有更好的选择
3. @SuppressWarnings: 抑制编译器警告

package com.annotation.javadoc;
public class AnnotationTest{
		public static void main(String[] args) {
			@SuppressWarnings("unused")
			int a = 10;
		}
		@Deprecated
		public void print(){
			System.out.println("过时的方法");
		}
		@Override
		public String toString() {
		return "重写的toString方法()";
	}
}

🔥跟踪代码依赖性，实现替代配置文件功能

●Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署
例：

@WebServlet("/login")

●spring框架中关于“事务”的管理

@Transactional(propagation=Propagation.REQUIRES_NEW,
				isolation=Isolation.READ_COMMITTED,readOnly=false,timeout=3)
		public void buyBook(String username, String isbn) {
		//1.查询书的单价
		int price = bookShopDao.findBookPriceByIsbn(isbn);
		//2. 更新库存
		bookShopDao.updateBookStock(isbn);
		//3. 更新用户的余额
		bookShopDao.updateUserAccount(username, price);
}

三、自定义注解

1. 自定义需使用 @interface 关键字
2. 自动继承了java.lang.annotation.Annotation接口
3. 成员变量在 Annotation 定义中以无参数方法的形式来声明
   其方法名和返回值定义了该成员的名字和类型，称为配置参数
   类型只能是八种基本数据类型、String、Class、enum、Annotation、以上所有类型的数组
4. 定义 Annotation 的成员变量时可为其指定初始值, 初始值可使用default 关键字
5. 如果定义注解含有配置参数，那么使用时必须指定参数值，除非它有默认值
   格式是“参数名 = 参数值”，若只一个参数成员，且名称为value

@MyAnnotation(value="努力的小鸣人")
public class MyAnnotationTest {
		public static void main(String[] args) {
		Class clazz = MyAnnotationTest.class;
		Annotation a = clazz.getAnnotation(MyAnnotation.class);
		MyAnnotation m = (MyAnnotation) a;
		String info = m.value();
		System.out.println(info);
	}
}
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@interface MyAnnotation{
		String value() default "xiaomingren";
}

四、元注解

JDK 的元注解用于修饰其他注解定义
四个元注解为：
●Retention
●Target
●Documented
●Inherited

👌Retention

1.用于指定该 Annotation 的生命周期
2. @Rentention 包含一个 RetentionPolicy 类型的成员变量
3. 使用@Rentention 时必须为该 value 成员变量指定值:
●RetentionPolicy.SOURCE:在源文件中有效，编译器直接丢弃这种策略的注释
●RetentionPolicy.CLASS:在class文件中有效， 当运行 Java 程序时, JVM不会保留注解，为默认值
●RetentionPolicy.RUNTIME:在运行时有效，当运行 Java 程序时, JVM 会保留注释。程序可以通过反射获取该注释

@Retention(RetentionPolicy.SOURCE)
@interface MyAnnotation{ }

👌Target

1. 用于指定被修饰的 Annotation 能用于修饰哪些程序元素
2. @Target 也包含一个名为 value 的成员变量
   

👌Documented

1. 用于指定被该元 Annotation 修饰的 Annotation 类将被javadoc 工具提取成文档
2. 默认情况下，javadoc是不包括注解的
3. 定义为Documented的注解必须设置 Retention值为 RUNTIME

👌Inherited

1. 所修饰的 Annotation 将具有继承性
2. 其子类也自动具有该注解

🎁总结：注解会让人能读懂别人写的代码，特别是框架相关代码，会用自定义注解解决问题就更厉害了
👌 作者算是一名Java初学者，文章如有错误，欢迎评论私信指正，一起学习~~
😊如果文章对小伙伴们来说有用的话，点赞👍关注🔎收藏🍔就是我的最大动力！
🚩不积跬步，无以至千里，书接下回，欢迎再见🌹