Mybatis基础入门（一）

目录

MyBatis介绍

MyBatis开发流程

MyBatis环境配置

mybatis-config.xml

SqlSessionFactory

SqlSession

初始化工具类MyBatisUtils

测试添加功能

MyBatis数据查询

SQL传参

单参数传递

多参数传递

实体类类型

使用@Param标识参数

获取多表关联查询结果

MyBatis的各种查询功能

1、查询一个实体类对象

2、查询一个list集合

3、查询单个数据

4、查询一条数据为map集合

5、查询多条数据为map集合

---

MyBatis介绍

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

• MyBatis是优秀的持久层框架

• MyBatis使用XML将SQL与程序解耦,便于维护

• MyBatis学习简单执行高效,是JDBC的延伸

MyBatis开发流程

• 引入Mybatis依赖

  Mybatis默认推荐用maven的形式，来进行组件管理。

• 创建核心配置文件

• 创建实体（Entity）类

• 创建Mapper映射文件

  Mapper是把实体和数据表进行映射的关键所在，通过这个文件明确哪个表和哪个类是相互对应的，这个表中的字段和哪个属性是对应的

• 初始化SessionFactory

  读取配置文件，加载mapper映射

• 利用SqISession对象操作数据对象

MyBatis环境配置

mybatis-config.xml

• MyBatis采用XML格式配置数据库环境信息

• MyBaits环境配置标签< environment>

• environment包含数据库驱动、URL、 用户名与密码

<?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>
    <settings>
        <!-- goods_id ==> goodsId 驼峰命名转换 -->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>
    <!--启用Pagehelper分页插件-->
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">
            <!--设置数据库类型-->
            <property name="helperDialect" value="mysql"/>
            <!--分页合理化-->
            <property name="reasonable" value="true"/>
        </plugin>
    </plugins>
    
    <!--设置默认指向的数据库-->
    <environments default="dev">
        <!--配置环境，不同的环境不同的id名字-->
        <environment id="dev">
            <!-- 采用JDBC方式对数据库事务进行commit/rollback -->
            <transactionManager type="JDBC"></transactionManager>
            <!--采用连接池方式管理数据库连接-->
            <!--<dataSource type="POOLED">-->
            <dataSource type="com.imooc.mybatis.datasource.C3P0DataSourceFactory">
                <property name="driverClass" value="com.mysql.jdbc.Driver"/>
                <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/babytun?useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="user" value="root"/>
                <property name="password" value="root"/>
                <property name="initialPoolSize" value="5"/>
                <property name="maxPoolSize" value="20"/>
                <property name="minPoolSize" value="5"/>
                <!--...-->
            </dataSource>
        </environment>
        <environment id="prd">
            <!-- 采用JDBC方式对数据库事务进行commit/rollback -->
            <transactionManager type="JDBC"></transactionManager>
            <!--采用连接池方式管理数据库连接-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://192.168.1.155:3306/babytun?useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="mappers/goods.xml"/>
        <mapper resource="mappers/goods_detail.xml"/>
    </mappers>
</configuration>

SqlSessionFactory

• SqISessionFactory是MyBatis的核心对象

• 用于初始化MyBatis,创建SqlSession对象

• 保证SqlSessionFactory在应用中全局唯一

SqlSession

• SqISession是MyBatis操作数据库的核心对象

• SqlSession使用JDBC方式与数据库交互

• SqlSession对象提供了数据表CRUD对应方法

        一个SqlSession是一个扩展过的connection，SqlSession连接对象在原有的connection对象基础之上封装了大量额外的使用方法。

