走进JavaWeb技术世界15:通过项目逐步深入了解Mybatis(一)

Mybatis 和 SpringMVC 通过订单商品案例驱动

官方中文地址:http://www.mybatis.org/mybatis-3/zh/

官方托管地址:https://github.com/mybatis/mybatis-3

本项目全部代码地址:https://github.com/zhisheng17/mybatis

对原生态 jdbc 程序(单独使用 jdbc 开发)问题总结

1、环境

​ java 环境 :jdk1.8.0_77

​ 开发工具 : IDEA 2016.1

​ 数据库 : MySQL 5.7

2、创建数据库

​ mybatis_test.sql

​ Tables :items、orderdetail、orders、user

3、JDBC 程序

​ 使用 JDBC 查询 MySQL 数据库中用户表的记录

​ 代码:


package cn.zhisheng.mybatis.jdbc;
/**
* Created by 10412 on 2016/11/27.
*/
import java.sql.*;
/**
*通过单独的jdbc程序来总结问题
*/
public class JdbcTest
{
public static void main(String[] args)
{
//数据库连接
Connection connection = null;
//预编译的Statement,使用预编译的Statement可以提高数据库性能
PreparedStatement preparedStatement = null;
//结果集
ResultSet resultSet = null;
try
{
//加载数据库驱动
Class.forName("com.mysql.jdbc.Driver");
//通过驱动管理类获取数据库链接
connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis_test?characterEncoding=utf-8", "root", "root");
//定义sql语句 ?表示占位符(在这里表示username)
String sql = "select * from user where username = ?";
//获取预处理statement
preparedStatement = connection.prepareStatement(sql);
//设置参数,第一个参数为sql语句中参数的序号(从1开始),第二个参数为设置的参数值
preparedStatement.setString(1, "王五");
//向数据库发出sql执行查询,查询出结果集
resultSet = preparedStatement.executeQuery();
//遍历查询结果集
while(resultSet.next())
{
System.out.println(resultSet.getString("id")+" "+resultSet.getString("username"));
}
} catch (Exception e) {
e.printStackTrace();
}finally{
//释放资源
if(resultSet!=null)
{
try {
resultSet.close();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
if(preparedStatement!=null)
{
try {
preparedStatement.close();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
if(connection!=null)
{
try {
connection.close();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
}
}

4、问题总结

  • 数据库连接,使用时就创建,不使用立即释放,对数据库频繁连接开启和关闭,造成数据库资源的浪费,影响数据库性能。

    解决方法:使用数据库连接池管理数据库连接。

  • 将 sql 语句硬编码到 java 代码中,如果 sql 语句需要修改,那么就需要重新编译 java 代码,不利于系统的维护。

    设想:将 sql 语句配置在 xml 配置文件中,即使 sql 语句发生变化,也不需要重新编译 java 代码。

  • 向 preparedStatement 中设置参数,对占位符号位置和设置参数值,硬编码在 java 代码中,同样也不利于系统的维护。

    设想:将 sql 语句、占位符、参数值配置在 xml 配置文件中。

  • 从 resultSet 中遍历结果集数据时,存在硬编码,将获取表的字段进行硬编码,不利于系统维护。

    设想:将查询的结果集自动映射成 java 对象。

Mybatis框架原理(掌握)

1、Mybatis 是什么?

​ Mybatis 是一个持久层的架构,是 appach 下的顶级项目。

​ Mybatis 原先是托管在 googlecode 下,再后来是托管在 Github 上。

​ Mybatis 让程序员将主要的精力放在 sql 上,通过 Mybatis 提供的映射方式,自由灵活生成(半自动,大部分需要程序员编写 sql )满足需要 sql 语句。

​ Mybatis 可以将向 preparedStatement 中的输入参数自动进行输入映射,将查询结果集灵活的映射成 java 对象。(输出映射

2、Mybatis 框架

 

注解:

  • SqlMapConfig.xml (Mybatis的全局配置文件,名称不定)配置了数据源、事务等 Mybatis 运行环境

  • Mapper.xml 映射文件(配置 sql 语句)

  • SqlSessionFactory (会话工厂)根据配置文件配置工厂、创建 SqlSession

  • SqlSession (会话)面向用户的接口、操作数据库(发出 sql 增删改查)

  • Executor (执行器)是一个接口(基本执行器、缓存执行器)、SqlSession 内部通过执行器操作数据库

  • Mapped Statement (底层封装对象)对操作数据库存储封装,包括 sql 语句、输入参数、输出结果类型

Mybatis入门程序

1、需求

实现以下功能:

  • 根据用户id查询一个用户信息
  • 根据用户名称模糊查询用户信息列表
  • 添加用户
  • 更新用户
  • 删除用户

2、环境

java 环境 :jdk1.8.0_77

开发工具 : IDEA 2016.1

数据库 : MySQL 5.7

Mybatis 运行环境( jar 包)

MySQL 驱动包

其他依赖包

3、 log4j.properties

在classpath下创建log4j.properties如下:

# Global logging configuration
#在开发环境日志级别要设置为DEBUG、生产环境要设置为INFO或者ERROR
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

Mybatis默认使用log4j作为输出日志信息。

4、工程结构

 

5、SqlMapConfig.xml

配置 Mybatis 的运行环境、数据源、事务等


<?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>
<!-- 和spring整合后 environments配置将废除-->
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理,事务由 Mybatis 控制-->
<transactionManager type="JDBC" />
<!-- 数据库连接池,由Mybatis管理,数据库名是mybatis_test,Mysql用户名root,密码root -->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_test?characterEncoding=utf-8" />
<property name="username" value="root" />
<property name="password" value="root" />
</dataSource>
</environment>
</environments>
</configuration>

6、创建 po 类

Po 类作为 mybatis 进行 sql 映射使用,po 类通常与数据库表对应,User.java 如下:

package cn.zhisheng.mybatis.po;
import java.util.Date;
/**
* Created by 10412 on 2016/11/28.
*/
public class User
{
private int id;
private String username; // 用户姓名
private String sex; // 性别
private Date birthday; // 生日
private String address; // 地址
//getter and setter
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;
}
}

7、根据用户 id(主键)查询用户信息

  • 映射文件

    • User.xml(原在 Ibatis 中命名)在 Mybatis 中命名规则为 xxxmapper.xml
    • 在映射文件中配置 sql 语句

    User.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="test">
</mapper>

namespace :命名空间,对 sql 进行分类化管理,用于隔离 sql 语句,后面会讲另一层非常重要的作用。

在 User.xml 中加入


<!--通过select执行数据库查询
id:标识映射文件中的sql
将sql语句封装到mappedStatement对象中,所以id称为Statement的id
#{}:表示占位符
#{id}:其中的id表示接收输入的参数,参数名称就是id,如果输入参数是简单类型,那么#{}中的参数名可以任意,可以是value或者其他名称
parameterType:表示指定输入参数的类型
resultType:表示指定sql输出结果的所映射的java对象类型
-->
<!-- 根据id获取用户信息 -->
<select id="findUserById" parameterType="int" resultType="cn.zhisheng.mybatis.po.User">
select * from user where id = #{id}
</select>

User.xml 映射文件已经完全写好了,那接下来就需要在 SqlMapConfig.xml中加载映射文件 User.xml

<!--加载映射文件-->
<mappers>
<mapper resource="sqlmap/User.xml"/>
</mappers>
  • 编写程序

package cn.zhisheng.mybatis.first;
import cn.zhisheng.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;
/**
* Created by 10412 on 2016/11/28.
*/
public class MybatisFirst
{
//根据id查询用户信息,得到用户的一条记录
@Test
public void findUserByIdTest() throws IOException
{
//Mybatis 配置文件
String resource = "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类型的对象
User user = sqlSession.selectOne("test.findUserById", 1);
System.out.println(user);
//释放资源
sqlSession.close();
}
}

然后运行一下这个测试,发现结果如下就代表可以了:

 

8、根据用户名称模糊查询用户信息列表

  • 映射文件

    依旧使用 User.xml 文件,只不过要在原来的文件中加入

     
    1. 1

    2. 2

    3. 3

    4. 4

    5. 5

    6. 6

    7. 7

    8. 8

    9. 9

     
    1. <!-- 自定义条件查询用户列表

    2. resultType:指定就是单条记录所映射的java对象类型

    3. ${}:表示拼接sql串,将接收到的参数内容不加修饰的拼接在sql中

    4. 使用${}拼接sql,会引起sql注入

    5. ${value}:接收输入参数的内容,如果传入类型是简单类型,${}中只能够使用value

    6. -->

    7. <select id="findUserByUsername" parameterType="java.lang.String" resultType="cn.zhisheng.mybatis.po.User">

    8. select * from user where username like '%${value}%'

    9. </select>

     

  • 编写程序

    依旧直接在刚才那个 MybatisFirst.java 中加入测试代码:

     
    1. 3

    2. 14

    3. 15

    4. 16

    5. 17

    6. 18

    7. 19

    8. 20

    9. 21

    10. 22

    11. 23

    12. 24

    13. 25

    14. 26

    15. 27

    16. 28

     
    1. //根据用户名称模糊查询用户信息列表

    2. @Test

    3. public void findUserByUsernameTest() throws IOException

    4. {

    5. //Mybatis 配置文件

    6. String resource = "SqlMapConfig.xml";

    7.  
    8. //得到配置文件流

    9. InputStream inputStream = Resources.getResourceAsStream(resource);

    10.  
    11. //创建会话工厂,传入Mybatis的配置文件信息

    12. SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    13. //通过工厂得到SqlSession

    14. SqlSession sqlSession = sqlSessionFactory.openSession();

    15.  
    16. //通过SqlSession操作数据库

    17. //第一个参数:映射文件中Statement的id,等于 = namespace + "." + Statement的id

    18. //第二个参数:指定和映射文件中所匹配的parameterType类型的参数

    19.  
    20. //selectList 查询结果可能多条

    21. //list中的user和映射文件中resultType所指定的类型一致

    22. List<User> list = sqlSession.selectList("test.findUserByUsername", "小明");

    23.  
    24. System.out.println(list);

    25.  
    26. //释放资源

    27. sqlSession.close();

    28. }

 

同样测试一下findUserByUsernameTest ,如果运行结果如下就代表没问题:

 

提示:

通过这个代码可以发现,其中有一部分代码是冗余的,我们可以将其封装成一个函数。

 
  1. 1

  2. 2

  3. 3

  4. 4

  5. 5

  6. 6

  7. 7

 
  1. public void createSqlSessionFactory() throws IOException {

  2. // 配置文件

  3. String resource = "SqlMapConfig.xml";

  4. InputStream inputStream = Resources.getResourceAsStream(resource);

  5. // 使用SqlSessionFactoryBuilder从xml配置文件中创建SqlSessionFactory

  6. sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

  7. }

注意:

1、#{ } 和 ${ } 的区别

  • #{ }表示一个占位符号,通过#{ }可以实现 preparedStatement 向占位符中设置值,自动进行java 类型和 jdbc 类型转换,#{ } 可以有效防止sql注入。#{ } 可以接收简单类型值或 pojo 属性值(通过 OGNL 读取对象中的值,属性.属性.属性..方式获取对象属性值)。 如果 parameterType 传输单个简单类型值,#{ }括号中可以是 value 或其它名称。
  • ${ } 表示拼接 sql 串,通过${ }可以将 parameterType 传入的内容拼接在 sql 中且不进行 jdbc 类型转换, ${ }可以接收简单类型值或 pojo 属性值((通过 OGNL 读取对象中的值,属性.属性.属性..方式获取对象属性值)),如果 parameterType 传输单个简单类型值,${}括号中只能是 value。

2、parameterType 和 resultType 区别

  • parameterType:指定输入参数类型,mybatis 通过 ognl 从输入对象中获取参数值拼接在 sql 中。
  • resultType:指定输出结果类型,mybatis 将 sql 查询结果的一行记录数据映射为 resultType 指定类型的对象。

3、selectOne 和 selectList 区别

  • selectOne 查询一条记录来进行映射,如果使用selectOne查询多条记录则抛出异常:

    org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to bereturned by selectOne(), but found: 3 at

  • selectList 可以查询一条或多条记录来进行映射。

9、添加用户

  • 映射文件

    在 User.xml 中加入:

     
    1. 1

    2. 2

    3. 3

    4. 4

    5. 5

    6. 6

    7. 7

    8. 8

     
    1. <!-- 添加用户 -->

    2. <insert id="insetrUser" parameterType="cn.zhisheng.mybatis.po.User" >

    3. <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">

    4. select LAST_INSERT_ID()

    5. </selectKey>

    6. insert into user(username, birthday, sex, address)

    7. values(#{username}, #{birthday}, #{sex}, #{address})

    8. </insert>

    注意:

    • selectKey将主键返回,需要再返回
    • 添加selectKey实现将主键返回
    • keyProperty:返回的主键存储在pojo中的哪个属性
    • order:selectKey的执行顺序,是相对与insert语句来说,由于mysql的自增原理执行完insert语句之后才将主键生成,所以这里selectKey的执行顺序为after
    • resultType:返回的主键是什么类型
    • LAST_INSERT_ID():是mysql的函数,返回auto_increment自增列新记录id值。

然后在 MybatisFirst.java 中写一个测试函数,代码如下

 
  1. 11

  2. 12

  3. 13

  4. 14

  5. 15

  6. 16

  7. 17

  8. 18

  9. 19

  10. 20

  11. 21

 
  1. @Test

  2. public void insetrUser() throws IOException, ParseException {

  3. //Mybatis 配置文件

  4. String resource = "SqlMapConfig.xml";

  5. //得到配置文件流

  6. InputStream inputStream = Resources.getResourceAsStream(resource);

  7. //创建会话工厂,传入Mybatis的配置文件信息

  8. SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

  9. //通过工厂得到SqlSession

  10. SqlSession sqlSession = sqlSessionFactory.openSession();

  11. User user = new User();

  12. SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd");

  13. user.setUsername("田志声");

  14. user.setSex("男");

  15. user.setBirthday(sdf.parse("2016-11-29"));

  16. user.setAddress("江西南昌");

  17. sqlSession.insert("test.insetrUser", user);

  18. sqlSession.commit();

  19. //释放资源

  20. sqlSession.close();

  21. }

然后 run 一下,如果出现的结果如下,那么就是成功了。

 

同时数据库也能查询到刚插入的用户信息:

 

10、自增主键返回 与 非自增主键返回

  • MySQL 自增主键:执行 insert 提交之前自动生成一个自增主键,通过 MySQL 函数获取到刚插入记录的自增主键: LAST_INSERT_ID() ,是在 insert 函数之后调用。

  • 非自增主键返回:使用 MySQL 的 uuid() 函数生成主键,需要修改表中 id 字段类型为 String ,长度设置为 35 位,执行思路:先通过 uuid() 查询到主键,将主键输入到 sql 语句中;执行 uuid() 语句顺序相对于 insert 语句之前执行。

    刚才那个插入用户的地方,其实也可以通过 uuid() 来生成主键,如果是这样的话,那么我们就需要在 User.xml 中加入如下代码:

     
    1. 1

    2. 2

    3. 3

    4. 4

    5. 5

    6. 6

    7. 7

    8. 8

    9. 9

     
    1. <!--使用 MySQL 的 uuid()生成主键

    2. 执行过程:

    3. 首先通过uuid()得到主键,将主键设置到user对象的id属性中

    4. 其次执行insert时,从user对象中取出id属性值

    5. -->

    6. <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">

    7. select uuid()

    8. </selectKey>

    9. insert into user(id, username, birthday, sex, address) values(#{id}, #{username}, #{birthday}, #{sex}, #{address})

  • Oracle 使用序列生成主键

    首先自定义一个序列且用于生成主键,selectKey使用如下:

     
    1. 1

    2. 2

    3. 3

    4. 4

    5. 5

    6. 6

    7. 7

    8. 8

     
    1. <insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">

    2. <selectKey resultType="java.lang.Integer" order="BEFORE"

    3. keyProperty="id">

    4. SELECT 自定义序列.NEXTVAL FROM DUAL

    5. </selectKey>

    6. insert into user(id,username,birthday,sex,address)

    7. values(#{id},#{username},#{birthday},#{sex},#{address})

    8. </insert>

11、删除用户

前面说了这么多了,这里就简单来说明下:

在 User.xml 文件中加入如下代码:

 
  1. 1

  2. 2

  3. 3

  4. 4

 
  1. <!--删除用户-->

  2. <delete id="deleteUserById" parameterType="int">

  3. delete from user where user.id = #{id}

  4. </delete>

在 MybatisFirst.java 文件中加入如下代码:

 
  1. 4

  2. 15

  3. 16

  4. 17

  5. 18

  6. 19

  7. 20

  8. 21

  9. 22

  10. 23

  11. 24

  12. 25

  13. 26

  14. 27

  15. 28

  16. 29

 
  1. //删除用户

  2. @Test

  3. public void deleteUserByIdTest() throws IOException

  4. {

  5. //Mybatis 配置文件

  6. String resource = "SqlMapConfig.xml";

  7.  
  8. //得到配置文件流

  9. InputStream inputStream = Resources.getResourceAsStream(resource);

  10.  
  11. //创建会话工厂,传入Mybatis的配置文件信息

  12. SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

  13.  
  14.  
  15. //通过工厂得到SqlSession

  16. SqlSession sqlSession = sqlSessionFactory.openSession();

  17.  
  18. //通过SqlSession操作数据库

  19. //第一个参数:映射文件中Statement的id,等于 = namespace + "." + Statement的id

  20. //第二个参数:指定和映射文件中所匹配的parameterType类型的参数

  21.  
  22. sqlSession.delete("test.deleteUserById", 26);

  23.  
  24. //提交事务

  25. sqlSession.commit();

  26.  
  27. //释放资源

  28. sqlSession.close();

  29. }

测试结果如下:

 

之前的数据库 user 表查询结果:

 

执行完测试代码后,结果如下:

 

12、更新用户信息

在 User.xml 中加入如下代码:

 
  1. 1

  2. 2

  3. 3

  4. 4

  5. 5

  6. 6

  7. 7

  8. 8

  9. 9

 
  1. <!--根据id更新用户

  2. 需要输入用户的id

  3. 传入用户要更新的信息

  4. parameterType指定user对象,包括id和更新信息,id必须存在

  5. #{id}:从输入对象中获取id属性值

  6. -->

  7. <update id="updateUserById" parameterType="cn.zhisheng.mybatis.po.User">

  8. update user set username = #{username}, birthday = #{birthday}, sex = #{sex}, address = #{address} where user.id = #{id}

  9. </update>

然后在 MybatisFirst.java 中加入

 
  1. 8

  2. 19

  3. 20

  4. 21

  5. 22

  6. 23

  7. 24

  8. 25

  9. 26

  10. 27

  11. 28

  12. 29

  13. 30

  14. 31

  15. 32

  16. 33

  17. 34

  18. 35

  19. 36

  20. 37

 
  1. //根据id更新用户信息

  2. @Test

  3. public void updateUserByIdTest() throws IOException, ParseException {

  4. //Mybatis 配置文件

  5. String resource = "SqlMapConfig.xml";

  6.  
  7. //得到配置文件流

  8. InputStream inputStream = Resources.getResourceAsStream(resource);

  9.  
  10. //创建会话工厂,传入Mybatis的配置文件信息

  11. SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

  12.  
  13. //通过工厂得到SqlSession

  14. SqlSession sqlSession = sqlSessionFactory.openSession();

  15.  
  16. //为了设置生日的日期输入

  17. SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd");

  18.  
  19. User user = new User();

  20. //根据id更新用户信息

  21. user.setId(24);

  22. user.setUsername("张四风");

  23. user.setBirthday(sdf.parse("2015-01-12"));

  24. user.setSex("女");

  25. user.setAddress("上海黄埔");

  26.  
  27. //通过SqlSession操作数据库

  28. //第一个参数:映射文件中Statement的id,等于 = namespace + "." + Statement的id

  29. //第二个参数:指定和映射文件中所匹配的parameterType类型的参数

  30. sqlSession.update("test.updateUserById", user);

  31.  
  32. //提交事务

  33. sqlSession.commit();

  34.  
  35. //释放资源

  36. sqlSession.close();

  37. }

测试结果如下:

 

查看数据库,id 为 24 的用户信息是否更新了:

 

啊,是不是很爽,所有的需求都完成了。

没错,这只是 Mybatis 的一个简单的入门程序,简单的实现了对数据库的增删改查功能,通过这个我们大概可以了解这个编程方式了。

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值