MyBatis-Plus 基础教程

• 无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
• 损耗小：启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作
• 强大的 CRUD 操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求
• 支持 Lambda 形式调用：通过 Lambda 表达式，方便的编写各类查询条件，无需再担心字段写错
• 支持主键自动生成：支持多达 4 种主键策略（内含分布式唯一 ID 生成器 - Sequence），可自由配置，完美解决主键问题
• 支持 ActiveRecord 模式：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可进行强大的 CRUD 操作
• 支持自定义全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）
• 内置代码生成器：采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码，支持模板引擎，更有超多自定义配置等您来使用
• 内置分页插件：基于 MyBatis 物理分页，开发者无需关心具体操作，配置好插件之后，写分页等同于普通 List 查询
• 分页插件支持多种数据库：支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库
• 内置性能分析插件：可输出 SQL 语句以及其执行时间，建议开发测试时启用该功能，能快速揪出慢查询
• 内置全局拦截插件：提供全表 delete 、 update 操作智能分析阻断，也可自定义拦截规则，预防误操作

    com.baomidou
    mybatis-plus
    3.5.3.2

// 不想努力直接继承mybatis-plus的家产 （Mapper层）
@Mapper
public interface UserMapper extends BaseMapper {

}

// 调用BaseMapper的方法 （Controller层）
void contextLoads() {
    userMapper.selectById(1L);
}

mybatis-plus:
  type-aliases-package: com.forest.mp.domain.po # 别名扫描包
  mapper-locations: "classpath*:/mapper/**/*.xml" # Mapper.xml文件地址,默认值
  configuration:
    map-underscore-to-camel-case: true # 是否开启下划线和驼峰的映射cache-
    enabled: false # 是否开启二级缓存
  global-config:
    db-config:
      id-type: assign_id # id为雪花算法生成
      update-strategy: not_null # 更新策略：只更新非空字段

@Mapper
public interface UserMapper extends BaseMapper {

}

public interface UserService extends IService {
    boolean deductionUserMoney(Long id, Integer money);
}

@Service
public class UserServiceImpl extends ServiceImpl implements UserService {

    @Override
    public boolean deductionUserMoney(Long id, Integer money) {
        User user = this.getById(id);
        if (user.getStatus() == null || user.getStatus() == 2) {
            throw new RuntimeException("该用户状态异常！");
        }

        user.setBalance(user.getBalance() - money);
        return this.updateById(user);
    }
}

@Api(tags = "用户相关接口")
@RestController("/users")
@RequiredArgsConstructor // lombok工具 构造必要的Bean
public class UserController {

    private final UserServiceImpl userService; // 加上final可被lombok自动构造

    @ApiOperation("新增用户")
    @PostMapping
    public boolean save(@ApiParam("用户Id") @RequestBody User user) {
        return userService.save(user);
    }

    @ApiOperation("删除用户")
    @DeleteMapping("/{id}")
    public boolean delete(@ApiParam("用户Id") @PathVariable Long id) {
        return userService.removeById(id);
    }

    @ApiOperation("根据id查询用户")
    @GetMapping("/{id}")
    public User get(@PathVariable Long id) {
        return userService.getById(id);
    }

    @ApiOperation("扣减用户余额")
    @PutMapping("/{id}/deduction/{money}")
    public boolean deduction(@ApiParam("用户Id") @PathVariable Long id, @ApiParam("扣除的钱") @PathVariable Integer money) {
        return userService.deductionUserMoney(id,money);
    }

}

User user = this.getById(id);
if (user.getStatus() == null || user.getStatus() == 2) {
    throw new RuntimeException("该用户状态异常！");
}

List
 addressList = Db.lambdaQuery(Address.class).eq(Address::getUserId, user.getId()).list();
UserVo userVo = new UserVo();
BeanUtils.copyProperties(user, userVo);
userVo.setAddressList(addressList);

return userVo;

