正文

新手快速上手：MyBatis开源框架入门与实践指南

/0 浏览量
0608

引言

在Java后端开发中，持久层框架一直是开发者关注的焦点。MyBatis作为一款优秀的持久层框架，以其简洁的配置和灵活的映射方式受到广泛欢迎。对于新手来说，快速上手MyBatis是掌握其核心功能和进阶技巧的第一步。本文将带你从入门到实践，详细了解MyBatis的使用。

一、MyBatis简介

1.1 什么是MyBatis？

MyBatis是一个支持定制化SQL、存储过程以及高级映射的持久层框架。它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。

1.2 MyBatis的优势

  • 易用性：通过XML或注解的方式配置SQL语句，简化了开发过程。
  • 灵活性：支持自定义SQL语句，满足各种复杂的业务需求。
  • 性能：减少了数据库访问的开销，提高了应用程序的运行效率。

二、环境搭建

2.1 添加依赖

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

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis.caches</groupId>
        <artifactId>mybatis-redis</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.10</version>
    </dependency>
</dependencies>

2.2 配置数据库

创建一个MySQL数据库，并创建一个名为mybatis_example的表，用于后续操作。

CREATE TABLE `user` (
  `id` int NOT NULL AUTO_INCREMENT,
  `name` varchar(50) NOT NULL,
  `age` int NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2.3 配置MyBatis

在项目的src目录下创建一个名为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_example?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

三、编写Mapper接口

在src目录下创建一个名为com/example/mapper的包，并在该包中创建一个名为UserMapper的接口。

package com.example.mapper;

public interface UserMapper {
    int insert(User user);
    User selectById(int id);
}

四、编写Mapper XML

在src目录下创建一个名为com/example/mapper的包，并在该包中创建一个名为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="com.example.mapper.UserMapper">
    <insert id="insert" parameterType="User">
        INSERT INTO `user` (`name`, `age`)
        VALUES (#{name}, #{age})
    </insert>
    <select id="selectById" parameterType="int" resultType="User">
        SELECT * FROM `user` WHERE `id` = #{id}
    </select>
</mapper>

五、测试MyBatis

在src目录下创建一个名为com/example/service的包，并在该包中创建一个名为UserServiceImpl的类。

package com.example.service;

import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class UserServiceImpl implements UserService {
    private final SqlSessionFactory sqlSessionFactory;

    public UserServiceImpl() {
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(
            Resources.getResourceAsStream("mybatis-config.xml")
        );
    }

    @Override
    public void addUser(User user) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            mapper.insert(user);
            session.commit();
        }
    }

    @Override
    public User getUserById(int id) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            return mapper.selectById(id);
        }
    }
}

在src目录下创建一个名为com/example/app的包，并在该包中创建一个名为App的类。

package com.example.app;

import com.example.model.User;
import com.example.service.UserServiceImpl;

public class App {
    public static void main(String[] args) {
        UserService userService = new UserServiceImpl();
        User user = new User();
        user.setName("张三");
        user.setAge(20);
        userService.addUser(user);
        User resultUser = userService.getUserById(1);
        System.out.println("Name: " + resultUser.getName() + ", Age: " + resultUser.getAge());
    }
}

运行App类，将看到以下输出：

Name: 张三, Age: 20

至此，你已经成功地完成了MyBatis的入门与实践。希望本文能帮助你更好地理解和掌握MyBatis的使用。

-- 展开阅读全文 --