MyBatis-入門
第一個MyBatis程式
學習任何東西的思路都是:
搭建環境 -> 匯入依賴 -> 編寫程式碼 -> 測試
搭建環境
首先安裝資料庫和資料庫管理軟體,這裡直接使用以前的MySQL和SQLyog,
然後建立相關的資料庫和資料表
-- 每個sql語句以分號結尾 CREATE DATABASE mybatis; USE mybatis; CREATE TABLE `user`( `id` INT(20) NOT NULL PRIMARY KEY, `name` VARCHAR(30) DEFAULT NULL, `pwd` VARCHAR(30) DEFAULT NULL )ENGINE=INNODB DEFAULT CHARSET=utf8; INSERT INTO `user` VALUES(1,'張三','111'),(2,'李四','000'),(3,'王五','666');
建立父子工程
-
建立父Maven - 空專案
-
刪除src目錄,父工程不寫程式碼的,只管匯入依賴
-
配置父工程的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>com.hong</groupId> <artifactId>MyBatis-Study</artifactId> <version>1.0-SNAPSHOT</version> <!--匯入相關依賴--> <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.11</version> </dependency> </dependencies> </project>
-
建立模組 -- Maven子專案繼承父專案的依賴
編寫配置檔案
在子專案的resources目錄下建立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&userUnicode=true&characterEncoding=UTF-8"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> </configuration>
封裝工具類
MybatisUtils.java
package com.hong.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 {
// 使用MyBatis的第一步就是獲取sqlSessionFactory物件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 通過工廠生產sqlSession物件
* @return sql操作物件
*/
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
編寫程式碼
實體類
Dao介面
介面實現類
-
pojo
package com.hong.pojo; // 實體類 public class User { 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; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getPwd() { return pwd; } public void setPwd(String pwd) { this.pwd = pwd; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", pwd='" + pwd + '\'' + '}'; } }
-
dao
package com.hong.dao; import com.hong.pojo.User; import java.util.List; /** * 以後的dao都寫成mapper */ public interface UserDao { // 獲取使用者列表 List<User> getUserList(); }
-
實現類由原來的UserDaoImpl轉變為Mapper配置檔案
原來的實現類(對比而已,現在不用了!)
package com.hong.dao; import com.hong.pojo.User; import java.util.List; /** * 以前jdbc時都是寫這種實現類 * 使用MyBatis之後就用xml實現 */ public class UserDaoImpl implements UserDao { public List<User> getUserList() { // 底層的JDBC跟資料庫打交道,拿到使用者列表後返回 return null; } }
Mybatis的Mapper配置檔案
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="com.hong.dao.UserDao"> <!--select查詢語句 --> <select id="getUserList" resultType="com.hong.pojo.User"> select * from mybatis.user </select> </mapper>
解釋:在xml中不能匯入包,所以要寫全路徑。id繫結的是介面的方法,返回結果是列表中的泛型。中間寫sql語句
測試
執行出錯跳轉到後面看看
UserDaoTest.java
package com.hong.dao;
import com.hong.pojo.User;
import com.hong.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
@Test
public void test() {
// 獲取資料庫操作物件
SqlSession sqlSession = MybatisUtils.getSqlSession();
try {
// 方式1 建議使用
UserDao userDao = sqlSession.getMapper(UserDao.class);
List<User> userList = userDao.getUserList();
// 方式2 老版本的獲取方式
// List<User> userList = sqlSession.selectList("com.hong.dao.UserDao.getUserList");
for (User user : userList) {
System.out.println(user);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
sqlSession.close();
}
}
}
解決完報錯之後的執行結果
User{id=1, name='張三', pwd='111'}
User{id=2, name='李四', pwd='000'}
User{id=3, name='王五', pwd='666'}
遇到的問題
注意點!這裡有很多坑要注意啦
-
沒有註冊mapper -> 繫結異常
Type interface com.hong.dao.UserDao is not known to the MapperRegistry.
-
回到核心配置檔案mybatis-config.xml中註冊mapper
<?xml version="1.0" encoding="UTF8" ?> <!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&userUnicode=true&characterEncoding=UTF-8"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/hong/dao/UserMapper.xml"/> </mappers> </configuration>
-
-
找不到資源 -> 可能是靜態資源被過濾,檢視target目錄下有沒有UserMapper.xml。也可能是路徑寫錯了
-
如果在target目錄下找不到,則在子專案的pom.xml新增一下程式碼
<build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.properties</include> <include>**/*.xml</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/java</directory> <includes> <include>**/*.properties</include> <include>**/*.xml</include> </includes> </resource> </resources> </build>
-
註冊mapper時,路徑使用斜槓分隔。
com/hong/dao/UserMapper.xml
-
-
版本相容問題,報錯一位元組錯誤時,將
<?xml version="1.0" encoding="UTF-8" ?>
的UTF-8
改成UTF8
-
建議不要在xml內出現中文,包括註釋
總結
使用配置檔案替代原來繁雜的JDBC操作,但思想都是一樣的。