在Java开发中,MyBatis是一个优秀的持久层框架,它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。下面,我将带你从零开始,搭建一个简单的MyBatis项目。
环境准备
在开始之前,请确保你已经安装了以下环境:
- Java Development Kit (JDK) 1.8及以上版本
- Integrated Development Environment (IDE),如IntelliJ IDEA或Eclipse
- Maven,用于项目构建和依赖管理
创建Maven项目
- 打开IDE,创建一个新的Maven项目。
- 在
pom.xml文件中添加以下依赖:
<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.8.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
配置数据库
- 下载并安装MySQL数据库。
- 创建一个新的数据库,例如
mybatis_example。 - 创建一个名为
user的表,包含以下字段:
CREATE TABLE user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50) NOT NULL,
password VARCHAR(50) NOT NULL
);
创建实体类
创建一个名为User的实体类,对应数据库中的user表:
public class User {
private Integer id;
private String username;
private String password;
// 省略getter和setter方法
}
创建Mapper接口
创建一个名为UserMapper的Mapper接口,定义查询用户的方法:
public interface UserMapper {
User getUserById(Integer id);
}
创建Mapper XML
在src/main/resources目录下创建一个名为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="getUserById" resultType="com.example.entity.User">
SELECT * FROM user WHERE id = #{id}
</select>
</mapper>
创建SqlSessionFactory
在src/main/java目录下创建一个名为SqlSessionFactoryUtil的类,用于创建SqlSessionFactory:
public class SqlSessionFactoryUtil {
public static SqlSessionFactory getSqlSessionFactory() throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
return sqlSessionFactory;
}
}
创建MyBatis配置文件
在src/main/resources目录下创建一个名为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/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>
使用MyBatis
在主类中,使用MyBatis进行数据库操作:
public class Main {
public static void main(String[] args) {
try {
SqlSessionFactory sqlSessionFactory = SqlSessionFactoryUtil.getSqlSessionFactory();
SqlSession sqlSession = sqlSessionFactory.openSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUserById(1);
System.out.println(user.getUsername());
sqlSession.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行主类,你应该能看到查询到的用户名。
总结
通过以上步骤,你已经成功搭建了一个简单的MyBatis项目。接下来,你可以继续学习MyBatis的高级特性,如动态SQL、插件等。祝你学习愉快!
