@Log(title="预约订单",businessType = BusinessType.INSERT)

### @Log 注解的使用方法及配置 在开发过程中，记录操作日志对于追踪系统行为和排查问题至关重要。`@Log` 注解用于简化日志记录的操作，在特定业务逻辑前后自动记录相关信息。 #### 日志注解的基础配置 为了使 `@Log` 注解生效，首先需要引入相应的 AOP（面向切面编程）框架支持。通常情况下，Spring Boot 应用程序可以通过集成 Spring AOP 或 AspectJ 来实现这一点。下面是一个简单的配置示例： ```xml <!-- pom.xml --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency> ``` 接着定义一个自定义的日志切面类来处理带有 `@Log` 注解的方法调用: ```java // LogAspect.java import org.aspectj.lang.annotation.Aspect; import org.aspectj.lang.annotation.Before; import org.slf4j.Logger; import org.slf4j.LoggerFactory; @Aspect public class LogAspect { private static final Logger logger = LoggerFactory.getLogger(LogAspect.class); @Before("@annotation(com.example.Log)") public void logMethodCall() { logger.info("Logging method call"); } } ``` 上述代码展示了如何创建一个名为 `LogAspect` 的切面类，并在其内部实现了对标注有 `com.example.Log` 注解的方法进行前置通知的功能[^1]。 #### 定义 @Log 注解及其属性 为了让开发者能够更加灵活地控制所要记录的信息，可以在定义 `@Log` 注解时为其添加一些必要的属性。例如，可以设置描述字段用来说明具体发生了什么类型的事件；还可以加入模块名称以便分类管理不同功能区的日志数据。 ```java // Log.java package com.example; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface Log { String description(); // 描述该次操作的内容 String module() default ""; // 所属模块，默认为空字符串表示全局适用 } ``` 此部分介绍了如何构建一个具有两个参数 (`description`, `module`) 的 `@Log` 自定义注解，其中 `description` 是必填项而 `module` 则允许为空值作为默认选项[^2]。 #### 实际应用场景中的应用——插入预约订单 当涉及到具体的业务流程如插入新的预约订单时，则可以根据实际需求给相应服务层接口上的方法加上 `@Log` 注解并填写合适的参数值。这有助于后续审计以及异常情况下的快速定位原因所在。 假设有一个负责处理新增加预订请求的服务类 `OrderService` 及其内的 `createReservation()` 方法，那么就可以像这样对其进行标记： ```java @Service public class OrderService { @Transactional(rollbackFor=Exception.class) @Log(description="用户提交新预约", module="ORDER_MANAGEMENT") public Reservation createReservation(/* 参数列表 */) throws Exception{ // 创建预约的具体逻辑... return reservation; } } ``` 这里不仅指明了当前动作属于哪个业务领域(`ORDER_MANAGEMENT`)，同时也清晰表达了正在发生的活动：“用户提交新预约”。每当这个函数被执行一次就会触发之前提到过的AOP机制从而完成自动化日志记录工作[^3]。