基本概念
MyBatis是一款优秀的持久层框架,用于简化JDBC开发。
持久层
- 负责将数据保存到数据库的那一层代码。
- JavaEE三层架构:表现层、业务层、持久层
框架
- 框架就是一个半成品软件,是一套可重用的、通用的、软件基础代码模型
- 在框架的基础之上构建软件编写更加高效、规范、通用、可扩展。
Mybatis优化
- 硬编码可以配置到配置文件
- 操作繁琐的地方mybatis都自动完成
mybatis的一个简单的入门案例
查询User表中所有数据,具体步骤如下:
1.创建user表,添加数据
CREATE DATABASE mybatis;
USE mybatis;
DROP TABLE IF EXISTS tb_user;
CREATE TABLE tb_user(
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(20),
PASSWORD VARCHAR(20),
gender CHAR(1),
addr VARCHAR(30)
);
INSERT INTO tb_user VALUES
(1,'zhangsan','123','男','北京');
INSERT INTO tb_user VALUES
(2,'李四','234','女','天津');
INSERT INTO tb_user VALUES
(3,'小袁','23','男','西安');
2.创建模块,导入坐标
<dependencies>
<!--mybatis依赖-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.5</version>
</dependency>
<!--mysql 驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.46</version>
</dependency>
<!--junit 单元测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
<!-- 添加slf4j日志api -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.20</version>
</dependency>
<!-- 添加logback-classic依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
<!-- 添加logback-core依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.2.3</version>
</dependency>
</dependencies>
其中logback.xml配置文件是固定的,直接复制到resources资源目录下即可。
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!--
CONSOLE :表示当前的日志信息是可以输出到控制台的。
-->
<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>[%level] %cyan([%thread]) %boldGreen(%logger{15}) - %msg %n</pattern>
</encoder>
</appender>
<logger name="com.it" level="DEBUG" additivity="false">
<appender-ref ref="Console"/>
</logger>
<!--
level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF
, 默认debug
<root>可以包含零个或多个<appender-ref>元素,标识这个输出位置将会被本日志级别控制。
-->
<root level="DEBUG">
<appender-ref ref="Console"/>
</root>
</configuration>
3.编写MyBatis核心配置文件 myatis-config.xml-- > 替换连接信息,解决硬编码问题
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!--数据库连接信息-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="****"/>
</dataSource>
</environment>
</environments>
<mappers>
<!--加载sql映射文件-->
<mapper resource="UserMapper.xml"/>
</mappers>
</configuration>
4.编写 SQL 映射文件 – > 统一管理sql语句,解决硬编码问题
写一个sql映射文件UserMapper.xml表示User表的映射文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace:名称空间-->
<mapper namespace="test">
<select id="selectAll" resultType="com.it.pojo.User">
select * from tb_user;
</select>
</mapper>
如果namespace="test"中test爆红
点击红色灯泡,将Mapper xml inspection(Mapper xml检查)的红色的对号去掉就可以了。
5.编码
- 定义POJO类
public class User {
private Integer id;
private String username;
private String password;
private String genger;
private String addr;
//get和set方法
//tostring方法
}
- 加载核心配置文件,获取SqlSessionFactory对象
- 获取SQLSession对象,执行SQL语句
- 释放资源
/**
* Mybatis 快速入门代码
*
*/
public class MybatisDemo {
public static void main(String[] args) throws IOException {
//1.加载mybatis的核心配置文件,获取SqlSessionFactory,这段代码是固定的,只写一次
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//2.获取SqlSession对象,用它来执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
//3.执行sql
List<User> users = sqlSession.selectList("test.selectAll");
System.out.println(users);
//4.释放资源
sqlSession.close();
}
}
如果遇到SQL映射文件的警告提示,原因在于idea和数据库没有建立连接,没有识别到表的信息,需要在idea中配置MySQL数据库连接。
填写用户名,密码和数据库名称即可,需要注意的是,有可能报时区的错,使时区相同
在url后面加上?serverTimezone=GMT即可。
Mapper代理开发
由于上述代码的仍然存在硬编码问题:如MybatisDemo中的test.selectAll,需要在配置文件中查找,比较麻烦,所以使用Mapper代理的方式来解决这个问题。
使用Mapper代理方式完成入门案例
1.定义与SQL映射文件同名的Mapper接口,并且将Mapper接口和SQL映射文件放置在同一目录下
2.设置SQL映射文件的namespace属性为Mapper接口全限定名
3.在Mapper接口中定义方法,方法名就是SQL映射文件中sql语句的id,并保持参数类型和返回值类型一致
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace:名称空间-->
<mapper namespace="com.it.mapper.UserMapper">
<select id="selectAll" resultType="com.it.pojo.User">
select * from tb_user;
</select>
</mapper>
//UserMapper接口
public interface UserMapper {
List<User> selectAll();
}
4.编码
- 通过SqlSession的getMapper方法获取Mapper接口的代理对象
- 调用对应方法完成sql的执行
public class MybatisDemo2 {
public static void main(String[] args) throws IOException {
//1.加载mybatis的核心配置文件,获取SqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//2.获取SqlSession对象,用它来执行sql
SqlSession sqlSession = sqlSessionFactory.openSession();
//3.执行sql
//List<Object> users = sqlSession.selectList("test.selectAll");
//3.1获取UserMapper接口的代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.selectAll();
System.out.println(users);
//4.释放资源
sqlSession.close();
}
}
细节:如果Mapper接口名称和SQL映射文件名称相同,并在同一目录下,则可以使用包扫描的方式简化SQL映射文件的加载
<mappers>
<!--加载sql映射文件-->
<!--<mapper resource="com/it/mapper/UserMapper.xml"/>-->
<package name="com.it.mapper"/>
</mappers>
需要注意的是在resources下创建包时,不能用“.”而要用“/”来表示分层。
我们可以通过设置别名,对下面代码进行进一步的优化:
<mapper namespace="com.it.mapper.UserMapper">
<select id="selectAll" resultType="com.it.pojo.User">
select * from tb_user;
</select>
</mapper>
由于在UserMapper.xml文件中,resultType比较复杂,resultType是用于指定查询结果的类型的属性。在这个代码中,resultType表示查询结果将会被映射为pojo包下User类型的对象。
具体来说,当MyBatis执行这个select语句后,它会将查询结果集中的每一行数据都映射为一个com.it.pojo.User类型的对象,然后将这些对象封装到一个List中作为查询结果返回。
需要注意的是,com.it.pojo.User类必须满足一定的条件,例如必须有一个无参构造方法,以及类中的属性名必须与查询结果集中的列名相对应等等。这些条件可以通过在com.it.pojo.User类中使用注解或XML配置来实现。
在mybatis-config.xml文件中在标签前面加上:
<typeAliases>
<package name="com.it.pojo"/>
</typeAliases>
在MyBatis中,typeAliases用于为Java类型设置别名,以便在MyBatis映射文件中使用这些别名来代替Java类型的全限定名。(别名为类名,并且不区分大小写)
在这个代码中,<package name="com.it.pojo"/>
表示将com.it.pojo包中的所有Java类都注册为别名。
<mapper namespace="com.itheima.mapper.UserMapper">
<!--<select id="selectAll" resultType="com.it.pojo.User">
select * from tb_user;
</select>-->
<select id="selectAll" resultType="User">
select * from tb_user;
</select>
</mapper>
注意:当数据库的表的字段名称和实体类的属性名称不一样时,可以使用resultMap标签,然后在select标签中,使用resultMap属性替换resultType属性。
例如:
<resultMap id="brandResultMap" type="brand">
<!--
id: 完成主键字段的映射
column:表的列名
property:实体类的属性名
result:完成一般字段的映射
column:表的列名
property:实体类的属性名
-->
<result column="brand_name" property="brandName" />
<result column="company_name" property="companyName" />
</resultMap>
<select id="selectAll" resultMap="brandResultMap">
select
*
from tb_brand;
</select>
注解开发
使用注解开发可以将原本需要写在SQL配置文件中的SQL语句和映射关系,改为使用注解来定义和配置。这样可以将SQL语句和映射关系直接与Java代码结合在一起,使得代码更加简单和紧凑。
举个例子,假设有一个User表,需要根据id查询用户信息的sql语句可以通过注解来定义:
public interface UserMapper {
List<User> selectAll();
@Select("select * from tb_user where id = #{id}")
User selectById(int id);
}
在上述例子中,@Select注解表示该方法是一个查询语句,其中的sql语句是直接写在注解中的。通过#{id}来表示参数的占位符。这样,当调用selectById方法时,就会执行对应的sql查询语句,并将结果映射为User对象返回。
使用注解开发可以简化配置,使得代码更加直观和易于理解。但需要注意的是,注解开发虽然方便,但也有一定的局限性,例如无法动态修改SQL语句和映射关系,不适用于复杂的SQL操作等。虽然方便,但也有一定的局限性。
以上就是mybatis的部分基本使用,感谢您的阅读,如果有不正确的地方还请多多指教。
欢迎大家留言讨论,如果对您有帮助还请点个赞啊!😄