@Service
public class DeptServiceImpl implements DeptService {
    @Autowired private DeptMapper deptMapper;
    @Autowired private EmpMapper empMapper;

    @Override
    @Transactional   // 开启事务管理
    public void delete(Integer id) {
        deptMapper.deleteById(id);   // 删除部门

        int i = 1/0;                  // 异常 → 触发回滚

        empMapper.deleteByDeptId(id); // 删除该部门下员工
    }
}

// 默认：只回滚 RuntimeException
@Transactional
public void method() throws Exception { ... }

// 推荐：所有异常都回滚
@Transactional(rollbackFor = Exception.class)
public void method() throws Exception { ... }

@Service
public class DeptLogServiceImpl implements DeptLogService {

    // 不论外层是否有事务都新建事务（独立运行）
    // 即使外层事务回滚，本方法已提交的事务也不会被回滚
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    @Override
    public void insert(DeptLog deptLog) {
        deptLogMapper.insert(deptLog);
    }
}

@Component
@Aspect    // ⚠️ 切面类必须加这个注解
@Slf4j
public class TimeAspect {
    // 切入点表达式：service 包下所有类的所有方法
    @Around("execution(* com.kge.service.*.*(..))")
    public Object recordTime(ProceedingJoinPoint pjp) throws Throwable {
        long begin = System.currentTimeMillis();    // 记录开始时间

        Object result = pjp.proceed();              // ⚠️ 执行原始方法（必须）

        long end = System.currentTimeMillis();      // 记录结束时间
        log.info(pjp.getSignature() + " 执行耗时: {}ms", end - begin);

        return result;
    }
}

@Slf4j
@Component
@Aspect
public class MyAspect {

    // ① 抽取公共切入点表达式（避免重复）
    @Pointcut("execution(* com.kge.service.*.*(..))")
    private void pt() {}

    @Before("pt()")
    public void before(JoinPoint jp) {
        log.info("before ...");
    }

    @Around("pt()")
    public Object around(ProceedingJoinPoint pjp) throws Throwable {
        log.info("around before ...");
        Object result = pjp.proceed();      // ⚠️ 必须调用，否则原方法不执行
        log.info("around after ...");
        return result;                       // ⚠️ 返回值必须为 Object 接收原方法返回值
    }

    @After("pt()")
    public void after(JoinPoint jp) {
        log.info("after ...");
    }

    @AfterReturning("pt()")
    public void afterReturning(JoinPoint jp) {
        log.info("afterReturning ...");
    }

    @AfterThrowing("pt()")
    public void afterThrowing(JoinPoint jp) {
        log.info("afterThrowing ...");
    }
}

@Slf4j @Component @Aspect
@Order(1)   // 数字越小，前置越先执行；后置越后执行
public class MyAspect4 { ... }

// 完整写法（明确指定方法）
execution(void com.kge.service.impl.DeptServiceImpl.delete(java.lang.Integer))

// 用 * 代替返回值
execution(* com.kge.service.impl.DeptServiceImpl.delete(java.lang.Integer))

// 用 * 代替包名（一层一个 *）
execution(* com.kge.*.*.DeptServiceImpl.delete(java.lang.Integer))

// 用 .. 省略包名
execution(* com..DeptServiceImpl.delete(java.lang.Integer))

// 用 * 代替类名 + 方法名
execution(* com..*.delete(java.lang.Integer))

// 用 .. 任意参数
execution(* com..*.*(..))

// 匹配以 find 开头的方法
execution(* com.kge.service.impl.DeptServiceImpl.find*(..))

// 组合（&& || !）
execution(* com.kge.service.DeptService.list(..)) || execution(* com.kge.service.DeptService.delete(..))

// 1. 自定义注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {}

// 2. 业务方法上加注解
@Service
public class DeptServiceImpl {
    @MyLog  // 标记为目标方法
    public List<Dept> list() { ... }

    @MyLog
    public void delete(Integer id) { ... }
}

// 3. 切面类用 @annotation 匹配
@Aspect
@Component
public class MyAspect {
    @Before("@annotation(com.kge.anno.MyLog)")
    public void before() { ... }
}

