Java之注解的魔法

最新推荐文章于 2023-02-03 09:09:14 发布
最新推荐文章于 2023-02-03 09:09:14 发布
阅读量1.5k 收藏 48
点赞数 8
分类专栏： # MyBatis3 # Java反射和注解之道 文章标签： Java注解 Java反射 MyBatis3
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hadues/article/details/94833245
版权

Java中注解的魔法

0x01 什么是注解？

在Java功法大全之中，有一种神秘的功法叫做注解。

那么到底什么是注解呢？

先别急，我们先来看一个经典的例子：

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

@ToString
@Setter
@Getter
public class UserInfo {
    private String userId;
    private String userName;
    private Integer userAge;
}

上面这个就是使用Lombok 注解实现省略Getter 和 Setter 以及ToString方法的经典用法。

上述代码编译后就会变成这样

public class UserInfo {
    private String userId;
    private String userName;
    private Integer userAge;

    public UserInfo() {
    }

    public String toString() {
        return "UserInfo(userId=" + this.getUserId() + ", userName=" + this.getUserName() + ", userAge=" + this.getUserAge() + ")";
    }

    public void setUserId(String userId) {
        this.userId = userId;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public void setUserAge(Integer userAge) {
        this.userAge = userAge;
    }

    public String getUserId() {
        return this.userId;
    }

    public String getUserName() {
        return this.userName;
    }

    public Integer getUserAge() {
        return this.userAge;
    }
}

看到没，我们通过以下简单的三个注解，替我们生成了成员属性的Getter 和Setter 以及ToString()方法，大大简化了我们的开发。

  1. @ToString
  2. @Setter
  3. @Getter

好了现在，我们应该也许能回答这个问题了.

1.1 关于注解的一些理解

  1. 所谓注解在我看来无非是简化代码开发或实现特定功能的一种手段
  2. 通过使用注解可以代替我们写一大堆低技术含量、具有重复性的代码
  3. 注解 != 注释 ，注解一般都是具有一定特定功能的，注释只具有描述信息的功能。
  4. 注解处理器通过解析注解将代码和注解合成完整的代码以供JVM加载调用。
    总结起来就是, 注解+ 代码= 完整代码
  5. 当然注解不仅仅只是可以替我们写代码，注解还可以实现更多其他特定的功能。
    比如Spring 扫描到类上如果有@Component注解则自动为其注册为Spring Bean.
    <Bean id="userInfo" class="com.xingyun.model.UserInfo" >
    完整的注解= 注解类+ 注解处理器

在这里插入图片描述

0x02 Java 注解知多少？

2.1 内置注解

在JavaSE 5中内置了三种注解

  • @Override
    • 这种注解的功能是比如你的一个类实现了一个接口，但是没有重写这个方法，编译器就会报错，甚至如果你重写接口的方法名称不匹配，也会报错。
    • 提醒级别是Error
  • @Deprecated
    • 这个注解的功能是当使用了已经过时的一些API 或者方法的时候，编译器就会产生警告信息。
    • 提醒级别是Warn
  • @SuppressWarnings
  • 这个注解的功能是忽略一些警告，关闭不当的编译器警告信息

除此之外，Java 还允许我们自定义一些注解。

2.2 自定义注解

自定义注解需要一些元注解来解释自定义的注解

2.2.1 了解元注解

以下是Java中内置的几种元注解，元注解专职负责注解其他的注解

元注解名称元注解功能描述
@Target表示该注解可以用于什么地方？是作用于类上？方法上？还是字段上？CONSTRUCTOR:构造器的声明；FIELD:域声明；LOCAL_VARIABLE：局部变量声明； METHOD: 方法声明；PACKAGE:包声明；PARAMETER:参数声明；TYPE:类，接口或enum声明
@Retention表示需要在什么级别保存该注解信息。SOURCE :注解将被编译器丢弃，CLASS 注解在class中可用，但是会被JVM 丢弃。RUNTIME级别JVM运行时也保留注解，因此可以通过反射机制读取注解的信息。
@Documented将此注解包含在javadoc 中
@Inherited允许子类继承父类中的注解
  • 比如上面的@Getter 和@Setter 以及@ToString都是SOURCE级别的
  • 因此当编译后，在UserInfo.class文件中将看不到这些注解。
  • 不信的话，我们可以打开lombok 源码可以看到
    @Setter注解类定义如下
import java.lang.annotation.ElementType; import
java.lang.annotation.Retention; import
java.lang.annotation.RetentionPolicy; import
java.lang.annotation.Target;

@Target({ElementType.FIELD, ElementType.TYPE})
@Retention(RetentionPolicy.SOURCE) 
public @interface Setter {
    AccessLevel value() default AccessLevel.PUBLIC;

