类注解
@Tag(name = "", description = "")
- 用于OpenAPI文档生成,定义该controller的名称为name所指,描述为description所指
@RestController
- 标识该类是一个REST控制器,能够处理HTTP请求并返回JSON数据
@RequestMapping("default/v1")
- 定义该controller的基础路径为default/v1,所有方法的路径都基于此路径
成员变量
@Autowired private FeedTransformService feedTransformService
- 使用@Aitpwired注解将FeedTransformService自动注入到controller中,用于处理业务逻辑
方法getDefaultValue
@GetMapping("/hello")
- 映射HTTP GET请求到路径/default/v1/hello
@Operation(summary = "Hello api")
- 用于OpenAPI文档生成,描述该API的摘要为“Hello.api”
@ApiResponses
- 定义该API的可能响应:
方法内容:返回字符串“xxController created from xx”,用于测试控制器是否正常工作
方法feedtransformation
@GetMapping("/feedtransformation")
- 映射HTTP GET请求到路径/default/v1/feedtransformation
@Operation(summary = "feed transformation")
- 用于OpenAPI文档生成,描述该API的摘要为“feed transformation.api”
@ApiResponses
- 定义该API的可能响应:
方法参数:
@RequestParam:从请求中获取参数
- calcRunId:计算运行ID
- site:站点名称
- 结算日期
方法内容:调用feedTransformService.feedTransForSite(calcRunId, site, cobDate)
POJO
Plain Old Java Object 是一个简单的Java对象,通常没用继承特定的类或实现特定的接口。它主要用于封装数据,常见于实体类或者数据传输对象(DTO)
类级别注解
@Component
- Spring注解,标识该类是一个组件,会被Spring容器管理
- 允许其他类通过依赖注入使用该类
依赖注入案例1:
@Autowired
private FeedTransformService feedTransformService
静态代码块
static { ... }
- 静态代码块在类加载时执行,用于初始化静态字段