本文提供了MyBatis资料的基础介绍,包括MyBatis的基本概念、与JDBC的区别、优点和应用场景。文章还详细讲解了MyBatis的环境搭建、基本使用方法及动态SQL的使用技巧。此外,还涵盖了MyBatis与Spring的集成方法和常用标签的解析。
MyBatis基础介绍 MyBatis是什么MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 的优点是灵活的 SQL 映射,能够无缝地与数据库进行交互。它通过 XML 或注解进行配置,将 Java 对象与数据库记录进行映射,以简化数据访问层的操作。MyBatis 允许用户在运行时动态构造 SQL 语句,提供了极大的灵活性和可维护性。
示例代码
User user = new User();
user.setId(1);
user.setUsername("example");
SqlSession session = sqlSessionFactory.openSession();
List<User> users = session.selectList("selectUserById", user);
MyBatis与JDBC的区别
MyBatis 与 JDBC 主要的区别在于它们的使用方式和功能特性:
-
JDBC:
- JDBC 是 Java 提供的直接访问数据库的工具,通过 JDBC 可以直接执行 SQL 语句,获取结果集。
- 使用 JDBC,开发者需要手动处理 SQL 语句的执行结果,进行类型转换和数据绑定。
- JDBC 比较繁琐,需要手动管理数据库连接,编写 SQL 语句等。
- MyBatis:
- MyBatis 是一个持久层框架,它简化了数据库操作,提供了 SQL 映射的功能。
- MyBatis 通过 XML 或注解方式将 SQL 语句和 Java 实体对象进行映射,减少了手动类型转换的繁琐工作。
- MyBatis 通过配置文件集中管理 SQL 语句,简化了数据库访问层代码的编写。
示例代码
// 使用 JDBC
Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/mydatabase", "root", "password");
PreparedStatement stmt = conn.prepareStatement("SELECT * FROM users WHERE id = ?");
stmt.setInt(1, 1);
ResultSet rs = stmt.executeQuery();
while (rs.next()) {
System.out.println(rs.getInt("id"));
System.out.println(rs.getString("username"));
System.out.println(rs.getString("password"));
}
MyBatis的优点与应用场景
优点
- 灵活的 SQL 映射:MyBatis 允许通过 XML 或注解的方式进行 SQL 映射,支持动态 SQL,灵活性高。
- 简化数据库操作:MyBatis 提供了丰富的映射功能,简化了数据库中的 CRUD 操作。
- 可维护性:通过配置文件管理数据库操作,便于维护和升级。
- 与数据库无关:MyBatis 的 SQL 映射通过 XML 或注解实现,与具体的数据库类型无关,易于移植。
- 性能高:MyBatis 的查询结果直接映射为 Java 对象,减少了数据转换的时间。
应用场景
- 中小型项目:适用于中小型项目,尤其是对于数据库操作频繁的项目。
- 企业应用:适用于企业级应用,特别是与数据库交互频繁的应用场景。
- 需要高度定制化SQL的项目:提供灵活的 SQL 映射,适用于需要高度定制化 SQL 的项目。
- 需要高性能的应用:提供了高效的数据库访问方式,适用于对性能有较高要求的应用。
开发 MyBatis 应用需要 Java 开发环境和数据库环境。以下是准备步骤:
- 安装 JDK:确保已经安装了 Java Development Kit (JDK)。建议使用 Java 8 或更高版本。
- 安装数据库:可以选择 MySQL、Oracle、SQL Server 等数据库。
- 配置数据库环境:在数据库中创建用户和数据库,确保数据库服务已经启动并可以访问。
数据库配置示例
<property name="driver" value="com.mysql.cj.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/mydatabase" />
<property name="username" value="root" />
<property name="password" value="password" />
添加MyBatis依赖
在 Maven 项目中,需要在 pom.xml
文件中添加 MyBatis 依赖。以下是依赖配置:
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
</dependencies>
在 Gradle 项目中,需要在 build.gradle
文件中添加依赖:
dependencies {
implementation 'org.mybatis:mybatis:3.5.4'
implementation 'mysql:mysql-connector-java:8.0.23'
}
完整的 pom.xml
示例
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>mybatis-example</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.4</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
</dependencies>
</project>
配置核心配置文件
MyBatis 的核心配置文件是 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/mydatabase" />
<property name="username" value="root" />
<property name="password" value="password" />
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/example/mapper/UserMapper.xml" />
</mappers>
</configuration>
在 mybatis-config.xml
中,environments
元素定义了数据库连接信息,dataSource
元素配置了数据源,mappers
元素指定了 SQL 映射文件的位置。
MyBatis 通过 XML 文件来定义 SQL 映射。以下是一个简单的 SQL 映射文件 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="selectUserById" resultType="com.example.model.User">
SELECT * FROM users WHERE id = #{id}
</select>
<insert id="insertUser" parameterType="com.example.model.User">
INSERT INTO users (id, username, password) VALUES (#{id}, #{username}, #{password})
</insert>
<update id="updateUser" parameterType="com.example.model.User">
UPDATE users SET username=#{username}, password=#{password} WHERE id=#{id}
</update>
<delete id="deleteUserById" parameterType="int">
DELETE FROM users WHERE id = #{id}
</delete>
</mapper>
在上述 XML 文件中,<mapper>
元素定义了 SQL 映射文件的命名空间,<select>
、<insert>
、<update>
和 <delete>
元素定义了不同的 SQL 语句。
复杂查询示例
<select id="selectUsersByCondition" resultType="com.example.model.User">
SELECT * FROM users WHERE id = #{id} AND username = #{username}
</select>
使用SqlSession执行SQL
在 MyBatis 中,SqlSession
是执行 SQL 语句的核心接口。以下是一个简单的示例代码,演示如何使用 SqlSession
执行 SQL 语句:
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class MyBatisExample {
public static void main(String[] args) throws IOException {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> users = mapper.selectUsers();
for (User user : users) {
System.out.println(user);
}
}
}
}
在上述代码中,首先加载 MyBatis 的配置文件 mybatis-config.xml
,然后创建 SqlSessionFactory
,使用 SqlSessionFactory
创建 SqlSession
,并通过 SqlSession
获取到 UserMapper
接口的实现,并执行 SQL 语句。
复杂查询示例
List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.selectUsersByCondition", new User(1, "example", "password"));
结果集映射到Java对象
MyBatis 可以将数据库查询结果直接映射到 Java 对象。以下是一个简单的 Java 对象 User
的定义:
public class User {
private int id;
private String username;
private String password;
// 构造函数、getter 和 setter 方法
public User(int id, String username, String password) {
this.id = id;
this.username = username;
this.password = password;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", password='" + password + '\'' +
'}';
}
}
在上述代码中,User
类定义了 id
、username
和 password
属性,并提供了相应的构造函数、getter 和 setter 方法。
复杂对象映射示例
public class UserDetail {
private int id;
private String username;
private String password;
private String email;
// 构造函数、getter 和 setter 方法
public UserDetail(int id, String username, String password, String email) {
this.id = id;
this.username = username;
this.password = password;
this.email = email;
}
// getter 和 setter 方法
}
MyBatis动态SQL入门
if标签
if
标签用于条件判断。以下是一个示例,根据参数选择是否添加 WHERE
子句。
<select id="selectUserById" resultType="com.example.model.User">
SELECT * FROM users
<where>
<if test="id != null">
AND id = #{id}
</if>
<if test="username != null">
AND username = #{username}
</if>
</where>
</select>
在上述代码中,<where>
标签会自动处理 WHERE
关键字,<if>
标签用于条件判断。
示例代码
User user = new User();
user.setUsername("example");
List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.selectUserById", user);
choose标签
choose
标签用于多条件选择。以下是一个示例,根据参数选择不同的 WHERE
子句。
<select id="selectUserById" resultType="com.example.model.User">
SELECT * FROM users
<where>
<choose>
<when test="id != null">
AND id = #{id}
</when>
<when test="username != null">
AND username = #{username}
</when>
<otherwise>
AND 1 = 1
</otherwise>
</choose>
</where>
</select>
在上述代码中,<choose>
标签用于多条件选择,<when>
标签用于条件分支,<otherwise>
标签用于默认条件。
示例代码
User user = new User();
user.setId(1);
List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.selectUserById", user);
set和foreach标签
set
标签用于动态生成 UPDATE
语句中的 SET
子句。foreach
标签用于遍历集合或数组。
<update id="updateUserSelective" parameterType="com.example.model.User">
UPDATE users
<set>
<if test="username != null">
username = #{username},
</if>
<if test="password != null">
password = #{password},
</if>
</set>
WHERE id = #{id}
</update>
<insert id="insertUsers" parameterType="java.util.List">
INSERT INTO users (id, username, password)
VALUES
<foreach item="item" index="index" collection="list" separator=",">
(#{item.id}, #{item.username}, #{item.password})
</foreach>
</insert>
在上述代码中,<set>
标签会自动处理 SET
关键字,<foreach>
标签用于遍历集合或数组。
示例代码
User user = new User();
user.setUsername("newUsername");
user.setPassword("newPassword");
mapper.updateUserSelective(user);
List<User> users = new ArrayList<>();
users.add(new User(1, "user1", "password1"));
users.add(new User(2, "user2", "password2"));
mapper.insertUsers(users);
MyBatis与Spring集成
MyBatis-Spring环境搭建
MyBatis 与 Spring 的集成可以简化数据库操作。以下是集成步骤:
- 添加 MyBatis-Spring 依赖:
<dependency>
<groupId>org.mybatis.spring</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.6</version>
</dependency>
- 配置 MyBatis 和 Spring:
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>
<bean id="userMapper" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.example.mapper" />
</bean>
在上述配置中,SqlSessionFactoryBean
用于创建 SqlSessionFactory
,MapperScannerConfigurer
用于自动扫描并注册 Mapper 接口。
完整的 Spring 配置文件示例
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
<property name="driverClassName" value="com.mysql.cj.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/mydatabase" />
<property name="username" value="root" />
<property name="password" value="password" />
</bean>
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
</bean>
<bean id="userMapper" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.example.mapper" />
</bean>
</beans>
使用SqlSessionTemplate
SqlSessionTemplate
是 MyBatis-Spring 提供的一个用于执行 SQL 的模板类,可以简化数据库访问操作。以下是一个示例代码:
import org.mybatis.spring.SqlSessionTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class UserService {
@Autowired
private SqlSessionTemplate sqlSessionTemplate;
public List<User> getUsers() {
UserMapper mapper = sqlSessionTemplate.getMapper(UserMapper.class);
return mapper.selectUsers();
}
}
在上述代码中,SqlSessionTemplate
用于执行 SQL 语句,UserMapper
接口用于定义 SQL 映射。
复杂业务逻辑示例
public List<User> getUsersByCondition(String username) {
UserMapper mapper = sqlSessionTemplate.getMapper(UserMapper.class);
return mapper.selectUsersByCondition(username);
}
配置Mapper接口
MyBatis-Spring 通过 MapperScannerConfigurer
配置 Mapper 接口。以下是一个示例 Mapper 接口:
public interface UserMapper {
List<User> selectUsers();
User selectUserById(int id);
void insertUser(User user);
void updateUser(User user);
void deleteUser(int id);
}
在上述代码中,UserMapper
接口定义了多个 SQL 映射方法。
复杂Mapper接口示例
public interface UserDetailMapper {
UserDetail getUserDetailById(int id);
void insertUserDetail(UserDetail userDetail);
}
MyBatis常用标签解析
include标签
include
标签用于包含其他 SQL 映射文件中的 SQL 语句。以下是一个示例:
<sql id="userColumns">
id, username, password
</sql>
<select id="selectUsers" resultType="com.example.model.User">
SELECT
<include refid="userColumns"></include>
FROM users
</select>
在上述代码中,<sql>
标签定义了一个 SQL 片段,<include>
标签用于包含该 SQL 片段。
示例代码
List<User> users = sqlSession.selectList("com.example.mapper.UserMapper.selectUsers");
resultMap标签
resultMap
标签用于定义结果集的映射规则。以下是一个示例:
<resultMap id="userResultMap" type="com.example.model.User">
<id property="id" column="id" />
<result property="username" column="username" />
<result property="password" column="password" />
</resultMap>
<select id="selectUserById" resultMap="userResultMap">
SELECT * FROM users WHERE id = #{id}
</select>
在上述代码中,<resultMap>
标签定义了结果集的映射规则,<id>
和 <result>
标签用于指定字段的映射。
示例代码
User user = sqlSession.selectOne("com.example.mapper.UserMapper.selectUserById", 1);
cache标签
cache
标签用于配置缓存机制。以下是一个示例:
<cache type="org.apache.ibatis.builtin.cache.PerpetualCache" />
在上述代码中,<cache>
标签用于配置缓存类型。MyBatis 提供了多种缓存类型,可以根据需要进行配置。
示例代码
<cache type="org.apache.ibatis.builtin.cache.PerpetualCache" />
以上文章详细介绍了 MyBatis 的基础概念、环境搭建、基本使用方法、动态 SQL 的使用及 MyBatis 与 Spring 的集成,并提供了相应的示例代码。
共同學習,寫下你的評論
評論加載中...
作者其他優質文章