Spring Boot REST：业务逻辑放Service还是Controller？返回多结构JSON

1. 业务逻辑的分层位置 #

检查蛋糕是否存在这类业务逻辑必须放在Service层，原因很直接：

• Controller的核心职责是处理HTTP请求的接收、参数初步校验、响应结果的封装，不该掺和业务规则的判断；
• Service层才是承载核心业务逻辑的地方，数据库查询、业务判断都属于它的职责范围，这样做能实现代码解耦，后续单独测试Service层也更方便，不用启动整个Spring上下文；
• 要是以后其他接口也需要用到“检查蛋糕是否存在”的逻辑，直接复用Service方法就行，避免重复造轮子。

2. 处理Service返回不同结构的方案 #

别直接让Service返回JSON字符串，层与层之间要保持强类型交互，推荐以下几种实用方案：

方案一：统一响应DTO（最推荐） #

定义一个通用的响应类，把两种场景的字段都包含进去，不存在的场景对应字段设为null即可：

// 通用响应DTO
public class ApiResponse<T> {
    private String success;
    private T result;
    private String message;

    // 省略构造方法、getter/setter
    // 静态工厂方法，快速创建响应实例
    public static <T> ApiResponse<T> success(T data) {
        ApiResponse<T> response = new ApiResponse<>();
        response.setSuccess("true");
        response.setResult(data);
        return response;
    }

    public static <T> ApiResponse<T> failure(String message) {
        ApiResponse<T> response = new ApiResponse<>();
        response.setSuccess("false");
        response.setMessage(message);
        return response;
    }
}

// 蛋糕实体类
public class Cake {
    private String name;
    private Integer calories;
    // 省略getter/setter
}

然后Service层返回这个ApiResponse<Cake>：

@Service
public class CakeService {
    @Autowired
    private CakeRepository cakeRepository;

    public ApiResponse<Cake> getCake(String cakeName) {
        Cake cake = cakeRepository.findByName(cakeName);
        if (cake != null) {
            return ApiResponse.success(cake);
        } else {
            return ApiResponse.failure("null");
        }
    }
}

Controller直接返回这个对象，Spring会自动帮你序列化成符合要求的JSON：

@RestController
@RequestMapping("/cakes")
public class CakeController {
    @Autowired
    private CakeService cakeService;

    @GetMapping("/{cakeName}")
    public ApiResponse<Cake> getCake(@PathVariable String cakeName) {
        return cakeService.getCake(cakeName);
    }
}

这种方案完全符合Spring最佳实践，强类型、易维护，完美匹配你的需求。

方案二：返回Object（不推荐） #

Service层返回Object类型，根据查询结果返回Cake实例或者错误信息的Map。但这种方式会丢失编译期类型检查，后续维护容易出问题，不建议用：

public Object getCake(String cakeName) {
    Cake cake = cakeRepository.findByName(cakeName);
    if (cake != null) {
        Map<String, Object> successMap = new HashMap<>();
        successMap.put("success", "true");
        successMap.put("result", cake);
        return successMap;
    } else {
        Map<String, Object> failureMap = new HashMap<>();
        failureMap.put("success", "false");
        failureMap.put("message", "null");
        return failureMap;
    }
}

方案三：自定义序列化（复杂场景可选） #

如果不想让JSON里出现null字段，可以给通用DTO加上Jackson的@JsonInclude(JsonInclude.Include.NON_NULL)注解，这样不存在的字段就不会被序列化到JSON里，和你要的结构完全一致。

内容的提问来源于stack exchange，提问作者James Work account