@TableField注解之深入理解与应用方式

更新时间：2024年10月23日 09:44:37 作者：需要重新演唱

在现代软件开发中,@TableField注解作为MyBatis-Plus中的一个重要特性,用于定义实体类字段与数据库表字段的映射关系,本文详细介绍了@TableField注解的使用场景、属性及其在实际开发中的应用,包括字段名称映射、非数据库字段标识、字段填充策略

@TableField注解：深入理解与应用

引言

在现代软件开发中，数据库操作是不可或缺的一部分。为了简化数据库操作，提高开发效率，许多ORM（Object-Relational Mapping）框架应运而生。

MyBatis-Plus作为MyBatis的增强工具，提供了丰富的功能和注解，其中@TableField注解是一个非常重要的注解，用于定义实体类字段与数据库表字段的映射关系。

本文将详细介绍@TableField注解的使用场景、属性及其在实际开发中的应用，帮助读者全面理解并掌握这一重要的注解。

MyBatis-Plus简介

MyBatis-Plus（简称MP）是一个MyBatis的增强工具，旨在简化开发、提高效率。

它提供了许多便捷的功能，如代码生成、分页插件、性能分析插件等，使得开发者可以更专注于业务逻辑的实现，而不必过多关注底层的数据库操作。

@TableField注解概述

基本概念

@TableField注解是MyBatis-Plus提供的一个注解，用于标识实体类字段与数据库表字段的映射关系。

通过@TableField注解，可以指定字段的名称、是否为数据库字段、是否为主键、是否为逻辑删除字段等属性，从而实现更灵活的数据库操作。

常用属性

@TableField注解提供了多个属性，常用的属性包括：

value：指定数据库表字段的名称。
exist：指定该字段是否为数据库表字段，默认为true。
fill：指定字段填充策略，如插入时自动填充、更新时自动填充等。
select：指定该字段是否参与查询，默认为true。
update：指定该字段是否参与更新，默认为true。
condition：指定该字段在查询条件中的匹配方式，如LIKE、EQUAL等。

@TableField注解的使用场景

1. 字段名称映射

在实际开发中，数据库表字段的命名规范可能与实体类字段的命名规范不一致。

例如，数据库表字段使用下划线命名法（如user_name），而实体类字段使用驼峰命名法（如userName）。通过@TableField注解的value属性，可以指定数据库表字段的名称，实现字段名称的映射。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;

@TableName("user")
public class User {
    @TableField("user_id")
    private Long id;

    @TableField("user_name")
    private String userName;

    // 其他字段和方法
}

在上述示例中，@TableField("user_id")将实体类字段id映射到数据库表字段user_id，@TableField("user_name")将实体类字段userName映射到数据库表字段user_name。

2. 非数据库字段标识

在某些情况下，实体类中可能包含一些非数据库字段，如计算属性、临时变量等。

通过@TableField注解的exist属性，可以指定该字段是否为数据库表字段。

将exist属性设置为false，表示该字段不是数据库表字段。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;

@TableName("user")
public class User {
    private Long id;

    private String userName;

    @TableField(exist = false)
    private Integer age;

    // 其他字段和方法
}

在上述示例中，@TableField(exist = false)将实体类字段age标识为非数据库字段，MyBatis-Plus在生成SQL语句时会忽略该字段。

3. 字段填充策略

在实际开发中，某些字段的值可能需要在插入或更新时自动填充，如创建时间、更新时间等。通过@TableField注解的fill属性，可以指定字段填充策略，实现自动填充功能。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.FieldFill;

@TableName("user")
public class User {
    private Long id;

    private String userName;

    @TableField(fill = FieldFill.INSERT)
    private Date createTime;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Date updateTime;

    // 其他字段和方法
}

在上述示例中，@TableField(fill = FieldFill.INSERT)指定createTime字段在插入时自动填充，@TableField(fill = FieldFill.INSERT_UPDATE)指定updateTime字段在插入和更新时自动填充。

4. 字段查询策略

在某些情况下，可能需要指定字段在查询条件中的匹配方式，如LIKE、EQUAL等。通过@TableField注解的condition属性，可以指定字段在查询条件中的匹配方式。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;

@TableName("user")
public class User {
    private Long id;

    @TableField(condition = "%s LIKE CONCAT('%%', #{%s}, '%%')")
    private String userName;

    // 其他字段和方法
}

// 查询示例
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
queryWrapper.like("user_name", "张");
List<User> userList = userMapper.selectList(queryWrapper);

在上述示例中，

@TableField(condition = "%s LIKE CONCAT('%%', #{%s}, '%%')")

指定userName字段在查询条件中使用LIKE匹配方式。

5. 逻辑删除字段标识

