來自：碼農(nóng)網(wǎng) 譯文鏈接：http://www./article/good-java-test.html 英文原文：https:///articles/anatomy-of-a-good-java-test 翻譯作者：碼農(nóng)網(wǎng) – 小峰
作為測(cè)試驅(qū)動(dòng)設(shè)計(jì)和開發(fā)的忠實(shí)粉絲，我相信創(chuàng)造良好的測(cè)試是我們作為Java開發(fā)人員可以做的最重要的事情之一。我們寫測(cè)試出于許多原因：
塑造系統(tǒng)的設(shè)計(jì)。我們知道輸入和輸出應(yīng)該是什么樣的，但是我們需要?jiǎng)?chuàng)建什么對(duì)象來做到這一點(diǎn)呢？代碼應(yīng)該塑造成什么樣的“形狀”？編寫測(cè)試可以讓我們知道應(yīng)該創(chuàng)建什么樣的代碼。 為了確保初始和持續(xù)的正確性。讓我們的應(yīng)用程序如期望地那樣運(yùn)作并且始終如一地精確很重要。測(cè)試應(yīng)該竭力確保做到這一點(diǎn)。 文檔。測(cè)試是系統(tǒng)的文檔，因?yàn)樗鼤?huì)說明它應(yīng)該做什么以及應(yīng)該怎么做。
那么“好的測(cè)試”到底是什么樣子的呢？
給測(cè)試命名
測(cè)試的名字至關(guān)重要，特別是從文檔角度來看的話。我們應(yīng)該能夠大聲讀出測(cè)試的名字就像一組需求一樣。事實(shí)上，有一個(gè)偉大的IntelliJ插件，叫Enso，它會(huì)將你的測(cè)試名轉(zhuǎn)變?yōu)榍『梦挥诿總€(gè)類旁邊的語句，這樣你就可以明明白白地看到你在做什么。
不要以“test”開始命名測(cè)試的名稱。這是來自于JUnit初期的后遺癥，當(dāng)需要它執(zhí)行的時(shí)候。你的Test類將在Test文件夾中，在一個(gè)最后有Test這個(gè)單詞的類中。會(huì)有一個(gè)@Test的注解。我們知道這是一個(gè)測(cè)試。
你也應(yīng)該避免以“should”或“will”開頭。這些都是干擾詞。既然你已經(jīng)為這個(gè)功能寫了一個(gè)測(cè)試，那我們就知道它“should或will”工作（如果不能工作的話，那我們知道我們需要修復(fù)它）。
將測(cè)試名稱當(dāng)作一個(gè)要求。 下面是一些例子
addingNumbersWillSumValuesTogether() explodesOnNegativeID() notifiesListenersOnUpdates()
不要害怕表達(dá)出來。如果你的測(cè)試名稱確實(shí)需要很長的一串單詞，那就這么做，只要它能清楚說明將發(fā)生什么事情。
測(cè)試代碼
測(cè)試將分為3個(gè)部分：設(shè)置，操作，斷言。
設(shè)置
對(duì)你的測(cè)試設(shè)置代碼應(yīng)該只與在測(cè)試中被斷言的值相關(guān)。如果你有多余的設(shè)置代碼，那就會(huì)搞不清楚它是什么，并且與測(cè)試不相關(guān)。
這可以通過多種方式實(shí)現(xiàn)：
將通用設(shè)置移動(dòng)到使用@Before注解的具體設(shè)置方法。 將重復(fù)的設(shè)置代碼移動(dòng)到輔助方法 使用Maker來創(chuàng)建復(fù)雜的測(cè)試對(duì)象，并只設(shè)置測(cè)試中相關(guān)的值。 我重申一下：每個(gè)測(cè)試的設(shè)置部分應(yīng)該只有與最后被斷言的值相關(guān)的代碼。
不好的例子：
@Test public void returnsBooksWherePartialTitleMatchesInAnyCast(){ Bookstore bookstore = new Bookstore(); Book harryPotterOne = new Book('Harry Potter and The Philosopher Stone'); bookstore.add(harryPotterOne); bookstore.add(new Book('Guardians of the Galaxy')); Book harryPotterTwo = new Book('The Truth about HARRY POTTER'); bookstore.add(harryPotterTwo); List results = bookstore.findByTitle('RY pot'); assertThat(results.size(), is(2)); assertThat(results, containsInAnyOrder(harryPotterOne, harryPotterTwo)); }
書店的初始化發(fā)生在測(cè)試中，書本的創(chuàng)建也是。這讓測(cè)試顯得混亂不堪，讓人搞不清楚發(fā)生了什么事情。
好的例子：
private Bookstore bookstore = new Bookstore(); private Book aHarryPotterBook = new Book('Harry Potter and The Philosopher Stone'); private Book anotherHarryPotterBook = new Book('The Truth about HARRY POTTER'); private Book aBook = new Book('Guardians of the Galaxy'); @Test public void returnsBooksWherePartialTitleMatchesInAnyCast(){ bookstore.add(aHarryPotterBook); bookstore.add(aBook); bookstore.add(anotherHarryPotterBook); List results = bookstore.findByTitle('RY pot'); assertThat(results.size(), is(2)); assertThat(results, containsInAnyOrder(aHarryPotterBook, anotherHarryPotterBook)); }
初始化發(fā)生在字段中，這樣在測(cè)試中發(fā)生了什么一清二楚。
操作
小菜一碟！最好保持到一行，你要進(jìn)行測(cè)試的獨(dú)立操作。有時(shí)候，你專門測(cè)試的是輸出是什么，如果某些東西被多次調(diào)用，或者在某些優(yōu)先操作之后調(diào)用的結(jié)果是什么，所以這不是一個(gè)硬性規(guī)定。當(dāng)讀取測(cè)試時(shí)，用戶應(yīng)該快速而輕松地能說“將這些值設(shè)置成這樣，如果我執(zhí)行這個(gè)操作/這些操作，那么這是預(yù)期的結(jié)果”。在上面的例子中，便是bookstore.findByTitle()方法。
斷言
使用Hamcrest。 Hamcrest是一個(gè)很棒的庫，給我們一個(gè)流暢的API用來寫入測(cè)試。不會(huì)像這樣的代碼：
assertEquals(results.size(), 2); assertTrue(results.contains(aHarryPotterBook)) assertTrue(results.contains(anotherHarryPotterBook))
我們可以一目了然、輕松地閱讀像這樣的代碼：
assertThat(results.size(), is(2)); assertThat(results, containsInAnyOrder(aHarryPotterBook, anotherHarryPotterBook));
這些相當(dāng)簡(jiǎn)單的例子：Hamcrest有很多偉大的方法，使編寫復(fù)雜測(cè)試變得很容易，并允許你創(chuàng)建自己的匹配器。
當(dāng)然，理想情況下，我們希望有一個(gè)獨(dú)立的斷言。這可以讓我們知道我們正在測(cè)試什么，并說明我們的代碼沒有意外情況。就像這篇文章中所說的那樣，這不是一個(gè)硬性的規(guī)則，因?yàn)樵谀承┣闆r下，這是必要的，但如果你有這樣一個(gè)的測(cè)試：
assertThat(orderBook.bids.size(), is(4)); assertThat(orderBook.asks.size(), is(3)); assertThat(orderBook.bids.get(0).price, is(5200)); assertThat(orderBook.asks.get(2).price, is(10000000)); assertThat(orderBook.asks.get(2).isBuy, is(false));
那么要理解測(cè)試哪里失敗或哪條斷言重要就變得困難多了。
你也可以在Hamcrest中編寫自定義的匹配器，因?yàn)镠amcrest可為復(fù)雜斷言提供一個(gè)優(yōu)雅的解決方案。如果你需要在一個(gè)循環(huán)中運(yùn)行斷言，或者你有大量的字段要斷言，那么一個(gè)自定義的匹配器可能才是上上之選。
一個(gè)測(cè)試的最重要的部分之一是，當(dāng)它失敗時(shí)，哪怕是一個(gè)5歲孩子也應(yīng)該看得出什么地方出了錯(cuò)以及哪里錯(cuò)了。失敗的消息一定不能含糊。關(guān)于這方面的解決方法是：
如果做任何類型的對(duì)象比較，那么保證對(duì)象有一個(gè)體面的toString（）消息。沒有什么比不匹配更糟的了。
想要做的更好的話，可以對(duì)你的對(duì)象使用自定義匹配器。你可以準(zhǔn)確地知道哪些字段未能匹配。
確保明確為什么你要選擇和這個(gè)值作比較。例如，如果你正在將一個(gè)字段值與數(shù)字3000比較，那么為什么是3000？你應(yīng)該費(fèi)力地明白這一點(diǎn)。顯然，這個(gè)數(shù)字不是隨便得來的，并且還要確保該變量的命名可以顯示它的值是如何得來的。
所有這些都應(yīng)該是在一個(gè)適度的常識(shí)范圍內(nèi)。沒有嚴(yán)格規(guī)定！
●本文編號(hào)88，以后想閱讀這篇文章直接輸入88即可。 ●輸入m可以獲取到文章目錄。
|
