基本環(huán)境搭建

1 新建一個無骨架的maven工程, 要在maven的directory中指定maven的安裝路徑和setting.xml,responstory的位置.
2 刪除新建工程src目錄,讓其成為一個父類,充當(dāng)父工程的角色.這樣設(shè)計的目的是不需要在重復(fù)的為后來新建的模塊設(shè)置對應(yīng)的jar依賴.
3 在pom.xml中導(dǎo)入常用的jar包,如mysql, mybatis,junit等.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!--父工程-->
    <groupId>cn.mineTest</groupId>
    <artifactId>mybatis_01</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>mybatis_study_01</module>
    </modules>
    <!--導(dǎo)入依賴-->
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.46</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
    </dependencies>
    <build>
        <!--容錯處理,以免配置文件無法導(dǎo)入或生效的問題-->
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>
</project>

4 創(chuàng)建一個模塊作為我們的工程項目,觀察父包中多了一個新建的這個模塊.新建的模塊不需要在重新導(dǎo)包了.這就是maven父子繼承的好處.(父工程的核心配置中會有子工程的mudule,表示子工程也擁有跟父類相同的配置)

<modules>
        <module>mybatis_study_01</module>
    </modules>

mybatis的集成

1 直接在mybatis搜索即可

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

2. 參照mybatis文檔,封裝加載核心配置文件的工具類.例如:

package com.mine.utils;

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;

// sqlSessionFactory工具類
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            String resource = "mybatis_config.xml";
         InputStream  inputStream = Resources.getResourceAsStream(resource);
         sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    // 獲取可以執(zhí)行sql的sqlSession對象
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

常見錯誤:

• 配置文件沒有注冊,錯誤提示如下:

org.apache.ibatis.binding.BindingException: Type interface 
com.mine.dao.UserDao is not known to the MapperRegistry.

解決方法:每一個Mapper.xml都需要在mybatis的核心配置文件中注冊.

例如:在mybatis核心配置中注冊UserMapper.xml.
<mappers>
        <mapper resource="com/mine/dao/UserMapper.xml"/>
    </mappers>

• 配置文件無法導(dǎo)入或生效的問題.即resouces中的配置文件導(dǎo)出失敗.解決方案是在build中配置resource.

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

CRUD操作

• namespace中的包名要和Dao/Mapper中的接口的包名保持一致.
• select選擇查詢語句
  • id: 指的就是namespace中的方法名.
  • resultType: sql語句執(zhí)行的返回值.
  • parameterType: 參數(shù)類型.

注意點(diǎn): 增刪改需要提交事務(wù).
例如:

// UserMapper
public interface UserMapper {
    List<User> getUserList();
    User getUserById(int id);
}
// UserMapper.xml
<mapper namespace="com.mine.dao.UserMapper">
  <select id="getUserList" resultType="com.mine.pojo.User">
    select * from mybatis.user
    </select>

    <select id="getUserById" resultType="com.mine.pojo.User" parameterType="int">
        select * from mybatis.user where id = #{id}
    </select>
    // 
    <insert id="addUser" parameterType="com.mine.pojo.User" >
        insert into mybatis.user (id, name, pwd) values (#{id}, #{name}, #{pwd})
    </insert>

    <update id="updateUser" parameterType="com.mine.pojo.User">
    update mybatis.user set name = #{name}, pwd = #{pwd} where id = #{id}
    </update>

    <delete id="deleteUser" parameterType="com.mine.pojo.User">
        delete from mybatis.user where id = #{id}
    </delete>
</mapper>

配置解析優(yōu)化

環(huán)境配置（environments)

盡管可以配置多個環(huán)境逸爵，但每個 SqlSessionFactory 實例只能選擇一種環(huán)境.可以通過默認(rèn)使用的環(huán)境 ID（default="development"）屬性來切換配置環(huán)境诵肛。

屬性（properties）

可以通過properties屬性來實現(xiàn)引用配置文件,這些屬性都是可以外部配置且動態(tài)替換,既可以在典型的java屬性文件中配置,亦可以通過properties元素的子元素來傳遞.
例如:
(1)我們可以在resources下新建一個db. properties文件,在其中配置db相關(guān)的設(shè)置.

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false
username=root
password=12345678

(2)然后在核心配置文件中通過properties標(biāo)簽元素引入db.proerties文件即可.

<configuration>
<!--引入外部配置文件-->
    <properties resource="db.properties"></properties>
        <environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"/>
                <dataSource type="POOLED">
                    <property name="driver" value="${driver}"/>
                    <property name="url" value="${url}"/>
                    <property name="username" value="${username}"/>
                    <property name="password" value="${password}"/>
                </dataSource>
            </environment>
        </environments>
    <mappers>
        <mapper resource="com/mine/dao/UserMapper.xml"/>
    </mappers>
