MyBatis Plus 增删改查 (三)

1. CURD方法参数与返回值说明

理解了方法参数与返回值，各个增删改查方法都是大同小异，都是各种重载方法。

1.1 方法参数

• @Param(Constants.WRAPPER) Wrapper queryWrapper
  • @Param作用是给参数起别名，以便在mybatis语句中的占位符使用（了解即可）
  • Constants.WRAPPER是常量，每个常量有不同的名字(了解即可)
  • Wrapper< T >是条件构造器，可以根据实体对象的默认情况下非null属性作等值比较，多个条件会自动用and连接，如果queryWrapper参数为null，则表示不添加条件(即查询所有记录)
  • 条件构造器也可以自身的方法动态添加条件，详情参考后面
  • @TableField注解中的condition 可以改变比较类型，whereStrategy可以改变属性是否作为条件的判断

FieldStrategy常量	描述
IGNORED	忽略判断,不建议使用,如果属性值为null,只会用=比较,不会用is，查询结果不对
NEVER	从不作为条件
NOT_NULL	非NULL判断，默认值
NOT_EMPTY	非空判断(只对字符串类型字段,其他类型字段依然为非NULL判断)
DEFAULT	追随全局配置

SqlCondition常量	描述
EQUAL	等于column=value，默认值
NOT_EQUAL	不等于column<>value
LIKE	左右模糊查询，column like ‘%value%’
LIKE_LEFT	左模糊查询，column like ‘%value’
LIKE_RIGHT	右模糊查询，column like ‘value%’

实体属性注解设置

// condition = SqlCondition.LIKE 字符串模糊查询
// whereStrategy=FieldStrategy.NOT_EMPTY  字符串为null或""则不会作为条件,注意空格会作为条件
@TableField(condition = SqlCondition.LIKE, whereStrategy=FieldStrategy.NOT_EMPTY)
private String bookName;

Wrapper参数测试

//构造条件实体对象
Book book = new Book();
book.setCategoryId(4);   //非null属性作等值比较 category_id=4
book.setBookPrice(null); //默认情况下null值属性不会作为默认值
book.setBookName("书籍");  //bookName属性上设置了SqlCondition.LIKE，所以不再是等值比较，而是like

//创建Wrapper，并把实体对象传递构造函数中
QueryWrapper<Book> wrapper = new QueryWrapper<>(book);

//SELECT * FROM book WHERE book_name LIKE CONCAT('%',?,'%') AND category_id=?
List<Book> bookList = bookService.list(wrapper);
bookList.forEach(System.out::println);

//SELECT * FROM book WHERE category_id=?
System.out.println("==========================空字符串============================");
book.setBookName("");  //bookName属性上设置了FieldStrategy.NOT_EMPTY，null值与空字符串都不会作为条件
bookList = bookService.list(wrapper);
bookList.forEach(System.out::println);

//SELECT * FROM book WHERE book_name LIKE CONCAT('%',?,'%') AND category_id=?
System.out.println("=============================空格=========================");
book.setBookName("  ");  //bookName属性即使设置了FieldStrategy.NOT_EMPTY，空格也会作为条件
bookList = bookService.list(wrapper);
bookList.forEach(System.out::println);

//SELECT * FROM book 
System.out.println("=======================Wrapper为null======================");
bookList = bookService.list(null);   //Wrapper为null则不添加条件
bookList.forEach(System.out::println);

• @Param(Constants.COLUMN_MAP) Map columnMap
  • 把每个键值对作等值比较，多个条件会自动用and连接，key必须是数据库的列名，而不是实体的属性名；如果value为null也会作为条件key is null
  • @TableField对columnMap无效，因为columnMap直接操作的是数据库表的列

//构造Map条件
Map<String,Object> map=new HashMap<>();
map.put("category_id",4);  //key值必须是列名，否则会报错  category_id=4
map.put("book_name",null);  // value为null也会作为条件,  book_name is null

//SELECT * FROM book WHERE category_id = ? AND book_name IS NULL 
List<Book> list = bookMapper.selectByMap(map);

• @Param(Constants.COLLECTION) Collection idList
  • idList是主键值集合

//构建主键集合
List<Integer> idList = Arrays.asList(1, 3, 6);

//SELECT  FROM book WHERE book_id IN ( ? , ? , ? )
List<Book> bookList = bookMapper.selectBatchIds(idList);
bookList.forEach(System.out::println);

• IPage page
  • page是分页对象，用于分页查询
  • 分页操作需要配置分页插件，不能单纯调用方法，详情参考3.8

//构建Page分页对象，第一参数是当前页码，第二参数是每页显示的记录数，
//第三参数是否执行count语句，默认为true，如果只查询数据可以把参数设为false
Page page=new Page(1,2,true);


//SELECT * FROM book LIMIT ?,?
Page<Book> bookPage = bookMapper.selectPage(page,null);

• Function mapper (可直接忽略，几乎不用)
  • 函数接口，定义了一个单个方法参数带返回值的方法，比如 V method(Object obj)，结果集在封装每一行数据后都会调用该函数接口的方法，把结果集的当前行记录的主键值作为实参值传递进方法中
  • 使用Lambda表达式实现函数接口的方法，根据传递的主键值做一些额外的操作

//必须有返回值,obj是主键值,Object类型，如需根据主键值删改查，需要强制转换为Serializable
Function function= obj->{
    if(obj!=null) {
        //获取主键值
        Serializable id = (Serializable) obj;
        
		/* 此处可以根据主键值id进行一系列的额外操作 */
		// xxxService.getById(id);
		// xxxService.deleteById(id);
		// xxxService.updateById(id);
		
		//返回值可以根据实际返回任何数据
        return  id;
    }
    return null;
};

//SELECT * FROM book
//Function的返回值类型V，而listObjs返回值类型List，因为结果集有多行记录
// List listObjs(Wrapper queryWrapper, Function mapper);
List<Serializable> list = bookService.listObjs(null, function);

1.2 返回值

• int

  • 执行sql语句后受影响的行数

• boolean

  • sql语句是否执行成功

• List>

  • 每行记录为Map，列名为key,列值为value

• List