MyBatis入门

--------------------------siwuxie095

   

   

   

   

   

   

   

   

   

   

搭建 MyBatis 环境

   

   

1、先下载相关库文件，下载链接：

   

https://github.com/mybatis/mybatis-3/releases

   

   

注意：这里选择下载 MyBatis 3.4 版本，下载后，

将 mybatis-3.4.5.zip 解压一览：

   

   

   

   

   

2、导入 MyBatis 的 jar 包

   

   

   

   

   

3、在使用 MyBatis 时，有日志信息输出，所以还要导入

日志相关的 jar 包，打开 lib 文件夹，如下：

   

1）slf4j-api

   

2）slf4j-log4j

   

3）log4j

   

   

   

   

   

4、导入 MySQL 的 JDBC 驱动，下载链接：

   

https://dev.mysql.com/downloads/connector/j/

   

其中，包含：mysql-connector-java

   

   

   

   

5、综上所述，共需 5 个 jar 包

   

   

   

   

   

   

   

   

创建实体类

   

   

包名：com.siwuxie095.entity

类名：User.java

   

   

User.java：

   

package com.siwuxie095.entity;

   

// 实体类

public class User {

 

private Integer uid;

private String username;

private String password;

private String address;

 

public Integer getUid() {

return uid;

}

public void setUid(Integer uid) {

this.uid = uid;

}

 

public String getUsername() {

return username;

}

public void setUsername(String username) {

this.username = username;

}

 

public String getPassword() {

return password;

}

public void setPassword(String password) {

this.password = password;

}

 

public String getAddress() {

return address;

}

public void setAddress(String address) {

this.address = address;

}

 

@Override

public String toString() {

return "User [uid=" + uid + ", username=" + username +

", password=" + password + ", address=" + address + "]";

}

 

}

   

   

   

   

   

   

   

创建数据库和表

   

   

1、创建一个 MySQL 连接：mybatis_conn

   

   

   

   

   

2、创建一个数据库：mybatis_db，其中：字符集 和 排序规则

可不选，图中显示即为默认值

   

   

   

   

   

3、在 mybatis_db 数据库中创建一张表：t_user，其中：uid 为主键，

且设为自动增长

   

   

   

   

   

4、在 t_user 表中插入若干数据

   

   

   

   

   

   

   

   

创建 MyBatis 的映射配置文件

   

   

主要配置映射语句，实现映射关系

   

   

1、创建 XML 格式的配置文件

   

映射配置文件的名称和位置没有固定要求

   

1）位置：建议在 映射器接口所在包 下

   

2）名称：建议为 映射器接口名.xml

   

「映射器接口，也称 映射器类，且有：映射器接口名 = 实体类名 + Mapper」

   

   

   

   

2、在配置文件中引入 XML 约束

   

mybatis-3-mapper.dtd

   

「XML 约束有 DTD 和 Schema 两种，在 MyBatis 的配置文件

中引入的是 DTD 约束」

   

   

在 UserMapper.xml 中添加如下约束：

   

<?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">

   

   

   

 

3、配置映射语句，实现映射关系

   

UserMapper.xml：

   

<?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 属性：命名空间，由于这里没有使用

MyBatis 的动态代理，所以不需要遵循任何规范，

可任意，唯一即可

-->

<mapper namespace="demo">

   

<!--

select 标签：配置映射查询语句

id 属性：在当前命名空间中的唯一标识符

ParameterType 属性：指定参数的 Java 类型，进行参数映射

resultType 属性：指定返回结果的 Java 类型，进行结果映射

 

注：parameterType 属性是可选的，即 可以不写，将自动进行参数映射

-->

<select id="getUser" parameterType="java.lang.Integer" resultType="com.siwuxie095.entity.User">

<!--

具体的 SQL 语句，其中：通过 #{} 占位符 获取传入的参数

 

注意：因为这里只有一个参数，所以大括号中可任意，建议

和实体类属性对应（不是和数据库表字段对应，这里相同只

是巧合）

-->

select * from t_user where uid = #{uid}

</select>

 

</mapper>

   

   

注：由于只是入门，比较简单，所以没有创建映射器接口，也就没有

所谓的映射器接口所在包，这里将 UserMapper.xml 直接放在 src 下

   

   

   

   

   

 

 

创建 MyBatis 的核心配置文件

   

   

1、创建 XML 格式的配置文件

   

核心配置文件的名称和位置没有固定要求

   

1）位置：建议在 src 下

   

2）名称：建议为 mybatis-config.xml

   

   

   

 

2、在配置文件中引入 XML 约束

   

