MyBatis框架(一)

一、框架

1.框架的概述

框架(Framework)是整个或部分系统的可重用设计；是被应用开发者定制的应用骨架；其实就是某种应用的半成品；框架一般是成熟的，不断升级的软件。

2.框架要解决的问题

框架要解决的最重要的一个问题就是：技术整合的问题。软件企业的研发集中在应用的设计上，而不是具体的技术实现。

3.软件开发的分层重要性

框架的重要性在于它实现了部分功能，并且能够很好地将低层应用平台和高级业务逻辑进行了缓和。为了实现软件工程中的“高内聚、低耦合”。把问题划分开来各个解决，易于控制，易于延展，易于分配资源。

通过分层更好的实现了各个部分的职责，在每一层将在细分出不同的框架，分别解决各层关注的问题。

4.分层开发的常用框架

• 解决数据的持久化问题的框架MyBatis
• 解决web层问题的MVC框架Spring MVC
• 解决技术整合问题的框架Spring

二、MyBatis框架

1.概述

(1).mybatis是一个优秀的基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注sql语句本身，而不需要花费精力去处理加载驱动、创建连接、创建statement等繁琐的过程。
(2).mybatis通过xml或注解的方式将要执行的各种statement配置起来，并通过java对象和statement中sql的动态参数进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射为java对象并返回。
(3).采用ORM思想解决了实体和数据库映射的问题，对jdbc进行了封装，屏蔽了jdbc api底层访问细节，使我们不用与jdbc api打交道，就可以完成对数据库的持久化操作。

2.使用

*下载MyBatis框架jar包

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.4.5</version>
</dependency>

* 搭建MyBatis的开发环境

配置jar包(配置单元测试的jar包，数据库驱动jar包，log4j日志jar包)

<dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>4.12</version> 
      <scope>test</scope> 
    </dependency> 
    <dependency> 
      <groupId>mysql</groupId> 
      <artifactId>mysql-connector-java</artifactId> 
      <version>5.1.6</version> 
      <scope>runtime</scope> 
    </dependency> 
    <dependency> 
      <groupId>log4j</groupId> 
      <artifactId>log4j</artifactId> 
      <version>1.2.12</version> 
    </dependency> 

在 org.westos.domain 包下编写实体类
在org.westos.dao 包下编写接口 IUserDao

* 编写持久层接口的映射文件.xml

要求：
	创建位置：必须和持久层接口在相同的包中
	名称：必须以持久层接口名称名为文件名，扩展名是.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">

//配置映射文件
<!--注意namespace值是接口的全路径-->
<mapper namespace="org.westos.dao.IUserDao">
    <!--注意id的值是接口中的方法名 resultType 查询返回的结果类型-->
    <select id="findAll" resultType="org.westos.domain.User">
        select * from user;
    </select>
</mapper>

* 编写MyBatis的核心配置文件SqlMapConfig.xml

在工程的resources目录下创建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>
    <environments default="mysql">
        <environment id="mysql">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <!--配置数据源的四个基本参数-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_test"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    
    <!--引入dao接口的映射文件-->
    <mappers>
        <mapper resource="org/westos/dao/IUserDao.xml"></mapper>
    </mappers>
</configuration>

*5 编写测试类，进行测试

在工程的test目录下的java目录下编写测试类进行测试
public class TestUserDao {
    @Test
    public void testFindAll() throws IOException {
        //读取MyBatis的核心配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //构建工厂
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
        //打开SqlSession对象
        SqlSession sqlSession = factory.openSession();
        //获取接口的代理对象
        IUserDao userDao = sqlSession.getMapper(IUserDao.class);
        //掉方法
        //执行查询操作
        List<User> list = userDao.findAll();
        for (User user : list) {
            System.out.println(user);
        }
        //释放资源
        in.close();
        sqlSession.close();
    }
}

3.常用操作

1.在接口中填写方法；修改接口的映射文件，书写sql语句；在测试类中测试以后的操作
2.增删改的操作需要提交事物sqlSession.commit()，查询的操作不需要
3.单元测试的注解

每次测试都得加载配置文件，获取sqlSession麻烦，我们可以使用Junit单元测试的几个注解来解决，不用每次测试都得重复写加载配置文件，获取sqlSession的代码
	@Before 注解在@Test注解执行之前调用 
(加载核心配置文件，建立SqlSessionFactory工厂，打开SqlSession对象)
	@After 注解在@Test执行完之后调用
(主要用来释放资源)

4.使用注解的方式

