首頁手記 MyBatis入門：新手必讀教程

MyBatis入門：新手必讀教程

標簽：

Java SSM 數據庫

本文详细介绍了MyBatis入门的相关内容，包括其基本概念、环境搭建、核心配置及映射文件的使用。文章还深入讲解了MyBatis的高级特性，如动态SQL、分页查询和缓存机制。通过本文，读者可以全面了解并掌握MyBatis的使用方法。

MyBatis简介与环境搭建

MyBatis是什么

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的繁琐操作，它通过简单的 XML 或注解进行配置，将接口和 Java 的 POJOs（普通 Java 对象）映射成数据库中的记录。

MyBatis的优点与应用场景

MyBatis 的主要优点如下：

简化数据库操作：MyBatis 通过映射文件或注解，将 SQL 语句与 Java 代码进行映射，简化了数据库操作的复杂性。
灵活的配置和响应：MyBatis 允许开发者自由选择数据库类型，同时提供了灵活的配置选项，方便开发者根据需求进行调整。
支持存储过程：MyBatis 支持存储过程的使用，适用于需要高性能和复杂业务逻辑的场景。
易于维护：MyBatis 的配置文件和 SQL 映射文件是分离的，便于数据库和应用程序的分离，使维护更加方便。

MyBatis 适用于需要对数据库进行复杂操作的项目，例如涉及大量查询、存储过程和分页的应用程序。它尤其适用于那些需要灵活控制 SQL 语句和结果集映射的项目。

开发环境搭建

首先，确保安装了 JDK 和 Maven。这里使用 Maven 来管理项目依赖，因此需要 Maven 环境。

创建 Maven 项目：

使用命令行创建 Maven 项目：

mvn archetype:generate -DgroupId=com.mkyong.mybatis -DartifactId=mybatis-tutorial -Dversion=1.0 -Dpackaging=jar

进入项目目录：
```
cd mybatis-tutorial
```

创建数据库表：

使用 MySQL 创建数据库和表：

CREATE DATABASE mybatis_example;
USE mybatis_example;

CREATE TABLE User (
  id INT PRIMARY KEY AUTO_INCREMENT,
  username VARCHAR(255),
  password VARCHAR(255),
  email VARCHAR(255)
);

Maven配置与依赖引入

在 pom.xml 文件中添加 MyBatis 依赖：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.23</version>
    </dependency>
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.13.1</version>
    </dependency>
</dependencies>

设置数据库连接属性：
- 在 src/main/resources 目录下创建 database.properties 文件，设置数据库连接属性：
```
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis_example
username=root
password=root
```

MyBatis核心概念与配置

核心配置文件解析

MyBatis 的核心配置文件 mybatis-config.xml 定义了数据库连接配置、Mapper 映射文件路径等信息。

基本结构：

<configuration>
    <properties resource="database.properties"/>
    <typeAliases>
        <typeAlias type="com.mkyong.mybatis.model.User" alias="User"/>
    </typeAliases>
    <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/mkyong/mybatis/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

配置属性：
- <properties>：引入外部属性文件，使配置更灵活。
- <typeAliases>：别名配置，方便在 SQL 中引用。
- <environments>：定义数据库环境，支持多环境切换。
- <transactionManager>：事务管理器，支持 JDBC 或 MANAGED 模式。
- <dataSource>：数据源配置，支持 UNPOOLED、POOLED、JNDI。
- <mappers>：Mapper 映射文件路径，关联 SQL 语句和 Java 类。

数据库连接配置

数据库连接配置在 <environment> 标签中的 <dataSource> 部分。例如：

<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>

配置SqlSessionFactory和SqlSession

使用代码生成 SqlSessionFactory，并创建 SqlSession 对象。

创建 SqlSessionFactory：

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

获取 SqlSession 对象：

SqlSession session = sqlSessionFactory.openSession();

MyBatis映射文件详解

映射文件的基本结构

MyBatis 映射文件包含 SQL 语句和映射配置。例如：

<sqlMapper namespace="com.mkyong.mybatis.mapper.UserMapper">
    <select id="selectUserById" resultType="User">
        SELECT id, username, password, email FROM User WHERE id = #{id}
    </select>
</sqlMapper>

SQL语句标签介绍

<select>：定义 SQL 查询。

<select id="selectUserById" resultType="User">
    SELECT id, username, password, email FROM User WHERE id = #{id}
</select>

<insert>：定义 SQL 插入。