    Setter.AnyAnnotation[] onMethod() default {};

    Setter.AnyAnnotation[] onParam() default {};

    /** @deprecated */
    @Deprecated
    @Retention(RetentionPolicy.SOURCE)
    @Target({})
    public @interface AnyAnnotation {
    } }
  • @Setter 的定义作用域是成员变量级别 ElementType.FIELD
  • @Setter 的级别是源码级别 Retention(RetentionPolicy.SOURCE)
2.2.2 自定义注解类

也许看后可能还是不太明白，没关系，接下来看我如何自定义一个注解@Column

新建一个类Column.java.内容如下所示：

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

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Column {
    String value() ;
    int length() default 255;
}
  • 纳尼？怎么看起来好像一个接口哈，是的看起来和接口确实挺像的，但是可以有默认值。
  • 通过上面操作，我们定义了一个@Column注解，该注解作用在字段上，在运行时级别生效。
2.2.2.1 注解元素类型限制

也许你会好奇，上面的length()方法为啥我不用Integer类型？
这是因为注解元素仅支持的如下类型，如果使用其他类型就会报错

  • 所有基本类型 int,float,boolean 等
  • String
  • Class
  • enum
  • Annotation
2.2.2.2 注解元素默认值限制
  • 所有的注解元素默认值不能有不确定的值 也就是说注解元素要么使用默认值，要么在使用注解时提供元素的值
  • 对于非基本类型的注解元素，默认值不能设置null 也就是说注解类中不能对于非基本类型的默认值不能使用null，最多只能定义一些特俗的值，比如空字符串“”或者负数
2.2.3 使用自定义注解

定义完刚才的注解后我们就可以这么使用了

import custom.annotion.Column;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

@ToString
@Setter
@Getter
public class UserInfo {
    @Column(value = "USER_ID",length = 1024)
    private String userId;
    @Column(value = "USER_NAME",length = 1024)
    private String userName;
    @Column(value = "USER_AGE",length = 1024)
    private Integer userAge;
}

值得注意的是，这里的@Column 就是我们刚才自定义的注解

2.2.4 编写注解处理器

上面我们已经自定义了一个注解类，也学会如何使用注解了，接下来我们就学习如何让自定义注解生效，毕竟没有生效的类就没有意义。

import custom.annotion.Column;
import model.UserInfo;

import java.lang.reflect.Field;

public class ScanTable {
    public static void main(String[] args) {
        //主方法中调用
        dealWithScan(UserInfo.class);
    }
    private static void dealWithScan(Class<?> mClass){
       //获取该类声明的所有成员变量
       Field[] fieldArray= mClass.getDeclaredFields();
       //遍历所有的成员变量
        for (Field filed:fieldArray
             ) {
             //获取该字段中的自定义注解
            Column column=filed.getAnnotation(Column.class);
            //不为空说明该字段曾经存在
            if(null!=column){
                System.out.println(filed.getName()+"使用了@Column注解,value="+column.value()+",length="+column.length());
            }else{
                System.out.println("没有使用@Column注解");
            }
        }
    }
}

上面代码运行后打印结果如下所示：

userId使用了@Column注解,value=USER_ID,length=1024
userName使用了@Column注解,value=USER_ID,length=1024
userAge使用了@Column注解,value=USER_ID,length=1024

看到没，我们到这里已经成功自定义一个注解并获取到这些注解的值了，
然后只需要在合适的地方加载调用这个方法，就可以获取并根据这些注解信息做一番操作了。

0x03 注解实战开发开源项目SmartMybatis3

我们已经学会了注解的基础用法，现在就来实战做点有意义的事情。

3.1.为什么创建SmartMyBatis3？

大家好,我是星云, 相信大家应该都知道的是MyBatis3 框架是一款优秀的持久层框架，但是我觉得它并不完美。

为什么这么说呢？ 请大家跟我一起来看MyBatis3 现存的几个痛点

3.1.1 痛点一：MyBatis3 使用XML实体类和数据库表字段映射

使用过MyBatis3 的应该都知道,像下面这样，在实际开发中，实体类和数据库表字段一般并不相同，需要一种映射。

为了实现这种映射，我们经常需要定义这样一个resultMap 标签

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.xingyun.sample.model.UserInfoMapper">
  <resultMap type="com.xingyun.sample.model.UserInfo" id="UserInfoResultMap">
       <id column="USER_ID" property="userId"/>
       <result column="USER_NAME" property="userName"/>
      <result column="USER_PASSWORD" property="userPassword"/>
     <result column="USER_AGE" property="userAge"/>
  </resultMap>
  