测试类：

    @Test
    public void testSqlSessionFactory() throws IOException {
        //利用Reader加载classpath下的mybatis-config.xml核心配置文件
        Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
        //初始化SqlSessionFactory对象,同时解析mybatis-config.xml文件
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
        System.out.println("SessionFactory加载成功");
        SqlSession sqlSession = null;
        try {
            //创建SqlSession对象,SqlSession是JDBC的扩展类,用于与数据库交互
            sqlSession = sqlSessionFactory.openSession();
            //创建数据库连接(测试用)
            Connection connection = sqlSession.getConnection();
            System.out.println(connection);
        }catch (Exception e){
            e.printStackTrace();
        }finally {
            if(sqlSession != null){   //sqlSession对象创建成功
                //如果type="POOLED",代表使用连接池,close则是将连接回收到连接池中
                //如果type="UNPOOLED",代表直连,close则会调用Connection.close()方法关闭连接
                sqlSession.close();
            }
        }
    }

        sqlSessionFactory 是应用的全局对象，在进行初始化的时候直接调用SqlSessionFactoryBuilder()构造者模式的build方法来对配置文件进行加载，同时得到sqlSessionFactory对象之后，利用sqlSessionFactory.openSession()这个配置文件中所描述的配置信息得到sqlSession对象，我们形象地将它看成一个底层的数据库连接，利用sqlSession对数据库表进行增删改查的操作，当我们进行数据库操作的时候，可以通过sqlSession产生的一系列方法来完成交互，其中getConnection()是用于得到sqlSession的数据库连接对象，在实际开发时，其实我们并不需要用它的。

        sqlSession对象有开就有关，当把所有的操作都做完之后，利用finally判断sqlSession是否为打开状态，如果打开的话，要调用close方法进行关闭。

初始化工具类MyBatisUtils

/**
 * MyBatisUtils工具类,创建全局唯一的SqlSessionFactory对象
 */
public class MyBatisUtils {
    //利用static(静态)属于类不属于对象,且全局唯一
    private static SqlSessionFactory sqlSessionFactory = null;
    //利用静态块在初始化类时实例化sqlSessionFactory
    static {
        Reader reader = null;
        try {
            reader = Resources.getResourceAsReader("mybatis-config.xml");
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
        } catch (IOException e) {
            e.printStackTrace();
            //初始化错误时,通过抛出异常ExceptionInInitializerError通知调用者
            throw new ExceptionInInitializerError(e);
        }
    }

    /**
     * openSession 创建一个新的SqlSession对象
     * @return SqlSession对象
     */
    public static SqlSession openSession(){
        return sqlSessionFactory.openSession();
    }

    /**
     * 释放一个有效的SqlSession对象
     * @param session 准备释放SqlSession对象
     */
    public static void closeSession(SqlSession session){
        if(session != null){
            session.close();
        }
    }
}

         这个工具类的主要作用是创建全局唯一的sqlSessionFactory对象，那么如何保证唯一呢？这里运用static静态关键字。什么是静态呢？就是这里被描述的对象它属于类而不属于对象，并且是全局唯一的，之后用static静态块在初始化类时实例化sqlSessionFactory，最后单独建立创建和销毁sqlSession对象的方法。

测试类：

  /**
     * MyBatisUtils使用指南
     * @throws Exception
  */
@Test
public void testMyBatisUtils() throws Exception {
    SqlSession sqlSession = null;
    try {
        sqlSession = MyBatisUtils.openSession();
        Connection connection = sqlSession.getConnection();
        System.out.println(connection);
    }catch (Exception e){
        throw e;
    } finally {
        MyBatisUtils.closeSession(sqlSession);
    }
}

测试添加功能

//读取MyBatis的核心配置文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//创建SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory，生产SqlSession对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//创建SqlSession对象，此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
//SqlSession sqlSession = sqlSessionFactory.openSession();
//创建SqlSession对象，此时通过SqlSession对象所操作的sql都会自动提交
SqlSession sqlSession = sqlSessionFactory.openSession(true);
//通过代理模式创建UserMapper接口的代理实现类对象
//在getMappe方法的底层可以帮助我们返回一个接口所对应的Impl实现类的对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);//获取mapper接口对象
//调用UserMapper接口中的方法，就可以根据UserMapper的全类名匹配元素文件，通过调用的方法名匹配
//映射文件中的SQL标签，并执行标签中的SQL语句
int result = userMapper.insertUser();//调用mapper接口里的方法，执行sql语句
//sqlSession.commit();

