Home > Java > javaTutorial > body text

Introduction to the definition and use of Java annotations (code examples)

不言
Release: 2019-02-21 14:41:00
forward
2518 people have browsed it

This article brings you the definition and use of Java annotations (code examples). It has certain reference value. Friends in need can refer to it. I hope it will be helpful to you.

Java annotations are used a lot in actual projects, especially after using Spring.

This article will introduce the syntax of Java annotations and examples of using annotations in Spring.

Syntax of annotations

Examples of annotations

Take the @Test annotation in Junit as an example

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test {
    long timeout() default 0L;
}
Copy after login

You can see the @Test annotation There are two annotations @Target() and @Retention().
This kind of annotation that annotates annotations is called meta-annotation.
It has the same meaning as the data that declares the data, which is called metadata. The format of the annotation after

is

修饰符 @interface 注解名 {   
    注解元素的声明1 
    注解元素的声明2   
}
Copy after login

The element of the annotation has two forms

type elementName();
type elementName() default value;  // 带默认值
Copy after login

Common meta-annotations

@TargetAnnotation

@Target annotation is used to limit which items the annotation can be applied to. Annotations without @Target can be applied to on any item.

You can see all items accepted by @Target

    # in the
  • java.lang.annotation.ElementType

    class ##TYPE Use

  • #FIELD on [Class, Interface, Annotation] Use ## on [Field, Enumeration Constant]

  • #METHOD

    Use

  • ## on [Method] Use
  • ## on [Parameter]

    #CONSTRUCTOR

    Use on [Constructor]
  • ##LOCAL_VARIABLE Use on [Local Variable]

  • ANNOTATION_TYPE Use

  • on [Annotation] Use on [Package]

  • TYPE_PARAMETER Introduced in Java 1.8 on [type parameters]

  • ##TYPE_USE

    on [any declared type Where] using Java 1.8, the

  • #@Test

    annotation is only allowed to be used on methods. <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">@Target(ElementType.METHOD) public @interface Test { ... }</pre><div class="contentsignin">Copy after login</div></div>If you want to support multiple items, pass in multiple values.

    @Target({ElementType.TYPE, ElementType.METHOD})
    public @interface MyAnnotation { ... }
    Copy after login
  • In addition, meta-annotations are also annotations and conform to the syntax of annotations, such as
@Target

annotations. @Target(ElementType.ANNOTATION_TYPE)

Indicates that the

@Target

annotation can only be used on annotations.

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
    ElementType[] value();
}
Copy after login
@Retention
Annotation@RetentionSpecifies how long the annotation should be retained. The default is RetentionPolicy.CLASS

. You can see all items in java.lang.annotation.RetentionPolicy

SOURCE
is not included in the class file

  • CLASS

    Contained in the class file, the virtual machine is not loaded

  • RUNTIME

    Contained in the class file, loaded by the virtual machine, you can use the reflection API to get the

  • @Test

    annotation will be loaded into the virtual machine, you can get it through the code <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">@Retention(RetentionPolicy.RUNTIME) public @interface Test { ... }</pre><div class="contentsignin">Copy after login</div></div>

    @Documented
  • Annotation

is mainly used for archiving tool identification. Annotated elements can be documented using Javadoc or similar tools.

@InheritedAnnotation

Added the annotation of the @Inherited annotation, the subclasses of the annotated class will also have this annotation

Annotation<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Inherited public @interface MyAnnotation { ... }</pre><div class="contentsignin">Copy after login</div></div>Parent class

@MyAnnotation 
class Parent { ... }
Copy after login

SubclassChild will add

@MyAnnotation

to

Parent

Inherited

class Child extends Parent { ... }
Copy after login

@RepeatableAnnotationsThe annotations introduced in Java 1.8 mark the annotations as reusable. Note 1

public @interface MyAnnotations {   
    MyAnnotation[] value();   
}
Copy after login

Note 2<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">@Repeatable(MyAnnotations.class) public @interface MyAnnotation {        int value(); }</pre><div class="contentsignin">Copy after login</div></div>Used when using

@Repeatable()

@MyAnnotation(1)
@MyAnnotation(2)
@MyAnnotation(3)
public class MyTest { ... }
Copy after login

Not used## When using #@Repeatable()

,

@MyAnnotation

remove

@Repeatablemeta-annotation

@MyAnnotations({
    @MyAnnotation(1), 
    @MyAnnotation(2),
    @MyAnnotation(3)})
public class MyTest { ... }
Copy after login
This annotation is still very useful, making our code more It is much more concise. The

@ComponentScan annotation of Spring also uses this meta-annotation. Types of elements

Supported element types
8 basic data types (byte

,

short

,

char

,
    int
  • ,

    long, float, double, boolean )String

    ##Class
  • enum
  • Annotation type

  • Array (all arrays of the above types)

  • Example
  • Enumeration class

    public enum Status {
        GOOD,
        BAD
    }
    Copy after login
  • Note 1
  • @Target(ElementType.ANNOTATION_TYPE)
    public @interface MyAnnotation1 {
        int val();
    }
    Copy after login

    Note 2

    @Target(ElementType.TYPE)
    public @interface MyAnnotation2 {
        
        boolean boo() default false;
        
        Class<?> cla() default Void.class;
        
        Status enu() default Status.GOOD;
        
        MyAnnotation1 anno() default @MyAnnotation1(val = 1);
        
        String[] arr();
        
    }
    Copy after login
  • When used, elements without default values ​​must pass values
@MyAnnotation2(
        cla = String.class,
        enu = Status.BAD,
        anno = @MyAnnotation1(val = 2),
        arr = {"a", "b"})
public class MyTest { ... }
Copy after login

Java

Built-in annotations

@Override

Annotations