<insert id="insertUser">
    INSERT INTO User (username, password, email) VALUES (#{username}, #{password}, #{email})
</insert>

<update>：定义 SQL 更新。

<update id="updateUser">
    UPDATE User SET username=#{username}, password=#{password}, email=#{email} WHERE id=#{id}
</update>

<delete>：定义 SQL 删除。

<delete id="deleteUserById">
    DELETE FROM User WHERE id=#{id}
</delete>

结果映射与别名配置

结果映射：

<select id="selectUserById" resultType="User">
    SELECT id, username, password, email FROM User WHERE id = #{id}
</select>

别名配置：

<typeAliases>
    <typeAlias type="com.mkyong.mybatis.model.User" alias="User"/>
</typeAliases>

参数类型与返回类型设置

参数类型和返回类型设置在 <select>、<insert>、<update> 和 <delete> 标签的 resultType 和 parameterType 属性中。

参数类型：

<select id="selectUserById" parameterType="int" resultType="User">
    SELECT id, username, password, email FROM User WHERE id = #{id}
</select>

返回类型：

<select id="selectUserById" resultType="User">
    SELECT id, username, password, email FROM User WHERE id = #{id}
</select>

MyBatis与DAO设计

DAO设计模式简介

DAO（Data Access Object）设计模式将所有对数据库的操作进行封装，使得应用程序可以方便地访问数据库，同时使得数据库操作和业务逻辑分离。

MyBatis与DAO实现

MyBatis 可以通过 Mapper 接口和 XML 映射文件实现 DAO 模式。

Mapper 接口：

public interface UserMapper {
    User selectUserById(int id);
    void insertUser(User user);
    void updateUser(User user);
    void deleteUserById(int id);
}

Mapper XML 文件：

<mapper namespace="com.mkyong.mybatis.mapper.UserMapper">
    <select id="selectUserById" resultType="User">
        SELECT id, username, password, email FROM User WHERE id = #{id}
    </select>
    <insert id="insertUser">
        INSERT INTO User (username, password, email) VALUES (#{username}, #{password}, #{email})
    </insert>
    <update id="updateUser">
        UPDATE User SET username=#{username}, password=#{password}, email=#{email} WHERE id=#{id}
    </update>
    <delete id="deleteUserById">
        DELETE FROM User WHERE id=#{id}
    </delete>
</mapper>

接口方式调用Mapper

通过 SqlSession 调用 Mapper 接口方法。

SqlSession session = sqlSessionFactory.openSession();
try {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1);
    System.out.println(user.getUsername());
} finally {
    session.close();
}

动态SQL的使用

MyBatis 提供了多种动态 SQL 标签，例如 <if>、<choose>、<when>、<otherwise> 等。

条件查询：

<select id="selectUserByCondition" parameterType="map" resultType="User">
    SELECT id, username, password, email FROM User
    <where>
        <if test="username != null">
            AND username = #{username}
        </if>
        <if test="email != null">
            AND email = #{email}
        </if>
    </where>
</select>

批量插入：

<insert id="batchInsertUser" parameterType="java.util.List">
    INSERT INTO User (username, password, email) VALUES
    <foreach item="item" index="index" collection="list" open="(" separator="),(" close=")">
        #{item.username}, #{item.password}, #{item.email}
    </foreach>
</insert>

MyBatis高级特性

分页查询

MyBatis 支持分页查询，可以通过 RowBounds 类实现分页。

Mapper 接口：

public interface UserMapper {
    List<User> selectUsersByPage(int offset, int limit);
}

Mapper XML 文件：

<select id="selectUsersByPage" resultType="User">
    SELECT * FROM User LIMIT #{offset}, #{limit}
</select>

分页查询代码：

SqlSession session = sqlSessionFactory.openSession();
try {
    UserMapper mapper = session.getMapper(UserMapper.class);
    List<User> users = mapper.selectUsersByPage(0, 10);
    for (User user : users) {
        System.out.println(user.getUsername());
    }
} finally {
    session.close();
}

复杂关联查询

MyBatis 支持复杂关联查询，例如一对多、多对多等。

Mapper 接口：

public interface UserMapper {
    User selectUserWithOrder(int userId);
}

Mapper XML 文件：

<select id="selectUserWithOrder" parameterType="int" resultType="User">
    SELECT U.id, U.username, U.password, U.email, O.id AS orderId, O.name AS orderName
    FROM User U
    LEFT JOIN Order O ON U.id = O.userId
    WHERE U.id = #{userId}
</select>

复杂关联查询代码：

SqlSession session = sqlSessionFactory.openSession();
try {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserWithOrder(1);
    System.out.println(user.getUsername());
    for (Order order : user.getOrders()) {
        System.out.println(order.getName());
    }
} finally {
    session.close();
}

二级缓存机制

MyBatis 支持二级缓存，可以显著提高查询性能。

全局缓存配置：
```
<cache />
```

Mapper 缓存配置：

<mapper namespace="com.mkyong.mybatis.mapper.UserMapper">
    <cache />
    <select id="selectUserById" resultType="User">
        SELECT id, username, password, email FROM User WHERE id = #{id}
    </select>
</mapper>

启用缓存：

SqlSession session = sqlSessionFactory.openSession();
try {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1);
    System.out.println(user.getUsername());
    // 缓存命中
    User userCached = mapper.selectUserById(1);
    System.out.println(userCached.getUsername());
} finally {
    session.close();
}