MyBatis数据查询

1. 创建实体类(Entity)

2. 创建Mapper XML来说明sql语句是什么

3. 编写<select> SQL标签

4. 开启驼峰命名映射

5. 新增<mapper>

6. SqlSession执行select语句

mapper：

<mapper namespace="goods">
    <select id="selectAll" resultType="com.imooc.mybatis.entity.Goods" useCache="false">
        select * from t_goods order by goods_id desc limit 10
    </select>
</mapper>

在配置文件中添加mapper的声明，这样在mybatis初始化的时候才知道mapper的存在

<mappers>
    <mapper resource="mappers/goods.xml"/>
</mappers>

测试类：

/**
 * select查询语句执行
 * @throws Exception
 */
@Test
public void testSelectAll() throws Exception {
    SqlSession session = null;
    try{
        session = MyBatisUtils.openSession();
        //其中goods为命名空间  selectAll为select标签的id
        List<Goods> list = session.selectList("goods.selectAll");
        for(Goods g : list){
            System.out.println(g.getTitle());
        }
    }catch (Exception e){
        throw e;
    }finally {
        MyBatisUtils.closeSession(session);
    }
}

SQL传参

MyBatis获取参数值的两种方式：${}和#{}

${}的本质就是字符串拼接，#{}的本质就是占位符赋值

