MyBatis框架快速入門(一),搭建MyBatis開發環境

MyBatis 框架概述

  • MyBatis作用在持久層,是一款負責數據庫訪問的框架,它內部封裝了 jdbc,使開發者只需要關注 sql 語句本身,而不需要去處理加載驅動、創建連接、創建 statement 等繁雜的過程。

  • MyBatis通過 xml或註解的方式 將要執行的各種 statement 配置起來,並通過java對象和statement中sql的動態參數進行映射生成最終執行的sql語句,最後由 mybatis 框架執行sql並將結果映射爲java對象並返回。

  • MyBatis採用 ORM 思想解決了實體和數據庫映射的問題,對jdbc進行了封裝,屏蔽了jdbc api底層訪問細節,使我們不用編寫調用jdbc api,就可以完成對數據庫的持久化操作。

  • ORM:對象關係映射思想。是指把Java對象和數據庫的表和字段進行關聯映射,即操作Java對象,就相當於操作了數據庫。

搭建 Mybatis 開發環境

單一的使用Mybatis 框架,不涉及客戶端,所以這裏使用Maven創建Java項目,搭建 Mybatis 開發環境並查詢數據庫用戶表所有用戶信息。
在這裏插入圖片描述

1.創建 maven 工程,引入依賴。

  • (引入依賴)pom.xml
    <dependencies>
        <!--Junit單元測試-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <!--<scope>test</scope>-->
        </dependency>
        <!--MySql的數據庫驅動-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.46</version>
        </dependency>
        <!--Mybatis的jar包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>
        <!--Mybatis依賴的日誌包-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>

2.準備實體類JavaBean

  • User實體類(User)
/*注意:
①JavaBean的屬性名和數據庫的字段名保持一致(有些情況不一致,則數據庫的字段名可起別名與JavaBean的屬性名保持一致)。
②屬性類型使用包裝類,不使用基本數據類型
*/
public class User {
    private Integer id;
    private String username;
    private String password;
    private String email;
    private Date birthday;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", email='" + email + '\'' +
                ", birthday=" + birthday +
                '}';
    }
}

3.準備映射器及其他相關配置文件

  • UserMapper接口【映射器】(UserMapper)
/*注意:
 ①映射器:在Mybatis裏,把持久層(dao層)接口稱爲映射器。
 ②映射器類名取名規範:可以取名爲`XXXMapper`,也可以寫成`XXXDao`。
 ③使用Mybatis框架只要創建接口即可,不需要創建接口的實現類,是通過代理對象來實現功能的。
*/
public interface UserMapper {
    //查詢所有用戶
    List<User> queryAllUser();
}
  • 映射配置文件(UserMapper.xml)

    映射配置文件規範:

    1. 映射配置文件名稱(UserMapper.xml)要和映射器類名(UserMapper)一樣。
    2. 映射配置文件位置要和映射器位置一樣。即:映射器在com.mycode.dao裏,那麼配置文件就應該在resourcescom/mycode/dao目錄下。Mybatis報錯(坑):Could not find resource com.mycode.dao.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">
<!--
mapper標籤
      namespace屬性:表示給哪個映射器進行配置,寫映射器的全限定類名
-->
<mapper namespace="com.mycode.dao.UserMapper">
    <!--
    select標籤:映射查詢語句(給一個查詢的方法進行配置)
          id屬性:命名空間中的唯一標識符,可被用來代表這條語句。(寫映射器方法名)
          resultType屬性:結果集的數據要封裝成的對象.(寫全限定類名)。注意:如果是集合情形,那應該是集合可以包含的類型,而不能是集合本身。
    -->
    <select id="queryAllUser" resultType="com.mycode.domain.User">
        select * from t_user
    </select>

    <!-- 擴展
    ①其他映射語句:
     delete標籤:映射刪除語句 (給一個刪除的方法進行配置)
     update標籤:映射更新語句 (給一個修改的方法進行配置)
     insert標籤:映射插入語句 (給一個添加的方法進行配置)
    ②工作中的術語:
     在mybatis裏通常把給映射器裏每個方法的配置稱爲一個statement。
   -->
</mapper>
  • 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>
    <!--
    environments標籤:數據庫的環境配置,MyBatis可以配置多種環境,這種機制有助於將SQL映射應用於多種數據庫之中。
                default屬性:使用哪個數據庫環境作爲默認的數據庫。
    -->
    <environments default="mybatis01">
        <!--數據庫環境一-->
        <environment id="mybatis01">
            <!--事務管理器的配置-->
            <transactionManager type="JDBC"></transactionManager>
            <!--
            dataSource標籤:使用標準的 JDBC 數據源接口來配置 JDBC 連接對象的資源。(數據源的配置)
                type屬性:數據源的類型(UNPOOLED,POOLED,JNDI)
            -->
            <dataSource type="POOLED">
                <!--
                    driver:JDBC驅動的Java類的完全限定名。
                    url:數據庫的 JDBC URL 地址。
                    username:登錄數據庫的用戶名。
                    password:登錄數據庫的密碼。
                  -->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///stusmanager"/>
                <property name="username" value="root"/>
                <property name="password" value="1998"/>
            </dataSource>
        </environment>

        <!--數據庫環境二-->
        <environment id="mybatis02">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///stusmanager"/>
                <property name="username" value="root"/>
                <property name="password" value="1998"/>
            </dataSource>
        </environment>

    </environments>

    <!--
        mappers標籤:配置映射文件的位置。前面已經在映射配置文件中定義了 SQL 映射語句,這裏就是“告訴”MyBatis去那找映射配置文件。
    -->
    <mappers>
        <mapper resource="com/mycode/dao/UserMapper.xml" />
    </mappers>
