Spring Boot 集成MyBatis简单教程

### Spring Boot集成MyBatis简单教程 #### 一、引言 随着微服务架构的兴起，Spring Boot作为Java领域中最热门的技术之一，以其简洁、快速的特性被广泛应用于企业级应用开发。MyBatis作为一款优秀的持久层框架，能够简化JDBC的操作，提供SQL语句的映射和管理功能。本教程将详细介绍如何在Spring Boot项目中集成MyBatis，包括项目搭建、实体类定义、服务层实现以及数据库配置等关键步骤。 #### 二、项目搭建 ##### 2.1 创建Spring Boot项目 1. **打开IDEA**：启动IntelliJ IDEA或其他支持Spring Boot的IDE。 2. **新建项目**：通过`File —— New —— Project`创建一个新的Spring Boot项目。 3. **使用Spring Initializr**：选择Spring Initializr作为项目的初始化工具。 4. **填写项目信息**： - **Group**：通常为公司域名倒序，例如`com.example`。 - **Artifact**：项目名，例如`spring-boot-mybatis-tutorial`。 - **Name**：项目展示名称，可与Artifact相同。 - **Description**：项目描述，例如“Spring Boot集成MyBatis示例”。 - **Packaging**：选择`jar`或`war`，这里选择`jar`。 - **Java**：选择项目使用的Java版本。 - **Dependencies**：添加依赖项，勾选`Web`、`JPA`、`MySQL Driver`、`MyBatis`等。 5. **项目创建**：确认信息无误后点击完成，IDEA将自动下载并构建项目。 ##### 2.2 定义实体类（POJO） 在`entity`包下创建实体类`Blog`： ```java public class Blog { private Integer bid; // 文章ID private String name; // 文章标题 private String authorId; // 文章作者ID // Getter和Setter方法 public Integer getBid() { return bid; } public void setBid(Integer bid) { this.bid = bid; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getAuthorId() { return authorId; } public void setAuthorId(String authorId) { this.authorId = authorId; } @Override public String toString() { return "Blog{" + "bid=" + bid + ", name='" + name + '\'' + ", authorId='" + authorId + '\'' + '}'; } } ``` #### 三、控制器实现 在`controller`包下创建`BlogController`类： ```java @RestController @EnableAutoConfiguration @RequestMapping("/blog") public class BlogController { @Autowired private BlogService blogService; @GetMapping("list") public Blog getBlog() { return blogService.getBlogById(1); } } ``` #### 四、服务层接口及实现 1. **创建服务接口**： ```java public interface BlogService { Blog getBlogById(int bid); int addBlog(Blog blog); } ``` 2. **实现类**： ```java @Component public class BlogServiceImpl implements BlogService { @Autowired private BlogMapper blogMapper; @Override public Blog getBlogById(int bid) { return blogMapper.selectByPrimaryKey(bid); } @Override public int addBlog(Blog blog) { // 实现新增博客的方法 return 0; } } ``` #### 五、数据库配置 在`application.yml`中进行数据库配置： ```yaml spring: profiles: active: dev mybatis: typeAliasesPackage: com.example.entity mapperLocations: classpath:mapper/*.xml --- spring: profiles: dev datasource: url: jdbc:mysql://localhost:3306/test?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver ``` #### 六、MyBatis映射文件 1. **创建映射文件**：在`resources/mapper`目录下创建`BlogMapper.xml`文件。 2. **编写SQL映射**： ```xml <mapper namespace="com.example.mapper.BlogMapper"> <select id="selectByPrimaryKey" resultType="com.example.entity.Blog"> SELECT * FROM blogs WHERE bid = #{bid} </select> <insert id="insert" parameterType="com.example.entity.Blog"> INSERT INTO blogs (name, author_id) VALUES (#{name}, #{authorId}) </insert> </mapper> ``` #### 七、运行与测试 1. **启动项目**：运行`Application`类启动Spring Boot应用。 2. **访问接口**：通过浏览器或Postman等工具访问`http://localhost:8080/blog/list`，查看返回结果。 #### 八、总结 通过以上步骤，我们成功地在Spring Boot项目中集成了MyBatis，并实现了基本的CRUD操作。这种集成方式不仅提高了开发效率，还使得代码更加清晰易读。对于初学者来说，这是一个很好的实践案例，有助于更好地理解Spring Boot和MyBatis的工作原理及其在实际项目中的应用。