大数跨境
0
0

Spring项目别再乱注入Service了!用Lambda封装个统一调用组件,直接起飞!

Spring项目别再乱注入Service了!用Lambda封装个统一调用组件,直接起飞! macrozheng
2025-12-09
0
导读:兄弟们,咱做 Spring 项目的时候,是不是总遇到这些破事。。。

Boot+Cloud项目学习:macrozheng.com

兄弟们,咱做 Spring 项目的时候,是不是总遇到这些破事:

  • 每个 Controller 里都要写@Autowired UserService userService,注入一大堆 Service,代码又乱又冗余;
  • 想统一加个日志/异常处理,得在每个 Service 方法里写一遍,改起来要疯;
  • 偶尔还会手滑把 Service 类名/方法名写错,编译不报错,跑起来才出问题,排查半天。

今天给大家分享个我自己写的ServiceManager组件,用 Lambda 搞定这些破事 —— 不用手动注入 Service,调用方法像写公式一样简单,还能自动缓存、统一处理异常,新手也能秒懂秒用!

先说说这组件能解决啥实际问题?

举个栗子:以前咱调用用户查询接口,得这么写:

// 1. 先注入Service
@Autowired
private UserService userService;
// 2. 再调用方法
public SerResult<UserDTO> getUser(Long userId) {
    try {
        log.info("开始查用户,ID:{}", userId);
        UserDTO user = userService.queryUser(userId);
        log.info("查询成功,结果:{}", user);
        return SerResult.success(user);
    } catch (Exception e) {
        log.error("查询失败", e);
        return SerResult.fail("查用户出错了");
    }
}

又是注入又是日志又是 try-catch,重复代码一堆。

用了ServiceManager之后,直接写成这样:

public SerResult<UserDTO> getUser(Long userId) {
    // 一行搞定:传方法+参数,其他全帮你做
    return ServiceManager.call(UserService::queryUser, userId);
}

注入?没了。日志?组件自动打。异常?组件自动处理。爽不爽?

组件核心逻辑:大白话拆解

其实这组件就干了 3 件事:

  • 你传个 Lambda(比如UserService::queryUser),它帮你找到对应的 Service 实例;
  • 把找到的实例和方法缓存起来,下次调用更快;
  • 统一执行方法,顺便把日志、异常处理都包了。

下面咱一步步来,代码都给你贴好,复制过去改改就能用。

第一步:先搭基础 —— 需要的依赖和工具类

首先得有几个小工具,不用自己写,直接复制:

1. 统一返回结果类(SerResult)

不管调用成功还是失败,都返回同一个格式,前端好处理:

package org.pro.wwcx.ledger.common.dto;
import lombok.Data;
// 服务调用的统一返回结果,前端拿到就知道是成功还是失败
@Data
publicclass SerResult<T{
    privateint code;       // 200=成功,500=失败,前端一看就懂
    private String msg;     // 提示信息,比如“操作成功”“查不到用户”
    private T data;         // 成功时返回的数据,比如用户信息
    // 成功的时候调用这个方法,把数据传进去
    publicstatic <T> SerResult<T> success(T data) {
        SerResult<T> result = new SerResult<>();
        result.setCode(200);
        result.setMsg("操作成功");
        result.setData(data);
        return result;
    }
    // 失败的时候调用这个方法,传错误信息
    publicstatic <T> SerResult<T> fail(String msg) {
        SerResult<T> result = new SerResult<>();
        result.setCode(500);
        result.setMsg(msg);
        result.setData(null);
        return result;
    }
}

2. Lambda 解析工具(LambdaUtil)

这工具是核心,帮咱从 Lambda 里 “扣” 出 Service 类名和方法名(不用懂原理,复制用就行):

package org.pro.wwcx.ledger.common.util;
import java.io.Serializable;
import java.lang.reflect.Method;
import java.lang.invoke.SerializedLambda;
// 从Lambda表达式里拿Service信息的工具
publicclass LambdaUtil {
    // 传个Lambda进来,返回它对应的“元数据”(比如哪个Service,哪个方法)
    public static SerializedLambda valueOf(Serializable lambda) {
        if (lambda == null) {
            thrownew IllegalArgumentException("Lambda不能传空!");
        }
        try {
            // 反射拿到Lambda里的隐藏方法,不用管这行是咋回事
            Method writeReplaceMethod = lambda.getClass().getDeclaredMethod("writeReplace");
            writeReplaceMethod.setAccessible(true);
            return (SerializedLambda) writeReplaceMethod.invoke(lambda);
        } catch (Exception e) {
            thrownew RuntimeException("解析Lambda出错了", e);
        }
    }
}

