Aşağıdaki gibi bir sınıf olsun:
public class SimpleTest {
public int topla(int a, int b){
return a+b;
}
}
Kod sadece verilen iki sayıyı toplamaktadır. topla method'unun doğru çalıştığını test etmek için aşağıdaki gibi bir test sınıfı yazılabilir:
import org.junit.*;
import static org.junit.Assert.*;
public class Tester {
@Test
public void testTopla(){
SimpleTest simple=new SimpleTest();
int c=simple.topla(1,2);
assertEquals(3, c);
}
}
@Test annotation'ı bir fonksiyonun test kodu içerdiğini belirtir. Eclipse vb.. bir çok editor bu ifadeyi doğrudan çalıştırmanızı sağlayacak desteği bulunmkatadır.
Test fonksiyonu (testTopla) içinde SimpleTest sınıfının nesnesi yaratılıp, 1 ve 2 sayısı toplanmakta ve c'ye atanmaktadır. C değerinin 3 olmasını bekliyoruz aksi takdirde hata var demektir. JUnit'de koşulları test etmek için assert ile başlayan çok sayıda fonksiyon bulunur. Biz değerin 3 olmasını kontrol etmek istediğimizden assertEquals fonksiyonunu kullanıyoruz
Aşağıdaki gibi bir sınıfınız olsun :
public class SimpleTest {
public int topla(int a, int b){
return a+b;
}
public int carp(int a, int b){
return a*b;
}
}
Bu sınıf içindeki topla ve carp method'larını test eden sınıf aşağıdaki gibi yazılabilir:
import org.junit.*;
import static org.junit.Assert.*;
public class Tester {
SimpleTest simple=null;
@Before
public void setUp(){
simple=new SimpleTest();
}
@After
public void tearDown(){
simple=null;
}
@Test
public void testTopla(){
int c=simple.topla(1,2);
assertEquals(3, c);
}
@Test
public void testCarp(){
int c=simple.carp(1,2);
assertEquals(2, c);
}
}
Yukarıdaki örnekte, SimpleTest nesnesi setUp içinde yapılmaktadır. Bu şekilde her test öncesi nesne yaratılır ve test sonrası nesne null haline getirilir
Aşağıda basit bir test suite sınıfı örneği görülmektedir:
import org.junit.runner.*;
import org.junit.runners.*;
@RunWith(Suite.class)
@Suite.SuiteClasses({
Test1.class,
Test2.class,
Test3.class,
Test4.class
})
public class SimpleTestSuite {
// bu sınıfın dolu olmasına gerek yoktur
}
Test suite 4 test sınıfından oluşmaktadır ve test suite çalıştırıldığında testler sırasıyla çalıştırılacaktır
Aşağıdaki gibi iki java sınıfı bulunmaktadır:
public class Toplar {
public int topla(int a, int b){
return a+b;
}
}
public class Carpar {
public int carp(int a, int b){
return a*b;
}
}
Yukarıdaki iki sınıf için ayrı aşağıdaki gibi iki test sınıfı yapılmıştır:
import static org.junit.Assert.*;
import org.junit.*;
public class ToplaTest {
Toplar simple;
@Before
public void setUp(){
simple=new Toplar();
}
@Test
public void testTopla(){
int c=simple.topla(1,2);
assertEquals(3, c);
}
}
import static org.junit.Assert.*;
import org.junit.*;
public class CarpTest {
Carpar simple;
@Before
public void setUp(){
simple=new Carpar();
}
@Test
public void testCarp(){
int c=simple.carp(1,2);
assertEquals(2, c);
}
}
Yukarıdaki iki testi aynı anda çalıştırabilmek için aşağıdaki gibi bir suite yaratılabilir:
import org.junit.runner.*;
import org.junit.runners.*;
@RunWith(Suite.class)
@Suite.SuiteClasses({
ToplaTest.class,
CarpTest.class
})
public class IslemSuit {
}
Yukarıdaki suit, ToplaTest ve CarpTest sınıflarını içermektedir. IslemSuit çalıştırılırsa önce ToplaTest , ardından da CarpTest sınıfları çalışacaktır
Aşağıdaki gibi iki sayıyı toplayan bir methodu olan bir sınıfımız olsun:
public class Toplar {
public int topla(int a, int b){
return a+b;
}
}
Toplama işlemi sadece bir kere değil, birden fazla sayıda tekrarlanabilir. Bunun için aşağıdaki gibi bir test sınıfı yazılabilir:
import static org.junit.Assert.*;
import java.util.*;
import org.junit.*;
import org.junit.runner.*;
import org.junit.runners.*;
import org.junit.runners.Parameterized.*;
@RunWith(value = Parameterized.class)
public class ToplaTest {
private int number1;
private int number2;
private int expected;
public ToplaTest(int number1, int number2, int expected) {
this.number1=number1;
this.number2=number2;
this.expected=expected;
}
@Parameters(name = "{index}: topla({0}+{1})={2}")
public static Iterable data1() {
return Arrays.asList(new Object[][] {
{ 2, 2, 4 },
{ 10, 1, 11 },
{ 1, 1, 2 },
{ 100, 1, 101 }
});
}
@Test
public void testTopla(){
Toplar t=new Toplar();
int c=t.topla(number1,number2);
assertEquals(expected,c);
}
}
Her test için gerekli olan parametreler test sınıfın kurucusunda verilmektedir. Toplama örneğinde iki sayı ve toplama sonucu beklediğimiz sayı değerleri bulunmaktadır. Dikkat edilirse @Test ile belirtilen fonksiyon, number1, number2 ve expected şeklinde sınıf değişkenlerini kullanmaktadır. @Parameters ile kullanılacak farklı parametre örnekleri , bir Iterable
tipinde verilmiştir. {index}: add({0}+{1})={2} ifadesi ise ekrana basılması sırasında test adımının adı olacaktır. Test çalıştığında aşağıdaki gibi bir çıktı alınacaktır :
[0: topla(2+2)=4]
[1: topla(10+1)=11]
[2: topla(1+1)=2]
[3: topla(100+1)=101]
Aynı örneği kurucu kullanmak yerine değişkenleri public yapıp, @Parameter kullanarak da yapılabilir. Bu şekilde yapılırsa test sınıfı aşağıdaki gibi olur:
import static org.junit.Assert.*;
import java.util.*;
import org.junit.*;
import org.junit.runner.*;
import org.junit.runners.*;
import org.junit.runners.Parameterized.*;
@RunWith(value = Parameterized.class)
public class ToplaTest {
@Parameter
public int number1;
@Parameter(value = 1)
public int number2;
@Parameter(value = 2)
public int expected;
@Parameters(name = "{index}: topla({0}+{1})={2}")
public static Iterable data1() {
return Arrays.asList(new Object[][] {
{ 2, 2, 4 },
{ 10, 1, 11 },
{ 1, 1, 2 },
{ 100, 1, 101 }
});
}
@Test
public void testTopla(){
Toplar t=new Toplar();
int c=t.topla(number1,number2);
assertEquals(expected,c);
}
}
Dikkat edilirse kurucuya ihtiyaç yoktur
Aşağıdaki örnekteki test kodu sadece Windows işletim sistemi olan ortamda çalışacaktır:
@Test
public void windowsTest() {
assumeTrue(System.getProperty("os.name").toLowerCase().contains("win"));
// test kesilir, kosul gerceklesmedi
}
Aşğaıdaki gibi bir sınıfımız olsun:
public class Toplar {
public int topla(int a, int b){
return a+b;
}
}
Bu sınıfdaki topla methodu için Theory sınıfı aşağıdaki gibidir:
import org.junit.experimental.theories.*;
import org.junit.runner.*;
import static org.junit.Assert.*;
@RunWith(Theories.class)
public class TheoryTest {
@DataPoints public static int[] first = new int[] {1, 2};
@DataPoints public static int[] second = new int[] {3, 4};
@Theory
public void testTopla(int a, int b) {
System.out.println(a+"+"+b);
assertEquals(a+b, (new Toplar()).topla(a, b));
}
}
DataPoints ile kullanılabilecek veriler verilmektedir. Verilen iki sayının + ile toplaı ile toplam fonksiyonudan gelen değerlerin tutması gerekiyor. Test çalıştırıldığında tüm olasılıklar ekrana basılmıştır:
1+1
1+2
1+3
1+4
2+1
2+2
2+3
2+4
3+1
3+2
3+3
3+4
4+1
4+2
4+3
4+4
JUnit 5 ile basit bir test yapabilmek için aşağıdaki bağımlılığı eklemek gerekir:
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<version>5.4.0-M1</version>
<scope>test</scope>
</dependency>
Maven kullanmıyorsanız gerekli jar'ları eklemeniz gerekir.
5.4 versiyonu henüz geliştirme aşamasındadır. Bir önceki versiyon da kullanılabilir.
Test edilecek aşağıdaki gibi bir sınıf yapalım:
public class Hello {
public static String hello(String name) {
return "hello "+name;
}
}
Test kodu aşağıdaki gibidir:
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;
public class HelloTest {
@Test
public void helloTest() {
String result=Hello.hello("test");
assertEquals("hello test", result);
}
}
Eğer dönen metin "hello test" ise sonuç test başarılı olacaktır.
JUnit 5'de rule desteği kaldırılmıştır. TemporaryFolder gibi bazı ön tanımlı rule'lar da JUnit 5 kütüphanesinde artık bulunmamaktadır. Ancak 5.4.2 sürümünden sonra @TempDir şeklinde Temporary Folder desteği gelmiştir. 5.4.2 öncesi TemporaryFolder işlevini sağlamak için TemporaryFolder uzantısı (extention) yaratmanız gerekir. Veya junit-extensions projesini kullanabilirsiniz. Bu
github.com/glytching/junit-extensions ve
glytching.github.io/junit-extensions/index bağlantılarına bakabilirsiniz.
Öncelikle projeye bağımlılıkları aşağıdaki gibi ekleyebiliriz:
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<version>5.4.0-M1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.github.glytching</groupId>
<artifactId>junit-extensions</artifactId>
<version>2.3.0</version>
<scope>test</scope>
</dependency>
Öncelikle test edilecek bir sınıf yazalım. Bu sınıf bir properties dosyasını yükleyen bir sınıf olsun:
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;
public class PropertiesLoader {
private Properties properties=null;
public void load(String path)
throws FileNotFoundException, IOException {
properties=new Properties();
try(InputStream is=new FileInputStream(path)){
properties.load(is);
}
}
public String getProperty(String key) {
return properties.getProperty(key);
}
}
Bu sınıfı test etmek için TemporaryFolderExtension'ı kullanan bir test sınıfı aşağıdaki gibi yaratılabilir:
import static org.junit.jupiter.api.Assertions.assertEquals;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Properties;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import io.github.glytching.junit.extension.folder.TemporaryFolder;
import io.github.glytching.junit.extension.folder.TemporaryFolderExtension;
@ExtendWith(TemporaryFolderExtension.class)
public class PropertiesLoaderTest {
private static File file;
@BeforeAll
public static void prepare(TemporaryFolder givenTemporaryFolder) throws IOException {
file = givenTemporaryFolder.createFile("test.properties");
Properties properties=new Properties();
properties.put("test", "testvalue");
try(OutputStream os =new FileOutputStream(file)){
properties.store(os,"test properties");
}
}
@Test
@ExtendWith(TemporaryFolderExtension.class)
public void loadTest() throws IOException {
PropertiesLoader loader=new PropertiesLoader();
loader.load(file.getAbsolutePath());
assertEquals("testvalue", loader.getProperty("test"));
}
}
Sınıfın en üstünde @ExtendWith(TemporaryFolderExtension.class) ile TemporaryFolderExtension'ı kullanacağımız belirtiyoruz. @BeforeAll ile tanımlanan yöntem ile TemporaryFolder'ı alıyoruz ve bir properties dosyasını yaratıyoruz. loadTest() yönteminde ise asıl test edeceğimiz PropertiesLoader sınıfını yaratıyoruz ve verilen path'deki properties dosyasını yükletiyoruz. Eğer test değeri testvalue ise PropertiesLoader başarılı bir şekilde çalışmış demektir.
JUnit 5, 5.4.2 sonrası için herhangi bir extention kütüphanesi kullanmadan "@TempDir Path path" şeklinde test yöntemlerine aktarılabilirsiniz:
@Test
public void createFileTest(@TempDir Path tempDir) {
String testFilePath=tempDir.toString()+File.separator+"test.txt";
try {
Files.createFile(Paths.get(testFilePath));
} catch (IOException e) {
fail(e);
}
//...
}