@Around("@annotation(com.kge.anno.MyLog)")
public Object around(ProceedingJoinPoint pjp) throws Throwable {
    String className  = pjp.getTarget().getClass().getName();   // 目标类名
    String methodName = pjp.getSignature().getName();           // 方法名
    Object[] args     = pjp.getArgs();                          // 方法参数

    Object result = pjp.proceed();                              // 执行原方法

    return result;
}

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Log {}

@Service
public class EmpServiceImpl implements EmpService {

    @Override @Log
    public void save(Emp emp) { ... }

    @Override @Log
    public void update(Emp emp) { ... }

    @Override @Log
    public void delete(List<Integer> ids) { ... }
}

@Slf4j
@Component
@Aspect
public class LogAspect {

    @Autowired private HttpServletRequest request;
    @Autowired private OperateLogMapper operateLogMapper;

    @Around("@annotation(com.kge.anno.Log)")
    public Object recordLog(ProceedingJoinPoint jp) throws Throwable {
        // ① 操作人：从请求头解析 JWT
        String jwt = request.getHeader("token");
        Claims claims = JwtUtils.parseJWT(jwt);
        Integer operateUser = (Integer) claims.get("id");

        // ② 操作元信息
        String className  = jp.getTarget().getClass().getName();
        String methodName = jp.getSignature().getName();
        String methodParams = Arrays.toString(jp.getArgs());

        // ③ 执行原方法 + 计算耗时
        long begin = System.currentTimeMillis();
        Object result = jp.proceed();
        long costTime = System.currentTimeMillis() - begin;

        // ④ 记录日志到数据库
        OperateLog logRecord = new OperateLog(null, operateUser, LocalDateTime.now(),
                className, methodName, methodParams,
                JSONObject.toJSONString(result), costTime);
        operateLogMapper.insert(logRecord);

        return result;
    }
}

@RestController
@RequestMapping("/depts")   // 类上统一前缀
public class DeptController {

    @Autowired private DeptService deptService;

    // 查询
    @GetMapping
    public Result list() {
        return Result.success(deptService.list());
    }

    // 新增（@RequestBody 接收 JSON）
    @PostMapping
    public Result save(@RequestBody Dept dept) {
        deptService.save(dept);
        return Result.success();
    }

    // 删除（@PathVariable 接收路径参数）
    @DeleteMapping("/{id}")
    public Result delete(@PathVariable Integer id) {
        deptService.delete(id);
        return Result.success();
    }
}

@Data @NoArgsConstructor @AllArgsConstructor
public class PageBean<T> {
    private Long total;     // 总记录数
    private List<T> rows;   // 当前页数据
}

@Service
public class EmpServiceImpl implements EmpService {
    @Autowired private EmpMapper empMapper;

    @Override
    public PageBean page(Integer page, Integer pageSize, String name,
                         Short gender, LocalDate begin, LocalDate end) {

        // ① 设置分页参数（页码 + 每页条数）
        PageHelper.startPage(page, pageSize);

        // ② 执行普通查询（PageHelper 自动添加 LIMIT）
        List<Emp> empList = empMapper.list(name, gender, begin, end);

        // ③ 强转为 Page 类型，获取分页结果
        Page<Emp> p = (Page<Emp>) empList;
        return new PageBean(p.getTotal(), p.getResult());
    }
}

@RestController
@RequestMapping("/emps")
public class EmpController {

    @Autowired private EmpService empService;

    @GetMapping  // GET /emps?page=1&pageSize=10&name=张&gender=1&begin=2010-01-01
    public Result page(
        @RequestParam(defaultValue = "1")  Integer page,
        @RequestParam(defaultValue = "10") Integer pageSize,
        String name, Short gender,
        @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,
        @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end) {

        PageBean pb = empService.page(page, pageSize, name, gender, begin, end);
        return Result.success(pb);
    }
}

// Controller：路径参数 1,2,3 自动封装为 List<Integer>
@DeleteMapping("/{ids}")
public Result delete(@PathVariable List<Integer> ids) {
    empService.delete(ids);
    return Result.success();
}

Dept dept = new Dept();
BeanUtils.copyProperties(deptDto, dept);   // DTO → 实体（属性名一致才拷贝）
dept.setCreateTime(LocalDateTime.now());   // 补充 DTO 没有的字段