  <select id="findAllUserInfo" resultMap="UserInfoResultMap">
  </select>
</mapper>

一般来说没什么问题，但是如果实体类字段特别多的话自己写起来就很麻烦。

那么有没有更简便的方法呢？

如果你愿意使用当前类库，那么你只需要添加如下代码

        //打印MyBatis3 XML实体类映射Map
        IDBColumnXMLHandler idbColumnXMLHandler= SmartMyBatis3App.getDBColumnXMLHandler();
        System.out.println("----打印MyBatis3 XML实体类映射Map开始----");
        idbColumnXMLHandler.printDocument(UserInfo.class);
        System.out.println("----打印MyBatis3 XML实体类映射Map结束----");

然后就可以输出我们想要的结果：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.xingyun.sample.model.UserInfoMapper">
  <resultMap type="com.xingyun.sample.model.UserInfo" id="UserInfoResultMap">
      <id column="USER_ID" property="userId"/>
     <result column="USER_NAME" property="userName"/>
     <result column="USER_PASSWORD" property="userPassword"/>
    <result column="USER_AGE" property="userAge"/>
  </resultMap>
</mapper>
3.1.2 痛点二：注解方式返回实体类与数据库字段映射

如果你使用的不是XML配置方式，而是通过注解方式的的话，那么我们可能需要这么做。

    @Select(value = "SELECT * FROM t_user_info")
    @Results({
	@Result(property ="userId",column ="USER_ID",javaType=Integer.class),
	@Result(property ="userName",column ="USER_NAME",javaType=String.class),
	@Result(property ="userPassword",column ="USER_PASSWORD",javaType=String.class),
	@Result(property ="userAge",column ="USER_AGE",javaType=Integer.class),
    })
    JobInfo findUserInfo();

如果字段特别多，那么手写将会很累。

但是如果使用当前的类库那么只需要编写如下代码即可自动生成：

 //打印MyBatis3 注解实体类映射Map
        iDBColumnAnnotationHandler= SmartMyBatis3App.getDBColumnAnnotationHandler();
        String result=iDBColumnAnnotationHandler.autoCreateMappingModel(UserInfo.class);
        System.out.println("----打印MyBatis3 注解实体类映射Map开始----");
        System.out.println(result);
        System.out.println("----打印MyBatis3 注解实体类映射Map结束---");

上述操作的前提需要在实体类中添加一些注解

import com.xingyun.annotations.model.DBColumn;
import com.xingyun.annotations.model.DBConstraints;
import com.xingyun.annotations.model.DBTable;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
import org.springframework.stereotype.Component;

@Getter
@Setter
@ToString
@DBTable(name = "t_user_info")
@Component
public class UserInfo {
    //数据库字段是主键，必须唯一,不可为空
    //列的名称，类型，长度
    @DBConstraints(primaryKey = true,unique = true,allowNull = false)
    @DBColumn(name = "USER_ID",type = "bigint",length = 20,description="用户主键")
    private Integer userId;

    //用户名称
    @DBConstraints(unique = true,allowNull = false)
    @DBColumn(name = "USER_NAME",description="用户名称")
    private String userName;

    //用户密码
    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_PASSWORD",description="用户密码")
    private String userPassword;

    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_AGE",type = "int",length = 20)
    private Integer userAge;
}

3.2 如何集成SmartMyBatis3?

3.2.1 下载依赖

下载地址：https://github.com/geekxingyun/SmartMybatis3/tree/master/lib

3.2.2 添加依赖
方式一：安装到本地仓库（推荐）
  • 双击 install-smart-mybatis3-1.0-RELEASE.bat
  • 或者在*.jar 同级目录下执行maven 安装jar到本地仓库命令
mvn install:install-file -DgroupId=com.xingyun -DartifactId=smart-mybatis3 -Dversion=1.0-RELEASE -Dpackaging=jar -Dfile=smart-mybatis3-1.0-RELEASE.jar

pom.xml中添加依赖

<dependency>
            <groupId>com.xingyun</groupId>
            <artifactId>smart-mybatis3</artifactId>
            <version>1.0-RELEASE</version>
</dependency>
方式二：直接将jar 添加到项目中
3.2.3 开始使用

主要有四大接口

