开发笔记:1MyBatis快速入门

• 使用工具：IDEA


• Maven项目环境

步骤

1. 创建项目


2. 导包/添加依赖（Mybatis，mysql-connector-java是必须的）


3. 数据库建表


4. 配置全局配置文件(配置数据源Environment)


5. 创建对象关系模型（POJO）


6. 创建Mapper接口


7. 创建Mapper接口对应的映射文件（xml）


8. 全局配置文件中注册Mapper.xml映射文件


9. 测试

1、创建项目

选择Maven，然后点击next即可；

填写GroupId和ArtifactId，然后一路点击next即可；

2、导包

在POM文件中添加相关依赖（使用mybatis框架至少需要添加Mybatis和mysql-connector-java的依赖）

相关依赖以及可以访问 http://mvnrepository.com/ 进行查找

必须依赖


org.mybatis
mybatis
3.5.5



mysql
mysql-connector-java
8.0.20



其他依赖



junit
junit
4.13
test




log4j
log4j
1.2.17



3、数据库建表

创建数据库

填写数据名（随意），字符集选utf8即可；

CREATE TABLE `user` (
`id` int(11) NOT NULL,
`username` varchar(40),
`birthday` date,
`gender` varchar(40),
`address` varchar(40),
PRIMARY KEY (`id`)
)


添加数据(添加一条简单的数据只是为了方便测试mybatis框架能否从数据库中获得数据)

INSERT INTO `user` VALUES (1, \'lin\', \'1997-08-17\', \'男\', \'汕头市\');


4、配置全局配置文件

注：全局配置文件一般放于类路径下，即项目的resources目录下

该文件名取名为mybatis-config.xml(随意)；


PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">





















这里至少配置数据源用于访问数据库

5、创建对象关系模型（POJO）

创建User实体类，将数据库读取出来的数据封装给该对象


public class User {
private Integer id;
private String username;
private Date birthday;
private String gender;
private String address;
//以下省略了各个属性的get和set方法，以及同String方法
}


6、创建Mapper接口

Mapper接口应该放置于java目录下

文件名为UserDao.java

public interface UserDao {
/**
* 查询所有User对象
*/
List findAllUser();
}


7、创建Mapper接口对应的映射文件（xml）

xml文件默认放置于resources目录下；


PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">




select * FROM user




注意：mapper接口和映射文件必须放置于同样结构的路径下
结构图如下

路径对比如下：

com.example.mybatis.dao.UserDao
com/example/mybatis/dao/UserDao.xml


8、全局配置文件中注册Mapper.xml映射文件

在mappers标签中进行注册

9、测试

public class MyBatisTest01 {
/**
* 测试能否成功获取数据库中的数据
*/
@Test
public void test01() throws IOException {
// 1、读取配置文件(从类路径下开始读取)
InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
// 2、创建SqlSessionFactory工厂
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessiOnFactory= builder.build(in);
// 3、使用工厂生产SqlSession对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 4、使用SQLSession创建Dao接口的代理对象
UserDao userDao = sqlSession.getMapper(UserDao.class);
// 5、使用代理对象执行方法
List users = userDao.findAllUser();
for (User user: users
) {
System.out.println(user);
}
// 6、释放资源
sqlSession.close();
in.close();
}
}


如果测试结果没有报错，则说明mybatis框架搭建成！！！

注意事项

1、测试时，要确保mysql服务是否已经启动
没有启动，则出现该异常 java.net.ConnectException: Connection refused: connect
2、数据源url属性没有添加时区
报错该异常：

com.mysql.cj.exceptions.InvalidConnectionAttributeException： You must configure either the server or JDBC driver (via the \'serverTimezone\' configuration property) to use a more specifc time zone value


3、映射文件Mapper.xml中的namespace属性需要填写对应的Mapper接口的全限定类名，并且保证接口和映射文件的包结构一致；