MyBatis 是一款优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,简单的 Java 对象)映射成数据库中的记录。下面,我们将一起探索 MyBatis 的入门教程和实战案例。
MyBatis 入门教程
1. MyBatis 简介
MyBatis 的核心是 SQL 映射文件,它定义了 SQL 语句和参数映射,以及结果集的映射。MyBatis 也提供了拦截器、插件等高级功能。
2. 环境搭建
- Maven 依赖:在项目的
pom.xml文件中添加 MyBatis 依赖。
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
- 配置文件:创建
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/yourdatabase"/>
<property name="username" value="root"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
</configuration>
3. 编写 SQL 映射文件
在 src/main/resources/mapper 目录下创建 XML 文件,如 UserMapper.xml,定义 SQL 语句和结果集映射。
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="com.example.model.User">
SELECT * FROM users WHERE id = #{id}
</select>
</mapper>
4. 接口定义
在 src/main/java 目录下创建接口,如 UserMapper.java。
package com.example.mapper;
public interface UserMapper {
User selectById(Integer id);
}
5. MyBatis 配置
在 src/main/java 目录下创建配置类,如 MyBatisConfig.java。
package com.example.config;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.apache.ibatis.io.Resources;
import java.io.IOException;
import java.io.InputStream;
public class MyBatisConfig {
public static SqlSessionFactory getSqlSessionFactory() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
return new SqlSessionFactoryBuilder().build(inputStream);
}
}
实战案例全解析
1. 实体类定义
创建实体类 User.java,对应数据库中的用户表。
package com.example.model;
public class User {
private Integer id;
private String name;
private String email;
// 省略 getter 和 setter
}
2. 实现接口
在 src/main/java 目录下创建接口实现类,如 UserMapperImpl.java。
package com.example.mapper.impl;
import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserMapperImpl implements UserMapper {
private SqlSessionFactory sqlSessionFactory;
public UserMapperImpl(SqlSessionFactory sqlSessionFactory) {
this.sqlSessionFactory = sqlSessionFactory;
}
@Override
public User selectById(Integer id) {
try (SqlSession session = sqlSessionFactory.openSession()) {
return session.selectOne("com.example.mapper.UserMapper.selectById", id);
}
}
}
3. 测试代码
创建测试类 UserTest.java,进行功能测试。
package com.example.test;
import com.example.config.MyBatisConfig;
import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.session.SqlSessionFactory;
public class UserTest {
public static void main(String[] args) throws IOException {
SqlSessionFactory sqlSessionFactory = MyBatisConfig.getSqlSessionFactory();
UserMapper userMapper = new UserMapperImpl(sqlSessionFactory);
User user = userMapper.selectById(1);
System.out.println(user.getName());
}
}
4. 总结
通过以上步骤,你已经成功搭建了一个简单的 MyBatis 项目。在实际项目中,你可以根据需要添加更多的功能,如分页、缓存、动态 SQL 等。
希望这份教程能够帮助你轻松入门 MyBatis,并在实际项目中搭建高效、可扩展的 Java 项目。