</configuration>
  • Mybatis的日誌配置文件,使用log4j輸出執行日誌信息 (log4j.properties)
# Set root category priority to INFO and its only appender to CONSOLE.
#log4j.rootCategory=INFO, CONSOLE     debug   info   warn error fatal
log4j.rootCategory=debug, CONSOLE, LOGFILE

# Set the enterprise logger category to FATAL and its only appender to CONSOLE.
log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE

# CONSOLE is set to be a ConsoleAppender using a PatternLayout.
#控制檯輸出
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n

# LOGFILE is set to be a File appender using a PatternLayout.
log4j.appender.LOGFILE=org.apache.log4j.FileAppender
#日誌文件存放路徑
log4j.appender.LOGFILE.File=d:\axis.log  
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n

4.測試查詢

  • 測試類(QuickStartTest)
/*
思路:讀取配置文件,得到一個輸入流,構造者根據輸入流流構造一個工廠,工廠生產一個SqlSession對象,
SqlSession對象得到映射器的代理對象,由代理對象執行sql語句。
 */
public class QuickStartTest {
    @Test
    public void quickStartTest() throws IOException {
        //讀取核心配置文件(SqlMapConfig.xml),得到輸入流
        InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        //創建構造者對象
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //構造者根據輸入流構造一個工廠,得到SqlSessionFactory工廠對象【構造者模式】
        SqlSessionFactory factory = sqlSessionFactoryBuilder.build(inputStream);
        //工廠對象生產一個SqlSession對象【工廠模式】
        SqlSession sqlSession = factory.openSession();
        //使用SqlSession對象獲取映射器UserMapper接口的代理對象(有接口,沒有實現類,生成代理對象,由代理對象完成功能)【代理模式】
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //調用UserMapper代理對象的方法(即調用代理對象行爲),查詢所有用戶.
         List<User> userList = mapper.queryAllUser();
        for (User user:userList) {
            System.out.println(user);
        }
        sqlSession.close();
        inputStream.close();
    }
}

運行輸出:<××××>爲註釋

   [main] DEBUG ache.ibatis.logging.LogFactory  - Logging initialized using 'class org.apache.ibatis.logging.log4j.Log4jImpl' adapter.
   [main] DEBUG source.pooled.PooledDataSource  - PooledDataSource forcefully closed/removed all connections.
   [main] DEBUG source.pooled.PooledDataSource  - PooledDataSource forcefully closed/removed all connections.
   [main] DEBUG source.pooled.PooledDataSource  - PooledDataSource forcefully closed/removed all connections.
   [main] DEBUG source.pooled.PooledDataSource  - PooledDataSource forcefully closed/removed all connections.
   [main] DEBUG ansaction.jdbc.JdbcTransaction  - Opening JDBC Connection  <打開JDBC連接>
   [main] DEBUG source.pooled.PooledDataSource  - Created connection 1131645570.<創建連接>
   [main] DEBUG ansaction.jdbc.JdbcTransaction  - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@43738a82]<取消自動提交事務>
   [main] DEBUG de.dao.UserMapper.queryAllUser  - ==>  Preparing: select * from t_user <準備執行sql語句>
   [main] DEBUG de.dao.UserMapper.queryAllUser  - ==> Parameters: 
   [main] DEBUG de.dao.UserMapper.queryAllUser  - <==      Total: 37<查詢到37條記錄>
User{id=1, username='張三', password='1', email='null', birthday=null}
User{id=2, username='李四', password='1', email='null', birthday=null}
User{id=3, username='王五', password='1', email='null', birthday=null}
User{id=4, username='上官婉兒', password='1', email='null', birthday=null}
User{id=5, username='上官鍋兒', password='1', email='null', birthday=null}
User{id=6, username='上官瓢兒', password='1', email='null', birthday=null}
.....
.....
User{id=37, username='小喬', password='1', email='null', birthday=null}
User{id=38, username='伽羅', password='1', email='null', birthday=null}
User{id=39, username='迪迦', password='1', email='null', birthday=null}
User{id=43, username='百里', password='123', email='[email protected]', birthday=Thu Jan 02 00:00:00 CST 2020}
   [main] DEBUG ansaction.jdbc.JdbcTransaction  - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@43738a82] <恢復自動提交狀態>
   [main] DEBUG ansaction.jdbc.JdbcTransaction  - Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@43738a82]<關閉JDBC連接>
   [main] DEBUG source.pooled.PooledDataSource  - Returned connection 1131645570 to pool.<連接歸還給數據庫連接池>

從運行日誌信息就可以看出,這正對應前面概述所說:MyBatis內部封裝了 jdbc,使開發者只需關注 sql 語句本身,而不需要去處理加載驅動、創建連接、創建 statement 等過程,同時MyBatis還採用 ORM 思想解決了實體和數據庫映射的問題,這使我們可以更爲方便的完成對數據的持久化操作。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章