[[oktatas:programozás|< Programozás]]

====== TDD ======
  * **Szerző:** Sallai András
  * Copyright (c) 2018, Sallai András
  * Szerkesztve: 2018, 2019, 2020
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
  * Web: https://szit.hu

===== A TDD =====

A **TDD** a **Test-driven development** rövidítése, magyarul **teszt-vezérelt fejlesztés**.
Egy szoftverfejlesztési folyamat, amely nagyon rövid fejlesztési ciklusok ismétléséből áll.
**Kent Beck** amerikai mérnök alkotta meg, vagy újra felfedezte. 

Tulajdonképpen a kód egy részét, ami jellemzően egy függvény, eljárás vagy metódus, 
teszteljük, újra és újra. A vizsgált részt egy egységként vagy angolul unitként 
szokás emlegetni. Így egységteszt vagy unit tesztnek is hívják. 

Két kódot fejlesztünk párhuzamosan:
  * teszt kód
  * ipari kód

A fejlesztést a teszt megírásával kezdjük, akkor amikor még nem is áll rendelkezésre az ipari kód.

A mai integrált fejlesztői környezetek támogatják a tesztek írását. 
Így könnyedén használhatjuk a teszt-vezérelt fejlesztésre.



===== A TDD folyamata =====

A tesztelést Java objektum orientált kódokkal tekintjük meg.

Három osztályt készítünk. 
  * főosztályt
  * teszt osztályt
  * hasznos kódot tartalmazó osztály

A TDD lépései
  - fejlesztjük a tesztet
    - csak annyit fejlesztünk rajta, hogy az ne teljesüljön
    - futtatjuk a tesztet
  - fejlesztjük az ipari kódot
    - csak annyit fejlesztünk, hogy teljesüljön a teszt
    - futtatjuk a tesztet
  - újratervezünk, ha szükséges
    - tesztelünk
    - folytatjuk elölről az első ponttól

{{:oktatas:programozas:tdd_3_resz.png|}}


===== Az Eclipse =====

Készítsünk egy projektet. A példa kedvéért legyen a neve sikidom.

  * File -> New -> Project...
  * Java -> Java Project
  * legyen a neve: sikidom

Készítsünk egy csomagot:
  * File -> New -> Package
  * legyen a neve: sikidom

Elkészítjük a tesztet:
  * File -> New -> JUnit Test Case
Ha nincs a menüben a JUnit Test Case, akkor válasszuk a következőt:
  * File -> New -> Other...
  * JUnit -> JUnit Test Case
  * legyen a neve: HaromszogTest


==== Eredmény ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		fail("Not yet implemented");
	}

}

</code>

==== A teszt fejlesztése ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
	}

}

</code>

==== A teszt futtatása ====

  * Run -> Run

A teszt hibával ér végett, mivel nem létezik a Haromszog osztály.


==== Az ipari kód fejlesztése ====

Elkészítjük a Haromszog osztályt, de nem fejlesztjük tovább.
  * File -> New -> Class
  * legyen a neve: Haromszog

<code java Haromszog.java>
package sikidom;

public class Haromszog {

}
</code>

=== Futtatjuk a tesztet ===

  * Run -> Run
  * A teszt teljesült.
  * Következik a teszt továbbfejlesztése.

==== Teszt fejlesztése ====

Hívjuk meg a szamolKerulet() metódust, ami még nem létezik. 
Egyelőre paraméterekre sincs szüksége. 

<code java HaormszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
		haromszog.szamolKerulet();
	}

}
</code>

Futtassuk a tesztet. A teszt nem teljesül.

==== Ipari kód fejlesztése ====

Annyit fejlesszünk a kódon, hogy teljesítse a tesztet.

<code java Haromszog.java>
package sikidom;

public class Haromszog {
	public void szamolKerulet() {
		
	}
}

</code>

==== Teszt fejlesztése ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
		double ker = haromszog.szamolKerulet();

	}

}

</code>


==== Ipari kód fejlesztése ====

<code java Haromszog.java>
package sikidom;

public class Haromszog {
	public double szamolKerulet() {
		return 0;
	}
}

</code>

==== Teszt fejlesztése ====

Jó lenne, ha a metódus fogadna paramétereket.

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
		double ker = haromszog.szamolKerulet(30, 35, 40);
		
	}

}
</code>

==== Ipari kód fejlesztése ====

<code java Haromszog.java>
package sikidom;

public class Haromszog {
	public double szamolKerulet(double a, double b, double c) {
		return 0;
	}
}

</code>

