引言
MyBatis是一个优秀的持久层框架,它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis可以通过简单的XML或注解用于配置和原始映射,将接口和Java的POJOs(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。本文将带你从搭建MyBatis环境开始,逐步深入到实战应用。
一、搭建MyBatis环境
1.1 环境准备
在开始之前,请确保你的电脑上已经安装了以下环境:
- JDK 1.8及以上版本
- Maven 3.0及以上版本
- MySQL数据库
1.2 创建Maven项目
- 打开Maven命令行工具,创建一个新的Maven项目。
- 添加以下依赖到
pom.xml文件中:
<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.3 配置数据库
- 在MySQL中创建一个新的数据库,例如
mybatis_example。 - 创建一个用户表
user,包含id、username和password三个字段。
二、编写MyBatis配置文件
在项目的src/main/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_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>
2.1 数据库连接配置
在上面的配置文件中,我们配置了数据库连接信息,包括驱动、URL、用户名和密码。
2.2 映射文件配置
在com/example/mapper目录下创建一个名为UserMapper.xml的文件,配置User对象的映射:
<?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="selectById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
在上面的映射文件中,我们定义了一个selectById方法,用于根据ID查询用户信息。
三、编写Mapper接口
在com/example/mapper目录下创建一个名为UserMapper.java的接口,定义selectById方法:
package com.example.mapper;
import com.example.entity.User;
public interface UserMapper {
User selectById(int id);
}
四、使用MyBatis
4.1 创建MyBatis会话工厂
在com/example/service目录下创建一个名为MyBatisUtil.java的工具类,用于获取MyBatis会话工厂:
package com.example.service;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatisUtil {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisUtil.class.getClassLoader(), "mybatis-config.xml");
} catch (Exception e) {
e.printStackTrace();
}
}
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
}
4.2 使用MyBatis查询数据
在com/example/service目录下创建一个名为UserService.java的服务类,用于查询用户信息:
package com.example.service;
import com.example.entity.User;
import com.example.mapper.UserMapper;
public class UserService {
public User getUserById(int id) {
try {
SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
UserMapper userMapper = sqlSessionFactory.openSession().getMapper(UserMapper.class);
return userMapper.selectById(id);
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
}
4.3 测试MyBatis
在com.example.controller目录下创建一个名为UserController.java的控制器类,用于测试MyBatis查询功能:
package com.example.controller;
import com.example.service.UserService;
import com.example.entity.User;
import java.util.Scanner;
public class UserController {
public static void main(String[] args) {
UserService userService = new UserService();
Scanner scanner = new Scanner(System.in);
System.out.print("请输入用户ID:");
int id = scanner.nextInt();
User user = userService.getUserById(id);
if (user != null) {
System.out.println("用户名:" + user.getUsername());
System.out.println("密码:" + user.getPassword());
} else {
System.out.println("未找到用户");
}
}
}
运行UserController类,输入用户ID,即可查询到对应的用户信息。
五、总结
本文详细介绍了Java开源框架MyBatis的入门知识,从搭建环境到实战应用,希望能帮助你快速上手MyBatis。在实际开发中,MyBatis还可以与Spring框架集成,实现更高级的功能。祝你学习愉快!
