ユニットテストの偏りを防ぐ命名規則の付け方

公開日: : 最終更新日:2015/10/15 プログラム ,

ユニットテスト名に以下の命名規則を付けるようにして二ヶ月ぐらい経った。

  • 正常系テストの場合: 正常系_${testName}
    • ${testName} の部分には「何を確認するテストなのか」を書く
  • 準正常系テストの場合: 準正常系_${testName}
  • 異常系テストの場合: 異常系_${testName}

この命名規則にしてからのメリットをメモしておく。

icatch-2015-005-1

photo credit: Brian Chan via unsplash

目次

1. 命名規則導入のメリット

メリットと感じるのは次の2点。

  1. パッと見てどんなテストなのか分かりやすい
  2. テストの種類が偏らない

当然だが何系のテストなのかパッと見て分かる。
ユニットテストのメソッド名は日本語で書く(これも分かりやすさのため)ので「正常系」とかが付いていても全く違和感がない。

この命名規則を付けるようになって、準正常系・異常系のテストが少ないことに気付かされたのは大きかった。
不備があったら結局は自分に返ってくる。
そうならないために準正常系・異常系テストを書く意識が増えたのは良かった。

2. 命名規則導入のデメリット

デメリットというか困っているのは、Maven の mvn test を実行して失敗したテストがあると日本語部分が読めないこと。
これはターミナルの設定で解決する問題なのだろうか?

3. Templates のエクスポートファイル

Eclipse の Templates 機能を使えばユニットテストの雛形を登録でき、コンテンツアシスト機能により素早くテストを作成できる。

以下の雛形を登録して日々の開発を行っている。

【正常系テスト】

@Test
public void 正常系_testName() throws Exception {
    // setup
    // exercise
    // verify
}

【準正常系テスト】

@Test
public void 準正常系_testName() throws Exception {
    // setup
    // exercise
    // verify
}

【異常系テスト】

@Test
public void 異常系_testName() throws Exception {
    // setup
    // exercise
    // verify
}

上記の雛形の定義を Eclipse からエクスポートした。

これを適当な名前で保存して Eclipse にインポートすると(もしくは個別に登録すると)、コンテンツアシストでの保管が有効になる。

  1. Java ソースコードを開いて “test” と入力
  2. この状態でコンテンツアシストを実行
  3. ダイアログに上記の3パターンが表示されれば OK

4. 更新履歴

  • 2015/10/14: 初版作成
  • 2015/10/15: 内容の修正

Googleアドセンス用(PC)

  • このエントリーをはてなブックマークに追加
  • follow us in feedly

関連記事

no image

VPS に Redmine を設置したときに対処したトラブル

Redmine のインストール自体は Redmine 2.3をCentOS 6.4にインストールする

記事を読む

20140811-00

64ビット版のCentOSをVMwareにインストールできない場合の対処法

Linux で検証したい作業が多かったので VMware に検証環境を作りました。OS は Cent

記事を読む

icatch_8626992930-resized

シェルスクリプトでcdしたいパスにスペースが入っている場合の対処法

cd したいパスにスペースが入っていると、パスの先頭からスペースまでを「移動したいパス」と解釈されて

記事を読む

icatch-9214710040_822a4c3456_z-resized

ロードアベレージを監視するシェルスクリプトを作成してみた

このブログを運用している Linux サーバの負荷が高い状態になってました。 何か被害にあったとかで

記事を読む

icatch-sublimetext_9222613858_mini-thumbnail

Sublime Text3 のインストール直後に行った設定メモ

突発的に自宅のマシンにインストールしてあった Sublime Text2 を 3 にアップデートしま

記事を読む

no image

CVS でタグ間で変更があったファイルを抽出するスクリプト

今どきバージョン管理ツールに CVS を使っているところは珍しいと思うし、あまり需要はないだろうけど

記事を読む

icatch-2015-006-1

バリデーションチェックにJava8のOptionalを使ってスマートに書く(自分比)

Web アプリのバリデーションチェックにアノテーションを使うことが増えた。だが、アノテーションで実装

記事を読む

icatch-8785445626_587fdac14d_z-resized

検証用の CentOS をインストールした直後に行う初期設定手順

職場でも自宅でも Linux で検証したい作業があったので VMware に 64 ビット版の Ce

記事を読む

icatch_3304032405-resized

CentOS に yum-plugin-priorities プラグインをインストールする

yum を使ってあるパッケージをインストールしようと調べていたところ、yum-plugin-prio

記事を読む

icatch-_9692711856-resized

シェルスクリプトでメールを送信する

このブログを運用している Linux サーバの監視スクリプトを作成した記事を書きました。 ロード

記事を読む

Googleアドセンス用(PC)

Message

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です


四 − 1 =

次のHTML タグと属性が使えます: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Googleアドセンス用(PC)

icatch-jersey_multi_pathparams
Jerseyの@PathParamはスラッシュの間に複数指定できる

http://hoge-api/user/{id}.{format}

icatch-vagrant_box_customize
VagrantのBoxファイルをカスタマイズして独自のBoxファイルを作成する

配布されている Vagrant の Box ファイルを使って検証環境を

icatch-2015-006-1
バリデーションチェックにJava8のOptionalを使ってスマートに書く(自分比)

Web アプリのバリデーションチェックにアノテーションを使うことが増え

icatch-2015-005-1
ユニットテストの偏りを防ぐ命名規則の付け方

ユニットテスト名に以下の命名規則を付けるようにして二ヶ月ぐらい経った。

icatch-2015-004-1
Vagrantで起動したCentOS上のOctopressをホストOSから確認する設定

タイトルの通りだが、Vagrant を使って起動した CentOS に

→もっと見る

PAGE TOP ↑