2020年6月5日のブックマーク (1件)

  • Javadoc の @throws に例外を網羅的に書くメリット | DevelopersIO

    記事は Javadoc に @throws を書く習慣の無い方に、@throws を書いてみようかな?と思っていただくことを目標に書きました。 記事は Javadoc に @throws を書く習慣の無い方に、@throws を書いてみようかな?と思っていただくことを目標に書きました。 前提 いわゆるコードの保守性よりもバグを出さないことの優先順位が上、という思想の元に、実際に開発に適用してみて割とよかった話、として記載しています 開発しているアプリ(prismatix)の性質上そうしている、というところが大いにあると思うので、マッチしない環境も多々あると思います Webアプリケーションで、ハンドリングされない例外があるとステータスコード500が返って、不要なアラートがバンバン飛んで辛くなるのは NG にしたい、みたいな背景があります 以下のような開発対象や開発環境だと、あまりメリット

    Javadoc の @throws に例外を網羅的に書くメリット | DevelopersIO
    inabajunmr
    inabajunmr 2020/06/05
    書いた