本文将介绍如何在 Spring Boot 应用中，针对不同的 Controller，限制 JSON 响应中特定 Key（例如 "DATA"）所包含的列表大小。通过将业务逻辑提取到 Service 层，并从 Controller 层传递限制参数，可以灵活地控制返回数据的大小，从而优化 API 性能，避免传输过大的数据。
在实际开发中，我们经常会遇到需要返回包含大量数据的 JSON 响应。如果不对数据量进行限制，可能会导致 API 响应缓慢，甚至造成服务器压力过大。本教程将以一个包含名为 "DATA" 的列表的 JSON 响应为例，演示如何根据不同的 Controller 需求，限制 "DATA" 列表的大小。
核心思想：将数据处理逻辑提取到 Service 层
为了实现灵活的限制，我们需要将数据处理的逻辑从 Controller 层分离出来，放到 Service 层。Service 层负责从数据库或其他数据源获取数据，并根据 Controller 传递的限制参数，对数据进行裁剪，最后返回处理后的结果。
示例代码：
- 创建 Service 类：MyService.java
@Service
public class MyService {
public MyDto createResponse(int limit) {
// 模拟从数据库或其他数据源获取数据
List data = generateData();
// 根据 limit 参数，裁剪 data 列表
List limitedData = data.subList(0, Math.min(limit, data.size()));
// 创建 MyDto 对象，并将 limitedData 放入其中
MyDto response = new MyDto();
response.setData(limitedData);
return response;
}
// 模拟生成数据的函数
private List generateData() {
List data = new ArrayList<>();
for (int i = 0; i < 150; i++) {
data.add("Data Item " + (i + 1));
}
return data;
}
} 这段代码中，createResponse 方法接收一个 limit 参数，用于指定 "DATA" 列表的最大长度。data.subList(0, Math.min(limit, data.size())) 这行代码使用 subList 方法截取 data 列表，并使用 Math.min 函数确保 limit 不超过 data 的实际大小，避免 IndexOutOfBoundsException。
- 创建 DTO 类：MyDto.java
public class MyDto {
private List data;
public List getData() {
return data;
}
public void setData(List data) {
this.data = data;
}
} 这个简单的 DTO 类用于封装 JSON 响应的数据，其中包含一个名为 data 的列表。
- 创建 Controller 类：MyController1.java 和 MyController2.java
@RestController
public class MyController1 {
@Autowired
MyService myService;
@GetMapping("/api/data1")
public MyDto createResponse() {
return myService.createResponse(30);
}
}@RestController
public class MyController2 {
@Autowired
MyService myService;
@GetMapping("/api/data2")
public MyDto createResponse() {
return myService.createResponse(90);
}
}这两个 Controller 类都依赖于 MyService。MyController1 的 /api/data1 接口调用 myService.createResponse(30)，将 "DATA" 列表的大小限制为 30。MyController2 的 /api/data2 接口调用 myService.createResponse(90)，将 "DATA" 列表的大小限制为 90。
注意事项：
- 数据源： 上述示例代码使用 generateData() 函数模拟生成数据。在实际项目中，你需要从数据库或其他数据源获取数据。
- 异常处理： 在实际项目中，你需要考虑各种异常情况，例如数据库连接失败、数据不存在等，并进行适当的处理。
- 分页： 如果数据量非常大，即使限制了列表的大小，一次性返回所有数据仍然可能导致性能问题。在这种情况下，可以考虑使用分页技术，将数据分批返回。
- 数据转换： 根据实际需求，可能需要在 Service 层对数据进行转换，例如将数据库中的实体对象转换为 DTO 对象。
总结：
通过将数据处理逻辑提取到 Service 层，并从 Controller 层传递限制参数，我们可以灵活地控制 JSON 响应中特定 Key 的大小。这种方法不仅可以优化 API 性能，还可以提高代码的可维护性和可测试性。在实际项目中，你需要根据具体的需求，选择合适的数据处理方法和技术。
