MyBatis-Plus 快速入门与核心注解

<properties>
    <java.version>17</java.version>
    <mybatis-plus.version>3.5.12</mybatis-plus.version>
</properties>

<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- MyBatis-Plus（注意：Spring Boot 3.x 使用 mybatis-plus-spring-boot3-starter） -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
        <version>${mybatis-plus.version}</version>
    </dependency>

    <!-- MySQL Driver -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!-- Lombok -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

server:
  port: 8080

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mybatis_plus?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: root1234

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl  # 开发环境打印 SQL
    map-underscore-to-camel-case: true                      # 驼峰命名转换
  global-config:
    db-config:
      id-type: assign_id         # 全局主键策略：雪花算法
      logic-delete-field: deleted  # 逻辑删除字段
      logic-delete-value: 1        # 逻辑已删除值
      logic-not-delete-value: 0    # 逻辑未删除值
  mapper-locations: classpath:mapper/*.xml

package com.xiaoye.mybatisplus;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.xiaoye.mybatisplus.mapper")
public class MybatisPlusDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(MybatisPlusDemoApplication.class, args);
    }
}

CREATE DATABASE mybatis_plus DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

USE mybatis_plus;

CREATE TABLE user (
    id BIGINT NOT NULL COMMENT '主键ID',
    name VARCHAR(30) DEFAULT NULL COMMENT '姓名',
    age INT DEFAULT NULL COMMENT '年龄',
    email VARCHAR(50) DEFAULT NULL COMMENT '邮箱',
    create_time DATETIME DEFAULT NULL COMMENT '创建时间',
    update_time DATETIME DEFAULT NULL COMMENT '更新时间',
    version INT DEFAULT 1 COMMENT '版本号（乐观锁）',
    deleted INT DEFAULT 0 COMMENT '逻辑删除标记（0未删除，1已删除）',
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

package com.xiaoye.mybatisplus.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.io.Serializable;
import java.time.LocalDateTime;

@Data
@TableName("user")
public class User implements Serializable {

    @TableId(type = IdType.ASSIGN_ID)   // 主键：雪花算法
    private Long id;

    private String name;                  // 自动映射 user_name → name（驼峰转换）

    private Integer age;

    private String email;

    @TableField(fill = FieldFill.INSERT)        // 创建时自动填充
    private LocalDateTime createTime;

    @TableField(fill = FieldFill.INSERT_UPDATE)  // 创建和更新时自动填充
    private LocalDateTime updateTime;

    @Version                                    // 乐观锁版本号
    @TableField(fill = FieldFill.INSERT)        // 创建时自动填充初始值 1
    private Integer version;

    @TableLogic                                 // 逻辑删除标记
    @TableField(fill = FieldFill.INSERT)        // 创建时自动填充初始值 0
    private Integer deleted;
}

package com.xiaoye.mybatisplus.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.xiaoye.mybatisplus.entity.User;

@Mapper
public interface UserMapper extends BaseMapper<User> {
    // 继承 BaseMapper 后，无需编写 XML 即可使用以下内置方法：
    // insert、deleteById、updateById、selectById、selectList、selectPage 等
}

// Service 接口
public interface UserService extends IService<User> {
    // IService 提供批量操作、Lambda 查询等高级能力
}

// Service 实现
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User>
    implements UserService {
    // ServiceImpl 内置了 saveBatch、updateBatchById、removeBatchByIds 等批量方法
}

@SpringBootTest
class MybatisPlusDemoApplicationTests {

    @Autowired
    private UserMapper userMapper;

    // 插入
    @Test
    void testInsert() {
        User user = new User();
        user.setName("张三");
        user.setAge(25);
        user.setEmail("zhangsan@example.com");

        int rows = userMapper.insert(user);
        System.out.println("影响行数：" + rows);
        System.out.println("自动生成的ID：" + user.getId());  // 雪花算法生成的 Long 型 ID
    }

    // 根据 ID 查询
    @Test
    void testSelectById() {
        User user = userMapper.selectById(1L);
        System.out.println(user);
    }

    // 查询所有
    @Test
    void testSelectAll() {
        List<User> users = userMapper.selectList(null);
        // 注意：逻辑删除的记录会被自动过滤
        // 生成的 SQL: SELECT ... FROM user WHERE deleted=0
        users.forEach(System.out::println);
    }

    // 根据 ID 更新
    @Test
    void testUpdateById() {
        User user = userMapper.selectById(1L);
        user.setName("李四");
        user.setAge(30);

        int rows = userMapper.updateById(user);
        System.out.println("影响行数：" + rows);
    }

    // 根据 ID 删除（逻辑删除）
    @Test
    void testDeleteById() {
        int rows = userMapper.deleteById(1L);
        // 逻辑删除：UPDATE user SET deleted=1 WHERE id=1 AND deleted=0
        System.out.println("影响行数：" + rows);
    }
}

雪花算法结构（64位 Long）:
┌─────────────────────────────────────────────────────────────┐
│ 1位 │      41位时间戳       │  10位机器ID  │   12位序列号   │
│符号位│  （毫秒级时间戳）     │（5位数据中心+5位机器）│（毫秒内计数）│
└─────────────────────────────────────────────────────────────┘

// 雪花算法（Long 型 ID）
@TableId(type = IdType.ASSIGN_ID)
private Long id;

// UUID（String 型 ID）
@TableId(type = IdType.ASSIGN_UUID)
private String id;

// 数据库自增
@TableId(type = IdType.AUTO)
private Long id;

mybatis-plus:
  global-config:
    db-config:
      id-type: assign_id  # 全局默认使用雪花算法