在Java开发领域,MyBatis是一个广泛使用的数据持久层框架,它可以帮助开发者高效地进行数据库操作。从零开始,本教程将带你一步步了解MyBatis的核心概念,掌握其使用方法,并通过实战案例实现数据库连接与对象关系映射(ORM)。
第一部分:MyBatis简介
1.1 MyBatis是什么?
MyBatis是一个半ORM(对象关系映射)框架,它将SQL语句与Java对象映射起来,从而简化了数据库操作。与全ORM框架(如Hibernate)相比,MyBatis提供了更高的灵活性和性能。
1.2 MyBatis的特点
- 灵活的SQL映射:MyBatis允许你将SQL语句与Java对象直接关联,实现复杂的数据库操作。
- 简单的配置:MyBatis的配置文件简洁明了,易于阅读和维护。
- 插件扩展:MyBatis支持插件扩展,方便实现自定义功能。
第二部分:环境搭建
2.1 开发工具
- IDE:推荐使用IntelliJ IDEA或Eclipse。
- Java版本:推荐使用Java 8及以上版本。
- Maven:用于依赖管理。
2.2 创建Maven项目
- 打开Maven命令行工具。
- 输入以下命令创建项目:
mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-example -DarchetypeArtifactId=maven-archetype-quickstart
- 选择“2”创建一个简单的Java项目。
2.3 添加依赖
在pom.xml文件中添加以下依赖:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
</dependencies>
第三部分:数据库连接
3.1 配置数据库连接
在src/main/resources目录下创建一个名为application.properties的文件,并添加以下内容:
# 数据库连接配置
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_example?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root
3.2 加载数据库连接
在src/main/java目录下创建一个名为DBConfig.java的文件,并添加以下内容:
import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;
import javax.sql.DataSource;
import org.apache.commons.dbcp2.BasicDataSource;
public class DBConfig {
private static DataSource dataSource;
public static DataSource getDataSource() {
if (dataSource == null) {
dataSource = createDataSource();
}
return dataSource;
}
private static DataSource createDataSource() {
BasicDataSource dataSource = new BasicDataSource();
Properties properties = new Properties();
try (InputStream inputStream = DBConfig.class.getClassLoader().getResourceAsStream("application.properties")) {
properties.load(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
dataSource.setDriverClassName(properties.getProperty("jdbc.driver"));
dataSource.setUrl(properties.getProperty("jdbc.url"));
dataSource.setUsername(properties.getProperty("jdbc.username"));
dataSource.setPassword(properties.getProperty("jdbc.password"));
return dataSource;
}
}
第四部分:ORM实现
4.1 创建实体类
在src/main/java目录下创建一个名为User.java的文件,并添加以下内容:
public class User {
private Integer id;
private String name;
private Integer age;
// 省略getter和setter方法
}
4.2 创建Mapper接口
在src/main/java目录下创建一个名为UserMapper.java的文件,并添加以下内容:
public interface UserMapper {
List<User> findAll();
User findById(Integer id);
void save(User user);
void update(User user);
void delete(Integer id);
}
4.3 创建Mapper XML文件
在src/main/resources目录下创建一个名为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">
<select id="findAll" resultType="com.example.User">
SELECT * FROM user
</select>
<select id="findById" parameterType="int" resultType="com.example.User">
SELECT * FROM user WHERE id = #{id}
</select>
<insert id="save" parameterType="com.example.User">
INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>
<update id="update" parameterType="com.example.User">
UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>
<delete id="delete" parameterType="int">
DELETE FROM user WHERE id = #{id}
</delete>
</mapper>
4.4 使用MyBatis
在src/main/java目录下创建一个名为App.java的文件,并添加以下内容:
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 App {
public static void main(String[] args) {
try (SqlSession sqlSession = MyBatisUtil.getSqlSession()) {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 查询所有用户
List<User> users = userMapper.findAll();
for (User user : users) {
System.out.println(user);
}
// 添加用户
User user = new User();
user.setName("张三");
user.setAge(20);
userMapper.save(user);
// 更新用户
user.setId(1);
user.setName("李四");
user.setAge(21);
userMapper.update(user);
// 删除用户
userMapper.delete(1);
}
}
}
4.5 MyBatis工具类
在src/main/java目录下创建一个名为MyBatisUtil.java的文件,并添加以下内容:
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(DBConfig.class.getClassLoader().getResourceAsStream("mybatis-config.xml"));
} catch (Exception e) {
e.printStackTrace();
}
}
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
}
在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="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml"/>
</mappers>
</configuration>
第五部分:总结
通过本教程,你已成功从零开始掌握了Java开源框架MyBatis。MyBatis以其灵活的SQL映射和简单的配置,在Java开发领域得到了广泛的应用。希望本教程能帮助你更好地理解MyBatis,并在实际项目中发挥其优势。
