當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

「译」JUnit 5 系列：环境搭建

發布時間：2025/3/15 编程问答 32 豆豆

生活随笔收集整理的這篇文章主要介紹了「译」JUnit 5 系列：环境搭建小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

原文地址：http://blog.codefx.org/libraries/junit-5-setup/
原文日期：15, Feb, 2016
譯文首發：Linesh 的博客：環境搭建
我的 Github：http://github.com/linesh-simplicity

2015年11月，Junit Lambda 團隊發布了該項目的第一版原型。此后，該項目把名稱改成了 JUnit 5 并獨立了出來，隨后在2016年2月份的時候發布了一個 alpha 版本。本篇打算以一系列文章，簡短地探索一下以下幾個方面：

環境搭建
基礎入門
架構體系
擴展模型（Extension Model)
條件斷言
注入
動態測試
...

（如果不喜歡看文章，你可以戳這里看我的演講，或者看一下最近的 vJUG 講座，或者我在 DevoxxPL 上的 PPT。

本篇將介紹 JUnit 5 的環境搭建，看完之后你應該能夠使用新的 API 來撰寫測試，并且使用你喜歡的 IDE 或構建工具來跑這些測試了。

概述

本系列文章都基于 Junit 5發布的先行版 Milestone 2。它可能會有變化。如果有新的里程碑（milestone）版本發布，或者試用版正式發行時，我會再來更新這篇文章。

這里要介紹的多數知識你都可以在 JUnit 5 用戶指南中找到（這個鏈接指向的是先行版 Milestone 2，想看的最新版本文檔的話請戳這里），并且指南還有更多的內容等待你發掘。下面的所有代碼都可以在我的 Github 上找到。

第一個測試

支持測試撰寫的 API 包含在junit-jupiter-api 包中。在構建工具中引入這個包，就行了。這就是全部，你就可以開始寫測試了。

Group ID: org.junit.jupiter
Artifact ID: junit-jupiter-api
Version: 5.0.0-M2

我們來寫第一個測試吧，此處簡單最好：

package org.codefx.demo.junit5;import org.junit.jupiter.api.Test;class HelloWorldTest {@Testvoid helloJUnit5() {System.out.println("Hello, JUnit 5.");}}

看起來怎樣？沒 public ，感覺帥氣不？這里我不會太深入細節講解，不過下一篇我會深入討論下這個（以及其他的一些基礎）。請別急，接著往下看。

運行測試

JUnit 5 是一代全新的測試框架，不過工具內置的支持則還未完全跟上。好在目前已有簡易的方法來運行 JUnit 5 及其測試。

使用 JUnit 4 runner

JUnit 團隊提供了一個 JunitPlatform runner，可以使用它在 Junit 4 上運行 JUnit 5 的測試。這個 runner 在另一個包下，因此你也必須將它加入到你的項目中：

Group ID: org.junit.platform
Artifact ID: junit-platform-runner
Version: 1.0.0-M2

這個 runner 最終會調用 Junit 引擎，后者才是真正運行 Junit 5 測試的部分。引擎也是在不同的包下，你也必須將它加入到項目中：

Group ID: org.junit.jupiter
Artifact ID: junit-jupiter-engine
Version: 5.0.0-M2

要運行項目中所有的測試，為它們創建一個測試套件是最簡單的做法：

package org.codefx.demo.junit5;import org.junit.platform.runner.JUnitPlatform; import org.junit.platform.runner.SelectPackages; import org.junit.runner.RunWith;@RunWith(JUnitPlatform.class) @SelectPackages({ "org.codefx.demo.junit5" }) public class TestWithJUnit5 { }

不過請注意，這個類必須是一個 JUnit 4 的測試類，也即是說它必須遵循一般的命名規范，并且必須是 public 的。@SelectPackages 注解會把包當做一個有層級的結構，因此它會負責跑 org.codefx.demo.junit5 開頭的包下的所有測試。

至此所有工作都完成了！你的 IDE 和構建工具應該都能運行這個 @RunWith(JUnitPlatform.class) 注解的測試類了，它會負責跑所有的 JUnit 5 的新測試。

不過在 JUnit 5 被完全支持之前，一些特性可能還不能工作，比如 IDE 無法運行單獨的測試等。不過目前為止，這是我發現的最簡單并且在多平臺下均工作良好的方案了。

IDE 的支持

Intellij IDEA 2016.2 開始對 JUnit 5 有了基本的支持。盡管支持還不是很完美，并且還需時刻關注 JUnit 5 的發展，不過畢竟最基本的支持有了，現在使用 JUnit 5 已經簡單得多了。

Eclipse 方面團隊仍在著手于內置支持的開發。

構建工具的支持

JUnit 團隊在為構建工具提供 JUnit 5 支持的基礎上已經做了大量的工作，比如提供與 JUnit 4 的兼容等。目前，我們已經有了一個可以工作的 Gradle 插件和 Maven Surefire 插件。這兩個項目都計劃在接下來的時間里交給各自的社區去開發和維護。

在如何集成這兩個構建工具（Gradle和Maven）的插件上，已經各有一個示例代碼庫。更多細節請前往官方用戶指南。

命令行支持也不賴

如果你覺得你就想靜靜地跑個測試，上面介紹的 IDE 和構建工具都太復雜了，那么建議你試下這個控制臺 launcher，它支持你直接在命令行運行測試。要使用它，請下載這個 zip 包。

遺憾的是，它還需要你做些配置，而非拿來即用的。你需要將上面提到的兩個包 junit-jupiter-api 和 junit-jupiter-engine 移動到 lib 目錄下，并編輯 bin 下執行腳本的 classpath 使其指向你的 lib 目錄：CLASSPATH=$APP_HOEM/lib/*。這樣該 launcher 才能運行。

不考慮其他依賴的話，這個執行腳本大概長得像這樣：

# run all tests junit-platform-console -p ${path_to_compiled_test_classes} -a # run a specific test junit-platform-console-p ${path_to_compiled_test_classes}org.codefx.demo.junit5.HelloWorldTest

向下兼容性

你可能注意到了，JUnit 5 啟用了新的包名：org.junit.jupiter、org.junit.platform 和 org.junit.vintage （這個包我們尚未談到）。我們待會再討論它們的含義，現在我們只需知道，這意味著你可以在一個項目中使用不同的 JUnit 版本，這就夠了。

允許在同個項目中使用多個版本的 JUnit 來進行測試，這使得你能緩緩遷移到 JUnit 5上。關于遷移，我們在探討 JUnit 新的架構時會再回顧這個話題。

通過異常（exceptions）于 JUnit 交互的測試庫，諸如 Hamcrest 和 AssertJ 等，易燃可以在 JUnit 的新版本下工作。這里有個使用 Mockito 和 AssertJ 寫的 HelloWorldTest 測試，有興趣的同學可以看下。

回顧

在這篇 JUnit 5 環境搭建的文章中，我們介紹了 junit-jupiter-api 和 junit-jupiter-engine 兩個包，在項目中使用了 junit-platform-runner ，寫了第一個最簡單的測試用例，并將它作為 JUnit 4 測試套件的一部分運行了起來。

下篇文章我會討論使用 JUnit 5 撰寫測試的一些基礎知識。

轉載于:https://www.cnblogs.com/natasha-yarovenko/p/5879628.html

總結

以上是生活随笔為你收集整理的「译」JUnit 5 系列：环境搭建的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

上一篇： grid列的值格式化
下一篇： sql server 触发器应用 ins