好的，我们来一步步手写两个非常实用的自定义注解 + 反射实现：
- @LogExecution：方法执行前后自动打印日志（入参 + 返回值 + 耗时）
- @NotBlankParam：方法参数非空/非空白校验（类似 @NotBlank 但作用于方法参数，且用纯反射实现，不依赖 Spring/Hibernate Validator）
我们先用最原始的反射方式实现（不依赖 AOP / Spring），适合理解原理、工具类、测试框架、轻量 SDK 等场景。然后简单提一下如何升级到 Spring AOP 方式。
第一部分：@LogExecution 日志注解（反射实现）
1. 定义注解
importjava.lang.annotation.*;@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic@interfaceLogExecution{Stringvalue()default"";// 可自定义日志前缀booleanlogArgs()defaulttrue;// 是否打印入参booleanlogResult()defaulttrue;// 是否打印返回值booleanlogTime()defaulttrue;// 是否打印耗时}2. 反射工具类（核心调用逻辑）
importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importjava.lang.reflect.Method;importjava.util.Arrays;publicclassLogExecutionUtil{privatestaticfinalLoggerlog=LoggerFactory.getLogger(LogExecutionUtil.class);/** * 包装执行目标方法，自动加日志 */publicstaticObjectinvokeWithLogging(Objecttarget,Methodmethod,Object[]args)throwsThrowable{LogExecutionanno=method.getAnnotation(LogExecution.class);if(anno==null){// 没有注解 → 直接执行returnmethod.invoke(target,args);}Stringprefix=anno.value().isEmpty()?method.getName():anno.value();StringBuilderlogPrefix=newStringBuilder("[").append(prefix).append("] ");// 打印入参if(anno.logArgs()){StringargsStr=args==null?"null":Arrays.toString(args);log.info("{}开始执行 → 参数: {}",logPrefix,argsStr);}longstart=System.nanoTime();try{Objectresult=method.invoke(target,args);// 打印返回值if(anno.logResult()){log.info("{}执行完成 → 返回: {}",logPrefix,result);}// 打印耗时if(anno.logTime()){doublems=(System.nanoTime()-start)/1_000_000.0;log.info("{}耗时: {} ms",logPrefix,String.format("%.3f",ms));}returnresult;}catch(Throwablee){log.error("{}执行异常",logPrefix,e);throwe;}}}3. 使用示例
publicclassUserService{@LogExecution(value="创建用户",logArgs=true,logResult=true,logTime=true)publicUsercreateUser(Stringusername,intage){if(age<0)thrownewIllegalArgumentException("年龄不能为负");returnnewUser(username,age);}@LogExecution("批量删除")// 使用默认值publicvoidbatchDelete(List<Long>ids){System.out.println("删除 "+ids.size()+" 条记录");}}4. 如何调用（代理 / 手动包装）
最简单的方式：写一个代理类或在调用处手动用invokeWithLogging：
// 手动调用方式UserServiceservice=newUserService();Methodmethod=UserService.class.getMethod("createUser",String.class,int.class);LogExecutionUtil.invokeWithLogging(service,method,newObject[]{"alice",25});更常见的是结合动态代理（JDK Proxy / ByteBuddy / CGLIB）使用。
第二部分：@NotBlankParam 参数非空校验（反射实现）
1. 定义注解（可重复）
importjava.lang.annotation.*;@Repeatable(NotBlankParams.class)@Target(ElementType.PARAMETER)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic@interfaceNotBlankParam{intindex()default-1;// 参数下标（从0开始），-1表示自动推断（推荐）Stringmessage()default"参数不能为空且不能为纯空白";}@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceNotBlankParams{NotBlankParam[]value();}2. 校验工具类
importjava.lang.reflect.Method;importjava.lang.reflect.Parameter;importjava.util.Objects;publicclassParamValidator{publicstaticvoidvalidateParams(Objecttarget,Methodmethod,Object[]args){Parameter[]parameters=method.getParameters();Annotation[][]paramAnnos=method.getParameterAnnotations();for(inti=0;i<parameters.length;i++){for(Annotationanno:paramAnnos[i]){if(annoinstanceofNotBlankParam){NotBlankParamnotBlank=(NotBlankParam)anno;intidx=notBlank.index()>=0?notBlank.index():i;if(idx>=args.length){thrownewIllegalArgumentException("注解 index 越界");}Objectvalue=args[idx];if(value==null||(valueinstanceofString&&((String)value).trim().isEmpty())){thrownewIllegalArgumentException(notBlank.message()+" (参数位置: "+idx+")");}}}}}}3. 使用示例
publicclassOrderService{publicvoidcreateOrder(@NotBlankParamStringorderNo,@NotBlankParam(message="收货人姓名必填")StringreceiverName,Stringremark){// remark 不校验System.out.println("创建订单："+orderNo);}}4. 调用方式（同样结合代理）
// 在方法执行前先校验ParamValidator.validateParams(target,method,args);// 再执行方法method.invoke(target,args);第三部分：升级方案（生产级常用方式）
| 场景 | 推荐方式 | 优点 | 实现复杂度 |
|---|---|---|---|
| 学习/理解原理 | 纯反射 + 手动代理 | 最清晰，理解最透彻 | ★★★☆☆ |
| 轻量工具类/SDK | JDK动态代理 / ByteBuddy | 无 Spring 依赖，体积小 | ★★★★☆ |
| Spring Boot 项目 | Spring AOP + @Aspect | 零侵入、最优雅 | ★★☆☆☆ |
| 高性能场景 | Annotation Processor + APT / 字节码生成 | 编译期生成代码，无反射开销 | ★★★★★ |
Spring AOP 快速示例（@LogExecution）
@Aspect@ComponentpublicclassLogExecutionAspect{@Around("@annotation(logAnno)")publicObjectaround(ProceedingJoinPointjoinPoint,LogExecutionlogAnno)throwsThrowable{// 前置日志、入参// proceed()// 后置日志、耗时、返回值}}小结 & 进阶方向
- 学会了@Retention(RUNTIME)+反射读取注解的基本套路
- 掌握了方法参数注解的获取方式（
method.getParameterAnnotations()） - 明白了自定义注解 + 反射的两种主要用途：日志追踪与参数/返回值校验
- 能自己写出简易的方法切面工具（不依赖框架）
接下来想深入哪个方向？
A. 写一个完整的JDK动态代理包装器（自动扫描 @LogExecution / @NotBlankParam）
B. 实现Spring AOP版本（AspectJ风格）
C. 做参数校验的支持分组 / 支持自定义消息国际化
D. 用Annotation Processor在编译期校验注解使用是否合法
E. 结合@Around做更复杂的场景（事务 + 日志 + 校验 一条龙）
告诉我字母，我继续带你写代码！
