MyBatis是支持普通SQL查询,存储过程和高级映射的优秀持久层框架,与持久层框架Hibernate对比,MyBatis对JDBC的封装相对没有Hibernate深,但对SQL语句的要求较高,优化比较方便。
项目文件结构
通过官方网站https://github.com/mybatis/mybatis-3/releases下载mybatis的最新版本并进行添加(添加到WebContent/WEB-INF/lib下)。
点击项目,右键-->Build Path-->Configure Build Path
然后找到放在WebContent/WEB-INF/lib下的那两个包添加进去即可(添加完成后如上图所示方框所示)
配置log4j.xml文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<!-- Console output -->
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<!-- <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss} %m (%F:%L) \n" /> -->
<param name="ConversionPattern" value="%-5p [%t] - %m%n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="debug" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>
配置数据库文件db.properties(创建此文件时步骤如下:new-->other-->General-->File)
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/数据库名?serverTimezone=UTC
jdbc.username=root
jdbc.password=
配置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>
<!--resource="属性文件名.properties"-->
<properties resource="db.properties"/>
<typeAliases>
<!--实体类所在的包名-->
<package name="com.mybatis.pojo"/>
</typeAliases>
<environments default="development">
<environment id="development">
<!--配置事务管理-->
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<!--resource="映射文件所在的路径"-->
<mapper resource="com/mybatis/mapper/UserInfoMapper.xml"/>
</mappers>
</configuration>
参数说明
接下来轮到编写映射文件,通俗简单点来讲就是SQL语句部分,创建xml文件(右键-->new-->other-->xml File)
<?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.mybatis.mapper.UserInfoMapper">
<!-- 按id查找 -->
<select id="findUserInfoById" parameterType="int" resultMap="userInfoMap">
select * from user_info where id=#{id}
</select>
<resultMap type="Userinfo" id="userInfoMap">
<!-- <id property="uid" column="id"/>当id不一样时添加此语句-->
<result property="sex1" column="sex"/>
</resultMap>
</mapper>
语法及参数说明
<mapper namespace="包名.映射文件名">
<元素名 id="" parameterType="参数类型" resiltType="结果类型">
SQL语句
</元素名>
……………
</mapper>
namespace |
值为映射文件全名(包括包名,不包括扩展名)
例:映射文件为com.mybatis.mapper.UserInfoMapper .xml <mapper namespace="com.mybatis.mapper.UserInfoMapper"> |
parameterType | 参数类型,传递给SQL语句的参数的类型,可以是简单类型,如int等,也可以是对象类型(即类全名) |
#{} | 相当于JDBC中的占位符?,#{id}表示该占位符接收的参数名为id |
resultType | SQL语句返回结果的类型,可以是简单类型,也可以是对象(即将执行结果封装在对象中) 例: <select id="findUserInfoById" parameterType="int" resultType="UserInfo"> select * from user_info where id = #{id} </select> |
resultMap | 用于指定实体类属性与表中字段(一致时不需要指定),其中每个result指定一个,property为实体类中的属性名,column为表中的字段名 <select id="findUserInfoById" parameterType="int" resultMap="userinfoMap"> select * from user_info where id = #{id} </select> <resultMap type="UserInfo" id="userinfoMap"> <id property="id" column="id"/> <result property="sex1" column="sex"/> </resultMap> |
创建实体类(里面的内容是数据库对应字段名),添加set/get方法,toString方法
创建测试类
package com.mybatis.test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
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.After;
import org.junit.Before;
import org.junit.Test;
import com.mybatis.mapper.UserInfoMapper;
import com.mybatis.pojo.UserInfo;
public class MyBatisTest {
private SqlSessionFactory sqlSessionFactory;
private SqlSession sqlSession;
@Before
public void init() {
// 读取mybatis配置文件
String resource = "mybatis-config.xml";
InputStream inputStream;
try {
// 得到配置文件流
inputStream = Resources.getResourceAsStream(resource);
// 根据配置文件信息,创建会话工厂
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 通过工厂得到SqlSession
sqlSession = sqlSessionFactory.openSession();
} catch (IOException e) {
e.printStackTrace();
}
}
// 根据id查询用户
@Test
public void testFindUserInfoById() {
// 通过sqlSession执行映射文件中定义的SQL,并返回映射结果
UserInfo ui = sqlSession.selectOne("findUserInfoById", 1);
// 打印输出结果
System.out.println(ui);
}
@After
public void destroy() {
// 提交事务
sqlSession.commit();
// 关闭sqlSession
sqlSession.close();
}
}
注:selectOne 和 selectList 的不同仅仅是 selectOne 必须返回一个对象。 如果多于一个, 或者 没有返回 (或返回了 null) 那么就会抛出异常。 如果不知道需要多少对象, 使用 selectList。
最后点击测试类中的testFindUserInfoById(),右键-->run as-->Junit test即可运行得到以下结果。
简单的一个小mybatis到这里就完成了。
有一个天大的坑,第一次写非常有可能犯的错:引错包!!!!!