はじめに

コーディング規約を強制するのに有効なPlug In発見。Checkstyle Plug Inです。
これのDefaultがSunのコーディング規約になっていますので、javaの基本的な規約を守らせることができます。
これを利用して規約を守る最低ラインを死守します。*1
Plug Inの導入は、http://www.atmarkit.co.jp/fjava/javatips/007eclipse004.html を見てください。

Plug Inはここから手に入る
http://sourceforge.net/projects/eclipse-cs/

規約を設定する

java標準のコーディング規約は恐ろしく厳しく感じるので、必要性を感じない規約は無視できるように設定変更してみます。

この項で設定変更した規約のファイル

1行の文字数を変更する

  • Sunの標準コーディング規約では1行は80文字以下に抑えなくてはいけないようです。
  • javaDocコメントで「@see」を記述する際などどうしても1行が長くなるのでこの規約を80文字から240文字に変更します。
checkstyle01.jpg
  • 「Size Violation」→「Maximum Line Length」を「Edit Rule」します。
checkstyle02.jpg
  • 「max」を 80 → 240 に変更します。

TABの使用を許可する

  • Sunの標準コーディング規約ではTABはソース中に存在してはいけないようです。
  • 「つかうだろ!」ってことで許可します。
checkstyle04.jpg
  • 「Whitespace」→「Tab Character」を「Delete Rule」します。*2

Magic Number のSevelityレベルを下げる

  • Magic Numberは使わない方が良いのかもしれませんが、for文で使用した際にも怒られるのはうっとおしいのでSevelityレベルをinfoに下げる。
checkstyle05.jpg
  • 「Coding Problem」→「Magic Number」を「Edit Rule」します。
checkstyle06.jpg
  • 「Sevelity」のレベルを「info」にします。
    • 「ignoreNumbers」にこのチェックを無視したい数値をカンマ区切りで記述していけば、チェックの対象から外せます。

引数でのfinal宣言チェックを行わない

  • メソッドの引数はどう考えてもfinalなので宣言してもいいけど、あまりにもうざいのでやめチェックを外す
  • コンストラクタも同様・・・
checkstyle07.jpg
  • 「Miscallaneous」→「Final Parameters」を「Edit Rule」します。
checkstyle08.jpg
  • 「Sevelity」のレベルを「ignore」にします。
    • 「METHOD_DEF」がメソッドのチェック。これを外すとメソッドのチェックのみ行わない設定になる
    • 「CTOR_DEF」がコンストラクタのチェック。これを外すとコンストラクタのチェックのみ行わない設定になる

プロジェクトに規約を設定する

  • プロジェクトの「プロパティ」より「Checkstyle」を選択します。
  • で「add」する。
    checkstyle09.jpg
  • プロジェクトがサーブレットだとjspのworkで警告でまくるので、対象のファイルを
    [^_]+[^j]+[^s]+[^p]\.java$

    としてコンパイルされたjspを除外する。*3

[^T]+[^e]+[^s]+[^t]\.java$

ちなみにJUnitの場合は、こんな感じで除外。。。

  • まぁ、つまるところただの正規表現なので・・・


備考




*1 SDKのソース見る限りこんなに厳しく規約守ってるようには見えませんけど・・・
*2 Sevelityレベルをignoreでもいいですね
*3 もっとうまい正規表現方法ないですか?

添付ファイル: file20041211_LooseSun_3_5_0 806件 [詳細] filecheckstyle02.jpg 598件 [詳細] filecheckstyle07.jpg 655件 [詳細] filecheckstyle08.jpg 505件 [詳細] file20031121_LooseSun_3_1_1 971件 [詳細] filecheckstyle01.jpg 707件 [詳細] filecheckstyle09.jpg 563件 [詳細] filecheckstyle05.jpg 543件 [詳細] filecheckstyle04.jpg 758件 [詳細] filecheckstyle06.jpg 519件 [詳細]

トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2017-04-07 (金) 16:01:32 (200d)