Java基础—注解的使用
1、注解的概述:
注解是用来替代配置文件的!你回忆一下,我们以前总是要写一些配置文件,例如web.xml你还记得么?里面要写<servlet>和<servlet-mapping>!谁来读配置文件呢?当然是Tomcat!谁来写配置文件呢?当然是我们来写了!
在Servlet3.0中就可以使用使用注解来代替配置文件,开发者就不用再写配置文件了,而是写注解,然后Tomcat来读取注解。
注解也是类,需要定义了才能使用!
分别在Servlet3.0中有一个注解类为@WebServlet,然后我们就可以在Servlet中使用@WebServlet中使用这个注解了。这个注解就是用来替代<servlet>了。然后Tomcat会通过反射来读取注解中的信息!
小结:
注解的语法:@注解名称
注解的作用:替代xml配置文件!
2、Java中的注解:
- @Overrid:作用在方法上的注解。当方法不是重写父类的方法时会报错;
- @Deprecated:作用在方法上。标记该方法为作废方法(已过时);
- @SuppressWarnings:作用在方法上,压制警告。
- 定义注解类:框架的工作
- 使用注解:我们的工作
- 读取注解(反射):框架的工作
4、定义注解类:
定义注解类不能使用class、enum,也不能使用interface,而是使用@interface。
eg.public @interface MyAnn{}
5、使用注解的目标:
注解可以使用在类(接口或枚举)、属性、方法、构造器、包、参数、局部变量。
eg.
package cn.ywq; @MyAnn public class MyClass { @MyAnn private int a; @MyAnn public MyClass() {} @MyAnn public void fun1() {} @MyAnn public void fun2(@MyAnn String s) { @MyAnn int n = 10; } }
6、注解的属性:
定义注解时,也可以给出属性。
public @interface MyAnn { String value(); int value1(); }
其中value就是属性!你可能会说,它是一个方法!没错,它是一个方法,但我们非要称之为属性,因为把它当做属性更加好理解。
当为注解指定属性后,那么在使用注解时就必须要给属性赋值了:
@MyAnn(value1=100,value="hello") public class MyClass { }
注解的属性还可以有默认值,在使用注解时就可以不给带有默认值的属性赋值了。但没有给出默认值的属性还是要赋值的。
public @interface MyAnn { String value() default "hello world"; int value1(); } @MyAnn(value1=100) public class MyClass { }
在使用注解时,如果只给名为value的属性赋值,那么可以不给出属性的名称直接给出值。
public @interface MyAnn { String value() default "hello world"; int value1() default 100; } @MyAnn() public class MyClass { } @MyAnn(value="hello") public class MyClass { } @MyAnn(value1=200) public class MyClass { } @MyAnn(value="hello",value1=200) public class MyClass { } @MyAnn("hello annocation") public class MyClass { } @MyAnn(300) public class MyClass { } @MyAnn("hello",value1=200) public class MyClass { }
- 注解的属性后面要有一对圆括号,而且圆括号内不能给出东西。就像是无参的方法一样;
- 注解的属性类型只能是:基本类型、String、Enum、Class、注解类型、以上类型的一维数组类型;
- 注解的属性可以有默认值,例如:int a() default 100;
- 数组的属性默认值:int[] arr() default {1,2,3},这里不能使用new int[]{1,2,3}
- 使用注解时,在给数组属性赋值时的格式:@MyAnn(arr={1,2,3});
注解属性的类型
> 8种基本类型
> String
> Enum
> Class
> 注解类型
> 以上类型的一维数组类型
当给数组类型的属性赋值时,若数组元素的个数为1时,可以省略大括号。
eg
@MyAnno1( //相当于一个注解对象 a=100, b="hello", c=MyEnum1.A, d=String.class, e=@MyAnno2(aa=200, bb="world"), 所以此处e也得是一个注解对象 f=100 //省略了大括号 ) public class Demo3 { } @interface MyAnno1 { int a(); String b(); MyEnum1 c(); Class d(); MyAnno2 e(); int[] f(); } @interface MyAnno2{ int aa(); String bb(); }
7、注解的作用目标:
在定义注解时可以限制注解的作用目录!例如让注解只能作用在类和方法上。
这需要使用元注解:@Target。该注解有一个属性value,类型为ElementType[],它是枚举类型。
Target注解的源码如下:
public @interface Target { ElementType[] value(); } public enum ElementType { TYPE,FIELD,METHOD,PARAMETED,CONSTRUCTOR,LOCAL_VARIABLE,ANNOCATION_TYPE,PACKAGE }
在定义注解时,可以使用@Target注解来限制注解的作用目标:
@Target({ElementType.TYPE, ElementType.METHOD}) public @interface MyAnn { }
这样MyAnn就只能作用在类和方法上的!其中ElementType.TYPE表示类和接口。
@MyAnn() public class MyClass { @MyAnn() //报错 private int a; @MyAnn() public void fun() {} }
8、注解的保留策略:
- 注解的保留策略是指,注解是只保留在源代码上,还是保留到class文件上,再或者是类在运行时,可以被类加载器加载到内存中。
- 如果希望注解被反射,那么注解就要保留到运行时,而不是源代码或类文件上。
- 指定注解的保留策略需要使用元注解@Retention,它有一个value属性,类型为RetentionPolicy类型,RetentionPolicy是枚举类型:
public @interface Retention { RetentionPolicy value(); } public enum RetentionPolicy { SOURCE, CLASS, RUNTIME }
下面代码是指定注解保留到运行时
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.TYPE, ElementType.METHOD}) public @interface MyAnn { String value() default "hello"; int value1() default 100; }