正文

掌握MyBatis：从入门到实战，高效构建Java项目数据库交互

/0 浏览量
0506

MyBatis简介

MyBatis是一个优秀的持久层框架，它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis可以通过简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。

入门篇

1. MyBatis环境搭建

1.1 添加依赖

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

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.22</version>
    </dependency>
</dependencies>

1.2 配置MyBatis

在项目的src/main/resources目录下创建mybatis-config.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="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydatabase"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2. 创建实体类

创建一个实体类User，对应数据库中的用户表：

public class User {
    private Integer id;
    private String name;
    private String email;
    // getter和setter方法
}

3. 创建Mapper接口

创建一个Mapper接口UserMapper，定义数据库操作方法：

public interface UserMapper {
    User getUserById(Integer id);
}

4. 创建Mapper XML

在src/main/resources目录下创建com/example/mapper/UserMapper.xml文件，配置SQL语句：

<?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="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

进阶篇

1. 动态SQL

MyBatis支持动态SQL，可以方便地编写复杂的SQL语句。

1.1 if标签

<select id="getUserByCondition" resultType="User">
    SELECT * FROM user
    <where>
        <if test="id != null">
            AND id = #{id}
        </if>
        <if test="name != null">
            AND name = #{name}
        </if>
    </where>
</select>

1.2 choose标签

<select id="getUserByCondition" resultType="User">
    SELECT * FROM user
    <where>
        <choose>
            <when test="id != null">
                id = #{id}
            </when>
            <when test="name != null">
                name = #{name}
            </when>
            <otherwise>
                1=1
            </otherwise>
        </choose>
    </where>
</select>

2. 缓存

MyBatis提供了内置的缓存机制，可以缓存查询结果，提高性能。

2.1 开启二级缓存

在mybatis-config.xml文件中配置二级缓存：

<settings>
    <setting name="cacheEnabled" value="true"/>
</settings>

2.2 在Mapper接口中配置缓存

public interface UserMapper {
    @CacheNamespace(eviction="FIFO", flushInterval=60000, size=512)
    User getUserById(Integer id);
}

实战篇

1. MyBatis与Spring集成

将MyBatis与Spring框架集成，可以方便地使用Spring的声明式事务管理。

1.1 配置Spring与MyBatis

在Spring的配置文件中配置数据源、SqlSessionFactory和Mapper接口：

<bean id="dataSource" class="org.apache.commons.dbcp2.BasicDataSource">
    <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/mydatabase"/>
    <property name="username" value="root"/>
    <property name="password" value="root"/>
</bean>

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="configLocation" value="classpath:mybatis-config.xml"/>
</bean>

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.example.mapper"/>
    <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>

1.2 使用MyBatis

在Spring的Bean中注入MyBatis的Mapper接口：

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public User getUserById(Integer id) {
        return userMapper.getUserById(id);
    }
}

2. MyBatis与MyBatis-Generator集成

MyBatis-Generator是一个代码生成器，可以自动生成MyBatis的Mapper接口、XML映射文件和实体类。

2.1 配置MyBatis-Generator

在src/main/resources目录下创建generatorConfig.xml文件，配置数据库连接信息和生成代码的路径：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        <property name="beginningDelimiter" value="`"/>
        <property name="endingDelimiter" value="`"/>
        <property name="javaFileEncoding" value="UTF-8"/>
        <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/mydatabase"
                        userId="root"
                        password="root"/>
        <javaModelGenerator targetPackage="com.example.model" targetProject="src/main/java"/>
        <sqlMapGenerator targetPackage="com.example.mapper" targetProject="src/main/resources"/>
        <javaClientGenerator targetPackage="com.example.mapper" targetProject="src/main/java" type="XMLMAPPER"/>
        <table tableName="user"/>
    </context>
</generatorConfiguration>

2.2 运行MyBatis-Generator

在命令行中运行以下命令：

mvn mybatis-generator:generate

这将生成Mapper接口、XML映射文件和实体类。

总结

MyBatis是一个功能强大、易于使用的持久层框架，可以帮助开发者高效地构建Java项目数据库交互。通过本文的介绍，相信你已经对MyBatis有了初步的了解。在实际项目中，你可以根据自己的需求，灵活运用MyBatis的各种功能，提高开发效率。

-- 展开阅读全文 --