<!-- Spring Boot 父依賴（已引入可忽略） -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
    <relativePath/>
</parent>

<dependencies>
    <!-- Spring Boot Web 依賴（用於接口測試，可選） -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- MyBatis-Plus 核心依賴 -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.5</version> <!-- 推薦使用最新穩定版 -->
    </dependency>

    <!-- MySQL 驅動（Spring Boot 3.x 需用 8.x 驅動） -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!--  lombok（簡化實體類 getter/setter，可選但推薦） -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>

    <!-- 測試依賴 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

spring:
  # 數據庫配置
  datasource:
    url: jdbc:mysql://localhost:3306/mp_demo?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&rewriteBatchedStatements=true
    username: root  # 你的 MySQL 用户名
    password: 123456  # 你的 MySQL 密碼
    driver-class-name: com.mysql.cj.jdbc.Driver  # MySQL 8.x 驅動類名

mybatis-plus:
  # 1.  mapper.xml 文件存放路徑（若使用 XML 自定義 SQL，需配置）
  mapper-locations: classpath:mapper/*.xml
  # 2. 實體類包掃描（自動識別 @TableName 註解的實體）
  type-aliases-package: com.example.mpdemo.entity
  # 3. 全局配置
  global-config:
    db-config:
      # 主鍵生成策略（默認雪花算法，後續詳細講）
      id-type: ASSIGN_ID
      # 邏輯刪除字段配置（全局統一配置，後續詳細講）
      logic-delete-field: isDeleted
      logic-delete-value: 1  # 已刪除
      logic-not-delete-value: 0  # 未刪除
      # 表名前綴（全局統一添加表前綴，如實體 User 對應表 mp_user）
      table-prefix: mp_
  # 4. 原生 MyBatis 配置（可選）
  configuration:
    # 打印 SQL（開發環境開啓，生產環境關閉）
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
    # 駝峯命名自動轉換（數據庫字段 user_name → 實體屬性 userName）
    map-underscore-to-camel-case: true
    # 開啓二級緩存（默認關閉，根據需求開啓）
    cache-enabled: false

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

// 掃描 Mapper 接口（替換為你的 Mapper 包路徑）
@MapperScan("com.example.mpdemo.mapper")
@SpringBootApplication
public class MpDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(MpDemoApplication.class, args);
    }
}

CREATE TABLE `mp_user` (
  `id` bigint NOT NULL COMMENT '主鍵ID',
  `user_name` varchar(50) NOT NULL COMMENT '用户名',
  `age` int DEFAULT NULL COMMENT '年齡',
  `email` varchar(100) DEFAULT NULL COMMENT '郵箱',
  `is_deleted` tinyint DEFAULT 0 COMMENT '邏輯刪除（0-未刪，1-已刪）',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '創建時間',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新時間',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

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

// Lombok 註解，自動生成 getter/setter/toString 等方法
@Data
// 關聯數據庫表（若全局配置了 table-prefix，可省略 value，自動拼接前綴）
@TableName("mp_user")
public class User {
    // 主鍵（雪花算法生成，適合分佈式場景）
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;

    // 普通字段（數據庫列名 user_name，駝峯自動轉換可省略 value）
    @TableField(value = "user_name")
    private String userName;

    // 普通字段（允許為 null）
    private Integer age;

    // 普通字段（非數據庫字段，查詢時忽略）
    @TableField(exist = false)
    private String tempField;

    // 邏輯刪除字段（覆蓋全局配置）
    @TableLogic(value = "0", delval = "1")
    private Integer isDeleted;

    // 自動填充：創建時間（插入時填充）
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;

    // 自動填充：更新時間（插入和更新時填充）
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.mpdemo.entity.User;
import org.springframework.stereotype.Repository;

// @Repository 註解（Spring 掃描為 DAO 組件）
@Repository
public interface UserMapper extends BaseMapper<User> {
    // 無需編寫任何方法，BaseMapper 已提供全套 CRUD
}

import com.example.mpdemo.entity.User;
import com.example.mpdemo.mapper.UserMapper;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;
import java.util.List;

@Service
public class UserService {

    // 注入 Mapper（也可使用 @Autowired）
    @Resource
    private UserMapper userMapper;

    // 1. 新增用户
    public boolean addUser(User user) {
        return userMapper.insert(user) > 0;
    }

    // 2. 根據 ID 查詢用户
    public User getUserById(Long id) {
        return userMapper.selectById(id);
    }

    // 3. 查詢所有用户
    public List<User> getAllUsers() {
        return userMapper.selectList(null); // queryWrapper 為 null 表示無條件
    }

    // 4. 根據 ID 更新用户（只更新非 null 字段）
    public boolean updateUser(User user) {
        return userMapper.updateById(user) > 0;
    }

    // 5. 根據 ID 刪除用户
    public boolean deleteUser(Long id) {
        return userMapper.deleteById(id) > 0;
    }
}

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.mpdemo.entity.User;

public interface UserService extends IService<User> {
    // 可添加自定義業務方法（如複雜查詢、多表關聯）
    List<User> getUserByAgeRange(Integer minAge, Integer maxAge);
}

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.mpdemo.entity.User;
import com.example.mpdemo.mapper.UserMapper;
import com.example.mpdemo.service.UserService;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {

    // 實現自定義方法（可直接使用 baseMapper 調用 Mapper 層方法）
    @Override
    public List<User> getUserByAgeRange(Integer minAge, Integer maxAge) {
        // 這裏後續結合條件構造器實現，先佔位
        return null;
    }
}

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.mpdemo.entity.User;
import com.example.mpdemo.service.UserService;
import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;

@RestController
@RequestMapping("/user")
public class UserController {

    @Resource
    private UserService userService;

    // 新增用户
    @PostMapping
    public boolean addUser(@RequestBody User user) {
        return userService.save(user);
    }

    // 批量新增用户
    @PostMapping("/batch")
    public boolean addUserBatch(@RequestBody List<User> userList) {
        return userService.saveBatch(userList);
    }

    // 根據 ID 查詢用户
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getById(id);
    }

    // 分頁查詢所有用户（page：頁碼，size：每頁條數）
    @GetMapping("/page")
    public IPage<User> getUserPage(@RequestParam Integer page, @RequestParam Integer size) {
        return userService.page(new Page<>(page, size));
    }

    // 根據 ID 更新用户
    @PutMapping
    public boolean updateUser(@RequestBody User user) {
        return userService.updateById(user);
    }

    // 根據 ID 刪除用户
    @DeleteMapping("/{id}")
    public boolean deleteUser(@PathVariable Long id) {
        return userService.removeById(id);
    }
}

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.example.mpdemo.entity.User;
import java.util.List;

// 1. 條件查詢：查詢年齡 > 18 且用户名包含 "張" 的用户
public List<User> queryUser() {
    QueryWrapper<User> queryWrapper = new QueryWrapper<>();
    // 鏈式調用條件：age > 18
    queryWrapper.gt("age", 18)
                // 用户名 like %張%
                .like("user_name", "張")
                // 按創建時間降序排序
                .orderByDesc("create_time");
    return userService.list(queryWrapper);
}

// 2. 條件統計：統計郵箱不為 null 且未刪除的用户數
public long countUser() {
    QueryWrapper<User> queryWrapper = new QueryWrapper<>();
    queryWrapper.isNotNull("email")
                .eq("is_deleted", 0); // 邏輯刪除字段
    return userService.count(queryWrapper);
}

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.example.mpdemo.entity.User;
import java.util.List;

// 1. 條件查詢：年齡在 18-30 之間，且郵箱以 "@qq.com" 結尾
public List<User> queryUserByLambda() {
    LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();
    // 字段名通過 User::getter 方法引用，編譯時檢查
    lambdaQueryWrapper.between(User::getAge, 18, 30) // age between 18 and 30
                      .likeRight(User::getEmail, "@qq.com") // email like '@qq.com%'
                      .orderByAsc(User::getCreateTime); // 按創建時間升序
    return userService.list(lambdaQueryWrapper);
}

// 2. 動態條件：根據傳入參數動態拼接條件（如用户名和年齡可選）
public List<User> queryUserDynamic(String userName, Integer age) {
    LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();
    // 若 userName 不為 null 且不為空，添加模糊查詢條件
    if (userName != null && !userName.isEmpty()) {
        lambdaQueryWrapper.like(User::getUserName, userName);
    }
    // 若 age 不為 null，添加年齡 >= 條件
    if (age != null) {
        lambdaQueryWrapper.ge(User::getAge, age);
    }
    // 強制查詢未刪除的用户（邏輯刪除）
    lambdaQueryWrapper.eq(User::getIsDeleted, 0);
    return userService.list(lambdaQueryWrapper);
}

import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;
import com.example.mpdemo.entity.User;

// 1. 條件更新：將用户名 "張三" 的年齡改為 25，郵箱改為 zhangsan@qq.com
public boolean updateUserByWrapper() {
    UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
    // 設置更新字段
    updateWrapper.set("age", 25)
                  .set("email", "zhangsan@qq.com")
                  // 設置更新條件
                  .eq("user_name", "張三")
                  .eq("is_deleted", 0);
    return userService.update(updateWrapper);
}

import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
import com.example.mpdemo.entity.User;

// 1. 條件更新：年齡 > 30 的用户，年齡統一加 1
public boolean updateUserByLambdaWrapper() {
    LambdaUpdateWrapper<User> lambdaUpdateWrapper = new LambdaUpdateWrapper<>();
    // 更新字段：age = age + 1
    lambdaUpdateWrapper.setSql("age = age + 1")
                      // 條件：age > 30 且未刪除
                      .gt(User::getAge, 30)
                      .eq(User::getIsDeleted, 0);
    return userService.update(lambdaUpdateWrapper);
}

// 2. 動態更新：只更新非 null 的字段
public boolean updateUserDynamic(User user) {
    LambdaUpdateWrapper<User> lambdaUpdateWrapper = new LambdaUpdateWrapper<>();
    // 條件：根據主鍵 ID 更新
    lambdaUpdateWrapper.eq(User::getId, user.getId());
    // 若 userName 不為 null，更新用户名
    if (user.getUserName() != null) {
        lambdaUpdateWrapper.set(User::getUserName, user.getUserName());
    }
    // 若 age 不為 null，更新年齡
    if (user.getAge() != null) {
        lambdaUpdateWrapper.set(User::getAge, user.getAge());
    }
    return userService.update(lambdaUpdateWrapper);
}

import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加分頁插件，指定數據庫類型（MySQL）
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.example.mpdemo.entity.User;
import java.util.List;

// 1. 基礎分頁（無條件）
public IPage<User> getUserPage(Integer pageNum, Integer pageSize) {
    // Page 構造器：pageNum（頁碼，從 1 開始），pageSize（每頁條數）
    Page<User> page = new Page<>(pageNum, pageSize);
    // 調用 Service 層 page 方法
    return userService.page(page);
}

// 2. 條件分頁（帶 Lambda 條件構造器）
public IPage<User> getUserPageByCondition(Integer pageNum, Integer pageSize, String userName) {
    Page<User> page = new Page<>(pageNum, pageSize);
    LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();
    if (userName != null) {
        lambdaQueryWrapper.like(User::getUserName, userName);
    }
    // 分頁 + 條件查詢
    IPage<User> userPage = userService.page(page, lambdaQueryWrapper);
    
    // IPage 核心屬性（返回給前端）
    long total = userPage.getTotal(); // 總記錄數
    long pages = userPage.getPages(); // 總頁數
    List<User> records = userPage.getRecords(); // 當前頁數據
    boolean hasNext = userPage.hasNext(); // 是否有下一頁
    boolean hasPrevious = userPage.hasPrevious(); // 是否有上一頁
    
    return userPage;
}

// 3. 自定義 XML SQL 分頁（若需自定義 SQL，分頁插件同樣生效）
// Mapper 接口方法：
// IPage<User> selectUserByAgePage(Page<User> page, @Param("minAge") Integer minAge);
// XML 中無需寫 limit，分頁插件自動添加：
// <select id="selectUserByAgePage" resultType="com.example.mpdemo.entity.User">
//     select * from mp_user where age >= #{minAge}
// </select>

import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分頁插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        // 樂觀鎖插件
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        return interceptor;
    }
}

import com.baomidou.mybatisplus.annotation.Version;

@Data
@TableName("mp_user")
public class User {
    // ... 其他字段省略 ...
    
    // 樂觀鎖版本號字段（數據庫表需添加 version 字段，默認值 0）
    @Version
    private Integer version;
}

import com.example.mpdemo.entity.User;
import org.springframework.transaction.annotation.Transactional;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {

    // 併發更新用户年齡（樂觀鎖示例）
    @Transactional
    public boolean updateUserAge(Long userId, Integer newAge) {
        // 1. 查詢用户（獲取當前版本號）
        User user = getById(userId);
        if (user == null) {
            return false;
        }
        
        // 2. 修改年齡
        user.setAge(newAge);
        
        // 3. 更新（SQL 自動拼接 where version = user.getVersion()）
        boolean success = updateById(user);
        if (!success) {
            // 更新失敗（版本號不匹配），可重試或拋異常
            throw new RuntimeException("併發更新衝突，請重試");
        }
        return true;
    }
}

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: isDeleted  # 邏輯刪除字段名（實體類字段名）
      logic-delete-value: 1          # 已刪除值
      logic-not-delete-value: 0      # 未刪除值

import com.baomidou.mybatisplus.annotation.TableLogic;

@Data
@TableName("mp_user")
public class User {
    // ... 其他字段省略 ...
    
    // 邏輯刪除字段（覆蓋全局配置）
    @TableLogic(value = "0", delval = "1")
    private Integer isDeleted;
}

// 1. 刪除操作（自動改為更新 is_deleted = 1）
userService.removeById(1L); 
// 執行的 SQL：update mp_user set is_deleted = 1 where id = 1 and is_deleted = 0

// 2. 查詢操作（自動過濾 is_deleted = 1 的數據）
userService.getById(1L); 
// 執行的 SQL：select * from mp_user where id = 1 and is_deleted = 0

userService.list();
// 執行的 SQL：select * from mp_user where is_deleted = 0

// 3. 如需查詢已刪除數據，需手動添加條件
LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.eq(User::getIsDeleted, 1);
userService.list(queryWrapper);

import com.baomidou.mybatisplus.extension.plugins.inner.SqlExplainInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PerformanceInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;

@Configuration
public class MyBatisPlusConfig {

    // 僅在 dev 環境啓用（通過 @Profile 控制）
    @Profile({"dev"})
    @Bean
    public PerformanceInterceptor performanceInterceptor() {
        PerformanceInterceptor interceptor = new PerformanceInterceptor();
        // 設置 SQL 執行超時時間（單位：ms），超時則拋異常
        interceptor.setMaxTime(500);
        // 格式化 SQL 輸出（美觀易讀）
        interceptor.setFormat(true);
        return interceptor;
    }
}

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import com.example.mpdemo.entity.User;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import java.util.List;

public interface UserMapper extends BaseMapper<User> {

    // 1. 簡單查詢：根據用户名和年齡查詢用户（註解 SQL）
    @Select("select * from mp_user where user_name = #{userName} and age = #{age} and is_deleted = 0")
    User selectByUserNameAndAge(@Param("userName") String userName, @Param("age") Integer age);

    // 2. 結合條件構造器：自定義 SQL + 動態條件（${ew.customSqlSegment} 是固定語法）
    @Select("select u.id, u.user_name, u.age from mp_user u ${ew.customSqlSegment}")
    List<User> selectCustomByWrapper(@Param(Constants.WRAPPER) Wrapper<User> wrapper);

    // 3. 分頁查詢：自定義 SQL + 分頁插件
    @Select("select * from mp_user where age >= #{minAge} and is_deleted = 0")
    IPage<User> selectByAgePage(IPage<User> page, @Param("minAge") Integer minAge);
}

mybatis-plus:
  mapper-locations: classpath:mapper/*.xml  # XML 文件放在 resources/mapper 目錄下

<?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 接口全路徑一致 -->
<mapper namespace="com.example.mpdemo.mapper.UserMapper">

    <!-- 1. 多表關聯查詢（用户表 + 訂單表，查詢用户及關聯的訂單數） -->
    <select id="selectUserWithOrderCount" resultType="java.util.Map">
        select 
            u.id, u.user_name, u.age, count(o.id) as order_count
        from 
            mp_user u
        left join 
            mp_order o on u.id = o.user_id
        where 
            u.is_deleted = 0
        group by 
            u.id
    </select>

    <!-- 2. 動態 SQL（結合 MP 條件構造器，${ew.customSqlSegment} 拼接條件） -->
    <select id="selectUserByXmlWrapper" resultType="com.example.mpdemo.entity.User">
        select * from mp_user
        <where>
            ${ew.customSqlSegment}
        </where>
    </select>

    <!-- 3. 批量插入（優化性能，比循環 insert 高效） -->
    <insert id="batchInsertUser">
        insert into mp_user (id, user_name, age, email, is_deleted, create_time, update_time)
        values
        <foreach collection="list" item="user" separator=",">
            (#{user.id}, #{user.userName}, #{user.age}, #{user.email}, #{user.isDeleted}, #{user.createTime}, #{user.updateTime})
        </foreach>
    </insert>

</mapper>

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.example.mpdemo.entity.User;
import org.apache.ibatis.annotations.Param;
import java.util.List;
import java.util.Map;

public interface UserMapper extends BaseMapper<User> {

    // 關聯 XML 中的 selectUserWithOrderCount 方法
    List<Map<String, Object>> selectUserWithOrderCount();

    // 關聯 XML 中的 selectUserByXmlWrapper 方法（結合條件構造器）
    List<User> selectUserByXmlWrapper(@Param("ew") Wrapper<User> wrapper);

    // 關聯 XML 中的 batchInsertUser 方法
    int batchInsertUser(@Param("list") List<User> userList);
}

// 訂單實體（關聯用户表）
@Data
@TableName("mp_order")
public class Order {
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;
    private Long userId; // 關聯用户表主鍵
    private String orderNo; // 訂單號
    private BigDecimal amount; // 金額
    private Integer isDeleted;

    // 一對一關聯用户信息（非數據庫字段，查詢時通過註解關聯）
    @TableField(exist = false)
    private User user;
}

// Mapper 接口註解關聯查詢
public interface OrderMapper extends BaseMapper<Order> {
    @Select("select o.*, u.user_name, u.age from mp_order o " +
            "left join mp_user u on o.user_id = u.id " +
            "where o.id = #{id} and o.is_deleted = 0")
    // @ResultMap 映射關聯字段（也可使用 @Result 逐個映射）
    @ResultMap("orderUserMap")
    Order selectOrderWithUser(@Param("id") Long id);
}

<!-- MyBatis-Plus 代碼生成器核心依賴 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>3.5.5</version>
</dependency>

<!-- 模板引擎（MP 支持 Velocity、Freemarker、Beetl，這裏用 Velocity） -->
<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity-engine-core</artifactId>
    <version>2.3</version>
</dependency>

import com.baomidou.mybatisplus.generator.FastAutoGenerator;
import com.baomidou.mybatisplus.generator.config.OutputFile;
import com.baomidou.mybatisplus.generator.engine.VelocityTemplateEngine;
import java.util.Collections;

public class CodeGenerator {
    public static void main(String[] args) {
        // 數據庫連接配置
        String url = "jdbc:mysql://localhost:3306/mp_demo?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true";
        String username = "root";
        String password = "123456";

        // 代碼生成核心配置
        FastAutoGenerator.create(url, username, password)
                // 1. 全局配置
                .globalConfig(builder -> {
                    builder.author("your-name") // 作者名
                            .outputDir(System.getProperty("user.dir") + "/src/main/java") // 代碼輸出目錄（項目 java 目錄）
                            .commentDate("yyyy-MM-dd") // 註釋日期格式
                            .disableOpenDir() // 生成後不自動打開文件夾
                            .enableSwagger() // 啓用 Swagger 註解（需引入 Swagger 依賴）
                            .fileOverride(); // 覆蓋已存在的文件
                })
                // 2. 包配置（代碼存放的包路徑）
                .packageConfig(builder -> {
                    builder.parent("com.example.mpdemo") // 父包名
                            .entity("entity") // 實體類包名
                            .mapper("mapper") // Mapper 接口包名
                            .service("service") // Service 接口包名
                            .serviceImpl("service.impl") // Service 實現類包名
                            .controller("controller") // Controller 包名
                            .xml("mapper.xml") // XML 文件包名（resources 目錄下）
                            .pathInfo(Collections.singletonMap(OutputFile.xml, System.getProperty("user.dir") + "/src/main/resources/mapper")); // XML 輸出目錄
                })
                // 3. 策略配置（表、字段、代碼生成規則）
                .strategyConfig(builder -> {
                    builder.addInclude("mp_user", "mp_order") // 要生成代碼的表名（多個表用逗號分隔）
                            .addTablePrefix("mp_") // 表前綴（生成實體類時自動去除前綴，如 mp_user → User）
                            // 實體類策略
                            .entityBuilder()
                            .enableLombok() // 啓用 Lombok 註解（生成 @Data 等）
                            .enableTableFieldAnnotation() // 為字段添加 @TableField 註解
                            .idType(com.baomidou.mybatisplus.generator.config.rules.IdType.ASSIGN_ID) // 主鍵生成策略
                            .logicDeleteFieldName("isDeleted") // 邏輯刪除字段名
                            .enableChainModel() // 啓用鏈式調用（生成 set 方法返回 this）
                            // Mapper 策略
                            .mapperBuilder()
                            .enableBaseResultMap() // 啓用 BaseResultMap（XML 中生成結果映射）
                            .enableBaseColumnList() // 啓用 BaseColumnList（XML 中生成字段列表）
                            .enableMapperAnnotation() // 為 Mapper 接口添加 @Mapper 註解
                            // Service 策略
                            .serviceBuilder()
                            .formatServiceFileName("%sService") // Service 接口命名格式（如 UserService）
                            .formatServiceImplFileName("%sServiceImpl") // Service 實現類命名格式（如 UserServiceImpl）
                            // Controller 策略
                            .controllerBuilder()
                            .enableRestStyle() // 啓用 RestController 註解
                            .enableHyphenStyle(); // URL 中駝峯轉連字符（如 userInfo → user-info）
                })
                // 4. 模板引擎配置（使用 Velocity）
                .templateEngine(new VelocityTemplateEngine())
                // 執行生成
                .execute();
    }
}

src/main/java/com/example/mpdemo/
├── entity/
│   ├── User.java
│   └── Order.java
├── mapper/
│   ├── UserMapper.java
│   └── OrderMapper.java
├── service/
│   ├── UserService.java
│   ├── OrderService.java
│   └── impl/
│       ├── UserServiceImpl.java
│       └── OrderServiceImpl.java
├── controller/
│   ├── UserController.java
│   └── OrderController.java
src/main/resources/mapper/
├── UserMapper.xml
└── OrderMapper.xml

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

@Data
@TableName("mp_user")
public class User {
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;

    @TableField(value = "user_name")
    private String userName;

    private Integer age;

    private String email;

    @TableLogic(value = "0", delval = "1")
    private Integer isDeleted;

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

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

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    // 插入時填充
    @Override
    public void insertFill(MetaObject metaObject) {
        // 填充 createTime 和 updateTime 為當前時間
        strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    // 更新時填充
    @Override
    public void updateFill(MetaObject metaObject) {
        // 填充 updateTime 為當前時間
        strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.mpdemo.entity.User;
import org.springframework.stereotype.Repository;

@Repository
public interface UserMapper extends BaseMapper<User> {
    // 無需自定義方法，BaseMapper 已滿足需求
}

// UserService.java
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.mpdemo.entity.User;
import java.util.List;

public interface UserService extends IService<User> {
    // 條件分頁查詢
    IPage<User> getUserPage(Page<User> page, String userName, Integer minAge, Integer maxAge);
}

// UserServiceImpl.java
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.mpdemo.entity.User;
import com.example.mpdemo.mapper.UserMapper;
import com.example.mpdemo.service.UserService;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {

    @Override
    public IPage<User> getUserPage(Page<User> page, String userName, Integer minAge, Integer maxAge) {
        LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();
        // 動態條件
        if (userName != null && !userName.isEmpty()) {
            lambdaQueryWrapper.like(User::getUserName, userName);
        }
        if (minAge != null) {
            lambdaQueryWrapper.ge(User::getAge, minAge);
        }
        if (maxAge != null) {
            lambdaQueryWrapper.le(User::getAge, maxAge);
        }
        // 過濾已刪除數據
        lambdaQueryWrapper.eq(User::getIsDeleted, 0);
        // 分頁查詢
        return page(page, lambdaQueryWrapper);
    }
}

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.mpdemo.entity.User;
import com.example.mpdemo.service.UserService;
import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;

@RestController
@RequestMapping("/user")
public class UserController {

    @Resource
    private UserService userService;

    // 新增用户
    @PostMapping
    public boolean addUser(@RequestBody User user) {
        return userService.save(user);
    }

    // 批量新增用户
    @PostMapping("/batch")
    public boolean addUserBatch(@RequestBody List<User> userList) {
        return userService.saveBatch(userList);
    }

    // 根據 ID 查詢用户
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getById(id);
    }

    // 條件分頁查詢
    @GetMapping("/page")
    public IPage<User> getUserPage(
            @RequestParam(defaultValue = "1") Integer pageNum,
            @RequestParam(defaultValue = "10") Integer pageSize,
            @RequestParam(required = false) String userName,
            @RequestParam(required = false) Integer minAge,
            @RequestParam(required = false) Integer maxAge) {
        Page<User> page = new Page<>(pageNum, pageSize);
        return userService.getUserPage(page, userName, minAge, maxAge);
    }

    // 根據 ID 更新用户
    @PutMapping
    public boolean updateUser(@RequestBody User user) {
        return userService.updateById(user);
    }

    // 根據 ID 刪除用户（邏輯刪除）
    @DeleteMapping("/{id}")
    public boolean deleteUser(@PathVariable Long id) {
        return userService.removeById(id);
    }
}

{
  "userName": "張三",
  "age": 25,
  "email": "zhangsan@qq.com"
}

{
  "id": 1425678901234567890,
  "userName": "張三三",
  "age": 26
}