插件扩展

MyBatis 允许通过插件扩展功能，例如日志记录、性能监控等。

编写插件：

public class MyPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        System.out.println("Before method execution");
        Object result = invocation.proceed();
        System.out.println("After method execution");
        return result;
    }

    @Override
    public Object plugin(Object target) {
        return Plugin.wrap(target, this);
    }

    @Override
    public void setProperties(Properties properties) {
    }
}

配置插件：

<plugins>
    <plugin interceptor="com.mkyong.mybatis.plugin.MyPlugin">
        <!-- 插件配置属性 -->
    </plugin>
</plugins>

MyBatis调试与异常处理

日志配置与输出

MyBatis 使用 Log4j 或 SLF4J 进行日志输出，配置 log4j.properties 文件。

日志配置文件：

log4j.rootLogger=INFO, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

log4j.logger.com.mkyong.mybatis=DEBUG

输出 SQL 语句：

<settings>
    <setting name="logImpl" value="SLF4J"/>
    <setting name="showSql" value="true"/>
</settings>

常见异常分析

SQL 语法错误：
- 解决方法：检查 SQL 语句，确保语法正确。
数据库连接错误：
- 解决方法：检查数据库连接配置，确保连接信息正确。
结果映射错误：
- 解决方法：检查结果映射配置，确保字段映射正确。

错误排查技巧

检查配置文件：确保 mybatis-config.xml 和 Mapper XML 文件配置正确。
日志输出：通过日志输出查看 SQL 语句和执行过程。
单元测试：编写单元测试，验证 SQL 语句和数据操作逻辑。

调试工具与方法

IDE 调试：使用 IntelliJ IDEA 或 Eclipse 进行调试。
SQL 客户端：使用 MySQL Workbench 或 DBeaver 进行 SQL 调试。
日志分析工具：使用 Logging Interceptor 或其他日志分析工具。

以上是关于 MyBatis 的入门教程，涵盖了从环境搭建到高级特性的各个方面。通过本文，读者可以更好地理解和使用 MyBatis，提高数据库操作的效率和灵活性。

點擊查看更多內容

為 TA 點贊

若覺得本文不錯，就分享一下吧！

評論

評論

共同學習，寫下你的評論

評論加載中...

展開查看更多評論

作者其他優質文章

正在加載中

慕尼黑5688855

手記
篇

粉絲

9

獲贊與收藏

18

關注作者，訂閱最新文章

閱讀免費教程

Java并發工具

23個小節 19844 321

Java 并發原理入門教程

26個小節 40021 580

Java 入門教程

50個小節 351802 3256

推薦

評論

收藏

共同學習，寫下你的評論



感謝您的支持，我會繼續努力的～

掃碼打賞，你說多少就多少

贊賞金額會直接到老師賬戶

支付方式

打開微信掃一掃，即可進行掃碼打賞哦

今天注冊有機會得

100積分直接送

付費專欄免費學

大額優惠券免費領

立即參與放棄機會

點擊
抽獎

慕課手記新用戶專享福利

恭喜你，你的運氣太好了，居然抽中了 100個積分！

恭喜你，抽中了價值元的專欄！

太棒了，直接落到你賬戶里！

積分商城里的羅技鼠標、機械鍵盤、
Kindle 閱讀器、小米平衡車
Apple iPad （10.2英寸）、大額優惠券
在等著你去兌換了噢

作者：

免費贈送

兌換碼：1111222211 復制

優惠券可用于購買實戰課、體系課
無門檻使用

先去看看，有什么好東西馬上兌換我愛學習，選課去


亚洲在线久爱草,狠狠天天香蕉网,天天搞日日干久草,伊人亚洲日本欧美

熱搜

最近搜索清空

MyBatis入門：新手必讀教程

MyBatis简介与环境搭建

MyBatis是什么

MyBatis的优点与应用场景

开发环境搭建

Maven配置与依赖引入

MyBatis核心概念与配置

核心配置文件解析

数据库连接配置

配置SqlSessionFactory和SqlSession

MyBatis映射文件详解

映射文件的基本结构

SQL语句标签介绍

结果映射与别名配置

参数类型与返回类型设置

MyBatis与DAO设计

DAO设计模式简介

MyBatis与DAO实现

接口方式调用Mapper

动态SQL的使用

MyBatis高级特性

分页查询

复杂关联查询

二级缓存机制

插件扩展

MyBatis调试与异常处理

日志配置与输出

常见异常分析

错误排查技巧

调试工具与方法

閱讀免費教程