3. Spring 工具类(SpringUtil)

帮咱从 Spring 里拿 Service 实例(不用手动@Autowired就是靠它):

package org.pro.wwcx.ledger.common.util;
import org.springframework.beans.BeansException;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.springframework.stereotype.Component;
// 从Spring里拿Bean的工具,不用自己注入Service
@Component
publicclass SpringUtil implements ApplicationContextAware {
    // Spring的上下文,相当于“Bean仓库”
    privatestatic ApplicationContext applicationContext;
    // 从仓库里按类型拿Bean,比如拿UserService类型的实例
    publicstatic <T> getBean(Class<T> requiredType) {
        if (applicationContext == null) {
            thrownew RuntimeException("Spring还没初始化好呢!");
        }
        return applicationContext.getBean(requiredType);
    }
    // 下面这行是Spring自动调用的,不用管
    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        SpringUtil.applicationContext = applicationContext;
    }
}

4. 函数接口(SerialBiFunction)

这个是 Lambda 的 “规矩”,规定传参和返回值的格式(复制就行):

package org.pro.wwcx.ledger.common.resolver.anno;
import java.io.Serializable;
// 支持序列化的双参数函数接口,Lambda要符合这个格式
public interface SerialBiFunction<TURextends Serializable {
    // 方法格式:传入T(Service实例)和U(参数),返回R(结果)
    apply(T t, U u);
}

5. 实例构建器(InstBuilder)

帮咱快速创建对象的小工具,不用写一堆set方法:

package org.pro.wwcx.ledger.common.resolver;
// 快速创建对象的工具,比如new ServiceExecutor后不用一个个set值
publicclass InstBuilder<T{
    privatefinal T target;
    // 初始化要创建的对象
    private InstBuilder(Class<T> clazz) {
        try {
            this.target = clazz.getDeclaredConstructor().newInstance();
        } catch (Exception e) {
            thrownew RuntimeException("创建对象失败", e);
        }
    }
    // 静态方法,入口:InstBuilder.of(ServiceExecutor.class)
    publicstatic <T> InstBuilder<T> of(Class<T> clazz) {
        returnnew InstBuilder<>(clazz);
    }
    // 链式set值:比如.set(ServiceExecutor::setParam, param)
    public <V> InstBuilder<T> set(Setter<T, V> setter, V value) {
        setter.set(target, value);
        returnthis;
    }
    // 最后调用build()拿到对象
    public T build() {
        return target;
    }
    // 定义setter的格式
    @FunctionalInterface
    publicinterface Setter<T, V> {
        void set(T target, V value);
    }
}

第二步:核心组件 ——ServiceManager

这是咱的主角,所有逻辑都在这,我一行行给你讲明白:

