junit - files.meetup.comfiles.meetup.com/1566558/2013-05 junit.pdf · junit status release date...

JUnitThe Other Stuff

Charles Sharp, OCIMay 9, 2013

Thursday, June 6, 13

Yay! An Ad!Java Testing with JUnit

www.ociweb.com/training/Java-Testing-with-JUnit

July 9 - July 18T/Th, 5:30 – 8:30

Mention the JUG and get 10% off!


http://www.ociweb.com/training/Java-Testing-with-JUnit

http://www.ociweb.com/training/Java-Testing-with-JUnit

JUnit StatusRelease Date4.11 Nov 14, 20124.10 Sep 29, 20124.9 Aug 22, 20114.8 Nov 30, 20094.7 Jul 27, 20094.6 Apr 13, 20094.5 Aug 8, 20084.4 Jul 19, 20074.3 Mar 20, 20074.2 Nov 16, 20064.1 May 2, 20064.0 Feb 16, 20063.8.2 Mar 3, 20063.8.1 Sep 4, 2002


JUnit Annotations• @Before

• @BeforeClass

• @After

• @AfterClass

• @Ignore

• @Test

• @Test(timeout=500)

• @Test(expected=<Exception>.class)


Everyone Uses • @Before fka setUp()

• @After fka tearDown()

• @Test fka test<something>()


Some Use• @BeforeClass

• @AfterClass


Quiz!


Tonight• Assumptions

• Categories

• Parameterized Testing

• Parameter

• Theory

• Rules

• Hamcrest Matchers


Everyone Uses Asserts• assertEquals(...) / assertArrayEquals(...)

• assertNull(...) / assertNonNull(...)

• assertSame(...) / assertNotSame(...)

• assertTrue(...) / assertFalse(...)

• fail(“Not implemented yet.”);


Not a whole lot of folk useassertThat([java.lang.string Reason],

T actual, org.hamcrest.matcher<T> matcher)

(more on Hamcrest in just a bit)


Hardly anyone uses • Assume:

• assumeNoException(...)

• assumeNotNull (...)

• assumeThat(...) // used a lot in @Theory

• assumeTrue(...)

Unlike Asserts, if an assumption is wrong, the test is halted and ignored.


@Category

• Canonical example is fast and slow

• Browser: Firefox, Chrome, Opera, others

• Database: DB2, Oracle, &c...

Gives the ability to group tests.- exclude a group- include a group


Category Example


Parameterized Testing

• @RunWith(Parameters.class)

• @RunWith(Theory.class)


Parameter.class• Pros:

• Quick to write

• No need to establish relationships

• Cons:

• Must detail all data


Parameter.class• Static Method to Generate Test

Data

• Single Constructor that stores test data

• Test(s)


Parameterized Example


Theory.class• Cons:

• Not (typically) quick to write

• Must understand data relationships

• Pros?:

• Don’t need to detail all data


Theory.class

• Method to generate and return test data

• Theory(s)


Theory Example


Rules• Add information to test results.

• Access information about a test before it is run

• Modify a test before running it.

• Modify test results.


Rules Examples


Hamcrest

What an odd name...


Matchers

or not.


Hamcrest Matchers• hamcrest.org (/JavaHamcrest/javadoc/1.3/)

• General purpose matching library for Java, Python, Ruby, Objective-C, PHP, and Erlang (What? No Haskell?)

• Provides readability

• code

• error messages


Hamcrest Cheat Sheet

http://www.marcphilipp.de/downloads/posts/2013-01-02-hamcrest-quick-reference/Hamcrest-1.3.pdf








Matcher Types• General Purpose:

is(T), not(T), any(T), isIn(T), instanceOf(Class)

• Strings:

startsWith(S), endsWith(S)equalToIgnoringCase(S), equalToIgnoringWhiteSpace(S)isEmptyString(), isEmptyOrNullString()


More matchers• Iterables:

contains(E ...) // (oh, boy, howdy...)

containsInAnyOrder(T ...)

hasItem(T) // Yay!

hasItems(T ...)


And more...• Collections:

hasSize(int)

empty()

emptyCollectionOf(Class<E>)


And many more...• Arrays

• Comparable

• Classes

• DOM

• Maps

• Numbers


Tonight• Assumptions

• Categories

• Parameterized Testing

• Parameter

• Theory

• Rules

• Hamcrest Matchers


junit - files.meetup.comfiles.meetup.com/1566558/2013-05 junit.pdf · junit status release date...

Documents