Java自定義注解

Java自定義注解

 

前言：這兩天看了一下Java自定義注解的內容，然后按照我自己的理解寫了兩份代碼，還挺有趣的，本文包括三個部分：注解的基礎、通過注解進行賦值（結合了工廠方法模式）、通過注解進行校驗。

 

一、注解的基礎

1.注解的定義：Java文件叫做Annotation，用@interface表示。

2.元注解：@interface上面按需要注解上一些東西，包括@Retention、@Target、@Document、@Inherited四種。

3.注解的保留策略：

　　@Retention(RetentionPolicy.SOURCE)   // 注解僅存在於源碼中，在class字節碼文件中不包含

　　@Retention(RetentionPolicy.CLASS)     // 默認的保留策略，注解會在class字節碼文件中存在，但運行時無法獲得

　　@Retention(RetentionPolicy.RUNTIME)  // 注解會在class字節碼文件中存在，在運行時可以通過反射獲取到

4.注解的作用目標：

　　@Target(ElementType.TYPE)                      // 接口、類、枚舉、注解

　　@Target(ElementType.FIELD)                     // 字段、枚舉的常量

　　@Target(ElementType.METHOD)                 // 方法

　　@Target(ElementType.PARAMETER)            // 方法參數

　　@Target(ElementType.CONSTRUCTOR)       // 構造函數

　　@Target(ElementType.LOCAL_VARIABLE)   // 局部變量

　　@Target(ElementType.ANNOTATION_TYPE) // 注解

　　@Target(ElementType.PACKAGE)               // 包

5.注解包含在javadoc中：

　　@Documented

6.注解可以被繼承：

　　@Inherited

7.注解解析器：用來解析自定義注解。

 

二、通過注解進行賦值（結合了工廠方法模式）

　　1.自定義注解

package annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Inherited
@Target({ ElementType.FIELD, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
public @interface Init
{
    public String value() default "";
}

　　2.在數據模型使用注解

package model;

import annotation.Init;

public class User
{
    private String name;
    private String age;

    public String getName()
    {
        return name;
    }

    @Init(value = "liang")
    public void setName(String name)
    {
        this.name = name;
    }

    public String getAge()
    {
        return age;
    }

    @Init(value = "23")
    public void setAge(String age)
    {
        this.age = age;
    }
}

　　3.用“構造工廠”充當“注解解析器”

package factory;

import java.lang.reflect.Method;

import annotation.Init;
import model.User;

public class UserFactory
{
    public static User create()
    {
        User user = new User();

        // 獲取User類中所有的方法（getDeclaredMethods也行）
        Method[] methods = User.class.getMethods();

        try
        {
            for (Method method : methods)
            {
                // 如果此方法有注解，就把注解里面的數據賦值到user對象
                if (method.isAnnotationPresent(Init.class))
                {
                    Init init = method.getAnnotation(Init.class);
                    method.invoke(user, init.value());
                }
            }
        }
        catch (Exception e)
        {
            e.printStackTrace();
            return null;
        }

        return user;
    }
}

　　4.運行的代碼

package app;

import java.lang.reflect.InvocationTargetException;

import factory.UserFactory;
import model.User;

public class Test
{
    public static void main(String[] args) throws IllegalAccessException,
            IllegalArgumentException, InvocationTargetException
    {
        User user = UserFactory.create();

        System.out.println(user.getName());
        System.out.println(user.getAge());
    }
}

　　5.運行結果

liang
23

 

三、通過注解進行校驗

　　1.自定義注解

package annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Inherited
@Target({ ElementType.FIELD, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
public @interface Validate
{
    public int min() default 1;

    public int max() default 10;

    public boolean isNotNull() default true;
}

　　2.在數據模型使用注解

package model;

import annotation.Validate;

public class User
{
    @Validate(min = 2, max = 5)
    private String name;

    @Validate(isNotNull = false)
    private String age;

    public String getName()
    {
        return name;
    }

    public void setName(String name)
    {
        this.name = name;
    }

    public String getAge()
    {
        return age;
    }

    public void setAge(String age)
    {
        this.age = age;
    }
}

　　3.注解解析器

package check;

import java.lang.reflect.Field;

import annotation.Validate;
import model.User;

public class UserCheck
{
    public static boolean check(User user)
    {
        if (user == null)
        {
            System.out.println("！！校驗對象為空！！");
            return false;
        }

        // 獲取User類的所有屬性（如果使用getFields，就無法獲取到private的屬性）
        Field[] fields = User.class.getDeclaredFields();

        for (Field field : fields)
        {
            // 如果屬性有注解，就進行校驗
            if (field.isAnnotationPresent(Validate.class))
            {
                Validate validate = field.getAnnotation(Validate.class);
                if (field.getName().equals("age"))
                {
                    if (user.getAge() == null)
                    {
                        if (validate.isNotNull())
                        {
                            System.out.println("！！年齡可空校驗不通過：不可為空！！");
                            return false;
                        }
                        else
                        {
                            System.out.println("年齡可空校驗通過：可以為空");
                            continue;
                        }
                    }
                    else
                    {
                        System.out.println("年齡可空校驗通過");
                    }

                    if (user.getAge().length() < validate.min())
                    {
                        System.out.println("！！年齡最小長度校驗不通過！！");
                        return false;
                    }
                    else
                    {
                        System.out.println("年齡最小長度校驗通過");
                    }

                    if (user.getAge().length() > validate.max())
                    {
                        System.out.println("！！年齡最大長度校驗不通過！！");
                        return false;
                    }
                    else
                    {
                        System.out.println("年齡最大長度校驗通過");
                    }
                }
                if (field.getName().equals("name"))
                {
                    if (user.getName() == null)
                    {
                        if (validate.isNotNull())
                        {
                            System.out.println("！！名字可空校驗不通過：不可為空！！");
                            return false;
                        }
                        else
                        {
                            System.out.println("名字可空校驗通過：可以為空");
                            continue;
                        }
                    }
                    else
                    {
                        System.out.println("名字可空校驗通過");
                    }

                    if (user.getName().length() < validate.min())
                    {
                        System.out.println("！！名字最小長度校驗不通過！！");
                        return false;
                    }
                    else
                    {
                        System.out.println("名字最小長度校驗通過");
                    }

                    if (user.getName().length() > validate.max())
                    {
                        System.out.println("！！名字最大長度校驗不通過！！");
                        return false;
                    }
                    else
                    {
                        System.out.println("名字最大長度校驗通過");
                    }
                }
            }
        }

        return true;
    }
}

　　4.運行的代碼

package app;

import check.UserCheck;
import model.User;

public class Test
{
    public static void main(String[] args)
    {
        User user = new User();
        
        user.setName("liang");
        user.setAge("1");
        
        System.out.println(UserCheck.check(user));
    }
}

　　5.運行結果

名字可空校驗通過
名字最小長度校驗通過
名字最大長度校驗通過
年齡可空校驗通過
年齡最小長度校驗通過
年齡最大長度校驗通過
true