在某些情况下，可能需要使用逻辑删除而不是物理删除，即通过一个字段标识记录是否被删除。通过@TableField注解的select属性，可以指定该字段是否参与查询。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.TableLogic;

@TableName("user")
public class User {
    private Long id;

    private String userName;

    @TableField(select = false)
    @TableLogic
    private Integer deleted;

    // 其他字段和方法
}

在上述示例中，@TableField(select = false)指定deleted字段不参与查询，@TableLogic标识该字段为逻辑删除字段。

实际应用案例

案例1：用户管理系统

在一个用户管理系统中，需要对用户信息进行增删改查操作。通过@TableField注解，可以实现字段名称映射、非数据库字段标识、字段填充策略等功能。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableLogic;

@TableName("user")
public class User {
    @TableField("user_id")
    private Long id;

    @TableField("user_name")
    private String userName;

    @TableField(exist = false)
    private Integer age;

    @TableField(fill = FieldFill.INSERT)
    private Date createTime;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Date updateTime;

    @TableField(select = false)
    @TableLogic
    private Integer deleted;

    // 其他字段和方法
}

案例2：订单管理系统

在一个订单管理系统中，需要对订单信息进行增删改查操作。通过@TableField注解，可以实现字段名称映射、字段查询策略等功能。

示例代码：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;

@TableName("order")
public class Order {
    @TableField("order_id")
    private Long id;

    @TableField("order_no")
    private String orderNo;

    @TableField(condition = "%s LIKE CONCAT('%%', #{%s}, '%%')")
    private String customerName;

    // 其他字段和方法
}

// 查询示例
QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
queryWrapper.like("customer_name", "张");
List<Order> orderList = orderMapper.selectList(queryWrapper);

总结

@TableField注解是MyBatis-Plus提供的一个非常重要的注解，用于定义实体类字段与数据库表字段的映射关系。

通过@TableField注解，可以实现字段名称映射、非数据库字段标识、字段填充策略、字段查询策略、逻辑删除字段标识等功能，从而简化数据库操作，提高开发效率。在实际开发中，应根据具体需求合理使用@TableField注解，实现灵活、高效的数据库操作。

通过本文的介绍，希望读者能够全面理解@TableField注解的使用场景、属性及其在实际开发中的应用，掌握这一重要的注解，并在实际开发中灵活应用，实现高质量的软件交付。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Spring boot2X Consul如何使用Feign实现服务调用
这篇文章主要介绍了spring boot2X Consul如何使用Feign实现服务调用,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-12-12
Java开发人员最常犯的5个错误总结
作为一名java开发程序员，不知道大家有没有遇到过一些匪夷所思的bug。这些错误通常需要您几个小时才能解决。今天，小编总结一些常见的编码错误，然后给出解决方案。希望大家在日常编码中能够避免这样的问题
2022-12-12
详解Java线程的创建及休眠
今天带大家学习的是Java的相关知识,文章围绕着Java线程的创建及休眠展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
2021-06-06
java类比C++的STL库详解
这篇文章主要介绍了java类比C++的STL库详解,标准模板库,是C++标准库的重要组成部分,中文可译为标准模板库或者泛型库,其包含有大量的模板类和模板函数,STL 是一些容器、算法和其他一些组件的集合,需要的朋友可以参考下
2023-08-08
mybatis模糊查询like语句该如何写
MyBatis模糊查询通常使用LIKE关键字,结合concat函数拼接通配符%实现,在MyBatis配置文件中,通过#{keyword}传递参数,生成带有通配符的查询语句,MyBatis-Plus中,通过LambdaQueryWrapper类和like方法构建模糊查询条件,简化查询操作
2024-09-09
Java多线程Thread类的使用及注意事项
这篇文章主要介绍了Java多线程Thread类的使用及注意事项，在java标准库中提供了一个Thread类来表示/操作线程，Thread类也可以视为是java标准库提供的API
2022-06-06
Java实现树形结构的示例代码
由于业务需要，后端需要返回一个树型结构给前端，包含父子节点的数据已经在数据库中存储好。本文将为大家分享Java现树形结构的示例代码，需要的可以参考下
2022-05-05
Java Socket模拟实现聊天室
这篇文章主要为大家详细介绍了Java Socket模拟实现聊天室，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-07-07
SpringData JPA中查询接口Repository的使用
本文主要介绍了SpringData JPA中查询接口Repository的使用，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07
在java中使用dom4j解析xml(示例代码)
鉴于目前的趋势，我们这里来讲讲Dom4j的基本用法，不涉及递归等复杂操作。Dom4j的用法很多，官网上的示例有那么点儿晦涩，这里就不写了
2013-10-10