MyBatis初学笔记

1、在SqlMapConfig.xml中配置数据链接池，使用连接池管理数据库链接

<!-- 加载属性文件 -->
<properties resource="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>

2、将Sql语句配置在XXXXmapper.xml文件中与java代码分离，需将接口类名和映射文件名要一致，且在同一个目录下。并在SqlMapConfig.xml中加载映射文件：
SqlMapConfig.xml：

<!-- 加载 映射文件 -->
<mappers>
    <mapper resource="sqlmap/User.xml"/>
    <!--通过resource方法一次加载一个映射文件 -->
    <!-- <mapper resource="mapper/UserMapper.xml"/> -->
    <!-- 通过mapper接口加载单个 映射文件
    遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中
    上边规范的前提是：使用的是mapper代理方法
     -->
    <!-- <mapper class="cn.luswei.mybatis.mapper.UserMapper"/> -->
    <!-- 批量加载mapper指定mapper接口的包名，mybatis自动扫描包下边所有mapper接口进行加载
    遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中
    上边规范的前提是：使用的是mapper代理方法
     -->
    <package name="cn.luswei.mybatis.mapper"/>
</mappers>

UserMapper.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命名空间，作用就是对sql进行分类化管理，理解sql隔离 
注意：使用mapper代理方法开发，namespace有特殊重要的作用，namespace等于mapper接口地址
-->
<mapper namespace="cn.luswei.mybatis.mapper.UserMapper">
　　 <!-- 在 映射文件中配置很多sql语句 -->
    <!-- 需求：通过id查询用户表的记录 -->
    <!-- 通过 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="user">
        SELECT * FROM USER WHERE id=#{value}
    </select>
　　 <!-- 根据用户名称模糊查询用户信息，可能返回多条
    resultType：指定就是单条记录所映射的java对象 类型
    ${}:表示拼接sql串，将接收到参数的内容不加任何修饰拼接在sql中。
    使用${}拼接sql，引起 sql注入
    ${value}：接收输入 参数的内容，如果传入类型是简单类型，${}中只能使用value
     -->
    <select id="findUserByName" parameterType="java.lang.String" resultType="cn.luswei.mybatis.po.User">
        SELECT * FROM USER WHERE username LIKE '%${value}%'
    </select>
　　 <!-- 定义resultMap
    将SELECT id id_,username username_ FROM USER 和User类中的属性作一个映射关系
    type：resultMap最终映射的java对象类型,可以使用别名
    id：对resultMap的唯一标识
    -->
    <resultMap type="user" id="userResultMap">
         <!-- id表示查询结果集中唯一标识 
         column：查询出来的列名
         property：type指定的pojo类型中的属性名
         最终resultMap对column和property作一个映射关系 （对应关系）
         -->
         <id column="id_" property="id"/>
         <!-- 
         result：对普通名映射定义
         column：查询出来的列名
         property：type指定的pojo类型中的属性名
         最终resultMap对column和property作一个映射关系 （对应关系）
          -->
         <result column="username_" property="username"/>
     
    </resultMap>
　　 <!-- 使用resultMap进行输出映射
    resultMap：指定定义的resultMap的id，如果这个resultMap在其它的mapper文件，前边需要加namespace
    -->
    <select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
        SELECT id id_,username username_ FROM USER WHERE id=#{value}
    </select>
</mapper>

3、#{}、${}、parameterType、resultType
　　#{}：表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换，#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。

　　${}：表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

　　parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。

　　resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。

4、Mapper动态代理方式
Mapper接口开发方法只需要程序员编写Mapper接口(相当于Dao接口)，由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper接口开发需要遵循以下规范：

　　1、Mapper.xml文件中的namespace与mapper接口的类路径相同。
　　2、Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
　　3、Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同
　　4、Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

映射文件Mapper.xml： 定义mapper映射文件UserMapper.xml（内容同Users.xml），需要修改namespace的值为 UserMapper接口路径。将UserMapper.xml放在classpath 下mapper目录 下。

接口文件Mapper.java：
　　1、Mapper接口方法名和Mapper.xml中定义的statement的id相同
　　2、Mapper接口方法的输入参数类型和mapper.xml中定义的statement的parameterType的类型相同
　　3、Mapper接口方法的输出参数类型和mapper.xml中定义的statement的resultType的类型相同

5、程序的测试：

    //会话工厂
    private SqlSessionFactory sqlSessionFactory;
 
    @Before
    public void createSqlSessionFactory() throws IOException {
        // 配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
 
        // 使用SqlSessionFactoryBuilder从xml配置文件中创建SqlSessionFactory
        sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);
 
    }
    @Test
    public void testFindUserById() throws Exception {
        //获取session
        SqlSession session = sqlSessionFactory.openSession();
        //获取mapper接口的代理对象
        UserMapper userMapper = session.getMapper(UserMapper.class);
        //调用代理对象方法
        User user = userMapper.findUserById(1);
        System.out.println(user);
        //关闭session
        session.close();
    }

6、MyBatis与Spring整合：

jar包：MyBatis官方提供的MyBatis与Spring整合的jar包：mybatis-spring-1.2.2.jar
还包括其他的包：spring相关的包、数据库驱动包、mybatis的包

MyBatis配置文件：