使用注解就不需要映射文件了，通过class属性来引入接口的全路径
<mapper class="org.westos.dao.IUserDao"></mapper>

5.获取自增长键的值

在映射文件中保存用户的操作中添加配置
<insert id="saveUser" parameterType="org.westos.domain.User">
        <!--获取自增长键的值的配置-->
        <selectKey keyProperty="id" keyColumn="id" resultType="int" order="AFTER">
            SELECT LAST_INSERT_ID();
        </selectKey>

说明：
keyProperty="id" 实体类中的id表示自增长键
keyColumn="id" 表中的主键名
resultType="int" 返回类型
order="AFTER"  在插入之后获取自增长键的值

在测试类中，在保存用户后，获取id的值
//在保存之后，获取id的值
        Integer id = user.getId();
        System.out.println(id);

6.parameterType传入参数的类型

SQL 语句传参，使用标签的 parameterType 属性来设定。
基本数据类型parameterType="int"，引用数据类型parameterType="String"
实体类类型parameterType="org.westos.domain.User"
实体类的包装类

实体类的包装类
<select id="likeUserByVO" parameterType="org.westos.domain.QueryVO" resultMap="myMap">
        select * from user where username like #{user.username};
    </select>
@Test
    public void likeUserByVO() {
        IUserDao mapper = sqlSession.getMapper(IUserDao.class);
        User user = new User();
        user.setUsername("%沈%");
        QueryVO queryVO = new QueryVO();
        queryVO.setUser(user);
        List<User> list = mapper.likeUserByVO(queryVO);
        for (User user1 : list) {
            System.out.println(user1);
        }
    }

说明：#{user.username}   user是QueryVO中的属性 会通过反射调用 getUser()获取User的对象
     username 是User中的属性，会通过getUsername来获取值

4.一些配置操作

* 实体类的属性名和表中的字段名不一致

在映射文件中配置实体类的属性名和表中字段名的对应关系

<resultMap id="myMap" type="org.westos.domain.User">
		//配置主键的对应关系
        <id property="id" column="id"></id>
        //配置其他普通字段的对应关系
        <result property="username" column="username"></result>
        <result property="birthday" column="birthday"></result>
        <result property="sex" column="sex"></result>
        <result property="address" column="address"></result>
    </resultMap>

修改返回数据类型的配置

<select id="findAll" resultMap="myMap">
    select *from user;
  </select>
说明：使用  resultMap="myMap" 来引用我们的映射配置

* 使用properties标签引用外部的配置文件

可以将连接数据库的配置单独写在一个外部的配置文件中

jdbc.Driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_test
jdbc.username=root
jdbc.password=123456

通过properties标签，在SqlMapConfig.xml核心配置文件中引入外部的配置文件

<!--属性配置-->
    <properties resource="jdbcConfig.properties"></properties>
  这个标签放到<configuration>标签里面的最前面

在修改dataSource标签中的配置

<dataSource type="POOLED">
                <property name="driver" value="${jdbc.Driver}"></property>
                <property name="url" value="${jdbc.url}"></property>
                <property name="username" value="${jdbc.username}"></property>
                <property name="password" value="${jdbc.password}"></property>
            </dataSource>

* 给实体类起别名

在SqlMapConfig.xml核心配置文件中，给实体类起别名

    <typeAliases>
        <typeAlias type="org.westos.domain.User" alias="user"></typeAlias>
    </typeAliases>

起了别名后，我们在映射文件中的返回参数类型、传入参数类型就可以使用别名了，不用再写User的全路径名。

如果说，我们有很多个实体类，那么一个一个去配置别名麻烦
我们可以使用 package 来给该包下所有的实体类配置别名。

<typeAliases>
        <package name="org.westos.domain"></package>
    </typeAliases>

给某个包下所有的实体类起了别名，这个别名，可以是原来的类名；可以是原来类名的全部小写，或全部大写。

* 使用package标签扫描该包下所有接口

<!--ORM的映射文件-->
    <!--扫描该接口所对应的映射文件-->
    <mappers>
        <mapper resource="org/westos/dao/IUserDao.xml"></mapper>
    </mappers>

如果一个包下的接口太多一个一个去扫描麻烦，那么可以使用package标签，扫描该包下的所有接口。(一个接口对应一个映射文件)

<!--ORM的映射文件-->
    <mappers>
        <package name="org.westos.dao"></package>
    </mappers>

5.总结

使用MyBatis，只需要编写Dao接口并且按照mybatis要求编写两个配置文件，就可以实现功能。