IDEA中創建mybatis項目
相比於傳統的JDBC代碼太復雜了,mybatis更加簡化,框架,自動化。
思路:搭建環境 --> 導入MyBatis --> 編寫代碼 --> 測試
1.創建項目並導入相關jar包
maven項目
首先你需要在pom文件中導入以下三個jar包
用於數據庫連接的jar包
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.25</version>
</dependency>
mybatis的jar包
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
junit包,用於測試
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.25</version>
</dependency>
導入后點以下刷新按鈕就ok啦
如果需要其它版本的jar包,可以去Maven Repository上查找,可以直接導入maven項目中,如果不是maven項目就直接手動導入這幾個jar包。
普通項目
2.相關配置文件
XML 配置文件中包含了對 MyBatis 系統的核心設置,包括獲取數據庫連接實例的數據源(DataSource)以及決定事務作用域和控制方式的事務管理器(TransactionManager)。下面是一個簡單的實例,
你需要將這個xml核心配置文件放在resource資源下
<?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">
<!--這里是從屬性文件db.properties文件讀取的鍵值對數據,用於連接數據庫-->
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<!--這里是改為自己接口的映射文件的路徑,下面的第二張圖片為例子-->
<mapper resource="com/zky/dao/UserMapper.xml"/>
</mappers>
</configuration>
配置的db.properties文件(數據庫和用戶名、密碼都改為自己的)
```properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?userSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
username=root
password=123456
下面這個是接口的映射路徑,不要和上面的搞混淆了。
3.mybatis的簡單原理
1.所有的mybatis應用都是以SqlSessionFactory 的實例為核心的。
2.SqlSessionFactory是通過SqlSessionFactoryBuilder所創建。
3.SqlSessionFactoryBuilder一般是通過一個xml核心配置文件來實例出SqlSessionFactory實例的。
String resource = "mybatis-config.xml";//我的核心配置文件的名字
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
通過上面的三段代碼就可以生成一個SqlSessionFactory實例,一般放在工具類里,而resource就是我們需要導入的xml配置文件的路徑。
4.工具類
package com.zky.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 {
static SqlSessionFactory sqlSessionFactory = null;
static {
try {
//使用Mybatis第一步:獲取SqlSessionFactory
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了SqlSessionFactory,顧名思義,我們需要獲得SqlSession的實例
//SqlSession 提供了在數據庫執行SQL命令所需的所有方法
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
5.實體類
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-tm2NRmqj-1627114335084)(C:\Users\zky\AppData\Roaming\Typora\typora-user-images\image-20210724151450386.png)]
package com.zky.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 + '\'' +
'}';
}
}
6.接口以及mapper映射(簡單的實現CRUD)
我的接口
package com.zky.dao;
import com.zky.pojo.User;
import java.util.List;
import java.util.Map;
public interface UserMapper {
//查詢所有用戶
public List<User> getUserList();
//插入用戶
public void addUser(User user);
//通過Map增加用戶
public void addUser2(Map<String,Object> map);
//刪除用戶
public void deleteUser(int id);
//修改用戶
public void updateUser(User user);
//查詢用戶
public User selectUser(int id);
//模糊查詢
public List<User> getUserLike(String str);
}
我的UserMapper.xml文件
這里的UserMapper.xml文件就相當於接口的實現類,分別實現了接口里的方法。
<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace=綁定一個指定的Dao/Mapper接口-->
<!--
id:就是對應的namespace中的方法名;
resultType : Sql語句執行的返回值;
parameterType : 參數類型;
-->
<mapper namespace="com.zky.dao.UserMapper">
<!-- 查詢所有用戶-->
<select id="getUserList" resultType="com.zky.pojo.User">
select * from mybatis.user;
</select>
<!-- 增加用戶-->
<insert id="addUser" parameterType="com.zky.pojo.User">
insert into mybatis.user(`id`,`name`,`pwd`) values (#{id},#{name},#{pwd});
</insert>
<insert id="addUser2" parameterType="map">
insert into mybatis.user(`id`,`name`,`pwd`) values (#{userid},#{username},#{userpassword});
</insert>
<!-- 刪除用戶-->
<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id = #{id};
</delete>
<!-- 修改用戶-->
<update id="updateUser" parameterType="com.zky.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id};
</update>
<!-- 查詢用戶-->
<select id="selectUser" parameterType="int" resultType="com.zky.pojo.User">
select * from mybatis.user where id = #{id};
</select>
<!-- 模糊查詢-->
<select id="getUserLike" parameterType="String" resultType="com.zky.pojo.User">
select * from mybatis.user where `name` like #{str};
</select>
</mapper>
7.創建測試類
創建與main目錄中相同的路徑
package com.zky.dao;
import com.zky.pojo.User;
import com.zky.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class UserMapperTest {
//查詢全部用戶測試
@Test
public void test(){
//1.獲得SqlSession對象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//2.執行SQL
//方式一:getMapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = userMapper.getUserList();
//方式二:
//List<User> userList1 = sqlSession.selectList("com.zky.dao.UserDao.getUserList");
for (User user:userList
) {
System.out.println(user);
}
sqlSession.close();
}
//增加用戶測試
@Test
public void addtext(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = new User(3,"凡凡","666");
mapper.addUser(user);
//提交事務,增刪改操作必須加上
sqlSession.commit();
sqlSession.close();
}
//通過map測試
@Test
public void addtext2(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("userid",6);
map.put("username","王大媽");
map.put("userpassword",789);
mapper.addUser2(map);
//提交事務
sqlSession.commit();
//關閉資源
sqlSession.close();
}
//刪除用戶測試
@Test
public void deletetext(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int id = 4;
mapper.deleteUser(id);
sqlSession.commit();
sqlSession.close();
}
//更新用戶測試
@Test
public void updatetext(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = new User(3, "涵玉", "6");
mapper.updateUser(user);
sqlSession.commit();
sqlSession.close();
}
//查詢單個用戶測試
@Test
public void selectuser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int id = 3;
User user = mapper.selectUser(id);
//查詢不用提交事務
System.out.println(user);
sqlSession.close();
}
//模糊查詢
@Test
public void getUserLikeTest(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
String str = "王%";
List<User> userLike = mapper.getUserLike(str);
for (User user:userLike
) {
System.out.println(user);
}
sqlSession.close();
}
}
我的數據庫
查詢全部用戶測試結果
增加用戶測試結果
另外的都是相同的原理、可以自己去測試。
8.注意:
1.報錯org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
還未在核心配置文件中注冊mappers,你需要在mappers里放入你的mapper resources。
2.增刪改一定要提交事務,不然程序無法正常執行
3.報錯java.lang.NullPointerException: Cannot invoke "org.apache.ibatis.session.SqlSessionFactory.openSession()" because "com.zky.utils.MybatisUtils.sqlSessionFactory" is null
這個錯誤很容易遇到,這是因為我們寫的xml等配置文件無法直接作為資源被程序讀取,我們必須在pom文件中加入下列代碼,使程序能夠讀我們的xml和properties相關的配置文件。
<!--在build中配置resources,來防止我們資源導出失敗的問題-->
<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>
<filtering>true</filtering>
</resource>
</resources>
</build>