${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引 号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号。

单参数传递：

使用${}和#{}以任意的名称获取参数的值，注意${}需要手动加单引号

<!-- 单参数传递,使用parameterType指定参数的数据类型即可,SQL中#{value}提取参数-->
<select id="selectById" parameterType="Integer" resultType="com.imooc.mybatis.entity.Goods">
    select * from t_goods where  goods_id = #{value}
</select>

/**
 * 传递单个SQL参数
 * @throws Exception
 */
@Test
public void testSelectById() throws Exception {
    SqlSession session = null;
    try{
        session = MyBatisUtils.openSession();
        Goods goods = session.selectOne("goods.selectById" , 1603);//第二个参数用来传递参数
        System.out.println(goods.getTitle());
    }catch (Exception e){
        throw e;
    }finally {
        MyBatisUtils.closeSession(session);
    }
}

多参数传递：

        将这些参数放在一个map集合中，通过${}和#{}访问map集合的键就可以获取相对应的 值，注意${}需要手动加单引号。

<!-- 多参数传递时,使用parameterType指定Map接口,SQL中#{key}提取参数 -->
<select id="selectByPriceRange" parameterType="java.util.Map" resultType="com.imooc.mybatis.entity.Goods">
    select * from t_goods
    where
    current_price between  #{min} and #{max}
    order by current_price
    limit 0,#{limt}
</select>

/**
 * 传递多个SQL参数
 * @throws Exception
 */
@Test
public void testSelectByPriceRange() throws Exception {
    SqlSession session = null;
    try{
        session = MyBatisUtils.openSession();
        
        Map param = new HashMap();
        param.put("min",100);
        param.put("max",500);
        param.put("limt",10);
        List<Goods> list = session.selectList("goods.selectByPriceRange", param);
        for(Goods g:list){
            System.out.println(g.getTitle() + ":" + g.getCurrentPrice());
        }
    }catch (Exception e){
        throw e;
    }finally {
        MyBatisUtils.closeSession(session);
    }
}

实体类类型：

此时可以使用${}和#{}，通过访问实体类对象中的属性名获取属性值，注意${}需要手动加单引号

<insert id="insertUser">
    insert into t_user values(null,#{username},#{password},#{age},#{sex},#{email})
</insert>

@Test
public void insertUser(){
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int result = mapper.insertUser(new User(null, "李四", "123123", 22, "男", "123@qq.com"));
    System.out.println(result);
}

使用@Param标识参数

        可以通过@Param注解标识mapper接口中的方法参数。此时，会将这些参数放在map集合中，以@Param注解的value属性值为键，以参数为值；以 param1,param2...为键，以参数为值；只需要通过${}和#{}访问map集合的键就可以获取相对应的值。注意${}需要手动加单引号。

接口：

/*
验证登录  注解
 */
User checkloginByparam(@Param("username") String username, @Param("password") String password);

mapper.xml

<select id="checkloginByparam" resultType="User">
    select * from t_user where username = #{username} and password = #{password}
</select>

@Test
public void checkloginparam(){
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.checkloginByparam("admin", "123");
    System.out.println(user);
}

获取多表关联查询结果

<!-- 利用LinkedHashMap保存多表关联结果
        MyBatis会将每一条记录包装为LinkedHashMap对象
        key是字段名  value是字段对应的值 , 字段类型根据表结构进行自动判断
        优点: 易于扩展,易于使用
        缺点: 太过灵活,无法进行编译时检查
-->
<select id="selectGoodsMap" resultType="java.util.LinkedHashMap" flushCache="true">
    select g.* , c.category_name,'1' as test from t_goods g , t_category c
    where g.category_id = c.category_id
</select>

/**
 * 利用Map接收关联查询结果
 * @throws Exception
 */
@Test
public void testSelectGoodsMap() throws Exception {
    SqlSession session = null;
    try{
        session = MyBatisUtils.openSession();
        List<Map> list = session.selectList("goods.selectGoodsMap");
        for(Map map : list){
            System.out.println(map);
        }
    }catch (Exception e){
        throw e;
    }finally {
        MyBatisUtils.closeSession(session);
    }
}

MyBatis的各种查询功能

1、查询一个实体类对象

<!--User getUserById(@Param("id") int id);-->
<select id="getUserById" resultType="User">
    select * from t_user where id = #{id}
</select>

2、查询一个list集合

<!--List<User> getUserList();-->
<select id="getUserList" resultType="User">
    select * from t_user
</select>

3、查询单个数据

<!--
在MyBatis中，对于Java中常用的类型都设置了类型别名
* 例如：java.lang.Integer-->int|integer
* 例如：int-->_int|_integer
* 例如：Map-->map,List-->list
-->
<!--int getCount();-->
<select id="getCount" resultType="_integer">
    select count(id) from t_user
</select>

4、查询一条数据为map集合

<!--Map<String, Object> getUserToMap(@Param("id") int id);-->
<select id="getUserToMap" resultType="map">
    select * from t_user where id = #{id}
</select>
<!--结果：{password=123456, sex=男, id=1, age=23, username=admin}-->

5、查询多条数据为map集合

方式一：

        将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，此时可以将这些map放在一个list集合中获取。

<!--List<Map<String, Object>> getAllUserToMap();-->
<select id="getAllUserToMap" resultType="map">
    select * from t_user
</select>

方式二：

        将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，并且最终要以一个map的方式返回数据，此时需要通过@MapKey注解设置map集合的键，值是每条数据所对应的 map集合。

        @MapKey注解用来设置当前map集合当中的键，他会把当前所查询出来的数据的某一个字段来作为键，把当前查询出来的数据转换成map集合来作为值，即Map<注解值，单条记录的Map>。

<!--
@MapKey("id")
Map<String, Object> getAllUserToMap();
-->
<select id="getAllUserToMap" resultType="map">
    select * from t_user
</select>

结果：
<!--
{
1={password=123456, sex=男, id=1, age=23, username=admin},
2={password=123456, sex=男, id=2, age=23, username=张三},
3={password=123456, sex=男, id=3, age=23, username=张三}
}
-->