Spring Boot 数据访问与数据库集成实战
在构建企业级应用时，数据持久化是核心环节。Spring Boot 通过自动配置和多种 ORM 框架支持，极大地简化了数据库集成的复杂度。本文将深入探讨如何在实际项目中高效地处理数据访问，涵盖 JPA、MyBatis 以及事务管理的最佳实践。
核心组件概览
Spring Boot 提供了丰富的数据访问抽象，开发者可根据项目需求选择最合适的方案：
- JdbcTemplate：适合需要精细控制 SQL 的场景，轻量且灵活。
- Spring Data JPA：基于 Hibernate，通过接口约定自动生成 CRUD 逻辑，开发效率极高。
- MyBatis：允许手写 SQL，适合复杂查询或对性能有极致要求的场景。
集成 MySQL 与 JPA
这是目前最主流的组合。首先需要在 pom.xml 中引入必要的依赖。除了 Web 启动器，我们还需要 Data JPA 的 Starter 和 MySQL 驱动。
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
接下来配置数据源。在 application.properties 中指定连接信息，并开启 Hibernate 的 DDL 自动更新模式，这在开发阶段能省去手动建表的麻烦。
server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=UTC
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=123456
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
定义实体类时，使用 @Entity 和 @Table 映射表结构。注意字段类型要与数据库保持一致，主键通常使用自增策略。
import javax.persistence.*;
@Entity
@Table(name = "product")
public class Product {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String productId;
private String productName;
private double price;
private int sales;
// 省略 Getter/Setter 方法
}
Repository 接口继承 JpaRepository 即可自动获得基础 CRUD 能力。如果需要自定义查询，只需遵循命名规范或添加 @Query 注解。
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;
public interface ProductRepository extends JpaRepository<Product, Long> {
List<Product> findBySalesGreaterThan(int sales);
}
开发测试：H2 数据库
H2 内存数据库非常适合单元测试和快速原型开发。它无需安装，配置简单，但切记不要在生产环境使用。
依赖方面，将 MySQL 驱动替换为 H2 驱动，并将作用域设为 runtime 以避免打包进生产包。
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<scope>runtime</scope>
</dependency>
配置 URL 指向内存数据库，并开启控制台以便调试。
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
实体类和 Repository 代码无需修改，这体现了 Spring Boot 屏蔽底层差异的能力。
灵活配置：MyBatis 集成
当 JPA 的自动 SQL 生成无法满足复杂业务需求时，MyBatis 是更好的选择。它允许开发者完全掌控 SQL 语句。
引入 MyBatis Starter 后，需要在配置文件中指定 Mapper XML 文件的位置和别名包路径。
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.demo.entity
Mapper 接口需添加 @Mapper 注解，XML 文件中定义具体的 SQL 映射关系。相比 JPA，这里需要显式编写 resultMap 来映射列名和属性名。
<mapper namespace="com.example.demo.mapper.ProductMapper">
<select id="findAll" resultType="Product">SELECT * FROM product</select>
<insert id="insert" parameterType="Product">INSERT INTO product (...) VALUES (...)</insert>
</mapper>
事务管理关键
在涉及多步数据库操作时，事务一致性至关重要。Spring Boot 通过 @Transactional 注解轻松实现声明式事务。
建议将事务注解放在 Service 层的方法上，而不是 Controller 层。对于只读查询，设置 readOnly = true 可以优化性能。
import org.springframework.transaction.annotation.Transactional;
@Service
public class ProductService {
@Autowired
private ProductRepository repository;
@Transactional
public void addProduct(Product product) {
repository.save(product);
}
@Transactional(readOnly = true)
public List<Product> getAllProducts() {
return repository.findAll();
}
}
综合案例：商品服务
最后，我们将上述组件串联起来，构建一个完整的商品管理接口。Controller 负责接收请求，Service 处理业务逻辑和事务，Repository 负责数据存取。
@RestController
@RequestMapping("/api/products")
public class ProductController {
@Autowired
private ProductService productService;
@GetMapping("/")
public List<Product> getAllProducts() {
return productService.getAllProducts();
}
@PostMapping("/")
public void addProduct(@RequestBody Product product) {
productService.addProduct(product);
}
}
启动应用后，可以通过 Postman 或浏览器测试接口。例如，调用 /api/products/top-selling?topN=3 即可获取销量最高的商品列表。这种分层架构不仅清晰易维护，也为后续扩展微服务打下了坚实基础。
在实际开发中，根据团队技术栈和项目复杂度选择合适的持久化方案是关键。无论是追求开发速度的 JPA，还是追求灵活性的 MyBatis，Spring Boot 都能提供强大的支持。
