一、环境搭建准备
1. 首先我们在IDEA中新建一个Project,然后选中左边的Maven,点击Next创建一个不使用模板的普通项目,填写好项目名及路径(按自己的习惯来),建立后大致如下图:
为了方便分模块学习,我们将其中的src删除(pom.xml不能删)用来之后创建更多的子模块,父工程就建立完成了。
_
2. 之后在父工程上新建一个Module,和刚才的操作一样,可以得到如下图的结构:
_
如果其中的文件没有特殊功能颜色标记,我们可以右键该文件,找到Mark Directory as以用来标记功能颜色:
_
或者点击右上角File,找到Project Structure,在项目结构中点击对应颜色进行标记:
_
3.在pom.xml中导入我们所需要的包
<?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>org.example</groupId>
<artifactId>Mybatis-Study</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>mybatis-01</module>
</modules>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
<properties>
<maven.compiler.source>15</maven.compiler.source>
<maven.compiler.target>15</maven.compiler.target>
</properties>
</project>
- 父工程中导入的依赖包在它的所有子模块里都可以用得到,而在子模块里导入的依赖包不能在另外一个子模块中用
- 在maven仓库里(浏览器搜索)可以搜索到该包的所有版本和放在xml文件中的格式
- 该xml展示的是父工程中的pom.xml,我们只需在其中加入dependencies标签,然后在该标签下按格式编写需要导入的依赖包,点击下图标标后maven会自动下载它包括的所有信息。如果不能自动下载,则需手动添加至依赖中
4. IDEA连接数据库,方便我们查看数据库和编写实体类
点击右侧的DataBase,添加我们所要用的数据库
_
在General中填写好来连接数据库的参数,Test Connection测试连接能否成功,成功后在Schemas中选择我们想展示的库,也可以在后期再更改。
_
二、代码文件编写
- 映射框架肯定少不了实体类,纯mybatis中我们把pojo类放置在与dao包同路径下
- 开始面向接口编程,dao包下创建需要操作相应数据的功能接口与该接口同名的xml文件,后缀均为Mapper得以与其他文件区分作用
- 在resources目录下编写mybatis-config.xml文件,里面存放的是我们mybatis的核心配置文件
- 在与dao同级路径下建立uitl包,包中编写实用的类方法可以增加我们的测试效率
其中:
pojo包中的User类对应我们想映射出来的数据库表的数据
对应的User类如下,并在记得其中右键选择generate生成属性的get和set方法!
package com.xin.pojo;
import java.io.Serializable;
public class User implements Serializable { //尽量将实体类可序列化
private int id;
private String name;
private String pwd;
public User(){}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
}
_
在dao中,UserMapper接口里编写我们想得到哪些数据的接口方法:
package com.xin.dao;
public interface UserMapper {
public List<User> getUserList(); //获得所有User
}
_
而UserMapper.xml中编写UserMapper接口中对应方法的业务实现:
<?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都要在mybatis.config.xml注册来绑定 -->
<mapper namespace="com.xin.dao.UserMapper"> <!--映射 绑定接口-->
<!-- 绑定接口方法 结果集映射类型 -->
<select id="getUserList" resultType="com.xin.pojo.User">
select * from mybatis.user
</select>
</mapper>
- 在mapper标签上的namespace表明所作用的接口
- 在mapper标签里写对应的接口方法的业务逻辑实现
- 其中,slelect标签对应查找的sql,如insert,delete,update等标签对应相应的逻辑sql
- slelect标签上id属性绑定接口中对应的方法,resultType属性指明结果集映射在哪个实体类里(没有别名的话得写明路径),类似于表中一行记录(包括列名和数据)对应一个类对象(类里的属性和值)
- selelct标签里面写对应的sql语句
- 还有一定不能忘了在mybatis-config.xml中注册该mapper.xml
在mybatis-config.xml里配置mybatis核心配置文件:
<?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"/> <!--事务管理器还有另一个MANAGED-->
<dataSource type="POOLED"> <!--dataSource type有三个 POOLED:有连接池-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8&useUnicode=true&useSSL=false"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/xin/dao/UserMapper.xml"/>
</mappers>
</configuration>
在configuration标签下的mappers标签下注册mapper.xml,采用的格式和方法不固定,最好是上图这种方法,适用性强可读性高。resource中对应mapper.xml的路径。
_
然后是util中编写工具类MybatisTUtils:
package com.xin.util;
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 java.io.IOException;
import java.io.InputStream;
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
String resource="mybatis-config.xml";
InputStream resourceAsStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
} catch (IOException e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession(){ //从工厂中获得操作sql的对象
return sqlSessionFactory.openSession();
}
}
- static静态代码块提前加载好对应的静态属性SqlSessionFactory,这样写与生命周期和效率有关,这里和sqlSession的加载过程以后的文章会说
- ibatis是以前mybatis的称谓
- 全写成静态方法可以不用去麻烦的new
最后就是我们的测试方法了,在与main同级的test包下新建一个类MyTest:
package test.xin.dao;
import com.xin.dao.UserMapper;
import com.xin.pojo.User;
import com.xin.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;
public class UserDaoTest {
@Test
public void testSelect(){
SqlSession sqlSession = MybatisUtils.getSqlSession(); //获得SqlSession对象
//获得UserMapper的映射,UserMapper和UserMapper.xml绑定了(getUserList,select)
UserMapper mapper = sqlSession.getMapper(UserMapper.class);//UserMapper和UserMapper.xml可以看作是一个东西
List<User> userList = mapper.getUserList();
for (User user : userList) {
System.out.println(user);
}
sqlSession.close(); //记得关闭
}
}
- @Test方法由junit包提供,单元测试,在方法上标记注解可以当作主方法一样直接运行该方法,可以让我们在一个类里更方便的测试
- 在工具类中获取SqlSession对象,而SqlSession对象包含了mybatis-config.xml下的所有配置,可以直接getMapper(接口.class)得到对应的mapper接口和mapper.xml结合的转型的mapper父类,并且该接口已经实现了逻辑
最后我们可以得到如下的结果:
User{id=1, name='李信', pwd='12345'}
User{id=2, name='李白', pwd='123456'}
User{id=3, name='李清照', pwd='123456'}
User{id=4, name='李世民', pwd='123456'}
User{id=5, name='李时珍', pwd='123456'}
User{id=6, name='李元芳', pwd='123456'}
User{id=7, name='李商隐', pwd='123456'}
User{id=8, name='李牧', pwd='123456'}
User{id=9, name='李世英', pwd='123456'}
User{id=10, name='奥利奥', pwd='123456'}
表中的数据为:
如有错误还请提出指正!