正文

Java开源框架MyBatis快速入门：从零基础到实战项目应用

/0 浏览量
0707

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

第一章：MyBatis 简介

1.1 什么是MyBatis

MyBatis 是一个半ORM（对象关系映射）框架，它允许使用简单的 XML 或注解用于配置和原始映射。它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。

1.2 MyBatis 的特点

  • 简化数据库操作：通过 XML 或注解的方式，简化了数据库操作。
  • 高性能：通过减少数据库访问次数和降低数据库压力，提高了应用程序的性能。
  • 高扩展性：通过插件机制，可以轻松扩展 MyBatis 的功能。
  • 良好的社区支持：拥有庞大的社区和丰富的文档资源。

第二章：环境搭建

2.1 创建Maven项目

  1. 打开 Maven 的官网下载 Maven 安装包。
  2. 解压安装包并配置环境变量。
  3. 打开命令行窗口，执行 mvn -version 查看 Maven 是否安装成功。

2.2 添加依赖

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

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.3</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
</dependencies>

2.3 配置数据库连接

在项目的 resources 目录下创建 application.properties 文件，配置数据库连接信息：

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root

第三章：MyBatis 配置

3.1 MyBatis 配置文件

在项目的 resources 目录下创建 mybatis-config.xml 文件，配置 MyBatis：

<?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/mybatis?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

3.2 映射文件

在项目的 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="selectUserById" resultType="com.example.domain.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

第四章：Java 代码配置

4.1 创建接口

在项目的 com.example.mapper 包下创建 UserMapper 接口：

package com.example.mapper;

import com.example.domain.User;
import org.apache.ibatis.annotations.Select;

public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User selectUserById(Integer id);
}

4.2 配置类

在项目的 com.example.config 包下创建 MyBatisConfig 配置类：

package com.example.config;

import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

@Configuration
public class MyBatisConfig {
    @Bean
    public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        return builder.build(this.getClass().getClassLoader().getResourceAsStream("mybatis-config.xml"), dataSource);
    }

    @Bean
    public SqlSession sqlSession(SqlSessionFactory sqlSessionFactory) throws Exception {
        return sqlSessionFactory.openSession();
    }
}

第五章：实战项目应用

5.1 创建实体类

在项目的 com.example.domain 包下创建 User 实体类：

package com.example.domain;

public class User {
    private Integer id;
    private String name;
    private String email;

    // 省略 getter 和 setter 方法
}

5.2 创建测试类

在项目的 com.example.mapper 包下创建 UserMapperTest 测试类：

package com.example.mapper;

import com.example.config.MyBatisConfig;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class UserMapperTest {
    @Test
    public void testSelectUserById() {
        ApplicationContext context = new AnnotationConfigApplicationContext(MyBatisConfig.class);
        UserMapper userMapper = context.getBean(UserMapper.class);
        User user = userMapper.selectUserById(1);
        System.out.println(user);
    }
}

运行测试类，输出用户信息：

User(id=1, name=张三, email=zhangsan@example.com)

通过以上步骤，你已经成功完成了 MyBatis 的快速入门，并且可以将其应用到实际的实战项目中。希望这篇文章对你有所帮助，祝你学习愉快！

-- 展开阅读全文 --