Spring Cloud 与 Spring Cloud Alibaba微服务开发流程详解：解耦之道
Spring Cloud 与 Spring Cloud Alibaba 微服务开发流程详解：解耦之道
前言
在当今数字化转型加速推进的背景下，企业应用架构正经历着从单体架构向微服务架构的重大转变。微服务架构通过将应用拆分成多个小型、独立的服务，每个服务专注于特定的业务功能，实现了系统的高可扩展性、灵活性和维护性。而Spring Cloud与Spring Cloud Alibaba作为微服务架构领域的杰出框架，为开发者提供了强大的工具和便捷的开发体验，助力企业高效构建基于微服务的应用系统。
本篇文章将深入剖析利用Spring Cloud与Spring Cloud Alibaba进行微服务开发的流程，重点探讨如何通过合理的架构设计和开发实践实现系统各模块间的解耦。我们将从项目的整体架构规划入手，逐步深入到各个关键层次的开发细节，包括API层、Biz层等在微服务架构中的角色与实现方式。同时，还会结合实际开发场景，分享如何有效管理项目中的target文件夹，以确保项目的整洁性和可维护性。无论是正在探索微服务架构的技术团队，还是希望提升开发技能的个人开发者，本文都将为您提供有价值的参考和指导，助您在微服务开发的道路上更加得心应手。
开发顺序复盘
api层就是对外的交互
在微服务架构中，api 层通常作为对外的交互接口，定义了服务间通信的契约和数据模型。以下是图片中 api 层各部分在开发中的作用：
1. api 包
- 作用：定义服务的接口和数据模型，供其他模块或服务调用。
- 详细说明：
2. enums 包
- 作用：定义枚举类型，用于表示固定的、有限的值集合。
- 详细说明：
public enum OrderStatusEnum {
// 订单状态枚举
WAIT_PAY("待支付"),
PAID("已支付"),
DELIVERED("已出票"),
CLOSED("已关闭");
private String description;
OrderStatusEnum(String description) {
this.description = description;
}
public String getDescription() {
return description;
}
}
3. common 包
- 作用：存放公共的工具类、常量类等，供整个项目或多个模块使用。
- 详细说明：
public class DictTypeConstants {
// 字典类型常量
public static final String TICKET_TYPE = "ticket_type";
public static final String ORDER_STATUS = "order_status";
}
public class ErrorCodeConstants {
// 错误码常量
public static final int SUCCESS = 200;
public static final int PARAM_ERROR = 400;
public static final int SERVER_ERROR = 500;
}
public class LogRecordConstants {
// 日志记录常量
public static final String LOGIN_LOG = "login_log";
public static final String OPERATION_LOG = "operation_log";
}
4. package-info.java
- 作用：提供包的信息，如包的描述、版本等。
- 详细说明：
/** * 包描述：门票模块的 API 层，定义了服务的接口和数据模型。 */ package cn.iocoder.central.module.ticket.api;
开发中的作用总结
- 统一接口定义：
api层通过定义统一的接口和数据模型，使得不同模块之间的交互更加规范和高效。 - 枚举类型规范化：
enums包中的枚举类型，为业务相关的固定值提供了规范化的表示，避免了使用魔法值带来的问题。 - 公共常量共享：
common包中的常量类，供整个项目或多个模块使用，确保了常量的统一性和一致性。 - 包信息清晰化：
package-info.java文件对包进行描述，有助于开发人员快速了解包的相关信息，提高开发和维护的效率。
通过以上结构和内容，api 层在开发中起到了规范交互、统一数据模型、共享公共常量等重要作用，为整个系统的稳定性和可维护性提供了保障。
biz层
在微服务架构中，biz 层通常是指业务逻辑层，负责处理具体的业务逻辑和数据操作。以下是图片中 biz 层各部分在开发中的作用：
1. controller 包
- 作用：处理客户端的 HTTP 请求，提供 RESTful API 接口。
- 详细说明：
@RestController
@RequestMapping("/ticket-order-info")
public class TicketOrderInfoController {
@Autowired
private TicketOrderInfoService ticketOrderInfoService;
@PostMapping("/save")
public ResponseEntity<TicketOrderInfoRespVO> saveTicketOrderInfo(@RequestBody TicketOrderInfoSaveReqVO reqVO) {
return ResponseEntity.ok(ticketOrderInfoService.saveTicketOrderInfo(reqVO));
}
}
2. dal 包
- 作用：数据访问层，负责与数据库进行交互，执行数据的增删改查操作。
- 详细说明：
@Mapper
public interface TicketOrderInfoMapper {
int deleteByPrimaryKey(Long id);
int insert(TicketOrderInfoDO record);
TicketOrderInfoDO selectByPrimaryKey(Long id);
int updateByPrimaryKeySelective(TicketOrderInfoDO record);
int updateByPrimaryKey(TicketOrderInfoDO record);
}
3. package-info.java
- 作用：提供包的信息，如包的描述、版本等。
- 详细说明：
/** * 包描述：门票模块的业务逻辑层，处理具体的业务逻辑和数据操作。 */ package cn.iocoder.central.module.ticket.biz;
开发中的作用总结
- 处理 HTTP 请求：
controller包中的控制器类负责处理客户端的 HTTP 请求，提供 RESTful API 接口，是客户端与服务器端交互的入口。 - 封装请求和响应数据：
vo包中的视图对象类用于封装请求和响应的数据，确保数据的完整性和一致性。 - 处理 Excel 文件操作：
excel包中的 VO 类专门用于处理 Excel 文件的导入和导出，方便与客户端进行 Excel 格式的数据交换。 - 数据访问操作：
dal包中的数据对象类和 Mapper 接口负责与数据库进行交互，执行数据的增删改查操作，是业务逻辑层与数据层之间的桥梁。 - 包信息清晰化：
package-info.java文件对包进行描述，有助于开发人员快速了解包的相关信息，提高开发和维护的效率。
通过以上结构和内容，biz 层在开发中起到了处理业务逻辑、封装数据、与数据库交互等重要作用，是整个微服务架构中的核心部分。
biz层中详细每个分层的分析
1. 框架层（Framework Layer）
- 功能与技术点配置：作为整个系统的基础，需先搭建好 Spring Security、Feign、JWT 等配置，为系统提供安全和通信支持。
- 联动方式实现：通过过滤器或拦截器检查请求中的认证信息，确保请求的合法性和安全性。
2. 数据访问层（Data Access Layer - DAL）
- 功能与技术点实现：负责数据存储与访问，包含 DataObject、MySQL 和 Redis 三部分。
- 联动方式实现：通过 MyBatis Plus 的 Mapper 接口与 MySQL 数据库交互，执行 SQL 语句完成数据操作。对于 Redis 缓存操作，使用 RedisTemplate 进行数据的存取和过期设置。在数据查询时，优先从 Redis 缓存中获取数据，若缓存不存在则查询 MySQL 数据库，并将查询结果缓存到 Redis 中。
3. 服务层（Service Layer）
- 功能与技术点实现：作为业务逻辑核心，处理票务信息的增删改查。
- 联动方式实现：通过依赖注入调用 DAL 层的 DAO 方法进行数据操作。当涉及多个服务的协作时，通过 Feign 客户端调用其他服务的 API，Nacos 实现服务发现和负载均衡。对于需要缓存的数据，服务层会先调用 Redis 相关操作从缓存中获取数据，若缓存失效则再调用 MySQL 相关操作从数据库中查询数据并更新缓存。
4. 控制层（Controller Layer）
- 功能与技术点实现：处理客户端的 HTTP 请求，尤其针对管理员操作和 Excel 文件相关视图对象（VO）。
- 联动方式实现：通过依赖注入（@Autowired）调用服务层的业务逻辑方法。例如，当处理一个门票订单信息的查询请求时，控制器方法会调用服务层的查询业务逻辑方法，获取数据后将其转换为 Excel 格式返回给客户端。
5. 映射层（Mapper Layer）
- 功能与技术点实现：存放 MyBatis 的映射文件，定义 SQL 语句与 Java 方法的映射关系，实现数据库操作结果与 Java 对象的相互转换。
- 联动方式实现：映射层的 Mapper 接口与 DAL 层的 DAO 类进行交互。DAO 类通过注入 Mapper 接口来执行 SQL 语句，完成数据的持久化操作或数据查询。MyBatis 会根据映射文件或注解中的配置，将 Java 对象转换为数据库操作所需的参数，或者将数据库查询结果映射为 Java 对象返回给 DAL 层。
通过以上分层架构设计，各层之间通过依赖注入、接口调用、配置文件等方式实现松耦合的联动，共同构建了一个高可用、安全、可扩展且性能优化的门票微服务系统。
项目中的target是什么
在软件开发项目中，target 文件夹通常是用于存放构建工具（如 Maven、Gradle 等）生成的构建输出文件的目录。以下是 target 文件夹在项目中的作用和内容的详细说明：
1. 构建输出目录
- 作用：
target文件夹是 Maven 项目的默认构建输出目录，用于存放构建过程中生成的各类文件。 - 详细说明：
2. 目录结构
classes目录：存放编译后的类文件和资源文件。test-classes目录：存放测试编译后的类文件和资源文件。surefire-reports目录：存放测试运行后的报告文件。generated-sources目录：存放构建过程中生成的源代码文件，如注解处理器生成的代码。
3. 构建工具的作用
- Maven：Maven 是一个流行的构建工具，它使用
pom.xml文件定义项目的依赖、插件和构建配置。在构建过程中，Maven 会将编译后的文件输出到target文件夹中。 - Gradle：Gradle 是另一个常用的构建工具，它使用
build.gradle文件进行配置，同样会将构建输出放在target文件夹中。
4. 版本控制
- 作用：
target文件夹通常被添加到版本控制的忽略列表中（如.gitignore），因为其中的内容是自动生成的，不需要纳入版本控制。 - 原因：
5. 清理构建
- 作用：在开发过程中，有时需要清理
target文件夹中的内容，以确保构建的干净性和一致性。 - 命令：
6. 实际开发中的注意事项
- 不要手动修改：
target文件夹中的内容是自动生成的，通常不需要手动修改。 - 构建配置：确保项目的构建配置（如
pom.xml或build.gradle）正确，以避免构建过程中出现问题。 - 依赖管理：正确管理项目的依赖，确保所有需要的库都正确配置并下载到本地。
通过以上说明，可以清楚地了解 target 文件夹在项目中的作用和重要性，以及在开发过程中如何正确使用和管理它。
查看15道真题和解析
美团一面2074人在聊