Presentation for Using Unit Testing to test your code with closer scope over JUnit Testing for Java

1. {
Introduction to unit
testing
What is unit testing,
and how we doing it.
Ahmed Gomaa
Ahmed.mgomaaa@gmail.com
Jul 16, 2013 (v 1.2)

2.  What is unit testing
 Unit Testing
 Test Suit
 Why unit testing
 Frameworks & JUnit
 Code Coverage
 How we doing it
 Installation of JUnit
 Naming
 Creating test unit
 Creating test suit
 Running the test
 Test Automation
Content

3. What is unit testing

4.  A unit test is a piece of code written by a developer that
executes a specific functionality in the code which is tested.
The percentage of code which is tested by unit tests is
typically called test coverage.
 Unit tests target small units of code, e.g. a method or a class,
(local tests) whereas component and integration tests targeting
to test the behavior of a component or the integration between
a set of components or a complete application consisting of
several components.
 Unit tests ensure that code works as intended. They are also
very helpful to ensure that the code still works as intended in
case you need to modify code for fixing a bug or extending
functionality. Having a high test coverage of your code allows
you to continue developing features without having to
perform lots of manual tests.
Unit Test

5.  The test suit is a group of test cases combined
tests a certain functionality or module.
 The relation between test cases and test suit is
many to many, as one test case can be part of
multiple test suits.
Test Suite

6.  Faster Development
 Higher Quality
 More flexibility
 Easer Development (specially for newcomers)
 Test Driven Development
Why unit testing!

7.  Unit testing have a lot of frameworks that help
simplify the process of unit testing and help in
testing automation.
 JUnit is a simple framework to write repeatable
tests. It is an instance of the xUnit architecture for
unit testing frameworks.
 JUnit is open source project can easily be used and
automated, and it is also has plugins for most of
IDEs (like: eclipse and net beans).
 JUnit is the most used unit testing framework.
 Since JUnit 4, it is using the annotations to define the
unit tests and test suits.
Frameworks & JUnit

8.  Code Coverage represents the amount of the code
covered by unit testing.
 JaCoCo:
 JaCoCo is an open source toolkit for measuring and
reporting Java code coverage.
 JaCoCo is a java tool (command line) used to check
the code coverage.
 EclEmma:
 EclEmma is a free Java code coverage plugin for
Eclipse.
 EclEmma was originaly based on EMMA code
coverage tool, since v2.0 is based in JaCoCo.
Code Coverage

9. How we do it

10.  The only thing you need to do is to add 2 JARs:
 junit.jar
 hamcrest-core.jar
 > download: https://github.com/junit-
team/junit/wiki/Download-and-Install
Installation of JUnit

11.  Unit testes will be created inside the same project
with the same packages and classes naming, except:
1. It will be under a root package called “unitTest”.
2. Test unit will be suffixed with “TestUnit”.
3. Test suit will be suffixed with “TestSuit”.
 Example:
 Business Class (class will be tested):
net.tedata.webservices.getCustomerInfo.GetCustomerI
nfo
 Unit Test Class:
unitTest.net.tedata.webservices.getCustomerInfo.GetC
ustomerInfoTestUnit
Naming

12.  Unit test class is not required to inherit or
extend any other class or interface.
 Only the test methods need to be annotated
with “@Test” annotation.
 JUnit assumes that all test methods can be
executed in an arbitrary order. Therefore tests
should not depend on other tests.
 Adding test methods (fail, or asserts).
Creating test unit

13.  Example Method:
Creating test unit
@Test
public void testMultiply() {
// MyClass is tested
MyClass tester = new MyClass();
// Check if multiply(10,5) returns 50
assertEquals("10 x 5 must be 50", 50, tester.multiply(10, 5));
}

14.  List of JUnit annotations:
1. @Test: The annotation @Test identifies that a method is
a test method.
2. @Test(expected = Exception.class): Fails, if the method
does not throw the named exception.
3. @Test(timeout=100): Fails, if the method does not
throw the named exception.
4. @Ignore: Ignores the test method. This is useful when
the underlying code has been changed and the test
case has not yet been adapted. Or if the execution time
of this test is too long to be included.
5. @Before, @After, @BeforeClass, @AfterClass: Before and
after will run before every test method run, and class
ones will run once before all the test cases run and this
method should be static.
Creating test unit

15.  Assert Statements (methods) list:
1. fail(String): Let the method fail. Might be used to check that a
certain part of the code is not reached. Or to have a failing test
before the test code is implemented.
2. assertTrue([message], boolean condition): Checks that the boolean
condition is true.
3. assertsEquals([String message], expected, actual): Tests that two
values are the same. Note: for arrays the reference is checked not
the content of the arrays.
4. assertsEquals([String message], expected, actual, tolerance): Test
that float or double values match. The tolerance is the number of
decimals which must be the same.
5. assertNull([message], object): Checks that the object is null.
6. assertNotNull([message], object): Checks that the object is not
null.
7. assertSame([String], expected, actual): Checks that both variables
refer to the same object.
8. assertNotSame([String], expected, actual): Checks that both
variables refer to different objects.
Creating test unit

16.  The test suit has 2 annotations:
1. @RunWith(Suite.class): Fixed
annotation
2. @SuiteClasses({
MyClassTestCases.class }): contains
the list of the test cases to run.
 Example:
Creating Test Suit
@RunWith(Suite.class)
@SuiteClasses({ MyClassTest.class, MySecondClassTest.class })
public class AllTests { }

17.  From Eclipse (using plugin):
 Right click on the test case or the suit.
 Then “Run As”
 Then “JUnit Test”
 Outside Eclipse:
 Example:
Running the test

18.  JUnit testing already can be automated by both
Ant and Maven.
Test Automation

19. Questions!

20.  JUnit tutorial:
 http://www.vogella.com/articles/JUnit/article.html
 JUnit official web site:
 http://junit.org
 List of unit testing frameworks:
 http://en.wikipedia.org/wiki/List_of_unit_testing_frameworks
 Java Code Coverage Tools:
 https://en.wikipedia.org/wiki/Java_Code_Coverage_Tools
 EclEmma:
 http://www.eclemma.org/
 Eclipse Update Site: http://update.eclemma.org/
 It is also available on Eclipse market place.
 JaCoCo:
 Home: http://www.eclemma.org/jacoco/
 Git Hub: https://github.com/jacoco
References