MyBatis详解(一):入门程序
目录
3.2、在src下建立log4j.properties文件(file)
3.6、编写mybatis的配置文件SqlMapConfig.xml
3.9、在SqlMapConfig.XML文件中加载po类的映射文件
一、对原生态jdbc程序中问题总结
关于jdbc部分的讲解可以参照博客:
快速学会使用JDBC+原理的全面详解(二)之快速学会使用JDBC、工具类、连接池
1.1、原始jdbc程序步骤:
(1) 注册驱动
JDBC类库向DriverManager注册数据库驱动·
(2)建立连接(url、username、password)
使用DriverManager提供的getConnection()方法连接到数据库
(3)创建SQL语句,获取语句执行对象
编写SQL语句,并建立SQL语句执行对象
(4)执行语句
执行SQL语句,并将结果集合返回到ResultSet中
(5)处理结果
(6)释放资源(注意关闭的顺序)
1.2、原生态jdbc程序问题总结
1、数据库连接,使用时就创建,不使用立即释放,对数据库进行频繁连接开启和关闭,造成数据库资源浪费,影响 数据库性能。
设想:使用数据库连接池管理数据库连接。
2、将sql语句硬编码到java代码中,如果sql 语句修改,需要重新编译java代码,不利于系统维护。
设想:将sql语句配置在xml配置文件中,即使sql变化,不需要对java代码进行重新编译。
3、向preparedStatement中设置参数,对占位符号位置和设置参数值,硬编码在java代码中,不利于系统维护。
设想:将sql语句及占位符号和参数全部配置在xml中。
4、从resutSet中遍历结果集数据时,存在硬编码,将获取表的字段进行硬编码,,不利于系统维护。
设想:将查询的结果集,自动映射成java对象。
二、mybatis框架
2.1、mybatis是什么
mybatis是一个持久层的框架,是apache下的顶级项目。
mybatis托管到goolecode下,再后来托管到github下(https://github.com/mybatis/mybatis-3/releases)。
mybatis让程序将主要精力放在sql上,通过mybatis提供的映射方式,自由灵活生成(半自动化,大部分需要程序员编写sql)满足需要sql语句。
mybatis可以将向 preparedStatement中的输入参数自动进行输入映射,将查询结果集灵活映射成java对象。(输出映射)
2.2、mybatis框架示意图
三、入门程序
3.1、jar包
这里给出SSM的全部jar包,即包括springMVC的。
ssm全部jar包(jdk1.7和spring3)链接:https://pan.baidu.com/s/11yS772MV2MTYt0kgtSwjMw
提取码:z4v7
ssm整合jar包(jdk1.8和spring4)链接:https://pan.baidu.com/s/1vEjPgqW8tNpwFtEUPZeWPQ
提取码:swlp
注意:jdk1.7和spring3的jar包兼容。
jdk1.8及以上和spring3的jar包不兼容!和spring4的jar包兼容
3.2、在src下建立log4j.properties文件(file)
# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
将上面内容复制进去
注意:需要直接在src下建立log4j.properties文件,而非在其子文件夹下。
如果出现一下异常:请参考博客:https://mp.csdn.net/postedit/86485140
log4j:WARN No appenders could be found for logger (org.apache.ibatis.logging.LogFactory).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
3.3、工程结构
IDEA下的工程结构如下:
config:用于存放xml文件
mybatis:用于存放po类、dao开发方法的接口和实现类、mapper开发方法的接口和xml文件
test:用于存放测试程序
3.4、入门程序需求
根据mybatis数据库的user表实现一下几个操作:
根据用户id(主键)查询用户信息
根据用户名称模糊查询用户信息
添加用户
删除用户
更新用户
3.5、编写db.properties
将数据库的一些信息单独存放在db.properties文件中,便于维护
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC
jdbc.username=root
jdbc.password=mysql
3.6、编写mybatis的配置文件SqlMapConfig.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>
<!-- 加载属性文件 -->
<properties resource="config/db.properties">
<!--properties中还可以配置一些属性名和属性值 -->
<!-- <property name="jdbc.driver" value=""/> -->
</properties>
<!-- 和spring整合后 environments配置将废除-->
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理,事务控制由mybatis-->
<transactionManager type="JDBC" />
<!-- 数据库连接池, 由mybatis管理-->
<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>
</configuration>
程序内有一些注释,可以参考
3.7、创建po类(即所要映射成的类,本例中为User类)
package mybatis.po;
import java.util.Date;
public class User {
private int id;
private String username;
private Date birthday;
private String sex;
private String address;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
}
3.8、映射文件
映射文件命名:
User.xml(原始ibatis命名),mapper代理开发映射文件名称叫XXXMapper.xml,比如:UserMapper.xml、ItemsMapper.xml
在映射文件中配置sql语句。
<?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="user">
<!-- 在映射文件中配置很多sql语句 -->
<!-- 通过select执行数据库查询
id:标识 映射文件中的 sql
将sql语句封装到mappedStatement对象中,所以将id称为statement的id
parameterType:指定输入参数的类型,这里指定int型
#{}表示一个占位符号
#{id}:其中的id表示接收输入的参数,参数名称就是id,如果输入参数是简单类型,#{}中的参数名可以任意,可以value或其它名称
resultType:指定sql输出结果的所映射的java对象类型,select指定resultType表示将单条记录映射成的java对象。
-->
<select id="findUserById" parameterType="int" resultType="mybatis.po.User">
SELECT * FROM USER WHERE id= #{id}
</select>
<!-- 根据用户名称模糊查询用户信息,可能返回多条
resultType:指定就是单条记录所映射的java对象 类型
${}:表示拼接sql串,将接收到参数的内容不加任何修饰拼接在sql中。
使用${}拼接sql,可能引起 sql注入问题
${value}:接收输入 参数的内容,如果传入类型是简单类型,${}中只能使用value
-->
<select id="findUserByName" parameterType="java.lang.String" resultType="mybatis.po.User">
SELECT * FROM USER WHERE username LIKE '%${value}%'
</select>
<!-- 添加用户
parameterType:指定输入 参数类型是pojo(包括 用户信息)
#{}中指定pojo的属性名,接收到pojo对象的属性值,mybatis通过OGNL获取对象的属性值
-->
<insert id="insertUser" parameterType="mybatis.po.User">
<!--
将插入数据的主键返回,返回到user对象中
SELECT LAST_INSERT_ID():得到刚insert进去记录的主键值,只适用与自增主键
keyProperty:将查询到主键值设置到parameterType指定的对象的哪个属性
order:SELECT LAST_INSERT_ID()执行顺序,相对于insert语句来说它的执行顺序
resultType:指定SELECT LAST_INSERT_ID()的结果类型
-->
<selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
SELECT LAST_INSERT_ID()
</selectKey>
insert into user (username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
<!--
使用mysql的uuid()生成主键
执行过程:
首先通过uuid()得到主键,将主键设置到user对象的id属性中
其次在insert执行时,从user对象中取出id属性值
-->
<!-- <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
SELECT uuid()
</selectKey>
insert into user(id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address}) -->
</insert>
<!-- 根据id删除用户 -->
<delete id="deleteUser" parameterType="java.lang.Integer">
delete from user where id = #{id}
</delete>
<!--更新用户-->
<update id="updateUser" parameterType="mybatis.po.User">
update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} where id=#{id}
</update>
</mapper>
3.9、在SqlMapConfig.XML文件中加载po类的映射文件
<mappers>
<mapper resource="config/sqlmap/User.xml"></mapper>
</mappers>
3.10、编写测试程序
package test;
import mybatis.po.SqlSessionUtils;
import mybatis.po.User;
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 java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
public class UserTest {
// 根据id查询用户信息,得到一条记录结果
@Test
public void testFindUserById() throws IOException {
// 根据id查询用户信息,得到一条记录结果
String resource="config/mybatis/SqlMapConfig.xml";
// 得到配置文件流
InputStream inputStream= Resources.getResourceAsStream(resource);
// 创建会话工厂,传入mybatis的配置文件信息
SqlSessionFactory sqlSessionFactory= new SqlSessionFactoryBuilder().build(inputStream);
// 通过工厂得到SqlSession
SqlSession sqlSession=sqlSessionFactory.openSession();
// 通过SqlSession操作数据库
// 第一个参数:映射文件中statement的id,等于=namespace+"."+statement的id
// 第二个参数:指定和映射文件中所匹配的parameterType类型的参数
// sqlSession.selectOne结果 是与映射文件中所匹配的resultType类型的对象
// selectOne查询出一条记录
User user=sqlSession.selectOne("user.findUserById",1);
System.out.println(user);
sqlSession.close();
}
//根据用户名称模糊查询用户信息
@Test
public void findUserByNameTest() throws IOException {
SqlSession sqlSession=SqlSessionUtils.getSqlSession();
List<User> users= sqlSession.selectList("user.findUserByName","小明");
System.out.println(users);
sqlSession.close();
}
//添加用户
@Test
public void insertUserTest(){
SqlSession sqlSession=SqlSessionUtils.getSqlSession();
User user = new User();
user.setUsername("张无忌");
user.setSex("男");
user.setBirthday(new Date());
user.setAddress("武当");
sqlSession.insert("user.insertUser",user);
sqlSession.commit();
sqlSession.close();
}
//根据id删除用户
@Test
public void deleteUserTest(){
SqlSession sqlSession=SqlSessionUtils.getSqlSession();
sqlSession.delete("user.deleteUser",41);
sqlSession.commit();
sqlSession.close();
}
//更新用户
@Test
public void updateUserTest(){
SqlSession sqlSession=SqlSessionUtils.getSqlSession();
User user = new User();
user.setId(1);
user.setUsername("李易峰");
sqlSession.update("user.updateUser",user);
sqlSession.commit();
sqlSession.close();
}
}
上面测试程序,将读取mybatis配置文件SqlMapConfig.xml、单例模式创建SQLsessionFactory会话工厂、获取会话SqlSession几个共用步骤封装为一个SqlSessionUtils工具类:
package mybatis.po;
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 SqlSessionUtils {
private static SqlSessionFactory sqlSessionFactory = null;
private SqlSessionUtils(){}
public static SqlSessionFactory initsqlSessionFactory(){
String resource="config/mybatis/SqlMapConfig.xml";
InputStream inputStream= null;
try {
inputStream = Resources.getResourceAsStream(resource);
} catch (IOException e) {
e.printStackTrace();
}
synchronized (SqlSessionUtils.class) {
if (sqlSessionFactory == null) {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
}
}
return sqlSessionFactory;
}
public static SqlSession getSqlSession(){
if(sqlSessionFactory==null){
initsqlSessionFactory();
}
SqlSession sqlSession=sqlSessionFactory.openSession();
return sqlSession;
}
}
四、入门程序总结
使用mybatis框架操作数据库时,解决了原生态jdbc的程序硬编码问题,并将查询的结果映射为对应的java对象(数据库的列构成java对象的属性)。
其主要步骤为:
1、导入所需要的jar包
2、将数据库的driver、url、user、password等信息封装在db.properties
3、建立mybatis的xml文件SqlMapConfig.xml,并在其中加载数据库信息文件db.properties,并完成环境的搭建,以便能够连接上数据库
4、建立操作数据库表格时所对应的po类,查询的列构成po类的属性
5、编写po类的映射文件,在其中编写sql语句
6、在mybatis的xml文件SqlMapConfig.xml中加载po类的映射文件
7、编写测试程序,利用SqlSession实例调用selectOne()、selectList()、insert()、update()、delete()等方法完成测试。