10.1. 単体テスト概要

10.1.1. はじめに

本章では、Macchinetta Server Framework (1.x)を使用したシステムにおける、JUnitを用いた単体テストについて提示する。

ここでの単体テストのスコープはレイヤまたはレイヤ間結合とし、テストに関するアクティビティのうち、テスト実装と テスト実施に関して解説する。 なお、解説するテスト実装は参考例でありシステムの品質を保証するためのテスト方針については、別途検討いただきたい。

10.1.2. 単体テストガイドラインが示すこと

本章では、以下のOSSライブラリを使用したレイヤまたはレイヤ間のテスト実装方法について説明する。

10.1.2.1. 単体テストで利用するOSSライブラリ構成

10.1.2.1.1. テスティングフレームワーク

Javaのテスティングフレームワークとして、JUnitを使用する。

10.1.2.1.2. アサーション

アサーションに使用するライブラリとしてHamcrestを使用する。 JUnit4が標準でサポートしているアサーションライブラリである。

10.1.2.1.3. モック化

テスト対象のメソッドが依存するクラスをモック化するためのライブラリとしてMockitoを使用する。

10.1.2.1.4. DIコンテナ

テスト用のDIコンテナとして Spring TestのDI機能を使用する。

10.1.2.1.5. MVCフレームワーク

テスト用のMVCフレームワークとして Spring MVC Test Frameworkを使用する。

10.1.2.1.6. トランザクション管理

テスト用のトランザクション管理として Spring Testのトランザクション管理機能を使用する。

10.1.2.1.7. データアクセス

テスト用のデータアクセスとして、Spring TestまたはDBUnitとSpring Test DBUnitを使用することを想定している。

  • Spring Test
    • Spring Testは@SqlアノテーションやJdbcTemplateなどを使用してSQLを発行する機能を提供している。
  • DBUnitSpring Test DBUnit
    • Spring Test DBUnitは、Spring Framework上でDBUnitを利用する際の支援ライブラリのため、DBUnitと組み合わせて使用する。 DBUnitの提供するデータベースのセットアップ、状態の検証などの機能をアノテーションベースで実装する機能を提供している。

10.1.2.2. 単体テストで利用するOSSライブラリのバージョン

単体テストで利用するOSSライブラリの一覧を以下に示す。

なお、以下のOSSライブラリはあくまで一例であり、実際は業務要件に合わせたライブラリを検討いただきたい。 また、本章内のアプリケーション自体を動作させるために利用するOSSライブラリ一覧については、 利用するOSSのバージョンを参照されたい。

Tip

version 1.1.0.RELEASEより、Spring IO platform<dependencyManagement>をインポートする構成を採用している。

Spring IO platformの<dependencyManagement>をインポートすることで、

  • Spring Frameworkが提供しているライブラリ
  • Spring Frameworkが依存しているOSSライブラリ
  • Spring Frameworkと相性のよいOSSライブラリ

への依存関係を解決しており、Macchinetta Server Framework (1.x)で使用するOSSのバージョンは、原則として、 Spring IO platformの定義に準じている。

なお、version 1.5.1.RELEASEで指定しているSpring IO platformのバージョンは、 Brussels-SR5である。


以下のOSSライブラリの中で、特にSpring Test(MockMvc)、Mockitoの使い方については、単体テストで利用するOSSライブラリの使い方で詳細を説明する。

Type GroupId ArtifactId Version Spring IO platform
JUnit junit junit 4.12 *
Hamcrest org.hamcrest hamcrest-core 1.3 *
Hamcrest org.hamcrest hamcrest-library 1.3 *
Mockito org.mockito mockito-core 1.10.19 *
Spring Test org.springframework spring-test 4.3.14.RELEASE *
DBUnit org.dbunit dbunit 2.5.4
Spring Test DBUnit com.github.springtestdbunit spring-test-dbunit 1.3.0

10.1.2.3. 単体テストの実装

単体テストはアプリケーションのレイヤ化に沿った以下のレイヤ単位で実装している。レイヤまたはレイヤ間のテスト方法を レイヤごとのテスト実装で説明する。 レイヤ単位に当てはめられない共通機能や、機能特有のテスト方法は、機能ごとのテスト実装で説明する。

../_images/UnitTestOverviewApplicationLayer.png

10.1.3. 対象読者

本章は、このドキュメントの対象読者に加えて以下の知識・経験があることを前提としている。

  • JUnitを使用した単体テストを行ったことがある

10.1.4. 単体テストの動作検証環境

本章は、以下の環境で動作検証をしている。 他の環境で実施する際は、本章をベースに適宜読み替えること。

種別 名前
OS Windows 7
JVM Java 1.8.0_144
IDE Spring Tool Suite 3.9.1.RELEASE (以降「STS」と呼ぶ)
Build Tool Apache Maven 3.3.9 (以降「Maven」と呼ぶ)
RDBMS PostgreSQL 9.6.5