==== Teszt fejlesztése ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
		double ker = haromszog.szamolKerulet(30, 35, 40);
		assertEquals(105, haromszog.szamolKerulet(30, 35, 40));
	}

}

</code>

A teszt sikertelen. Hiba ugyan nincs, de a teszt sikertelen, mivel
nem 105 az eredményt, 30, 35 és 40 bemenő paraméterek esetén.

==== Ipari kód fejlesztése ====

A kódot egyszerű javítani, írjuk oda, hogy 105-tel térjen vissza. 

<code java Haromszog.java>
package sikidom;

public class Haromszog {
	public double szamolKerulet(double a, double b, double c) {
		return 105;
	}
}

</code>

A teszt lefut.

==== Teszt fejlesztése ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void test() {
		Haromszog haromszog = new Haromszog();
		double ker = haromszog.szamolKerulet(30, 35, 40);
		assertEquals(105, haromszog.szamolKerulet(30, 35, 40));
		assertEquals(75, haromszog.szamolKerulet(20, 25, 30));
	}

}

</code>

A teszt újra sikertelen. A hiba csak 30, 35 és 40 bemenő paraméterek esetén működik.

==== Ipari kód fejlesztése ====

A kódot egyszerű javítani, írjuk oda, hogy 105-tel térjen vissza. 

<code java Haromszog.java>
package sikidom;

public class Haromszog {
	public double szamolKerulet(double a, double b, double c) {
		return a + b + c;
	}
}

</code>

A teszt lefut.

Ezek után jöhet a tesztelés szélsőértékekre. 

==== Újratervezés ====

<code java HaromszogTest.java>
package sikidom;

import static org.junit.jupiter.api.Assertions.*;

import org.junit.jupiter.api.Test;

class HaromszogTest {

	@Test
	void szamolKeruletTest() {
		Haromszog haromszog = new Haromszog();
		assertEquals(105, haromszog.szamolKerulet(30, 35, 40));
		assertEquals(75, haromszog.szamolKerulet(20, 25, 30));
	}

}

</code>

Kitöröltük a felesleges sort, mivel mindenképpen meghívjuk szamolKerulet() metódust.
Mivel a test() metódus csak a szamolKerulet() metódust teszteli, ezért átnevezzük
szamolKeruletTest() névre.
===== Netbeans =====
==== Ipari kód osztálya ====

Netbeans alatt létre kell hoznunk a tesztelendő osztályt:
<code java Haromszog.java>
/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */
package hu.szit.sikidom;

/**
 *
 * @author andras
 */
public class Haromszog {
    
}

</code>

==== Tesztkód ====


A jobb egér gombbal kattintunk a Prejects fülön a
projekt nevén. 

  * New -> Other...
  * Az előugró ablakban:
    * Categories: Unit Tests
    * File Types: JUnit Test
    * Next >
  * Az újabb ablakban:
    * Class Name: HaromszogTest
    * Package: hu.szit.sikidom
    * Generated Code:
      * [ ] Test Initializer
      * [ ] Test Finalizer
      * [ ] Test Class Initializer
      * [ ] Test Class Finalizer
    * Generated Comments:
      * [ ] Source Code Hints
    * Finish gomb 


==== Eredmény ====
<code java HaromszogTest.java>
/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

/**
 *
 * @author andras
 */
public class HaromszogTest {
    
    public HaromszogTest() {
    }
    
}

</code>


==== Első teszt írása ====

<code java HaromszogTest.java>
/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */

import org.junit.Test;
import static org.junit.Assert.*;

/**
 *
 * @author andras
 */
public class HaromszogTest {
    
    public HaromszogTest() {
    }
    
    @Test
    public void test() {
        Haromszog har = new Haromszog();
        har.szamitKerulet();
    }
    
}

</code>

Futtassuk a tesztet:
  * Run -> Test Project (sikidom)

==== Ipari kód fejlesztése ====

Írjunk annyi kódot, ami miatt a teszt nem fut hibára.

<code java Haromszog.java>
/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */
package hu.szit.sikidom;

/**
 *
 * @author andras
 */
public class Haromszog {
    public void szamitKerulet() {
        
    }    
}

</code>


A teszt most már nem fut hibára.

==== Tervezzük újra ====

Jelen esetben semmi különöset nem csinálok, csak kiszedem a megjegyzéseket.

<code java Haromszog.java>
package hu.szit.sikidom;

public class Haromszog {
    public void szamitKerulet() {
        
    }    
}

</code>

<code java HaromszogTest.java>
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

public class HaromszogTest {
    
