正文

新手必看：MyBatis开源框架深度解析，从入门到实践全攻略

/0 浏览量
0810

引言

MyBatis 是一款优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 通过简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。本文将带你从入门到实践，全面解析 MyBatis 框架。

一、MyBatis 简介

1.1 什么是 MyBatis？

MyBatis 是一个半ORM（对象关系映射）框架，它将 SQL 映射成 Java 对象，简化了数据库操作。MyBatis 不同于完全的ORM框架如Hibernate，它更注重SQL的灵活性和扩展性。

1.2 MyBatis 的优势

  • 简化数据库操作：通过 XML 或注解的方式，将 SQL 映射成 Java 对象，减少手动编写 SQL 代码。
  • 灵活的 SQL 映射：支持自定义 SQL，满足复杂的业务需求。
  • 支持多种数据库：适用于各种关系型数据库，如 MySQL、Oracle、SQL Server 等。
  • 易于集成：可以与各种 Java 框架集成，如 Spring、Spring Boot 等。

二、MyBatis 入门

2.1 环境搭建

  1. 下载 MyBatis：从官网下载 MyBatis 的最新版本。
  2. 添加依赖：在项目的 pom.xml 文件中添加 MyBatis 依赖。
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.6</version>
</dependency>
  1. 配置 MyBatis：在 src/main/resources 目录下创建 mybatis-config.xml 文件，配置数据库连接信息。
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2.2 编写 Mapper 接口

在 com.example.mapper 包下创建 UserMapper.java 接口，定义数据库操作方法。

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

2.3 编写 Mapper XML

在 src/main/resources/com/example/mapper 目录下创建 UserMapper.xml 文件，编写 SQL 映射。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

2.4 使用 MyBatis

在 Java 代码中，使用 MyBatis 的 SqlSessionFactory 和 SqlSession 执行数据库操作。

public class Main {
    public static void main(String[] args) throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.getUserById(1);
            System.out.println(user);
        }
    }
}

三、MyBatis 高级特性

3.1 动态 SQL

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

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

3.2 批量操作

MyBatis 支持批量操作，可以减少数据库访问次数，提高性能。

List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.getUserByIds", Arrays.asList(1, 2, 3));

3.3 缓存

MyBatis 支持一级缓存和二级缓存，可以减少数据库访问次数，提高性能。

<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

四、MyBatis 实践

4.1 MyBatis 与 Spring 集成

MyBatis 可以与 Spring 框架集成，方便地使用 Spring 的依赖注入、事务管理等特性。

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

4.2 MyBatis 与 MyBatis-Generator 集成

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

<generatorConfiguration>
    <context id="Mysql" targetRuntime="MyBatis3">
        <property name="javaFileEncoding" value="UTF-8"/>
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/test"
                        userId="root"
                        password=""/>
        <javaModelGenerator targetPackage="com.example.entity" 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 schema="test" tableName="user"/>
    </context>
</generatorConfiguration>

五、总结

MyBatis 是一款优秀的持久层框架，它通过将 SQL 映射成 Java 对象，简化了数据库操作。本文从入门到实践，全面解析了 MyBatis 框架，希望对您有所帮助。在实际项目中，您可以根据自己的需求选择合适的 MyBatis 特性，提高开发效率。

-- 展开阅读全文 --