学习注解s

注解

注释：给人看，用于提醒程序员
注解：给程序看的，它拥有一定的功能
注解是JDK1.5之后才有
注解的格式：@关键词
注解的位置：类上、方法上、属性上

注解的分类

1、编译检查

如果写法错误，则编译报错

1 @Override : 表明该方法重写的父类的方法
2 @Deprecated ： 标记过时
3 @SuppressWarnings("serial") ：  抑制警告

2、文档

通过注解生成文档

/**
 * 
 * @author 老王 
 * @version 1.0
 * 
 *
 */
public  class Father {
   
	/**
	 * 
	 * @param a  加数1
	 * @param b  加数2
	 * @return   两数之和
	 */
	public int add(int a,int b){
   
		return a+b;
	};
}

通过CMD命令生成文档API
	javadoc xx.java
	javadoc *.java
步骤：
	1 创建文件夹，把需要生成文档的java文件放进该文件夹中
	2 通过cmd切换到当前文件夹，最后通过javadoc命令生成文档

3、自定义

//语法:新建自定义注解
public @interface 注解名{

	方法列表;
}
注解的底层是一个接口,它继承了Annotation接口
通过反编译证明：
1  javac xx.java
2  javap xx.class
public interface MyAnno extends java.lang.annotation.Annotation {
}

注解的属性

1 这里的属性实际上指的是接口中的方法的声明
2 方法必须有返回值
3 返回值类型也是有规定的：
	3.1  8大基本数据类型
	3.2  String
	3.3  枚举
	3.4  注解
	3.5  返回以上类型的数组形式

使用自定义注解

语法：在类上、方法上、属性上都能使用

如果该注解没有任何属性:@注解名
如果该注解有任何属性: @注解名(属性1=值1,属性2=值2.....)

public @interface  MyAnno {
   
	public  int  x1(); // 八大基本类型
	public  String  x2();//String类型
	public  Stu  x3();//枚举类型
	public  MyAnno2  x4();//注解类型
	public  int[]  x5();//以上类型的数组类型
}
//使用:
@MyAnno(x1=3,x2="abc",x3=Stu.jack,x4=@MyAnno2,x5={
   1,2,3})
public class User {
   }

我们可以把定义在注解中的属性当作形参
而使用注解时传递的值当作实参

关于属性的特殊案例

1 如果数组中的元素只有一个，则可以省去{}
2 我们可以给属性设置默认值，设置默认值后，在使用注解是可以不用管该属性
3 如果属性名是value，并且该注解只有这一个属性或者该注解的其他属性都有默认值，则在使用注解时可以省去value

//定义
public @interface  MyAnno {
   
	public  String[]  value();
}
//使用：
@MyAnno(value={
   "abc"})
public class User {
   }
//简写：
@MyAnno("abc")
public class User {
   }

元注解

用于约束注解的注解
位置࿱