搭建MyBatis实例
开发环境
创建maven工程、
建立sql表单、
创建MyBatis核心配置文件、
创建Mapper接口、
创建MyBatis的映射文件、
通过junit进行测试、
加入log4j日志功能
开发环境
IDE:idea 2019.2
构建工具:maven 3.5.4
MySQL版本:MySQL 5.7
MyBatis版本:MyBatis 3.5.7
创建maven工程
配置maven打包方式为jar
a>打包方式:jar
引入mybatis、junit、mysql依赖
b>引入依赖
<dependencies>
<!-- Mybatis核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.3</version>
</dependency>
</dependencies>
建立sql表单
创建MyBatis的核心配置文件
习惯上命名为mybatis-config.xml,这个文件名仅仅只是建议,并非强制要求。将来整合Spring
之后,这个配置文件可以省略,所以大家操作时可以直接复制、粘贴。
核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
核心配置文件存放的位置是src/main/resources目录下
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:13306/mybatis"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>
创建mapper接口
MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要提供实现类
package com.sdjzu.mybatis.mapper;
import com.sdjzu.mybatis.pojo.User;
import java.util.List;
/*、
*mapper接口
* */
public interface UserMapper {
/*
* */
/*
* 添加用户信息
* */
//执行sql语句,将结果返回(影响的行数)
int insertUser();
/*
* 修改用户信息
* */
void updateUser();
/*
* 删除用户信息
* */
void deleteUser();
/*
* 根据id查找
* */
User getUserById();
/*
* 查询集合
* */
List<User> getUserList();
}
创建User类pojo,对应表单t_user
创建MyBatis的映射文件
- 相关概念:ORM(Object Relationship Mapping)对象关系映射。
- 对象:Java的实体类对象
- 关系:关系型数据库
- 映射:二者之间的对应关系
- 映射文件的命名规则
- 表所对应的实体类的类名+Mapper.xml
- 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
- 因此一个映射文件对应一个实体类,对应一张表的操作
- MyBatis映射文件用于编写SQL,访问以及操作表中的数据
- MyBatis映射文件存放的位置是src/main/resources/mappers目录下
- MyBatis中可以面向接口操作数据,要保证两个一致
- mapper接口的全类名和映射文件的命名空间(namespace)保持一致
- mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
调用接口中的方法:
①根据接口的全类名找到xml文件
②根据方法名找到xml中的sql语句
<?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 namespace="com.sdjzu.mybatis.mapper.UserMapper">
<!--int insertUser();-->
<insert id="insertUser">
insert into t_user values(null,'admin','123456',23,'男','12345@qq.com')
</insert>
<!--void updateUser();-->
<update id="updateUser">
update t_user set username='jay' where id=1
</update>
<delete id="deleteUser">
delete from t_user where id=2
</delete>
<!--User getUserById();-->
<select id="getUserById" resultType="com.sdjzu.mybatis.pojo.User">
select * from t_user where id=1
</select>
<!--List<User> getUserList();-->
<select id="getUserList" resultType="com.sdjzu.mybatis.pojo.User">
select * from t_user
</select>
</mapper>
通过junit测试功能
- SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的会话)
- SqlSessionFactory:是“生产”SqlSession的“工厂”
- 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象
- 此时需要手动提交事务,如果要自动提交事务,则在获取sqlSession对象时,使用
SqlSession sqlSession = sqlSessionFactory.openSession(true);
,传入一个Boolean类型的参数,值为true,这样就可以自动提交
**
在测试过程中出现的问题
**
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.sdjzu.mybatis.mapper.UserMapper.insertUser
出现这种错误检查两点
1.接口的全类名输入是否正确
2.方法是否输入正确
org.apache.ibatis.exceptions.PersistenceException:
### Error updating database. Cause: java.sql.SQLException: Error setting driver on UnpooledDataSource. Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.cj.jdbc.Driver
### The error may exist in mappers/UserMapper.xml
### The error may involve com.sdjzu.mybatis.mapper.UserMapper.insertUser
### The error occurred while executing an update
### Cause: java.sql.SQLException: Error setting driver on UnpooledDataSource. Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.cj.jdbc.Driver
Process finished with exit code -1
出现这种错误:驱动的连接方式不对
mysql5.0:com.mysql.jdbc.Driver
mysql8.0: com.mysql.cj.jdbc.Driver
最终测试成功:
package com.sdjzu.mybatis.test;
import com.sdjzu.mybatis.mapper.UserMapper;
import com.sdjzu.mybatis.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class MyBatisTest {
/*
* SqlSession默认不自动提交事务,若需要自动提交事务:设置为true*/
@Test
public void UserTest() throws IOException {
//加载核心配置文件(设置连接数据库的环境)mybatis-config.xml
//Resources是一个类,调用静态方法
InputStream is= Resources.getResourceAsStream("mybatis-config.xml");
//获取sqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder=new SqlSessionFactoryBuilder();
//获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//获取sqlSession对象
/*
* SqlSession默认不自动提交事务,若需要自动提交事务:设置为true*/
SqlSession sqlSession = sqlSessionFactory.openSession(true);
//获取mapper对象
//sqlSession.getMapper()该方法可以返回接口的实现类的对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//测试功能
//mapper接口的实现类对象调用mapper接口中的方法
int result= mapper.insertUser();
//提交事务
//sqlSession.commit();
System.out.println("result(影响的行数):" + result);
}
@Test
public void updateTest() throws IOException {
//加载核心配置文件(设置连接数据库的环境)mybatis-config.xml
//Resources是一个类,调用静态方法
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//获取sqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//获取sqlSession对象
/*
* SqlSession默认不自动提交事务,若需要自动提交事务:设置为true*/
SqlSession sqlSession = sqlSessionFactory.openSession(true);
//获取mapper对象
//sqlSession.getMapper()该方法可以返回接口的实现类的对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//测试功能
mapper.updateUser();
}
@Test
public void deleteTest() throws IOException {
//加载核心配置文件(设置连接数据库的环境)mybatis-config.xml
//Resources是一个类,调用静态方法
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//获取sqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//获取sqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//获取sqlSession对象
/*
* SqlSession默认不自动提交事务,若需要自动提交事务:设置为true*/
SqlSession sqlSession = sqlSessionFactory.openSession(true);
//获取mapper对象
//sqlSession.getMapper()该方法可以返回接口的实现类的对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//测试功能
//mapper.deleteUser();
//根据id查询
/*User userById = mapper.getUserById();
System.out.println(userById);*/
//查询集合
List<User> userList = mapper.getUserList();
//循环遍历list集合
for (int i = 0; i <userList.size() ; i++) {
System.out.println(userList.get(i));
}
}
}
** 加入log4j日志功能**
加入依赖
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
加入log4j的配置文件
log4j的配置文件名为log4j.xml, 存放的位置是src/main/resources目录下
日志的级别: FATAL(致命)>ERROR(错误)>WARN(警 告)>INFO(信息)>DEBUG(调试)
从左到右打印的内容越来越详细(复制过去代码爆红,忽略即可)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="info" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>
MyBatis的增删改查
mybatis中的功能如何写:mybatis中的功能是面向接口编程,所以首先要有mapper接口中的方法,再又方法找到映射文件中的SQL
-
添加
<!--int insertUser();--> <insert id="insertUser"> insert into t_user values(null,'admin','123456',23,'男','12345@qq.com') </insert>
-
删除
<!--int deleteUser();--> <delete id="deleteUser"> delete from t_user where id = 6 </delete>
-
修改
<!--int updateUser();--> <update id="updateUser"> update t_user set username = '张三' where id = 5 </update>
-
查询一个实体类对象
<!--User getUserById();--> <select id="getUserById" resultType="com.atguigu.mybatis.bean.User"> select * from t_user where id = 2 </select>
-
查询集合
<!--List<User> getUserList();--> <select id="getUserList" resultType="com.atguigu.mybatis.bean.User"> select * from t_user </select>
- 注意:
- 查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射关系
- resultType:自动映射,用于属性名和表中字段名一致的情况
- resultMap:自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
- 当查询的数据为多条时,不能使用实体类作为返回值,只能使用集合,否则会抛出异常TooManyResultsException;但是若查询的数据只有一条,可以使用实体类或集合作为返回值