mybatis-3-config.dtd

   

   

在 mybatis-config.xml 中添加如下约束：

   

<?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">

   

   

   

   

3、在核心配置文件中进行相关配置

   

第一部分：配置环境（必须）

   

第二部分：其它配置（可选）

   

第三部分：引入映射配置文件（必须）

   

   

mybatis-config.xml：

   

<?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 根标签 -->

<configuration>

 

 

<!--

第一部分：配置环境

 

配置环境(environments)：包括事务管理和连接池

 

environments 标签其中可以添加多个 environment 标签，

即 多个环境

 

default 属性表示默认环境（从配置的多个环境选一个）

-->

<environments default="development">

<environment id="development">

 

<!-- 配置事务管理器 -->

<transactionManager type="JDBC" />

 

<!-- 配置数据源：这里使用 MyBatis 内置连接池 -->

<dataSource type="POOLED">

<property name="driver" value="com.mysql.jdbc.Driver" />

<!--

jdbc:mysql://localhost:3306/mybatis_db 可省略为 jdbc:mysql:///mybatis_db

-->

<property name="url" value="jdbc:mysql:///mybatis_db" />

<property name="username" value="root" />

<property name="password" value="8888" />

</dataSource>

 

</environment>

</environments>

 

 

<!--

第二部分：其它配置

 

由于这里只是入门，没什么好配置的 ... 所以就不配置

-->

 

 

<!--

第三部分：引入映射配置文件

 

由于只是入门，比较简单，所以没有创建映射器接口，也就没有所谓

的映射器接口所在包，这里将 UserMapper.xml 直接放在 src 下，

而不是像建议的那样放在 映射器接口所在包 下

-->

<mappers>

 

<mapper resource="UserMapper.xml" />

 

</mappers>

 

 

<!--

注意：

 

这三部分的配置顺序并不是这里的 第一部分、第二部分、第三部分 的顺序

 

关于 MyBatis 核心配置文件中的配置顺序，可参照如下链接中从上至下的

标签顺序

 

http://www.mybatis.org/mybatis-3/zh/configuration.html

-->

 

</configuration>

   

   

   

   

   

   

   

测试：实现查询操作

   

   

第一步：加载 MyBatis 核心配置文件

   

第二步：创建 SqlSessionFactory 对象

   

第三步：使用 SqlSessionFactory 创建 SqlSession 对象

   

第四步：编写具体逻辑：CRUD 操作

   

第五步：提交事务

   

第六步：关闭资源

   

   

「注意：只有第四步是变化的」

   

   

包名：com.siwuxie095.test

类名：MyBatisTest.java

   

   

MyBatisTest.java：

   

package com.siwuxie095.test;

   

import java.io.IOException;

import java.io.InputStream;

   

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 com.siwuxie095.entity.User;

   

public class MyBatisTest {

 

/**

* 手动加上 @Test 以进行单元测试（将自动导入 JUnit 4 的 jar 包）

*

* 选中方法名，右键->Run As->JUint Test

*/

@Test

public void testGet() throws IOException {

 

/*

* 第一步：加载 MyBatis 核心配置文件

*

* 直接到 src 下查找 mybatis-config.xml 文件

*/

String resource="mybatis-config.xml";

InputStream inputStream=Resources.getResourceAsStream(resource);

 

 

/*

* 第二步：创建 SqlSessionFactory 对象

*

* 通过 SqlSessionFactoryBuilder 匿名对象调用 build() 方法进行创建

*/

SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);

 

 

/*

* 第三步：使用 SqlSessionFactory 创建 SqlSession 对象

*

* 调用 sqlSessionFactory 的 openSession() 方法进行创建

*/

SqlSession sqlSession=sqlSessionFactory.openSession();

 

 

/*

* 第四步：编写具体的逻辑：CRUD 操作

*

* 调用 sqlSession 的 selectOne() 方法实现查询

*

* 传入参数：

* (1) 映射查询语句的调用（也称 引用）

* (2) 映射查询语句的参数

*

* 通过 namespace.id 来调用相应的映射语句

*/

User user=sqlSession.selectOne("demo.getUser", 1);

System.out.println(user);

 

 

/*

* 第五步：提交事务

*

* 注意：这里是 查，所以跳过 提交事务 这一步

*/

 

 

/*

* 第六步：关闭资源

*

* 关闭 SqlSession 会话

*/

sqlSession.close();

}

 

}

   

   

   

   

   

工程结构目录一览：

   

   

   

   

   

   

   

   

   

   

【made by siwuxie095】