</configuration>

• 關(guān)于引入外部文件的注意事項:
  (1)可以直接引入
  (2)可以在其中增加一些屬性配置
  (3)如果兩個文件同一個字段,則會優(yōu)先使用外部配置文件的.比如我們在db. properties中配置了賬戶密碼,在核心配置文件中引入db. properties之后,在properties標(biāo)簽中也配置了賬戶密碼,那么此時會優(yōu)先使用外部配置文件db. properties中的賬戶密碼.

類型別名（typeAliases）

類型別名目的是為Java類型設(shè)置一個短的名字,它只和 XML 配置有關(guān),存在的意義僅在于用來減少類完全限定名的冗余.

• 給類型取別名有兩種方式:
  (1)直接使用typeAlias標(biāo)簽

    <typeAliases>
        <typeAlias type="com.mine.pojo.User" alias="user"/>
    </typeAliases>

(2)指定一個包名
指定包名這種方式,Mybatis會在包名下面搜索需要的JavaBean.這種設(shè)置,會掃描實體類的包,則它的默認(rèn)別名就是當(dāng)前這個類的類名,首字母小寫.

 <typeAliases>
        <package name="com.mine.pojo" />
    </typeAliases>

兩種取別名的方式區(qū)別在于第一種可以自定義別名,第二種則不行.對于第二種方法若一定要自定義別名,而不采用類首字母小寫的方式作為別名,則需要在對應(yīng)的實體類上增加注解的方式可以實現(xiàn).

例如:
@Alias("hello")
public class User {

映射器(Mapper)

MapperRegistry主要是幫助我們注冊綁定Mapper文件.有三種實現(xiàn)方式.
(1) 直接使用resource來指定對應(yīng)文件.

<mappers>
        <mapper resource="com/mine/dao/UserMapper.xml"/>
    </mappers>

(2)使用class文件幫到注冊

<mappers>
        <mapper class="com.mine.dao.UserMapper.xml"/>
    </mappers>

(3)使用掃描包進(jìn)行注入綁定

<mappers>
        <mapper package="com.mine.dao"/>
    </mappers>

其中方法(2)和(3)中需要尤其注意:
接口和Mapper配置文件必須同名
接口和Mapper配置文件必須在同一個包下.

日志

如果數(shù)據(jù)庫操作,出現(xiàn)異常,則需要排錯,日志就是最好的幫手.
日志工廠:logImpl
(1)STDOUT_LOGGING為標(biāo)準(zhǔn)日志工廠實現(xiàn).

• 在mybatis的核心配置文件中,配置我們的日志

<!--日志配置-->
    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

(2)LOG4J

• 可以控制日志信息輸送的目的地是控制臺年栓、文件宝穗、GUI組件等
• 可以控制每一條日志的輸出格式
• 可以定義每一條日志信息的級別，我們能夠更加細(xì)致地控制日志的生成過程
• 可以通過一個配置文件來靈活地進(jìn)行配置朋其，而不需要修改應(yīng)用的代碼鉴吹。
  log4j的配置:
  (1)先導(dǎo)入log4j依賴包.
  (2)log4j.properties配置

### 配置根 ###
log4j.rootLogger = DEBUG,console ,file

### 配置輸出到控制臺 ###
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold = DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern = [%c] - %m%n

### 配置輸出到文件 ###
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File = ./logs/log4jTest.log
log4j.appender.file.maxFileSize = 10mb
#log4j.appender.fileAppender.Append = true
log4j.appender.file.Threshold = DEBUG
log4j.appender.file.layout = org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern = [%p][%d{yy-MM-dd}][%c]%m%n

### 設(shè)置輸出sql的級別，其中l(wèi)ogger后面的內(nèi)容全部為jar包中所包含的包名 ###
log4j.logger.org.apache = DEBUG
log4j.logger.org.mybatis = DEBUG
log4j.logger.java.sql.Connection = DEBUG
log4j.logger.java.sql.Statement = DEBUG
log4j.logger.java.sql.PreparedStatement = DEBUG
log4j.logger.java.sql.ResultSet = DEBUG

(3)在setting中配置log4j為日志的實現(xiàn)方式

<settings>
        <setting name="logImpl" value="LOG4J"/>
    </settings>

log4j使用:
(1) 在要使用log4j的類中導(dǎo)入包 import org.apache.log4j.Logger;
(2) 生成日志對象, 日志對象為當(dāng)前類的class

 @Test
    public void log4jTest() {
        Logger logger = Logger.getLogger(UserDaoTest.class);
        logger.info("log4j測試來了");
        logger.debug("log4j的debug來了");
        logger.error("log4j的error來了");
    }

(3)日常開發(fā)中只需要在需要日志的地方補(bǔ)充上必要的logger.info語句即可快速定位.