正文

手把手教你轻松入门MyBatis：从搭建环境到实际应用

/0 浏览量
0820

引言

MyBatis 是一款优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。在这个教程中，我们将从搭建环境开始，一步步教你如何轻松入门 MyBatis，并应用到实际项目中。

一、搭建环境

1. 确定Java版本

首先，我们需要确保你的开发环境已经安装了 Java。MyBatis 支持的 Java 版本包括 Java 5、Java 6、Java 7、Java 8。为了方便起见，这里我们使用 Java 8。

2. 安装IDE

选择一个合适的 IDE 进行开发，如 IntelliJ IDEA 或 Eclipse。这里以 IntelliJ IDEA 为例。

3. 添加MyBatis依赖

在项目中创建一个 Maven 项目，并添加以下依赖：

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

二、编写配置文件

1. 创建mybatis-config.xml

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

2. 创建映射文件

在项目的 src 目录下创建一个名为 mapper 的文件夹，用于存放映射文件。例如，创建一个名为 UserMapper.xml 的文件，用于定义对 User 表的 CRUD 操作。

<?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.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <insert id="insertUser" parameterType="com.example.entity.User">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>
    <update id="updateUser" parameterType="com.example.entity.User">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
    <delete id="deleteUser" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

三、编写实体类

在项目的 src 目录下创建一个名为 entity 的文件夹，用于存放实体类。例如，创建一个名为 User.java 的实体类，对应 User 表。

package com.example.entity;

public class User {
    private int id;
    private String name;
    private int age;

    // getter 和 setter 方法
}

四、编写Mapper接口

在项目的 src 目录下创建一个名为 mapper 的文件夹，用于存放 Mapper 接口。例如，创建一个名为 UserMapper.java 的接口，对应 UserMapper.xml。

package com.example.mapper;

import com.example.entity.User;

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

五、编写Service层

在项目的 src 目录下创建一个名为 service 的文件夹，用于存放 Service 层。例如，创建一个名为 UserService.java 的接口，以及对应的实现类 UserServiceImpl.java。

package com.example.service;

import com.example.entity.User;

public interface UserService {
    User getUserById(int id);
    void addUser(User user);
    void updateUser(User user);
    void deleteUser(int id);
}

package com.example.service.impl;

import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;

public class UserServiceImpl implements UserService {
    private UserMapper userMapper;

    public UserServiceImpl(SqlSession sqlSession) {
        this.userMapper = sqlSession.getMapper(UserMapper.class);
    }

    @Override
    public User getUserById(int id) {
        return userMapper.selectUserById(id);
    }

    @Override
    public void addUser(User user) {
        userMapper.insertUser(user);
    }

    @Override
    public void updateUser(User user) {
        userMapper.updateUser(user);
    }

    @Override
    public void deleteUser(int id) {
        userMapper.deleteUser(id);
    }
}

六、编写Controller层

在项目的 src 目录下创建一个名为 controller 的文件夹，用于存放 Controller 层。例如，创建一个名为 UserController.java 的类，对应 UserService。

package com.example.controller;

import com.example.entity.User;
import com.example.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/user/{id}")
    public String getUserById(@PathVariable("id") int id) {
        User user = userService.getUserById(id);
        // 处理逻辑
        return "user详情页";
    }

    @PostMapping("/user/add")
    public String addUser(User user) {
        userService.addUser(user);
        return "跳转到用户列表页";
    }

    @PostMapping("/user/update")
    public String updateUser(User user) {
        userService.updateUser(user);
        return "跳转到用户列表页";
    }

    @PostMapping("/user/delete")
    public String deleteUser(@RequestParam("id") int id) {
        userService.deleteUser(id);
        return "跳转到用户列表页";
    }
}

七、启动项目

  1. 运行项目，访问 /user/{id} 查询用户信息。
  2. 访问 /user/add 添加用户。
  3. 访问 /user/update 更新用户信息。
  4. 访问 /user/delete 删除用户。

总结

通过以上步骤，你已经成功入门了 MyBatis，并将其应用到实际项目中。希望这个教程对你有所帮助。在后续的学习中，你可以尝试添加更多功能，如分页、关联查询等。祝你学习愉快！

-- 展开阅读全文 --