　　在classpath下创建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>
        <!-- 全局setting配置，根据需要添加 -->
        <!-- 配置别名 -->
        <typeAliases>
            <!-- 批量扫描别名 -->
            <package name="cn.luswei.ssm.po"/>
        </typeAliases>
     
        <!-- 配置mapper
        使用自动扫描器时，mapper.xml文件如果和mapper.java接口在一个目录则此处不用定义mappers
        由于使用spring和mybatis的整合包进行mapper扫描，这里不需要配置了。
        必须遵循：mapper.xml和mapper.java文件同名且在一个目录 
         -->
        <!--
        <mappers>
        <package name="cn.luswei.mybatis.mapper" />
        </mappers>
         -->
    </configuration>

　　在spring配置文件中定义一个Mapper扫描器，自动扫描包中的Mapper接口生成代理对象：此方法即mapper接口开发方法，只需定义mapper接口，不用编写mapper接口实现类。只需要在spring配置文件中定义一个mapper扫描器，自动扫描包中的mapper接口生成代代理对象，如：

    <!-- mapper扫描器
        mapper批量扫描，从mapper包中扫描出mapper接口，自动创建代理对象并且在spring容器中注册 
        遵循规范：将mapper.java和mapper.xml映射文件名称保持一致，且在一个目录 中
        自动扫描出来的mapper的bean的id为mapper类名（首字母小写）
     -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="mapper接口包地址"></property>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

　　basePackage：扫描包路径，中间可以用逗号或分号分隔定义多个包
　　使用扫描器后，从spring容器中获取mapper的实现对象：

    //自动装配：可用于构造器和字段
    @Autowired
    private ItemsMapper itemsMapper;
    Items items = itemsMapper.selectByPrimaryKey(id);

Spring配置文件：
　　

　　与其他框架整合时，可将Spring的配置文件按功能分成几个几个文件，以便管理：
　　在classpath下创建applicationContext-dao.xml，定义数据库链接池、SqlSessionFactory
　　注意：在定义sqlSessionFactory时指定数据源dataSource和mybatis的配置文件。

　　applicationContext-dao.xml：

    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
        xsi:schemaLocation="http://www.springframework.org/schema/beans 
            http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 
            http://www.springframework.org/schema/mvc 
            http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd 
            http://www.springframework.org/schema/context 
            http://www.springframework.org/schema/context/spring-context-3.2.xsd 
            http://www.springframework.org/schema/aop 
            http://www.springframework.org/schema/aop/spring-aop-3.2.xsd 
            http://www.springframework.org/schema/tx 
            http://www.springframework.org/schema/tx/spring-tx-3.2.xsd ">
        <!-- 加载配置文件 -->
        <context:property-placeholder location="classpath:db.properties"/>
        <!-- 数据库连接池 -->
        <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
               <property name="driverClassName" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
                <property name="maxActive" value="10"/>
                <property name="maxIdle" value="5"/>
        </bean>    
        <!-- mapper配置 -->
        <!-- 让spring管理sqlsessionfactory 使用mybatis和spring整合包中的 -->
        <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
            <!-- 数据库连接池 -->
            <property name="dataSource" ref="dataSource" />
            <!-- 加载mybatis的全局配置文件 -->
            <property name="configLocation" value="classpath:mybatis/SqlMapConfig.xml" />
        </bean>
        <!-- mapper扫描器
            mapper批量扫描，从mapper包中扫描出mapper接口，自动创建代理对象并且在spring容器中注册 
            遵循规范：将mapper.java和mapper.xml映射文件名称保持一致，且在一个目录 中
            自动扫描出来的mapper的bean的id为mapper类名（首字母小写）
         -->
        <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
            <property name="basePackage" value="mapper接口包地址"></property>
            <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
        </bean>
    </beans>

　　在classpath下创建applicationContext-transaction.xml，配置声明式事务管理：

　　applicationContext-transaction.xml：

    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
        xsi:schemaLocation="http://www.springframework.org/schema/beans 
            http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 
            http://www.springframework.org/schema/mvc 
            http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd 
            http://www.springframework.org/schema/context 
            http://www.springframework.org/schema/context/spring-context-3.2.xsd 
            http://www.springframework.org/schema/aop 
            http://www.springframework.org/schema/aop/spring-aop-3.2.xsd 
            http://www.springframework.org/schema/tx 
            http://www.springframework.org/schema/tx/spring-tx-3.2.xsd ">
        <!-- 事务管理器 
            对mybatis操作数据库事务控制，spring使用jdbc的事务控制类
        -->
        <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
            <!-- 数据源
            dataSource在applicationContext-dao.xml中配置了
             -->
            <property name="dataSource" ref="dataSource"/>
        </bean>
     
        <!-- 通知 -->
        <tx:advice id="txAdvice" transaction-manager="transactionManager">
            <tx:attributes>
                <!-- 传播行为 -->
                <tx:method name="save*" propagation="REQUIRED"/>
                <tx:method name="delete*" propagation="REQUIRED"/>
                <tx:method name="insert*" propagation="REQUIRED"/>
                <tx:method name="update*" propagation="REQUIRED"/>
                <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
                <tx:method name="get*" propagation="SUPPORTS" read-only="true"/>
                <tx:method name="select*" propagation="SUPPORTS" read-only="true"/>
            </tx:attributes>
        </tx:advice>
        <!-- aop -->
        <aop:config>
            <aop:advisor advice-ref="txAdvice" pointcut="execution(* cn.luswei.ssm.service.impl.*.*(..))"/>
        </aop:config>
    </beans>