  • IDBTableXMLHandler iDBTableXMLHandler;
    获取@DBTable注解的表名
  • IDBColumnXMLHandler idbColumnXMLHandler;
  • IDBColumnAnnotationHandler iDBColumnAnnotationHandler;
  • ISmartObjectHandler iSmartObjectHandler;
public interface ISmartObjectHandler {

    /**
     * 获取注解映射的数据库表列名
     * @param mClass
     * @return
     */
    List<String> getDBColumnList(Class<?> mClass);
    /**
     * 获取字段名称列表
     * @param mClass
     * @return
     */
    List<String> getFieldNameList(Class<?> mClass);
    /**
     * 获取字段类型带包名列表
     * @param mClass
     * @return
     */
    List<String> getFieldTypeList(Class<?> mClass);
    /**
     * 获取字段类型不带包名列表
     * @param mClass
     * @return
     */
    List<String> getFieldSimpleTypeList(Class<?> mClass);
}
3.2.3.1 在实体类上添加注解
import com.xingyun.annotations.model.DBColumn;
import com.xingyun.annotations.model.DBConstraints;
import com.xingyun.annotations.model.DBTable;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
import org.springframework.stereotype.Component;

@Getter
@Setter
@ToString
@DBTable(name = "t_user_info")
@Component
public class UserInfo {
    //数据库字段是主键，必须唯一,不可为空
    //列的名称，类型，长度
    @DBConstraints(primaryKey = true,unique = true,allowNull = false)
    @DBColumn(name = "USER_ID",type = "bigint",length = 20,description="用户主键")
    private Integer userId;

    //用户名称
    @DBConstraints(unique = true,allowNull = false)
    @DBColumn(name = "USER_NAME",description="用户名称")
    private String userName;

    //用户密码
    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_PASSWORD",description="用户密码")
    private String userPassword;

    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_AGE",type = "int",length = 20)
    private Integer userAge;
}
3.2.3.2 主方法中调用
3.2.3.2.1 获取注解的表名

如果想获取这个注解的值

@DBTable(name = "t_user_info")
public class UserInfo {
}

调用方法如下：

        //打印MyBatis3 映射表名
        IDBTableXMLHandler iDBTableXMLHandler= SmartMyBatis3App.getDBTableXMLHandler();
        String dbTableName=iDBTableXMLHandler.getDBTableName(UserInfo.class);
        System.out.println("----打印MyBatis3 映射表名开始----");
        System.out.println(dbTableName);
        System.out.println("----打印MyBatis3 映射表名结束----");
3.2.3.2.2 获取XML 中的ResultMap

如果想获取类似这样的内容

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.xingyun.sample.model.UserInfoMapper">
  <resultMap type="com.xingyun.sample.model.UserInfo" id="UserInfoResultMap">
      <id column="USER_ID" property="userId"/>
    <result column="USER_NAME" property="userName"/>
    <result column="USER_PASSWORD" property="userPassword"/>
     <result column="USER_AGE" property="userAge"/>
  </resultMap>
</mapper>

那么调用方法如下：

        //打印MyBatis3 XML实体类映射Map
        IDBColumnXMLHandler idbColumnXMLHandler= SmartMyBatis3App.getDBColumnXMLHandler();
        System.out.println("----打印MyBatis3 XML实体类映射Map开始----");
        idbColumnXMLHandler.printDocument(UserInfo.class);
        System.out.println("----打印MyBatis3 XML实体类映射Map结束----");
3.2.3.2.3 获取@Results({}) 注解返回实体类映射

如果想获取类似这样的内容

@Results({
	@Result(property ="userId",column ="USER_ID",javaType=Integer.class),
	@Result(property ="userName",column ="USER_NAME",javaType=String.class),
	@Result(property ="userPassword",column ="USER_PASSWORD",javaType=String.class),
	@Result(property ="userAge",column ="USER_AGE",javaType=Integer.class),
})

那么调用方法如下：