package org.pro.wwcx.ledger.common.servicer;
import lombok.extern.slf4j.Slf4j;
import org.pro.wwcx.ledger.common.dto.SerResult;
import org.pro.wwcx.ledger.common.resolver.InstBuilder;
import org.pro.wwcx.ledger.common.resolver.anno.SerialBiFunction;
import org.pro.wwcx.ledger.common.util.LambdaUtil;
import org.pro.wwcx.ledger.common.util.SpringUtil;
import java.lang.invoke.SerializedLambda;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
// 日志注解,能打日志
@Slf4j
publicclass ServiceManager {
    // 缓存初始化大小,6666够咱用了,不够再改
    privatestaticfinalint INIT_COUNT = 6666;
    // 缓存Lambda对应的Service信息,key是Lambda,value是Service元数据
    privatestaticfinal Map<SerialBiFunction<?,?,?>, LambdaMeta<?>> CACHE_LAMBDA;
    // 静态代码块,项目启动时就初始化缓存
    static {
        CACHE_LAMBDA = new ConcurrentHashMap<>(INIT_COUNT);
    }
    // 对外提供的调用方法:传Lambda(比如UserService::queryUser)和参数,返回结果
    @SuppressWarnings("unchecked")
    publicstatic <T,U,R> SerResult<R> call(SerialBiFunction<T,U,R> fn, U param){
        // 先检查:Lambda不能传空
        if (fn == null) {
            return SerResult.fail("服务函数不能为空!");
        }
        // 1. 从缓存拿Service信息:有就直接用,没有就解析并缓存
        LambdaMeta<T> lambdaMeta = (LambdaMeta<T>) CACHE_LAMBDA.computeIfAbsent(fn, k-> {
            // 解析Lambda,拿到Service实例、类名这些信息
            LambdaMeta<T> meta = parseSerialFunction(fn);
            log.debug("缓存Service信息:{}", meta.getServiceName());
            return meta;
        });
        // 2. 创建执行器,把Lambda、参数、Service信息传进去
        ServiceExecutor<T,U,R> executor = InstBuilder.of(ServiceExecutor.class)
                .set(ServiceExecutor::setServiceFnfn)    // 传Lambda方法
                .set(ServiceExecutor::setParamparam)      // 传参数
                .set(ServiceExecutor::setLambdaMetalambdaMeta)  // 传Service信息
                .build()
;  // 构建执行器
        // 3. 执行方法,返回结果
        return executor.callService();
    }
    // 解析Lambda:从Lambda里拿到Service类名、实例、方法名
    @SuppressWarnings("unchecked")
    privatestatic <T, U, R> LambdaMeta<T> parseSerialFunction(SerialBiFunction<T,U,R> fn) {
        // 用LambdaUtil拿到Lambda的元数据
        SerializedLambda lambda = LambdaUtil.valueOf(fn);
        // 封装Service信息的对象
        LambdaMeta<T> lambdaMeta = new LambdaMeta<>();
        // 1. 解析Service类名:Lambda里的类名是“com/example/UserService”,要改成“com.example.UserService”
        String tClassName = lambda.getImplClass().replaceAll("/"".");
        try {
            // 2. 拿到Service的Class对象(比如UserService.class)
            Class<T> aClass = (Class<T>) Class.forName(tClassName);
            // 3. 从Spring里拿Service实例(不用@Autowired就是靠这行)
            T inst = SpringUtil.getBean(aClass);
            // 4. 把信息存到lambdaMeta里
            lambdaMeta.setClazz(aClass);    // 存Service的Class
            lambdaMeta.setInst(inst);       // 存Service实例
            lambdaMeta.setServiceName(lambda.getImplMethodName());  // 存方法名(比如queryUser)
        } catch (ClassNotFoundException e) {
            // 找不到类就抛异常
            thrownew RuntimeException("没找到Service类:" + tClassName, e);
        }
        return lambdaMeta;
    }
    // 封装Service信息的内部类:存Class、实例、方法名
    @lombok.Data
    privatestaticclass LambdaMeta<T> {
        private Class<T> clazz;          // Service的Class(比如UserService.class)
        private T inst;                  // Service实例(Spring里的Bean)
        private String serviceName;      // 方法名(比如queryUser)
    }
}

第三步:执行器 ——ServiceExecutor

这是帮咱统一执行方法、打日志、处理异常的 “打工人”:

package org.pro.wwcx.ledger.common.servicer;
import lombok.Setter;
import lombok.extern.slf4j.Slf4j;
import org.pro.wwcx.ledger.common.dto.SerResult;
import org.pro.wwcx.ledger.common.resolver.anno.SerialBiFunction;
// 执行Service方法的类,统一打日志、处理异常
@Slf4j
@Setter
publicclass ServiceExecutor<TUR{
    private SerialBiFunction<T, U, R> serviceFn;  // 要执行的Lambda方法
    private U param;                               // 方法参数
    private ServiceManager.LambdaMeta<T> lambdaMeta;  // Service信息
    // 执行方法的核心逻辑
    public SerResult<R> callService() {
        // 记录开始时间,方便算耗时
        long startTime = System.currentTimeMillis();
        String serviceName = lambdaMeta.getClazz().getSimpleName();  // 比如UserService
        String methodName = lambdaMeta.getServiceName();             // 比如queryUser
        log.info("开始调用:{}的{}方法,参数:{}", serviceName, methodName, param);
        try {
            // 真正执行方法:用Service实例调用Lambda方法
            R result = serviceFn.apply(lambdaMeta.getInst(), param);
            // 算耗时,打成功日志
            long costTime = System.currentTimeMillis() - startTime;
            log.info("调用成功:{}的{}方法,耗时{}ms,结果:{}",
                    serviceName, methodName, costTime, result);
            // 返回成功结果
            return SerResult.success(result);
        } catch (Exception e) {
            // 出错了就打错误日志,返回失败结果
            long costTime = System.currentTimeMillis() - startTime;
            log.error("调用失败:{}的{}方法,耗时{}ms",
                    serviceName, methodName, costTime, e);
            return SerResult.fail("调用" + serviceName + "的" + methodName + "方法失败:" + e.getMessage());
        }
    }
}

