1、注解开发介绍
在过去使用框架开发项目,基本都采用xml作为框架的核心配置文件存在,但是这种方式开发效率还是比较地下、不灵活。
现在企业开发为了能够更快的提高开发效率,必然会使用企业级框架进行项目开发,而现在主流的框架都支持基于注解的方式开发项目。
mybatis框架已经全面支持基于注解的开发。
使用mybatis的注解开发,并不能省略mybatis的核心配置文件,而注解仅仅只是代替Mapper文件。
MyBatis 的注解开发主要代替了以下功能:
- 替代映射器接口(Mapper XML)
- 使用@Mapper标注接口为映射器接口
- 使用@Select、@Update等注解写SQL语句
- 替代结果映射(ResultMap)
- 使用@Results和@Result注解配置结果映射
- 替代字段与属性映射
- 使用@Column注解指定数据库列名
- 使用@Id注解指定主键字段
- 替代关联查询
- 使用@One、@Many注解配置一对一、一对多关系
- 替代动态SQL
- 使用@SelectProvider、@UpdateProvider等注解执行动态SQL
- 替代缓存配置
- 使用@CacheNamespace、@CacheFlush等注解配置缓存
注解开发使配置更简单,直接在接口及字段上通过注解即可实现XML方式的大部分功能。
但注解方式有限制。比如复杂的结果映射、动态SQL等还是建议用XML方式配置。所以在复杂场景下,注解+XML配置可以发挥两者优势。
2、Mybatis注解开发
mybatis注解开发主要介绍:
1、 注解开发的环境搭建
2、 单表的CRUD操作(使用代理方式)
3、 多表查询操作
4、 缓存的配置
2.1、注解开发环境搭建
2.1.1、创建maven项目
选择File > New > Project
,进入创建界面
选择New Project
,右侧填写项目名,选择项目存储路径,选择语言,构建工具,jdk版本,maven高级设置:
2.1.2、maven的配置文件
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.qbzaixian</groupId><artifactId>qbzaixian</artifactId><version>1.0-SNAPSHOT</version><packaging>jar</packaging><properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.13</version></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.34</version></dependency><!-- lombok简化实体类开发,需要idea安装lombok的插件哦~~~--><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.8</version></dependency><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope></dependency></dependencies>
</project>
2.1.3、书写mybatis的核心配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!-- properties 引入外部的配置文件,必须使用resource属性 --><properties resource="db.properties"/><!--settings 标签 --><settings><!-- 设置mybatis 的缓存--><setting name="cacheEnabled" value="true"/><!-- 开启驼峰式命名规则--><setting name="mapUnderscoreToCamelCase" value="true"/></settings><!-- 设置别名 --><typeAliases><package name="com.qbzaixian.pojo"/></typeAliases><environments default="mysql"><environment id="mysql"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${driver}" /><property name="url" value="${url}" /><property name="username" value="${username}" /><property name="password" value="${password}" /></dataSource></environment></environments><mappers><!-- 这里必须采用包的方式配置,因为没有mapper文件,书写接口所在的包--><package name="com.qbzaixian.mapper"/></mappers>
</configuration>
2.1.4、创建数据库
-- 创建数据库
CREATE DATABASE mybatis;
USE mybatis;
DROP TABLE IF EXISTS `tb_item`;
-- 创建商品表
CREATE TABLE `tb_item` (`id` INT(11) NOT NULL AUTO_INCREMENT,`item_name` VARCHAR(32) NOT NULL COMMENT '商品名称',`item_price` FLOAT(6,1) NOT NULL COMMENT '商品价格',`item_detail` TEXT COMMENT '商品描述',PRIMARY KEY (`id`)
) ENGINE=INNODB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;INSERT INTO `tb_item` VALUES ('1', 'iPhone 6', '5288.0', '苹果公司新发布的手机产品。');
INSERT INTO `tb_item` VALUES ('2', 'iPhone 6 plus', '6288.0', '苹果公司发布的新大屏手机。');-- 创建用户表DROP TABLE IF EXISTS `tb_user`;
CREATE TABLE `tb_user` (`id` BIGINT(20) NOT NULL AUTO_INCREMENT,`user_name` VARCHAR(100) DEFAULT NULL COMMENT '用户名',`password` VARCHAR(100) DEFAULT NULL COMMENT '密码',`name` VARCHAR(100) DEFAULT NULL COMMENT '姓名',`age` INT(10) DEFAULT NULL COMMENT '年龄',`sex` TINYINT(1) DEFAULT NULL COMMENT '性别,1男性,2女性',`birthday` DATE DEFAULT NULL COMMENT '出生日期',`created` DATETIME DEFAULT NULL COMMENT '创建时间',`updated` DATETIME DEFAULT NULL COMMENT '更新时间',PRIMARY KEY (`id`),UNIQUE KEY `username` (`user_name`)
) ENGINE=INNODB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8;INSERT INTO `tb_user` VALUES ('1', 'zhangsan', '123456', '张三', '30', '1', '1984-08-08', '2022-09-19 16:56:04', '2022-09-21 11:24:59');
INSERT INTO `tb_user` VALUES ('2', 'lisi', '123456', '李四', '21', '2', '1991-01-01', '2022-09-19 16:56:04', '2022-09-19 16:56:04');
INSERT INTO `tb_user` VALUES ('3', 'wangwu', '123456', '王五', '22', '2', '1989-01-01', '2022-09-19 16:56:04', '2022-09-19 16:56:04');
INSERT INTO `tb_user` VALUES ('4', 'zhangwei', '123456', '张伟', '20', '1', '1988-09-01', '2022-09-19 16:56:04', '2022-09-19 16:56:04');
INSERT INTO `tb_user` VALUES ('5', 'lina', '123456', '李娜', '28', '1', '1985-01-01', '2022-09-19 16:56:04', '2022-09-19 16:56:04');
INSERT INTO `tb_user` VALUES ('6', 'lilei', '123456', '李磊', '23', '1', '1988-08-08', '2022-09-20 11:41:15', '2022-09-20 11:41:15');-- 订单表
DROP TABLE IF EXISTS `tb_order`;
CREATE TABLE `tb_order` (`id` INT(11) NOT NULL AUTO_INCREMENT,`user_id` BIGINT(20) NOT NULL,`order_number` VARCHAR(20) NOT NULL COMMENT '订单号',PRIMARY KEY (`id`),KEY `FK_orders_1` (`user_id`),CONSTRAINT `FK_orders_1` FOREIGN KEY (`user_id`) REFERENCES `tb_user` (`id`) ON DELETE NO ACTION ON UPDATE NO ACTION
) ENGINE=INNODB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;INSERT INTO `tb_order` VALUES ('1', '1', '20220921001');
INSERT INTO `tb_order` VALUES ('2', '2', '20220921002');
INSERT INTO `tb_order` VALUES ('3', '1', '20220921003');-- 创建订单明细表DROP TABLE IF EXISTS `tb_orderdetail`;
CREATE TABLE `tb_orderdetail` (`id` INT(11) NOT NULL AUTO_INCREMENT,`order_id` INT(32) DEFAULT NULL COMMENT '订单号',`item_id` INT(32) DEFAULT NULL COMMENT '商品id',`total_price` DOUBLE(20,0) DEFAULT NULL COMMENT '商品总价',`status` INT(11) DEFAULT NULL COMMENT '状态',PRIMARY KEY (`id`),KEY `FK_orderdetail_1` (`order_id`),KEY `FK_orderdetail_2` (`item_id`),CONSTRAINT `FK_orderdetail_1` FOREIGN KEY (`order_id`) REFERENCES `tb_order` (`id`),CONSTRAINT `FK_orderdetail_2` FOREIGN KEY (`item_id`) REFERENCES `tb_item` (`id`)
) ENGINE=INNODB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;INSERT INTO `tb_orderdetail` VALUES ('1', '1', '1', '5288', '1');
INSERT INTO `tb_orderdetail` VALUES ('2', '1', '2', '6288', '1');
INSERT INTO `tb_orderdetail` VALUES ('3', '2', '2', '6288', '1');
INSERT INTO `tb_orderdetail` VALUES ('4', '3', '1', '5288', '1');
2.2、注解开发快速入门
2.2.1、编写pojo类
@Data
public class User {private Long id;// 用户名private String userName;// 密码private String password;// 姓名private String name;// 年龄private Integer age;// 性别,1男性,2女性private Integer sex;// 出生日期private Date birthday;// 创建时间private Date created;// 更新时间private Date updated;
}
2.2.2、编写接口
/*** MyBaits的注解开发*/
public interface UserMapper {@Select("select * from tb_user where id = #{id}")public User selectById(Integer id);
}
2.2.3、编写测试类
public class MyBatisTest {private SqlSessionFactory factory;@Beforepublic void init() throws Exception {//1、获取配置文件InputStream in = Resources.getResourceAsStream("mybatis-config.xml");factory = new SqlSessionFactoryBuilder().build(in);}@Testpublic void testFindUserById(){SqlSession session = factory.openSession(true);UserMapper mapper = session.getMapper(UserMapper.class);User user = mapper.selectById(1);System.out.println(user);}
}
3、注解开发CRUD
mybatis注解开发主要使用的注解有:
- @Select:完成查询sql语句的编写
- @Update:完成修改的SQL语句编写
- @Delete:完成删除的SQL语句编写
- @Insert:完成插入的SQL语句编写
3.1、@Select注解
@Select:标记在方法上,表示该方法对应的SQL是查询语句。
public interface UserMapper {@Select("select * from tb_user where id = #{id}")public User selectById(Integer id);@Select("select * from tb_user")public List<User> selectUsers();
}
@Test
public void testFindUserById(){SqlSession session = factory.openSession(true);UserMapper mapper = session.getMapper(UserMapper.class);User user = mapper.selectById(1);System.out.println(user);System.out.println("--------------------");List<User> users = mapper.selectUsers();users.forEach(System.out::println);
}
3.2、@Update注解
@Update:表示该方法对应的SQL是更新语句。
@Update("update tb_user set age = #{age} , user_name = #{userName} WHERE id = #{id}")
public void updateUser(User user);
@Test
public void testUpdate(){SqlSession session = factory.openSession(true);UserMapper mapper = session.getMapper(UserMapper.class);User user = new User();user.setAge(30);user.setUserName("小羊苏西");user.setId(3L);mapper.updateUser(user);
}
3.3、@Delete注解
@Delete:表示该方法对应的SQL是删除语句。
@Delete("delete from tb_user where id = #{id}")
public void deleteById(Integer id);
@Test
public void testDelete(){SqlSession session = factory.openSession(true);UserMapper mapper = session.getMapper(UserMapper.class);mapper.deleteById(6);
}
3.4、@Insert注解
@Insert:表示该方法对应的SQL是插入语句。
@Insert("insert into tb_user(user_name,name,age,password,sex) values(#{userName},#{name},#{age},#{password},#{sex})")
public void addUser(User user);
@Test
public void testInsert(){SqlSession session = factory.openSession(true);UserMapper mapper = session.getMapper(UserMapper.class);User user = new User();user.setName("zwj");user.setUserName("张无忌");user.setAge(20);user.setPassword("123123");user.setSex(1);mapper.addUser(user);
}
4、@Results注解
Results注解主要完成在查询的时候列名和pojo的属性不对应时的映射操作的(类似于Mapper文件中使用resultMap进行配置解决),为了演示这个问题,这里故意修改pojo中的属性与列名不一致。
@Data
public class User2 {private Long id;// 用户名:故意修改userName为uName,方便下面测试private String uName;// 密码:故意修改password为pwd,方便下面测试private String pwd;// 姓名private String name;// 年龄private Integer age;// 性别,1男性,2女性private Integer sex;// 出生日期private Date birthday;// 创建时间private Date created;// 更新时间private Date updated;
}
为了方便,测试,这里在上面演示的CRUD中,对口和测试都是直接复制,在接口和类名后面添加了数字2.
public interface UserMapper2 {@Select("select * from tb_user where id = #{id}")public User2 selectById(Integer id);@Select("select * from tb_user")public List<User2> selectUsers();
}
public class MyBatisTest2 {private SqlSessionFactory factory;@Beforepublic void init() throws Exception {//1、获取配置文件InputStream in = Resources.getResourceAsStream("mybatis-config.xml");factory = new SqlSessionFactoryBuilder().build(in);}@Testpublic void testFindUserById(){SqlSession session = factory.openSession(true);UserMapper2 mapper = session.getMapper(UserMapper2.class);User2 user = mapper.selectById(1);System.out.println(user);}
}
查看打印的执行结果:
User2(id=1, uName=null, pwd=null, name=张三, age=30, sex=1, birthday=Wed Aug 08 00:00:00 CST 1984, created=Mon Sep 19 16:56:04 CST 2022, updated=Wed Sep 21 11:24:59 CST 2022)
注意,uName和pwd并没有封装到数据,因为pojo的属性名和列名不对应。无法自动封装。
mybatis提供Results注解解决这个问题
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Results {/*** Returns the id of this result map.** @return the id of this result map*/String id() default "";/*** Returns mapping definitions for property.** @return mapping definitions*/Result[] value() default {};
}
其中的id,是给当前这个Results注解起名字,方便在别的地方引用。
其中的Result用来书写具体的列名和属性名的对应关系。
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Repeatable(Results.class)
public @interface Result {/*** Returns whether id column or not.** @return {@code true} if id column; {@code false} if otherwise*/boolean id() default false;/*** Return the column name(or column label) to map to this argument.** @return the column name(or column label)*/String column() default "";/*** Returns the property name for applying this mapping.** @return the property name*/String property() default "";/*** Return the java type for this argument.** @return the java type*/Class<?> javaType() default void.class;/*** Return the jdbc type for column that map to this argument.** @return the jdbc type*/JdbcType jdbcType() default JdbcType.UNDEFINED;/*** Returns the {@link TypeHandler} type for retrieving a column value from result set.** @return the {@link TypeHandler} type*/Class<? extends TypeHandler> typeHandler() default UnknownTypeHandler.class;/*** Returns the mapping definition for single relationship.** @return the mapping definition for single relationship*/One one() default @One;/*** Returns the mapping definition for collection relationship.** @return the mapping definition for collection relationship*/Many many() default @Many;
}
Result注解中常用的几个属性解释:
id:当前的列是否为主键
column:对应数据库中的列名
property:对应pojo中的属性名
javaType:对应的属性名的数据类型
jdbcType:对应的数据库列类型
public interface UserMapper2 {@Select("select * from tb_user where id = #{id}")@Results(id = "uDemo",value = {@Result(column = "user_name",property = "uName",id = false),@Result(column = "password",property = "pwd",id = false),})public User2 selectById(Integer id);@Select("select * from tb_user")public List<User2> selectUsers();
}
重新执行测试,会发现对应的属性已经可以自动封装数据
User2(id=1, uName=zhangsan, pwd=123456, name=张三, age=30, sex=1, birthday=Wed Aug 08 00:00:00 CST 1984, created=Mon Sep 19 16:56:04 CST 2022, updated=Wed Sep 21 11:24:59 CST 2022)
在接口中,如果某个方法上已经使用Results定义好映射关系,别的方法上也需要相同的映射关系,可以使用ResultMap注解引用(前提是Results注解必须使用id属性给其命名)
public interface UserMapper2 {@Select("select * from tb_user where id = #{id}")@Results(id = "uDemo",value = {@Result(column = "user_name",property = "uName",id = false),@Result(column = "password",property = "pwd",id = false),})public User2 selectById(Integer id);@Select("select * from tb_user")// 引用上面已经定义好的结果集映射处理注解Results@ResultMap(value="uDemo")public List<User2> selectUsers();
}
5、多表操作
实体类
@Data
public class Order {private Integer id;private Long userId;private String orderNumber;// 添加用户引用private User user;// 添加订单明细引用(一个订单对应多个明细,需要使用集合来封装)private List<Orderdetail> orderdetails;
}
@Data
public class Orderdetail {private Integer id;private Double totalPrice;private Integer status;// 一个订单明细对应一个商品private Item item;
}
@Data
public class Item {private Integer id;private String itemname;private Float itemprice;private String itemdetail;
}
5.1、注解一对一
演示通过订单明细查询对应的商品,订单明细和商品之间是一对一的关系。
在mybatis提供的@Result注解中有:one和many属性,用于完成多表操作注解映射关系配置
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Repeatable(Results.class)
public @interface Result {// 其他的在上面已经解释过,这里删除省略了...........One one() default @One;Many many() default @Many;
}
- one属性表示的一对一的映射配置
- many属性表示一对多的映射配置
public interface OrderdetailMapper {/*** 通过订单明细查询对应的商品,订单明细和商品之间是一对一的关系* 接收订单明细的id*/// 主查询:根据订单明细的id查询订单明细,但由于订单明细中关联对应的商品信息// 需要使用@Results注解配置关联商品信息映射关系@Select("select * from tb_orderdetail where id = #{id}")// 配置关联查询@Results(value = {// 配置id属性@Result(column = "id",property = "id",id = true),@Result(column = "total_price",property = "totalPrice",id = false),// column配置关联表中的列名// property配置实体类中对应的属性@Result(column = "item_id",property = "item",id = false,// one配置关联的查询// one注解中的select配置对应的关联查询所在的接口中的方法// fetchType配置关联查询是即时查询,还是懒加载查询one=@One(select="com.qbzaixian.mapper.ItemMapper.findById",fetchType = FetchType.EAGER)),})public Orderdetail findOrderdetailAndItem(Integer id);
}
public interface ItemMapper {@Select("select * from tb_item where id = #{id}")public Item findById(Integer id);
}
@Test
public void testOneToOne(){SqlSession session = factory.openSession(true);OrderdetailMapper mapper = session.getMapper(OrderdetailMapper.class);Orderdetail orderdetail = mapper.findOrderdetailAndItem(1);System.out.println(orderdetail);
}
在MyBatis注解开发中,FetchType是一个枚举,它定义了关联对象的加载方式,主要有三个值:
LAZY:延迟加载:指示MyBatis在加载主对象时,不会主动加载关联对象,只有当访问关联对象属性时,才会发起加载。
EAGER:急加载:指示MyBatis在每次加载主对象时,会 joins 一并加载关联对象,相当于SQL的子查询。
DEFAULT:默认加载:指示MyBatis按照全局配置来决定使用延迟加载或急加载。
在MyBatis中,默认一对一采用急加载,一对多采用延迟加载。FetchType可以根据需要指定关联对象的加载方式。
5.2、注解一对多
查询订单信息,每个订单都关联着多个订单详情,需要使用@Results注解进行配置
public interface OrderMapper {@Select("select * from tb_order where id = #{id}")@Results(value = {@Result(property = "id",column = "id",id = true),@Result(property = "orderdetails",column = "id",many = @Many(select = "com.qbzaixian.mapper.OrderdetailMapper.findOrderdetailAndItem",fetchType = FetchType.LAZY))})public Order selectOrderAndOrderDetail(Integer id);
}
@Test
public void testOneToMany(){SqlSession session = factory.openSession(true);OrderMapper mapper = session.getMapper(OrderMapper.class);Order order = mapper.selectOrderAndOrderDetail(1);System.out.println(order);
}
5.3、注解多对多
上面演示的一对多的查询,由于在订单明细中关联查询了商品信息,其实上面的演示已经完成多对多的查询。
一个订单对应多个商品,每个商品可能被添加到不同的订单中。
6、注解开启缓存
注解开启二级缓存,只需要在类上添加@CacheNamespace,并且将blocking属性设置为true即可。
@CacheNamespace(blocking = true)
public class MyBatisTest2 {private SqlSessionFactory factory;
}