        //打印MyBatis3 注解实体类映射Map
        IDBColumnAnnotationHandler iDBColumnAnnotationHandler= SmartMyBatis3App.getDBColumnAnnotationHandler();
        String result=iDBColumnAnnotationHandler.autoCreateMappingModel(UserInfo.class);
        System.out.println("----打印MyBatis3 注解实体类映射Map开始----");
        System.out.println(result);
        System.out.println("----打印MyBatis3 注解实体类映射Map结束---");
3.2.3.2.4 获取实体类成员属性名称集合

如果想获取类似下面这样的成员属性名称列表

userId
userName
userPassword
userAge

调用方法如下：

 //打印UserInfo 对象字段集合
        ISmartObjectHandler iSmartObjectHandler=SmartMyBatis3App.getSmartObjectHandler();
        List<String> fieldNameList=iSmartObjectHandler.getFieldNameList(UserInfo.class);
        System.out.println("----打印UserInfo 对象字段集合开始---");
        for (String fieldName:fieldNameList
             ) {
            System.out.println(fieldName);
        }
        System.out.println("----打印UserInfo 对象字段集合结束---");

输出结果：

----打印UserInfo 对象字段集合开始---
userId
userName
userPassword
userAge
----打印UserInfo 对象字段集合结束---
3.2.3.2.5 获取解映射表名的字段类型集合
        //打印 注解映射表名的字段类型集合
        List<String> dbColumnNameList=iSmartObjectHandler.getDBColumnList(UserInfo.class);
        System.out.println("----打印 注解映射表名的字段类型集合开始---");
        for (String dbColumnName:dbColumnNameList
        ) {
            System.out.println(dbColumnName);
        }
        System.out.println("----打印 注解映射表名的字段类型集合结束---");

输出结果：

----打印 注解映射表名的字段类型集合开始---
USER_ID
USER_NAME
USER_PASSWORD
USER_AGE
----打印 注解映射表名的字段类型集合结束---
3.2.3.2.6 获取带包名的成员变量类型集合
 //打印 带包名的字段类型集合
        List<String> fieldTypeList=iSmartObjectHandler.getFieldTypeList(UserInfo.class);
        System.out.println("----打印 带包名的字段类型集合开始---");
        for (String fieldType:fieldTypeList
        ) {
            System.out.println(fieldType);
        }
        System.out.println("----打印 带包名的字段类型集合结束---");

输出结果

----打印 带包名的字段类型集合开始---
java.lang.Integer
java.lang.String
java.lang.String
java.lang.Integer
----打印 带包名的字段类型集合结束---
3.2.3.2.7 获取不带包名的成员变量类型集合
  //打印 不带包名的字段类型集合
        List<String> fieldSimpleTypeList=iSmartObjectHandler.getFieldSimpleTypeList(UserInfo.class);
        System.out.println("----打印 不带包名的字段类型集合开始---");
        for (String fieldSimpleType:fieldSimpleTypeList
        ) {
            System.out.println(fieldSimpleType);
        }
        System.out.println("----打印 不带包名的字段类型集合结束---");

输出结果：

----打印 不带包名的字段类型集合开始---
Integer
String
String
Integer
----打印 不带包名的字段类型集合结束---

0x04 关于SmartMybatis3项目实现思路

4.1 定义注解实体类

4.1.1 @DBTable注解实体类

要想实体类和数据库字段之间建立映射，那么我们首先需要针对表名做一个注解

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

/**
 * 自定义表注解
 */
//作用于类级别
@Target({ElementType.TYPE})
//运行时保留该注解
@Retention(RetentionPolicy.RUNTIME)
public @interface DBTable {
    String name() default "";
}

用法的话就是：

@DBTable(name = "t_user_info")
public class UserInfo {
}
4.1.2 @DBColumn

其次最重要的是实体类名称和数据库字段名称做一个映射

因此我们创建注解类DBColumn.java 内容如下：

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

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface DBColumn {
    //数据库字段的名称
    String name() default "";
    //数据库字段的长度
    long length() default 255;
    //数据库字段的类型
    String type() default "varchar";
    //数据库字段说明
    String description() default "";
}

用法就像这样：

public class UserInfo {
    //列的名称，类型，长度
    @DBColumn(name = "USER_ID",type = "bigint",length = 20,description="用户主键")
    private Integer userId;
}
4.1.3 @DBConstraints 注解

我们还需要对字段的一些基本操作制定一些约束，比如是否可以为空，是否是主键之类。

注解类DBConstraints.java内容如下：

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

/**
 * 自定义字段约束注解
 */
//作用于成员变量字段
@Target(ElementType.FIELD)
//运行时保留该注解
@Retention(RetentionPolicy.RUNTIME)
public @interface DBConstraints {
    //是否是主键
    boolean primaryKey() default false;
    //是否唯一
    boolean unique() default false;
    //是否允许为空
    boolean allowNull() default true;
}

用法的话就像这样

public class UserInfo {
    //数据库字段是主键，必须唯一,不可为空
    @DBConstraints(primaryKey = true,unique = true,allowNull = false)
    private Integer userId;
  }

完整的一个测试实体类如下：

import com.xingyun.annotations.model.DBColumn;
import com.xingyun.annotations.model.DBConstraints;
import com.xingyun.annotations.model.DBTable;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
import org.springframework.stereotype.Component;

@Getter
@Setter
@ToString
@DBTable(name = "t_user_info")
@Component
public class UserInfo {
    //数据库字段是主键，必须唯一,不可为空
    //列的名称，类型，长度
    @DBConstraints(primaryKey = true,unique = true,allowNull = false)
    @DBColumn(name = "USER_ID",type = "bigint",length = 20,description="用户主键")
    private Integer userId;

