控制器类 controller (接口(API)通常是通过控制器(Controller)来实现的)
服务接口/类 service
接口实现类 impl
工具类 util
配置类 @configuration config/configuration
组件类 @component
异步消息处理类 handler
实体类 专门存数据
---------------------------------------------------------------------------------------------------------------------------------
@RestController
标记这是一个RESTful风格的控制器。
该控制器的所有返回值都会被自动序列化为JSON格式,并作为HTTP响应体返回给客户端。
@RequestMapping("/ds_class")
设置当前控制器的所有请求映射的基础路径为/ds_class。
例如,所有在这个控制器中的请求映射都会以/ds_class开头。
@Api(value = "数据源-分类类别", tags = {"A-数据源-分类类别"})
用于Swagger文档,描述该控制器的作用。
value属性表示控制器的主要功能描述。
tags属性用于在Swagger UI中对API进行分类。
@Autowired
自动注入MetaMapDsClassService服务实例。
Spring框架会自动查找并注入相应的Bean。
@GetMapping
定义一个处理GET请求的方法。
映射到/ds_class路径上。
当客户端发送GET请求到/ds_class时,会调用此方法。
@ApiOperation(value = "获取数据源-分类类别的信息", produces = "application/json;charset=utf-8")
用于Swagger文档,描述该方法的功能。
value属性表示方法的主要功能描述。
produces属性指定返回的内容类型为application/json;charset=utf-8。
@ApiParam(value = "数据源ID") 和 @ApiParam(value = "数据源版本")
用于Swagger文档,描述请求参数的作用。
value属性表示参数的主要功能描述。