我正在使用 Spring MVC 来实现各种 REST 服务。对于文档,我使用 Swagger。
这很好用,文档看起来不错,而且非常实用。我遇到的唯一问题是文档注释确实挤满了控制器类,尤其是错误代码注释。
Example:
@ApiErrors(value = {
@ApiError(code = 123, reason = "Reason123"),
@ApiError(code = 124, reason = "Reason124"),
@ApiError(code = 125, reason = "Reason125"),
@ApiError(code = 126, reason = "Reason126"),
@ApiError(code = 127, reason = "Reason127") })
public void exampleFunctionImplementation() {
}
在许多情况下,这会导致大量注释,而真正的应用程序代码隐藏在中间的某个位置。此外,该注释集经常重复,因为许多方法可能返回同一组错误代码。
是否有任何选项可以通过在其他地方将注释列表定义为另一个类文件中的常量来缩短这一时间?或者也许是我忽略的更简单的事情?
我尝试定义数组@ApiError
某处的项目,但这不会编译:
ApiError[] array = {ApiError(code = 123, reason = "Reason123")};
如果有人能给我提示如何解决这个问题,我将很高兴,提前致谢!