    //用户名称
    @DBConstraints(unique = true,allowNull = false)
    @DBColumn(name = "USER_NAME",description="用户名称")
    private String userName;

    //用户密码
    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_PASSWORD",description="用户密码")
    private String userPassword;

    //默认约束 等价于
//  @DBConstraints(primaryKey = false,unique = false,allowNull = true)
    @DBConstraints
    @DBColumn(name = "USER_AGE",type = "int",length = 20)
    private Integer userAge;
}

4.2 编写注解处理器

上面的注解已经写好了，也学会使用了，但是我们怎么解析我们自定义的注解呢？

4.2.1 表名@DBTable注解的解析

还记得我们之前是这个注解的使用用法吧

@DBTable(name = "t_user_info")
public class UserInfo {
}

想要获取 t_user_info这个值,其实很简单，

我们只需要通过反射如下编码即可：

import com.xingyun.annotations.model.DBTable;
import com.xingyun.annotations.processor.interfaces.IDBTableXMLHandler;

@SuppressWarnings("unused")
public class DBTableXMLHandler implements IDBTableXMLHandler {
    /**
     * 获取注解的数据库表名
     * @param mClass
     * @return
     */
    @Override
    public String getDBTableName(Class<?> mClass){
        DBTable dbTable=mClass.getAnnotation(DBTable.class);
        if(null!=dbTable){
            return dbTable.name();
        }
        return null;
    }
}

在需要的地方我们可以通过这样这个名字：

DBTableXMLHandler  dbTableXMLHandler=new DBTableXMLHandler();
String  tableName=dbTableXMLHandler.getDBTableName(UserInfo.class);

这样就可以获取

  • 值得注意的是，为了让项目更清晰，我这里分层写了一个接口类
  • 让当前类实现IDBTableXMLHandler 接口，
  • 这里你可以暂时忽略implements IDBTableXMLHandler
  • 这里的调用方法可能和Github 上描述的虽然不太一样，但是这样是最直接的用法。
  • 关键点在于我们首先需要反射获取类上的@DBTable 注解对象，然后就很简单了
4.2.2列名@DBColumn注解的解析

还记得刚才我们的注解使用时这样的

public class UserInfo {
    //列的名称，类型，长度
    @DBColumn(name = "USER_ID",type = "bigint",length = 20,description="用户主键")
    private Integer userId;

我们想要获取name的值，还是需要通过反射，不过这次不太一样：

 public List<String> getDBColumnList(Class<?> mClass){
        List<String> dbColumnList=new ArrayList<>();
        //遍历字段集合
        Field[] fieldArray=mClass.getDeclaredFields();
        for (Field field:fieldArray
        ) {
            DBColumn dbColumn=field.getAnnotation(DBColumn.class);
            String dbColumnName;
            if(null!=dbColumn){
                dbColumnName=dbColumn.name();
                dbColumnList.add(dbColumnName);
            }
        }
        return dbColumnList;
    }

这次不同的是这个注解是成员变量上的，因此我们需要通过mClass.getDeclaredFields();获取成员变量数组，然后判断成员变量上面有没有@DBColumn这个注解对象，如果有，那么获取到这个对象，然后赋值即可，

剩下的相信对于聪明的你来说就比较简单了，

我们只需要使用Dom4j API 生成XML 代码片段并格式化输出即可

或者使用StringBuild 拼接内容即可

其他几种解析方式和这个类似就不过做过多重复介绍了。

对了，成员变量字段列表获取的方式也比较简单，这里简单贴一下