• • 在表中添加一个字段标记数据是否被删除
  • 当删除数据时把标记置为1
  • 查询时只查询标记为0的数据

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: deleted # 全局逻辑删除的实体字段名,字段类型可以是boolean, integer
      logic-delete-value: 1 # 逻辑已删除值(默认为 1)
      logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)

@Getter
public enum UserStatus {
    NORMAL(1, "正常"),
    FROZEN(0, "冻结"),
    ;
    @EnumValue /* 标记 mybatis-plus 需要处理的枚举 */
    @JsonValue /* SpringMvc 在处理enum返回值的时候默认会返回`NORMAL`这类英文的数据。这并不优雅，我们可以用`@JsonValue`来指定返回的是value还是desc还是enum */
    private final int value;
    private final String description;
    
    UserStatus(int value, String description) {
        this.value = value;
        this.description = description;
    }
}

mybatis-plus:
  configuration:
    default-enum-type-handler: com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler

@Data
public class UserDetail {
    private Integer age;
    private String intro;
    private String gender;
}

/* 开启自动结果映射 */
@TableName(value = "user", autoResultMap = true)
@ApiModel(description = "用户表单实体")
@Data
public class User {

    @ApiModelProperty("用户id")
    private Long id;

    @ApiModelProperty("用户名")
    private String username;

    @ApiModelProperty("密码")
    private String password;

    @ApiModelProperty("注册手机号")
    private String phone;

    /* 添加类型处理器 */
    @TableField(typeHandler = JacksonTypeHandler.class)
    @ApiModelProperty("详细信息")
    private UserDetail info;

    @ApiModelProperty("使用状态（1正常")
    private Integer status;

    @ApiModelProperty("账户余额")
    private Integer balance;

    @ApiModelProperty("创建时间")
    private LocalDateTime createTime;

    @ApiModelProperty("更新时间")
    private LocalDateTime updateTime;
}

@Configuration
public class MybatisConfiguration {
    @Bean /* 重写Mybatis-plus拦截器哦 */
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        // 创建一个mybatis-plus拦截器
        MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
        // 创建MySql分页插件,将他添加到mybatis-plus里
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor(DbType.MYSQL);
        mybatisPlusInterceptor.addInnerInterceptor(paginationInnerInterceptor);

        return mybatisPlusInterceptor;
    }
}

void contextLoads() {

    int pageNum = 1;
    int pageSize = 10;

    /* 开启分页查询 */
    Page page = new Page<>(pageNum, pageSize);
    page.addOrder(new OrderItem("balance", true)/* 排序字段,是否降序 */);
    page.addOrder(new OrderItem("id", true)/* 排序字段,是否降序 */);

    /* lambda条件构造器 */
    LambdaQueryWrapper lambdaQueryWrapper = new LambdaQueryWrapper()
            .eq(User::getStatus, 1);

    /* 开始查询 */
    Page userPage = userMapper.selectPage(page, lambdaQueryWrapper);

    /* 结果封装 */
    long total = userPage.getTotal();
    List records = userPage.getRecords();
}

• 成员变量名与数据库字段名不一致
• 成员变量名以is开头，且是布尔值
• 成员变量名与数据库关键字冲突
• 成员变量不是数据库字段
• 成员变量名与数据库字段名不一致

• • 默认以类名驼峰转下划线作为表名
  • 默认把名为id的字段作为主键
  • 默认把变量名驼峰转下划线作为表的字段名

• • @TableName:指定表名称及全局配置
  • @Tableld:指定id字段及相关配置
  • @TableField:指定普通字段及相关配置

• • AUTO、ASSIGN_ID、INPUT

• • 成员变量名与数据库字段名不一致
  • 成员变量名以is开头，且是布尔值
  • 成员变量名与数据库关键字冲突
  • 成员变量不是数据库字段

• • MyBatis-Plus ( 条件构造器 的使用 )