7

Spring MVC を使用して、さまざまな REST サービスの実装に取り​​組んでいます。ドキュメントには、Swagger を使用しています。

これはうまく機能し、ドキュメントは見栄えがよく、本当に機能的です。私が抱えている唯一の問題は、ドキュメントの注釈、特にエラー コードの注釈が実際にコントローラー クラスを混雑させていることです。

例:

@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")};

誰かがこの問題を解決する方法を教えてくれたらうれしいです。事前に感謝します!

4

1 に答える 1