    public List<String> getFieldNameList(Class<?> mClass){
        List<String> fieldNameList=new ArrayList<>();
        //遍历字段集合
        Field[] fieldArray=mClass.getDeclaredFields();
        for (Field field:fieldArray
        ) {
            fieldNameList.add(field.getName());
        }
        return fieldNameList;
    }

仓库开源源码

Github 源码地址：SmartMyBatis3

本篇完~

交流及分享，分享才能进步，如果喜欢我的博文，欢迎，点赞、评论或转发。

我是星云，我们下篇再见~

极客星云
关注
专栏目录
一键解锁编程魔法：java插入式注解（AOP）如何让你的代码效率翻倍？
java专栏
05-26 820
🔥关注墨瑾轩，带你探索Java的奥秘🚀🔥超萌技术攻略，轻松晋级编程高手🚀🔥技术宝库已备好，就等你来挖掘🚀🔥订阅墨瑾轩，智趣学习不孤单🚀🔥即刻启航，编程之旅更有趣🚀。
神奇的javascript"魔法代码"
07-18
打开带有几张图片的网页，将这段代码输入到IE浏览器的地址里，敲回车，就会看到页面上的所有图片围成一圈绕着一个点旋转。大家可以亲自体验一下......
LaTeX中的魔法注释
陌雨’的博客
10-31 1457
一般来说，注释中的内容会被 LaTeX\LaTeXLATE​X 忽略，但是有些特殊注释不会被忽略，并起到特殊作用。这些注释即为魔法注释。 在程序第一行加入如下代码， LaTeX\LaTeXLATE​X 会自动为你选择 pdfLaTeX 进行编译。XeLaTeX 同理。 % !TEX program = pdflatex 示例 在加入魔法注释前，编译引擎为 XeLaTeX 加入魔法注释后，编译器自动讲编译引擎变为 pdfLaTeX ...
LaTeX魔法注释
mathwyz的博客
03-31 347
% !TEX TS-program = pdflatex 设置LaTeX默认编译工具为pdflatex % !TEX encoding = UTF-8 Unicode 设置LaTeX编码为UTF-8编码
深度解析Java中的5个“黑魔法”
一个被知识诅咒的人
04-16 1249
现在的编程语言越来越复杂，尽管有大量的文档和书籍，这些学习资料仍然只能描述编程语言的冰山一角。而这些编程语言中的很多功能，可能被永远隐藏在黑暗角落。本文将为你解释其中5个Java中隐藏的秘密，可以称其为Java的“黑魔法”。对于这些魔法，会描述它们的实现原理，并结合一些应用场景给出实现代码。 一石二鸟：实现注释（Annotation） 从JDK5开始，Java开始引入注释功能，从此，注释已成为许多...
Python基础教程代码与注释P92 6.4 参数魔法
prlhnxx的博客
01-18 521
# -*- coding: cp936 -*- #P92 6.4 参数魔法 6.4.2 我能改变参数吗 def try_to_change(n): n = 'Mr. Gumby' #局部作用域（local scope） name = 'Mr. Entity' try_to_change(name) print name # 列表作参数时，发生变化 def change(n):
深度解析Java中的5个“黑魔法”完整源代码
04-16
Java注解是一种元数据，它提供了将信息附加到代码而不改变其语义的方法。注解可以用于编译器检查、运行时处理、代码生成等多种场景。例如，`@Override`注解确保方法覆盖了超类的方法，`@Deprecated`标记过时的API。...
Java枚举类与注解
qq_40500437的博客
05-28 456
枚举类与注解 枚举类 类的对象是有限个的，确定的可使用枚举 例如星期、性别、季节、支付方式等 当需要定义一组常量时，强烈建议使用枚举类 阿里云代码规范中不允许出现魔法值哦，如下 //魔法值 if("男".equal(sex)){ //此时这里的男为魔法值，因为未进行定义 return "这是个男生" } 解决方法 //解决方法 final String MAN = "男" if(MAN.equal(sex)){ //但是如果有很多个常量 return "这是个男生" } 但是这样的确符
带你快速看完9.8分神作《Effective Java》—— 枚举 & 注解篇
如切如磋，如琢如磨
12-16 1378
豆瓣评分9.8的图书《Effective Java》，是当今世界顶尖高手Josh Bloch的著作，在我之前的文章里我也提到过，编程就像练武，既需要外在的武功招式（编程语言、工具、中间件等等），也需要修炼心法（设计模式、源码等等）学霸、学神OR开挂 我个人在Java领域也已经学习了近5年，在修炼“内功”的方面也通过各种途径接触到了一些编程规约，例如阿里巴巴的泰山版规约，在此基础下读这本书的时候仍是让我受到了很大的冲激，学习到了很多约定背后的细节问题，还有一些让我欣赏此书的点是，书中对于编程规约的解释让我感
JAVA编程规范_Java编程规范_
10-01
- 单行注释用于临时或快速注解，多行注释用于解释复杂的逻辑或方法。 - 避免无用的注释，如对明显代码的解释。 4. **类和接口设计**： - 类应该有单一职责，避免大而全的类。 - 接口定义行为，抽象类实现共性。...
lombok的使用
殷素素的博客
06-17 1120
文章目录常用注解使用方式说明`val``var``@NonNull``@Clearup``@GET`和`@SET``@toString``@EqualsAndHashCode``@AllArgsConstructor``@NoArgsConstructor``@RequiredArgsConstructor``@DATA`日志相关的注解 维护一个pojo的时候最讨厌看到满屏的set/get，有些时...
9.3 LinkedList设计思想
杨充
09-23 5427
LinkedList设计思想
lombok用法
小草的博客
05-11 1363
一、lombok介绍 官方定义： Project Lombok is a java library that automatically plugs into your editor and build tools, spicing up your java.Never write another getter or equals method again, with one annotation your class has a fully featured builder, Automate
Java枚举类使用Lombok
心之所往 码之所向
06-12 1万+
枚举类是一个特殊的常量类，由于其特殊的设计，具有简洁性、安全性以及便捷性，在开发中被普遍使用。本文简单介绍一下如何使用Lombok进行枚举类定义。
Lombok之@Getter/@Setter使用
热门推荐
cauchy6317的博客
10-11 2万+
一. 为什么要用@Getter/@Setter? 二. @Getter/@Setter如何使用？ 三. @Getter/@Setter源码 四. 特别说明 本文已经收录在[Lombok注解系列文章总览]中，并继承总览中所提的特别说明。(https://blog.csdn.net/cauchy6317/article/details/102498569) ...
【JAVA基础——优雅的Enum枚举】Java 枚举(enum) 如何编写一个优雅的枚举,枚举的用法.枚举的继承与实现.
最新发布
qq_44765647的博客
02-03 1163
优雅的编写Java 枚举enum,在工作中,发现还有相当多的人在从 enum取值的时候每次都使用循环遍历一遍。甚至还有人自己写构造方法和getter方法。启发于 《Effective Java第二版》，作者Joshua Bloch是Sun公司的高级工程师，也是“Java平台核心组”的设计师。书中很多帮助开发提升平常开发技术能力的知识，有非常专业的理论知识，强烈推荐。
随记、三个小知识点（枚举、set、lombok）
ITw333的博客
09-25 2965
1.枚举类的一个用法： public enum OrderStatusEnum{ CANCELED(0,"已取消"), NO_PAY(10,"未支付"), PAID(20,"已付款"), SHIPPED(40,"已发货"), ORDER_SUCCESS(50,"订单完成"), ORDER_CLOSE(60,"订单关闭"); Or
【优雅代码】01-lombok精选注解及原理
想飞的孤独少年的博客
01-26 204
【优雅代码】01-lombok精选注解及原理
Lombok 常用注解
m0_53067943的博客
07-26 516
主演总结了Lombok的常用注解
Java编程规范与语言详解
- 单行注释：`//`，用于临时或快速注解，不应过多使用。 - 多行注释：`/* ... */`，用于详细解释代码块，但避免在代码中过度使用。 3. **代码布局**： - 使用标准的缩进（通常是4个空格）保持代码对齐。 - 每个...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

极客星云

谢谢认可，希望对你的学习有帮助

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值