一.概述
什麼是MyBatis
MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code,並且改名爲MyBatis 。2013年11月遷移到Github。iBATIS一詞來源於“internet”和“abatis”的 組合
MyBatis 是一款優秀的持久層框架,它支持定製化 SQL、存儲過程以及高級映射。
MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。
MyBatis 可以使用簡單的 XML 或註解來配置和映射原生信息,將接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成數據庫中的記錄。
二.MyBatis的搭建過程
1.準備一個數據庫
CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
`id` INT(20) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL,
PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`name`,`pwd`)
VALUES (1,'劉恆','123456'),(2,'長鳴軒','123456'),(3,'加流域','123456');
2.導包,核心配置中加入MyBatis的依賴
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<dependency> //註釋框架,簡化代碼量
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.8</version>
</dependency>
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>
<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://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
</configuration>
4.編寫一個工具類操作數據庫
package utils;
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 inputStream = Resources.getResourceAsStream(resource);
// 工廠模式
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
// 獲取sqlSession的連接
public static SqlSession getSession(){
return sqlSessionFactory.openSession();
}
}
5. 配置了一個實體類,引入了Lombok
package pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
private int id;
private String name;
private String pwd;
}
6.持久層的操作接口
package mapper;
import pojo.User;
import java.util.List;
// 操作用戶的接口類
public interface UserMapper {
List<User> getUserList();
}
7.編寫SQL,使用配置文件 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">
<!-- 原來我們都是編寫具體的執行sql -->
<mapper namespace="mapper.UserMapper">
<select id="getUserList" resultType="pojo.User">
select * from user;
</select>
</mapper>
8.將UserMapper.xml配置文件註冊到Mybatis的配置文件中
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
9.編寫測試類進行運行
import mapper.UserMapper;
import pojo.User;
import utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import java.util.List;
public class Test {
public static void main(String[] args) {
// 如何獲取接口
// 1、 獲取SqlSession, 執行sql使用的
SqlSession session = MyBatisUtils.getSession();
// 2、通過 session.getMapper(Class ) 獲得接口
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> userList = mapper.getUserList();
for (User user : userList) {
System.out.println(user);
}
}
}
三.CURD增刪改查
1.查詢select
(1)通過id 查詢用戶 User selectById(int id);
- 在接口中編寫:
User selectById(int id);
- 編寫對應的mapper中的sql語句
<select id="selectById" resultMap="bojo.User" >
select *from user where id=#{id};</select>
- 測試
@Test
public void getUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
(2)通過用戶名和密碼查詢用戶
- 在接口中編寫:
User selectByUsernamePwd(@Param("name") String name, @Param("pwd") String pwd);
- 編寫對應的mapper中的sql語句
<select id="selectByUsernamePwd" resultType="pojo.User">
select *from user where name =#{name} and pwd =#{pwd}
</select>
- 測試
import mapper.UserMapper;
import org.apache.log4j.Logger;
import pojo.User;
import utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
class Test {
public static void main(String[] args) {
Logger logger = Logger.getLogger(Test.class);
SqlSession session = MybatisUtils.getSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user1 = mapper.selectByUsernamePwd("劉恆","123456");
System.out.println(user1);
}
}
2.Insert增加
增加一個新用戶
- 在接口中編寫:
int addUser(User user);
- 編寫對應的mapper中的sql語句
<insert id="addUser" parameterType="pojo.User">
insert into mybatis.user (id, name, pwd) values (#{id},#{name},#{pwd});
</insert>
- 編寫測試類
3.修改update
修改用戶信息
- 在接口中編寫:
int updateUser(User user);
- 編寫對應的mapper中的sql語句
<update id="updateUser" parameterType="pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id} ;
</update>
- 測試
4.刪除Delete
刪除一個用戶
- 在接口中編寫:
int deleteUserByID(int id)
- 編寫對應的mapper中的sql語句
<delete id="deleteUserByID" parameterType="int">
delete from mybatis.user where id = #{id};
</delete>
- 測試
注意:
增刪改需要提交事務!
增刪改,標籤一定要對應,參數類型必須要寫
增刪改不用寫返回值,查詢,必須寫返回值,集合、泛型中的內容(具體的對象)
四.字段名與屬性名不一致,正確輸出的解決辦法
1.用as,將屬性名改爲正確的字段名
<select id="selectById" resultType="pojo.User">
select id,name,pwd as password from user where id=#{id};
</select>
2.resultMap結果集映射
<!--結果集映射-->
<resultMap id="UserMap" type="pojo.User>
<!--column數據庫中的字段,property實體類中的屬性-->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserById" resultMap="UserMap">
select * from mybatis.user where id = #{id}
</select>
注意:
當屬性名爲主鍵時,result可以用id替換
column數據庫中的字段,property實體類中的屬性
五.配置解析
1.配置文件
注意:配置文檔中的順序符合上圖
2.環境配置(environments)
<environments default="development">
<!--environments標籤元素可以有多套配置-->
<environment id="development">
<!--transactionManager事務管理器-->
<transactionManager type="JDBC"/>
<!--dataSource數據源配置-->
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
3.屬性(properties)
我們可以通過properties屬性來實現引用配置文件 這些屬性都是可外部配置且可動態替換的,既可以在典型的 Java 屬性文件中配置,亦可通過 properties 元素的子元素來傳遞。
- 編寫一個配置文件 db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis? useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=123456
- 配置db.properties 讓配置文件讀取
<properties resource="db.properties" ></properties>
- 在覈心配置中environment映入
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
4.typeAliases
包的別名配置
<typeAliases>
<package name="pojo"></package> //指定一個包名,MyBatis 會在包名下面搜索需要的 Java Bean
<!--<typeAlias type="pojo.User" alias="user"></typeAlias>爲 Java 類型設置一個短的名字。-->
</typeAliases>
5.映射器(mappers)
MapperRegistry:註冊綁定我們的Mapper文件;
(1)方式一
<!--每一個Mapper.XML都需要在Mybatis核心配置文件中註冊!-->
<mappers>
<mapper resource="Mapper/UserMapper.xml"/>//資源對應的路徑
</mappers>
(2)方式二:使用class文件綁定註冊
<!--每一個Mapper.XML都需要在Mybatis核心配置文件中註冊!-->
<mappers>
<mapper class="Mapper.UserMapper"/>//接口對應的路徑
</mappers>
注意:前提是UserMapper接口和UserMapper.xml在同一個包下
(3)方式三:掃描包
<mappers>
<package name="Mapper"/>
</mappers>