Sping 的常用注解(@annotation)说明
五种元注解
元注解既是注解在注解方法上的注解,有点绕口,可以简单认为几乎所有注解类会被这5种注解种的N种所修饰
@Target
这是用来标记当前注解的作用范围,java.lang.annotation.ElementType,Target通过ElementType来指定注解可使用范围的枚举集合
取值 |
注解使用范围 |
METHOD |
可用于方法上 |
TYPE |
可用于类或者接口上 |
ANNOTATION_TYPE |
可用于注解类型上(被@interface修饰的类型) |
CONSTRUCTOR |
可用于构造方法上 |
FIELD |
可用于域上 |
LOCAL_VARIABLE |
可用于局部变量上 |
PACKAGE |
用于记录java文件的package信息,这里比较特别 |
PARAMETER |
可用于参数上 |
这里重点说明下:ElementType. PACKAGE。它并不是使用在一般的类中,而是用在固定的文件package-info.java中。这里需要强调命名一定是“package-info”。由于package-info.java并不是一个合法的类,使用eclipse创建类的方式会提示不合法,所以需要以创建文件的方式来创建package-info.java。
例如,定义可使用范围PACKAGE:
@Target({ElementType.PACKAGE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface AsynLog {
}
那么,创建文件:package-info.java,内容如下:
@AsynLog
package org.my.commons.logs.annotation;
@Retention:解释说明注解的存活时间。
它的取值如下:
—— RetentionPolicy.SOURCE 注解只在源码阶段保留,在编译器进行编译时它将被丢弃忽视。
——RetentionPolicy.CLASS 注解只被保留到编译进行的时候,它并不会被加载到 JVM 中。
——RetentionPolicy.RUNTIME 注解可以保留到程序运行的时候,它会被加载进入到 JVM 中,所以在程序运行时可以获取到它们。
@Documented:能够将注解中的元素包含到 Javadoc 中去。
@Inherited:如果一个父类被 @Inherited 注解过的注解进行注解的话,那么如果它的子类没有被任何注解应用的话,那么这个子类就继承了父类的注解。
@Repeatable:注解的值可以同时取多个。
常用注解概述:
·@Service:用于标注业务层组件;
·@Controller:用于标注控制层组件(如Struts中的action);
·@Repository:用于标注数据访问组件,即DAO组件;
·@Component:泛指组件,当组件不好归类的时候,我们可以使用这个注解进行标注;
·@Autowired:默认按类型装配,如果我们想使用按名称装配,可以结合@Qualifier注解一起使用。如下:
@[email protected]("personDaoBean")存在多个实例配合使用;
·@Resource:默认按名称装配,当找不到与名称匹配的bean才会按类型装配;
·@PreDestory:摧毁注解,默认单例,启动就加载;
·@Async:异步方法调用;
·@Configuration:把一个类作为一个IOC容器,它的某个方法头上如果注册了@Bean,就会作为这个spring容器中的Bean;
·@Scope:用于指定scope作用域的(用在类上);
·@PostConstruct:用于指定初始化方法(用在方法上);
·@PreDestory:用于指定销毁方法(用在方法上);
·@DependsOn:定义Bean初始化及销毁时的顺序;
·@Primary:自动装配时当出现多个Bean候选者时,被注解为@Primary的Bean将作为首选者,否则将抛出异常;
·@Lazy(true):表示延迟初始化。
2、@Scope
如上:@Scope可以指定模式,默认还是singleton,即单例模式。“prototype”表示原型,即每次都会new出一个新的出来。
3、@Service
@Service和@Controller、@Repository、@Component其实都是一样的,当你知道这个类具体是干什么的就用具体的注解,如果不知道就用@Component。(概述中已叙述清楚)
另外:这里的@Service,干了两件事:
a.声明该类是一个bean,这样才可以使用@Autowired来自动注入;
b.这个类的bean的id是类名,且首字母小写,你也可以这样做,@Service("这里是你想要的id名")。
4、@[email protected](“指定bean”)配套使用
这种情况是:当出现一个接口有多个实现类时来区分使用,例如下面的AnnotationService,这个接口就有两个实现类。
package com.annotation;
import com.annotation.service.AnnotationService;
@Component
public class QualifierResoutce {
@Autowired
@Qualifier("annotationServiceImpl2")
// @Resource(name="annotationServiceImpl2")
public AnnotationService as;
}
上面的@Component,就是不知道这个类是干嘛的,所以就使用这个注解;
而这两个注解的配套使用就是,自动注入这个属性,并且走的是这个属性(接口)的哪个实现类。
5、@Resource
上面也出现了这个注解,这个注解和@Autowired非常类似。
@Resource的装配顺序:
[email protected]后面没有任何内容,默认通过name属性去匹配bean,找不到再按type去匹配;
b.指定了name或者type则根据指定的类型去匹配bean;
c.指定了name和type则根据指定的name和type去匹配bean,任何一个不匹配都将报错。
@Resource和@Autowired的区别:
[email protected]默认按照byType方式进行bean匹配,@Resource默认按照byName方式进行bean匹配;
[email protected]是Spring的注解,@Resource是J2EE的注解,这个看一下导入注解的时候这两个注解的包名就一清二楚了。
Spring属于第三方的,J2EE是java自己的东西,因此,建议使用@Resource注解,以减少代码和Spring之间的耦合。
6、@Controller
@Controller对应表现层的Bean,也就是Action,当使用这个注解以后,spring容器中就会有一个和这个注解的类名相同(首字母小写)的action;
也可以这样@Controller("ActionName")来指定名字;
同样,@Repository,也是这样的。
自定义注解
自定义注解的属性也叫做成员变量。注解只有成员变量,没有方法。注解的成员变量在注解的定义中以“无形参的方法”形式来声明,其方法名定义了该成员变量的名字,其返回值定义了该成员变量的类型。
格式:
@元注解
public @interface 注解名{
String 属性名() default "属性默认值";
}
自定义一个注解:
@Target({ ElementType.PARAMETER, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AspectAonn {
/**
* 模块
*/
public String title() default "";
}
使用这个注解
@AspectAonn(title="test")
public void dm() {
System.err.println("this service");
}