第四步:怎么用?举个实际例子

咱以用户查询和更新为例,看 Controller 里怎么写:

1. 先写个 Service(正常写,不用改)

package org.pro.wwcx.ledger.service;
import org.pro.wwcx.ledger.dto.UserDTO;
import org.pro.wwcx.ledger.dto.UserUpdateDTO;
import org.springframework.stereotype.Service;
// 正常的Service,该咋写咋写
@Service
publicclass UserService {
    // 查用户:根据ID查
    public UserDTO queryUser(Long userId) {
        // 这里模拟查数据库,实际项目里换JDBC/MyBatis
        UserDTO user = new UserDTO();
        user.setUserId(userId);
        user.setUserName("张三");
        user.setAge(25);
        return user;
    }
    // 更新用户:传ID和更新参数
    public Boolean updateUser(Long userId, UserUpdateDTO updateDTO) {
        // 这里模拟更新数据库
        log.info("更新用户{}的信息:{}", userId, updateDTO);
        returntrue;  // 返回更新成功
    }
}

2. Controller 里调用(重点看变化)

package org.pro.wwcx.ledger.controller;
import org.pro.wwcx.ledger.common.dto.SerResult;
import org.pro.wwcx.ledger.common.servicer.ServiceManager;
import org.pro.wwcx.ledger.dto.UserDTO;
import org.pro.wwcx.ledger.dto.UserUpdateDTO;
import org.pro.wwcx.ledger.service.UserService;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/user")
publicclass UserController {
    // 查用户:不用注入UserService!一行搞定
    @GetMapping("/{userId}")
    public SerResult<UserDTO> getUser(@PathVariable Long userId) {
        // 直接传Lambda(UserService::queryUser)和参数(userId)
        return ServiceManager.call(UserService::queryUser, userId);
    }
    // 更新用户:同样不用注入
    @PutMapping("/{userId}")
    public SerResult<Boolean> updateUser(
            @PathVariable Long userId,
            @RequestBody UserUpdateDTO updateDTO)
 
{
        // 这里要注意:因为updateUser有两个参数,所以要显式指定Lambda类型
        return ServiceManager.call(
                (UserService service, UserUpdateDTO dto) -> service.updateUser(userId, dto),
                updateDTO
        );
    }
}

3. 跑起来看看效果

查用户的时候,日志会自动打:

开始调用:UserService的queryUser方法,参数:1001
调用成功:UserService的queryUser方法,耗时5ms,结果:UserDTO(userId=1001, userName=张三, age=25)

要是出错了,比如传个不存在的用户 ID(假设数据库查不到会抛异常),日志会打错误信息,返回给前端的结果是:

{
  "code"500,
  "msg""调用UserService的queryUser方法失败:用户不存在",
  "data"null
}

这组件的好处:总结一下

  • 不用再写 @Autowired: Controller 里干干净净,再也不用注入一堆 Service;
  • 统一日志 / 异常: 想改日志格式、加权限校验,只需要改 ServiceExecutor,不用改每个方法;
  • 缓存优化: 解析过的 Service 信息会缓存,下次调用更快;
  • 类型安全: 写 Lambda 的时候,方法名错了编译就报错,不用等到运行才发现。

注意事项:避坑指南

  • JDK 版本: 用 JDK8 及以上,Lambda 表达式是 JDK8 才有的;
  • Service 要加 @Service: Spring 才能扫描到,不然 SpringUtil 拿不到实例;
  • 多实现类的情况: 如果一个接口有多个实现(比如 UserService 有 UserServiceImpl1 和 UserServiceImpl2),需要在 SpringUtil 里加按名称拿 Bean 的方法。

作者:只会写代码

来源:juejin.cn/post/7575017581036765222


Github上标星11K的微服务实战项目mall-swarm,全套 视频教程 来了!全套教程约26小时,共59期,如果你想学习目前最新的微服务技术栈,同时提高自己微服务项目的开发能力的话,不妨了解下,下面是项目的整体架构图,感兴趣的小伙伴可以点击链接 mall-swarm视频教程 加入学习。

整套 视频教程 的内容还是非常完善的,涵盖Spring Cloud核心组件、微服务项目实战、Kubernetes容器化部署等内容,你也可以点击链接 mall-swarm视频教程 了解更多内容。

【声明】内容源于网络
0
0
macrozheng
内容 1937
粉丝 0
macrozheng
总阅读119
粉丝0
内容1.9k