MyBatis 是一个优秀的持久层框架,它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。
环境搭建
1. Java环境
首先,确保你的电脑上安装了Java开发工具包(JDK)。MyBatis 需要 JDK 1.6 或更高版本。
- 下载 JDK:前往 Oracle官网下载适合你操作系统的 JDK 安装包。
- 安装 JDK:按照安装包的提示完成安装。
- 配置环境变量:将 JDK 的安装路径添加到系统的环境变量中。
2. Maven
MyBatis 通常与 Maven 一起使用,因为 Maven 可以帮助我们管理项目依赖。
- 下载 Maven:前往 Maven 官网下载适合你操作系统的 Maven 安装包。
- 安装 Maven:按照安装包的提示完成安装。
- 配置环境变量:将 Maven 的安装路径添加到系统的环境变量中。
3. 创建 Maven 项目
使用 Maven 命令行工具创建一个新的 Maven 项目。
mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-example -DarchetypeArtifactId=maven-archetype-quickstart
4. 添加 MyBatis 依赖
在项目的 pom.xml 文件中添加 MyBatis 的依赖。
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
</dependencies>
数据库配置
接下来,我们需要配置数据库连接信息。
1. 配置文件
创建一个名为 db.properties 的配置文件,并添加以下内容:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false
jdbc.username=root
jdbc.password=root
2. 读取配置文件
在 applicationContext.xml 配置文件中读取数据库连接信息。
<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.apache.commons.dbcp.BasicDataSource">
<property name="driverClassName" value="${jdbc.driver}" />
<property name="url" value="${jdbc.url}" />
<property name="username" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
</bean>
</beans>
创建实体类
创建一个实体类 User,对应数据库中的 users 表。
public class User {
private Integer id;
private String username;
private String email;
// 省略 getter 和 setter 方法
}
创建 Mapper 接口
创建一个 Mapper 接口 UserMapper,定义所需的方法。
public interface UserMapper {
List<User> findAll();
User findById(Integer id);
void save(User user);
void update(User user);
void delete(Integer id);
}
创建 Mapper XML
创建一个 UserMapper.xml 文件,配置 SQL 语句。
<mapper namespace="com.example.mapper.UserMapper">
<select id="findAll" resultType="User">
SELECT * FROM users
</select>
<select id="findById" parameterType="Integer" resultType="User">
SELECT * FROM users WHERE id = #{id}
</select>
<insert id="save" parameterType="User">
INSERT INTO users (username, email) VALUES (#{username}, #{email})
</insert>
<update id="update" parameterType="User">
UPDATE users SET username = #{username}, email = #{email} WHERE id = #{id}
</update>
<delete id="delete" parameterType="Integer">
DELETE FROM users WHERE id = #{id}
</delete>
</mapper>
配置 MyBatis
在 applicationContext.xml 配置文件中配置 MyBatis。
<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="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<property name="mapperLocations" value="classpath*:com/example/mapper/*.xml" />
</bean>
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.example.mapper" />
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
</bean>
</beans>
使用 MyBatis
现在,你可以在你的业务层代码中注入 UserMapper 并使用它。
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public List<User> findAll() {
return userMapper.findAll();
}
public User findById(Integer id) {
return userMapper.findById(id);
}
public void save(User user) {
userMapper.save(user);
}
public void update(User user) {
userMapper.update(user);
}
public void delete(Integer id) {
userMapper.delete(id);
}
}
总结
通过以上步骤,你就可以开始使用 MyBatis 进行持久层开发了。MyBatis 的强大之处在于它将数据库操作与 Java 代码分离,使你的业务层代码更加简洁易懂。随着你不断深入使用 MyBatis,你将发现它的更多优点。祝你在 MyBatis 的学习道路上越走越远!
