モッキートの静的メソッドのモック化 – パワーモック
モッキートは、モックオブジェクトを作成することを可能にします。静的メソッドはクラスに属するため、モッキートでは静的メソッドをモックする方法はありません。しかし、モッキートフレームワークにPowerMockを組み合わせることで、静的メソッドをモックすることができます。
パワーモックを使用して、モッキートを使って静的メソッドをモック化する方法
PowerMockは、Mockitoフレームワークを拡張し、JUnitとTestNGのテストケースを実行するためのさまざまなモジュールを提供します。ただし、PowerMockはまだJUnit 5をサポートしていないため、JUnit 4のテストケースを作成します。また、TestNGをMockitoとPowerMockと統合する方法も学びます。
パワーモックの依存関係
私たちは、Mockitoで静的メソッドをモック化するために、以下のPowerMockの依存関係が必要です。
- powermock-api-mockito2: This is the core PowerMock dependency and used to extend Mockito2 mocking framework. If you are using Mockito 1.x versions then use powermock-api-mockito module.
- powermock-module-junit4: For running JUnit 4 test cases using PowerMock.
- powermock-module-testng: For running TestNG test cases and supporting PowerMock.
以下は、私たちのプロジェクトの最終的な pom.xml です。
<project xmlns="https://maven.apache.org/POM/4.0.0"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.scdev.powermock</groupId>
<artifactId>PowerMock-Examples</artifactId>
<version>0.0.1-SNAPSHOT</version>
<properties>
<testng.version>6.14.3</testng.version>
<junit4.version>4.12</junit4.version>
<mockito-core.version>2.19.0</mockito-core.version>
<powermock.version>2.0.0-beta.5</powermock.version>
<java.version>10</java.version>
</properties>
<dependencies>
<!-- TestNG -->
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<version>${testng.version}</version>
<scope>test</scope>
</dependency>
<!-- JUnit 4 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit4.version}</version>
<scope>test</scope>
</dependency>
<!-- Mockito 2 -->
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>${mockito-core.version}</version>
<scope>test</scope>
</dependency>
<!-- PowerMock TestNG Module -->
<dependency>
<groupId>org.powermock</groupId>
<artifactId>powermock-module-testng</artifactId>
<version>${powermock.version}</version>
<scope>test</scope>
</dependency>
<!-- PowerMock JUnit 4.4+ Module -->
<dependency>
<groupId>org.powermock</groupId>
<artifactId>powermock-module-junit4</artifactId>
<version>${powermock.version}</version>
<scope>test</scope>
</dependency>
<!-- PowerMock Mockito2 API -->
<dependency>
<groupId>org.powermock</groupId>
<artifactId>powermock-api-mockito2</artifactId>
<version>${powermock.version}</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.7.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.0</version>
<dependencies>
<dependency>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire-junit47</artifactId>
<version>2.22.0</version>
</dependency>
<dependency>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire-testng</artifactId>
<version>2.22.0</version>
</dependency>
</dependencies>
<configuration>
<additionalClasspathElements>
<additionalClasspathElement>src/test/java/</additionalClasspathElement>
</additionalClasspathElements>
<!-- TestNG Test Fails when executed from command line with message
"Cannot use a threadCount parameter less than 1"
Works when threadCount is explicitly specified
https://gist.github.com/juherr/6eb3e93e2db33979b7e90b63ddadc888-->
<threadCount>5</threadCount>
</configuration>
</plugin>
</plugins>
</build>
</project>
注意してください、私はPowerMockの2.0.0-beta.5のバージョンを使用しています。このバージョンはJava 10をサポートしていますが、まだベータ版なので、複雑な場合には問題が発生する可能性があります。現在の安定版1.7.xを使用しようとしたときに、次のエラーが発生しました。
java.lang.NoSuchMethodError: org.mockito.internal.handler.MockHandlerFactory.createMockHandler(Lorg/mockito/mock/MockCreationSettings;)Lorg/mockito/internal/InternalMockHandler;
at org.powermock.api.mockito.internal.mockcreation.DefaultMockCreator.createMethodInvocationControl(DefaultMockCreator.java:114)
at org.powermock.api.mockito.internal.mockcreation.DefaultMockCreator.createMock(DefaultMockCreator.java:69)
at org.powermock.api.mockito.internal.mockcreation.DefaultMockCreator.mock(DefaultMockCreator.java:46)
at org.powermock.api.mockito.PowerMockito.mockStatic(PowerMockito.java:73)
この例外に対して開かれているGitHubの問題は、issue1とissue2です。簡単なクラスを作成しましょう。そのクラスには静的メソッドがあります。
package com.scdev.mockito.staticmethod;
public class Utils {
public static boolean print(String msg) {
System.out.println("Printing "+msg);
return true;
}
}
JUnit Mockito PowerMockの例を示します。
PowerMockをMockitoとJUnit 4と統合するために、以下の手順を実施する必要があります。
- Annotate test class with @RunWith(PowerMockRunner.class) annotation.
- Annotate test class with @PrepareForTest and provide classed to be mocked using PowerMock.
- Use PowerMockito.mockStatic() for mocking class with static methods.
- Use PowerMockito.verifyStatic() for verifying mocked methods using Mockito.
こちらは、JUnitのテストケースでMockitoとPowerMockを使用して静的メソッドを嘲笑できる完全な例です。
package com.scdev.mockito.staticmethod;
import static org.junit.Assert.assertFalse;
import static org.junit.Assert.assertTrue;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.Mockito.atLeast;
import static org.mockito.Mockito.when;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.powermock.api.mockito.PowerMockito;
import org.powermock.core.classloader.annotations.PrepareForTest;
import org.powermock.modules.junit4.PowerMockRunner;
@RunWith(PowerMockRunner.class)
@PrepareForTest(Utils.class)
public class JUnit4PowerMockitoStaticTest{
@Test
public void test_static_mock_methods() {
PowerMockito.mockStatic(Utils.class);
when(Utils.print("Hello")).thenReturn(true);
when(Utils.print("Wrong Message")).thenReturn(false);
assertTrue(Utils.print("Hello"));
assertFalse(Utils.print("Wrong Message"));
PowerMockito.verifyStatic(Utils.class, atLeast(2));
Utils.print(anyString());
}
}
テストNGモッキートパワーモックの例
テストケースにおいて、TestNGでは@RunWithのアノテーションを使用する必要はありません。テストクラスがPowerMockTestCaseを拡張するようにするため、PowerMockObjectFactoryがテストクラスのインスタンスを作成する必要があります。
package com.scdev.mockito.staticmethod;
import static org.testng.Assert.assertFalse;
import static org.testng.Assert.assertTrue;
import static org.mockito.Mockito.*;
import org.powermock.api.mockito.PowerMockito;
import org.powermock.core.classloader.annotations.PrepareForTest;
import org.powermock.modules.testng.PowerMockTestCase;
import org.testng.annotations.Test;
@PrepareForTest(Utils.class)
public class TestNGPowerMockitoStaticTest extends PowerMockTestCase{
@Test
public void test_static_mock_methods() {
PowerMockito.mockStatic(Utils.class);
when(Utils.print("Hello")).thenReturn(true);
when(Utils.print("Wrong Message")).thenReturn(false);
assertTrue(Utils.print("Hello"));
assertFalse(Utils.print("Wrong Message"));
PowerMockito.verifyStatic(Utils.class);
Utils.print("Hello");
PowerMockito.verifyStatic(Utils.class, times(2));
Utils.print(anyString());
}
}
以下の内容を日本語で自然な言い方に言い換えてください。1つのオプションだけで大丈夫です:
要約
PowerMockは、Mockitoの拡張機能を提供しており、そのうちの1つは静的メソッドのテスト機能です。また、JUnit 4とTestNGとの統合も容易です。ただし、JUnit 5については近い将来のサポート予定はありません。
私達のGitHubリポジトリから、完全なプロジェクトをダウンロードすることができます。