Service层返回的数据是一个多个对象集合组成的Map集合，如何在controller层进行swagger标注详细的数据

在Spring Boot项目中，如果你的服务层（Service Layer）返回的是一个包含多个对象的Map集合，要在Controller层使用Swagger进行详细的API文档标注，你需要按照以下步骤操作：

1. **创建数据模型** (Model): 首先，为Map中的每个对象创建一个单独的Java实体类，并添加到 Swagger 的 `@ApiModel` 注解中。例如：

   @ApiModel(description = "你的对象描述")
   public class YourObject {
       // 属性和getter/setter...
   }
   
   Map<String, YourObject> yourObjectsMap;

2. **映射到响应体** (Response Body): 使用 `@ApiModelProperty` 注解来描述Map的数据结构和各元素的含义：

   @ApiOperation(value = "获取集合", notes = "返回的对象集合")
   @GetMapping("/your-endpoint")
   @ResponseBody
   public ResponseEntity<Map<String, YourObject>> getYourCollection() {
       // 返回处理后的map
       return ResponseEntity.ok(yourObjectsMap);
   }

   @ApiModelProperty(
       value = "响应中的数据",
       dataType = "map",
       valueProperties = {
           @ValueProperty(name = "key", description = "键"),
           @ValueProperty(name = "value", description = "值，YourObject实例")
       })
   private Map<String, YourObject> yourObjectsMap;

3. **运行Swagger UI**: 启动应用后，访问`http://localhost:8080/swagger-ui.html`，你应该能看到生成的API文档，其中会详细展示返回的Map及其内容。