tells the compiler that this is a method that overrides the parent class. If the parent class deletes this method, the subclass will report an error.

@DeprecatedAnnotation

indicates that the annotated element has been deprecated.

@SuppressWarnings

Annotation

Tells the compiler to ignore warnings.

@FunctionalInterface

Annotations

Annotations introduced in Java 1.8. This annotation forces the compiler javac to check whether an interface conforms to the functional interface standard.

特别的注解

有两种比较特别的注解

  • 标记注解 : 注解中没有任何元素,使用时直接是 @XxxAnnotation, 不需要加括号

  • 单值注解 : 注解只有一个元素,且名字为value,使用时直接传值,不需要指定元素名@XxxAnnotation(100)

利用反射获取注解

JavaAnnotatedElement接口中有getAnnotation()等获取注解的方法。
MethodFieldClassPackage等类均实现了这个接口,因此均有获取注解的能力。

例子

注解

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
public @interface MyAnno {   
    String value();   
}
Copy after login

被注解的元素

@MyAnno("class")
public class MyClass {
    
    @MyAnno("feild")
    private String str;
    
    @MyAnno("method")
    public void method() { }
    
}
Copy after login

获取注解

public class Test {
    
    public static void main(String[] args) throws Exception {
    
        MyClass obj = new MyClass();
        Class<?> clazz = obj.getClass();
        
        // 获取对象上的注解
        MyAnno anno = clazz.getAnnotation(MyAnno.class);
        System.out.println(anno.value());
        
        // 获取属性上的注解
        Field field = clazz.getDeclaredField("str");
        anno = field.getAnnotation(MyAnno.class);
        System.out.println(anno.value());
        
        // 获取方法上的注解
        Method method = clazz.getMethod("method");
        anno = method.getAnnotation(MyAnno.class);
        System.out.println(anno.value());
    }
    
}
Copy after login

Spring中使用自定义注解

注解本身不会有任何的作用,需要有其他代码或工具的支持才有用。

需求

设想现有这样的需求,程序需要接收不同的命令CMD
然后根据命令调用不同的处理类Handler
很容易就会想到用Map来存储命令和处理类的映射关系。

由于项目可能是多个成员共同开发,不同成员实现各自负责的命令的处理逻辑。
因此希望开发成员只关注Handler的实现,不需要主动去Map中注册CMDHandler的映射。

最终效果

最终希望看到效果是这样的

@CmdMapping(Cmd.LOGIN)
public class LoginHandler implements ICmdHandler {
    @Override
    public void handle() {
        System.out.println("handle login request");
    }
}

@CmdMapping(Cmd.LOGOUT)
public class LogoutHandler implements ICmdHandler {
    @Override
    public void handle() {
        System.out.println("handle logout request");
    }
}
Copy after login

开发人员增加自己的Handler,只需要创建新的类并注上@CmdMapping(Cmd.Xxx)即可。

具体做法

具体的实现是使用Spring和一个自定义的注解
定义@CmdMapping注解

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Component
public @interface CmdMapping {
    int value();   
}
Copy after login

@CmdMapping中有一个int类型的元素value,用于指定CMD。这里做成一个单值注解。
这里还加了Spring@Component注解,因此注解了@CmdMapping的类也会被Spring创建实例。

然后是CMD接口,存储命令。

public interface Cmd {
    int REGISTER = 1;
    int LOGIN    = 2;
    int LOGOUT   = 3;
}
Copy after login

之后是处理类接口,现实情况接口会复杂得多,这里简化了。

public interface ICmdHandler { 
    void handle();   
}
Copy after login

上边说过,注解本身是不起作用的,需要其他的支持。下边就是让注解生效的部分了。
使用时调用handle()方法即可。

@Component
public class HandlerDispatcherServlet implements 
    InitializingBean, ApplicationContextAware {

    private ApplicationContext context;

    private Map<Integer, ICmdHandler> handlers = new HashMap<>();
    
    public void handle(int cmd) {
        handlers.get(cmd).handle();
    }
    
    public void afterPropertiesSet() {
        
        String[] beanNames = this.context.getBeanNamesForType(Object.class);

        for (String beanName : beanNames) {
            
            if (ScopedProxyUtils.isScopedTarget(beanName)) {
                continue;
            }
            
            Class<?> beanType = this.context.getType(beanName);
            
            if (beanType != null) {
                
                CmdMapping annotation = AnnotatedElementUtils.findMergedAnnotation(
                        beanType, CmdMapping.class);
                
                if(annotation != null) {
                    handlers.put(annotation.value(), (ICmdHandler) context.getBean(beanType));
                }
            }
        }
        
    }

    public void setApplicationContext(ApplicationContext applicationContext)
            throws BeansException {   
        this.context = applicationContext;
    }

}
Copy after login

主要工作都是Spring做,这里只是将实例化后的对象putMap中。

测试代码

@ComponentScan("pers.custom.annotation")
public class Main {

    public static void main(String[] args) {
        
        AnnotationConfigApplicationContext context 
            = new AnnotationConfigApplicationContext(Main.class);
            
        HandlerDispatcherServlet servlet = context.getBean(HandlerDispatcherServlet.class);
        
        servlet.handle(Cmd.REGISTER);
        servlet.handle(Cmd.LOGIN);
        servlet.handle(Cmd.LOGOUT);

        context.close();
    }
}
Copy after login

> 完整项目

总结

可以看到使用注解能够写出很灵活的代码,注解也特别适合做为使用框架的一种方式。
所以学会使用注解还是很有用的,毕竟这对于上手框架或实现自己的框架都是非常重要的知识。

The above is the detailed content of Introduction to the definition and use of Java annotations (code examples). For more information, please follow other related articles on the PHP Chinese website!

Related labels:
source:segmentfault.com
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Popular Tutorials
More>
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template