    public HaromszogTest() {
    }
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        har.szamitKerulet();
    }
    
}

</code>

==== A teszt fejlesztése ====

Jó lenne, ha adna vissza értéket szamitKerulet() metódus. 
<code java>
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        double ker = har.szamitKerulet();
    }
</code>

Futtassuk a tesztet.
==== Ipari kód fejlesztése ====

Éppen csak annyira fejlesztjük, hogy teljesítse a tesztet. 

<code java>
public class Haromszog {
    public double szamitKerulet() {
        return 0;
    }
}
</code>

Mentsünk és futtassuk a tesztet. 

==== Újratervezés ====

Most nincs mit.

==== Teszt fejlesztése ====
Jó lenne, ha metódus fogadna bemenő paramétereket.
<code java>
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        double ker = har.szamitKerulet(30, 35, 40);
    }
</code>

==== Ipari kód fejlesztése ====

<code java Haromszog.java>

package hu.szit.sikidom;

public class Haromszog {
    public double szamitKerulet(double a, double b, double c) {
        return 0;
    }
}

</code>

==== Újratervezés ====

<code java Haromszog.java>

package hu.szit.sikidom;

public class Haromszog {
    public double szamitKerulet(double aOldal, double bOldal, double cOldal) {
        return 0;
    }
}

</code>

==== A teszt fejlesztése ====

<code java HaromszogTest.java>
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

public class HaromszogTest {
    
    public HaromszogTest() {
    }
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        double ker = har.szamitKerulet(30, 35, 40);
        assertEquals(105, har.szamitKerulet(30, 35, 40), 0);
    }
    
}

</code>

==== Ipari kód fejlesztése ====
Ha 0 helyett 105-el térünk vissza, a teszt már teljesül:
<code java Haromszog.java>

package hu.szit.sikidom;

public class Haromszog {
    public double szamitKerulet(double aOldal, double bOldal, double cOldal) {
        return 105;
    }
}

</code>


==== Újratervezés ====

Az alábbi sort töröljük, mivel helyettesíti az assertEquals()-t 
tartalmoaz sor:
  double ker = har.szamitKerulet(30, 35, 40);


<code java HaromszogTest.java>
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

public class HaromszogTest {
    
    public HaromszogTest() {
    }
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        assertEquals(105, har.szamitKerulet(30, 35, 40), 0);
    }
    
}

</code>

==== A teszt fejlesztése ====

<code java HaromszogTest.java>
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

public class HaromszogTest {
    
    public HaromszogTest() {
    }
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        assertEquals(105, har.szamitKerulet(30, 35, 40), 0);
        assertEquals(75, har.szamitKerulet(20, 25, 30), 0);
    }
    
}

</code>

==== Ipari kód fejlesztése ====

<code java Haromszog.java>
package hu.szit.sikidom;

public class Haromszog {
    public double szamitKerulet(double aOldal, double bOldal, double cOldal) {
        return aOldal+bOldal+cOldal;
    }
}

</code>

==== Újratervezése ====
Most nem teszünk semmit.

==== Teszt fejlesztése ====

<code java HaromszogTest.java>
package hu.szit.sikidom;

import org.junit.Test;
import static org.junit.Assert.*;

public class HaromszogTest {
    
    public HaromszogTest() {
    }
    @Test
    public void haromszogKeruletTest() {
        Haromszog har = new Haromszog();
        assertEquals(105, har.szamitKerulet(30, 35, 40), 0);
        assertEquals(75, har.szamitKerulet(20, 25, 30), 0);
    }
    
    @Test(expected = IllegalArgumentException.class)
    public void haromszogKeruletException() {
        Haromszog har = new Haromszog();
        har.szamitKerulet(0, 25, 30);
    }
}

</code>

JUnit5 már lehetővé teszi:
<code java>
        assertThrows(IllegalArgumentException.class, 
                har.szamitKerulet(0, 25, 30));
</code>

==== Ipari kód fejlesztése ====

<code java Haromszog.java>
package hu.szit.sikidom;

public class Haromszog {
    public double szamitKerulet(double aOldal, double bOldal, double cOldal) {
        if(aOldal <= 0) {
            throw new IllegalArgumentException("Nem megfelelő paraméter");
        }
        return aOldal+bOldal+cOldal;
    }
}

</code>


===== Link =====
JUnit5 API:
  * https://junit.org/junit5/docs/5.0.1/api/org/junit/jupiter/api/Assertions.html (2020)

Kivétel hiánya a JUnit5-ben:
  * https://howtodoinjava.com/junit5/expected-exception-example/ (2020)