{"id":596,"date":"2024-10-22T16:08:29","date_gmt":"2024-10-22T16:08:29","guid":{"rendered":"https:\/\/iseebugs.pl\/?p=596"},"modified":"2024-10-22T18:48:40","modified_gmt":"2024-10-22T18:48:40","slug":"maven-rodzaje-testow","status":"publish","type":"post","link":"https:\/\/iseebugs.pl\/index.php\/2024\/10\/22\/maven-rodzaje-testow\/","title":{"rendered":"Maven – przejmij w\u0142adz\u0119 nad testami!"},"content":{"rendered":"\n

Korzystaj\u0105c z Maven’a do zarz\u0105dzania projektem najcz\u0119\u015bciej do uruchamiania test\u00f3w korzystamy z komendy mvn test<\/code>. Czy ta komenda na pewno uruchomi je wszystkie i czy mo\u017cemy je uruchamia\u0107 jako\u015b inaczej?<\/p>\n\n\n\n

Stan zastany<\/h2>\n\n\n\n

Testy mo\u017cemy podzieli\u0107 na 3 g\u0142\u00f3wne grupy testowe tj. E2E, Integracyjne oraz Jednostkowe. Jednak nas jako programist\u00f3w interesuje r\u00f3wnie\u017c czy uruchamiaj\u0105c dany test uruchamiamy ca\u0142y kontekst u\u017cywanego przez nas frameworka (np. Spring Boota) czy nie, co si\u0119 bezpo\u015brednio przek\u0142ada na czas trwania test\u00f3w.<\/p>\n\n\n\n

Najcz\u0119\u015bciej przeze mnie spotykanym stanem na istniej\u0105cym projekcie jest taki gdzie wszystkie klasy testowe maj\u0105 w nazwie s\u0142owo Test np. SomeClassTest.java itp. A testy s\u0105 uruchamiane poprzez komend\u0119 mvn test<\/code>. <\/p>\n\n\n\n

Testy jednostkowe<\/h2>\n\n\n\n

Komenda „mvn test” uruchamia faz\u0119 test<\/code> cyklu \u017cycia projektu za kt\u00f3r\u0105 odpowiada plugin Surefire<\/code>. W tej fazie s\u0105 uruchamiane wszystkie testy jednostkowe. Maven nie rozr\u00f3\u017cnia test\u00f3w jednostkowych na podstawie tego czy jest uruchamiany kontekst frameworka czy nie podczas test\u00f3w. <\/p>\n\n\n\n

Maven rozr\u00f3\u017cnia klasy testowe po ich nazwach:<\/p>\n\n\n\n

    \n
  • jednostkowe – posiadaj\u0105 w swojej nazwie s\u0142owo „Test”<\/li>\n\n\n\n
  • integracyjne – posiadaj\u0105 w swojej nazwie znaki „IT” <\/li>\n<\/ul>\n\n\n\n

    Wi\u0119c je\u017celi nazwiemy swoj\u0105 klas\u0119 np. MyClassIntegrationTest.java<\/code> to zostanie ona zakwalifikowany przez Maven’a do test\u00f3w jednostkowych pomimo, \u017ce mo\u017ce by\u0107 to test integracyjny uruchamianym wraz z kontekstem frameworka. <\/p>\n\n\n\n

    Czasami si\u0119 zdarza, \u017ce tego chcemy np. w sytuacji kiedy chcemy przetestowa\u0107 kluczowe dla naszego modu\u0142u operacje na prawdziwej bazie danych a nie na bazie inMemory. <\/p>\n\n\n\n

    Ta faza projektu nie uruchamia test\u00f3w integracyjnych.<\/p>\n\n\n\n

    Testy integracyjne<\/h2>\n\n\n\n

    Ale jak w takim razie uruchomi\u0107 testy integracyjne? R\u0119czne wywo\u0142ywanie test\u00f3w integracyjnych nie wydaje si\u0119 zbyt rozs\u0105dnym rozwi\u0105zaniem. <\/p>\n\n\n\n

    Aby uruchomi\u0107 testy integracyjne musimy skonfigurowa\u0107 Failsafe plugin<\/code> kt\u00f3ry s\u0142u\u017cy do uruchamiania mi\u0119dzy innymi test\u00f3w integracyjnych. Aby w\u0142\u0105czy\u0107 plugin do projektu musimy minimalnie skonfigurawa\u0107 nasz plik pom.xml.<\/p>\n\n\n\n

    <plugin>\n\t<groupId>org.apache.maven.plugins<\/groupId>\n\t<artifactId>maven-failsafe-plugin<\/artifactId>\n\t<version>3.1.2<\/version>\n\t<executions>\n\t\t<execution>\n\t\t\t<goals>\n\t\t\t\t<goal>integration-test<\/goal>\n\t\t\t\t<goal>verify<\/goal>\n\t\t\t<\/goals>\n\t\t<\/execution>\n\t<\/executions>\n<\/plugin><\/code><\/pre>\n\n\n\n
    Powy\u017cszy kod dodaje plugin failsafe do faz: integration-test oraz verify. Jest to minimalna konfiguracja i nale\u017cy doda\u0107 plugin do obu faz cyklu \u017cycia. Oczy wi\u015bcie mo\u017cna pomin\u0105\u0107 dodanie go do jednego ale wtedy:<\/p>\n\n\n\n
      \n
    • Mo\u017cna zrezygnowa\u0107 z integration-test<\/code><\/strong>, ale to oznacza, \u017ce testy integracyjne nie zostan\u0105 uruchomione. W takim przypadku failsafe<\/code> nie b\u0119dzie mia\u0142 \u017cadnych test\u00f3w do zweryfikowania w fazie verify<\/code>, wi\u0119c ten etap stanie si\u0119 zb\u0119dny.<\/li>\n\n\n\n
    • Mo\u017cna zrezygnowa\u0107 z verify<\/code><\/strong>, ale nie jest to zalecane, poniewa\u017c po uruchomieniu test\u00f3w integracyjnych w fazie integration-test<\/code>, wyniki tych test\u00f3w powinny by\u0107 zweryfikowane. Je\u015bli nie ma fazy verify<\/code>, b\u0142\u0119dy w testach integracyjnych mog\u0105 by\u0107 przeoczone.<\/li>\n<\/ul>\n\n\n\n
      Mo\u017cemy dostosowa\u0107 do naszych potrzeb pliki jakie b\u0119d\u0119 uruchamiane podczas wykonywania fazy test\u00f3w integracyjnych. <\/p>\n\n\n\n
      <configuration>\n\t<includes>\n\t\t<include>**\/*IT.java<\/include>\n\t\t<include>**\/*E2E.java<\/include>\n\t<\/includes>\n<\/configuration><\/code><\/pre>\n\n\n\n
      Dodaj\u0105c powy\u017cszy kod w konfiguracji pom.xml doprecyzowujemy z jakimi przyrostkami b\u0119d\u0105 brane pliki pod uwag\u0119 przez maven-failsafe-plugin. Powy\u017cszy kod b\u0119dzie uruchamia\u0142 testy integracyjne oraz End to End.<\/p>\n\n\n\n
      Aby uruchomi\u0107 wszystkie testy integracyjne nale\u017cy skorzysta\u0107 z komendy:<\/p>\n\n\n\n
      mvn failsafe:integration-test<\/code><\/pre>\n\n\n\n
      Pe\u0142en kod konfiguracji mavana jest nast\u0119puj\u0105cy:<\/p>\n\n\n\n
      <plugin>\n\t<groupId>org.apache.maven.plugins<\/groupId>\n\t<artifactId>maven-failsafe-plugin<\/artifactId>\n\t<version>3.1.2<\/version>\n\t<executions>\n\t\t<execution>\n\t\t\t<goals>\n\t\t\t\t<goal>integration-test<\/goal>\n\t\t\t\t<goal>verify<\/goal>\n\t\t\t<\/goals>\n\t\t<\/execution>\n\t\t<configuration>\n\t\t\t<includes>\n\t\t\t\t<include>**\/*IT.java<\/include>\n\t\t\t\t<include>**\/*E2E.java<\/include>\n\t\t\t<\/includes>\n\t\t<\/configuration>\n\t<\/executions>\n<\/plugin><\/code><\/pre>\n\n\n\n
      Maven verify<\/h2>\n\n\n\n
      Cz\u0119sto chcemy uruchomi\u0107 wszystkie testy na raz np. przed wykonaniem merge’a. Do tego najlepiej nadaje si\u0119 faza verify. Uruchamiaj\u0105c poni\u017csz\u0105 komend\u0119 uruchomiamy wszystkie testy jakie mamy w programie zar\u00f3wno jednostkowe jak i integracyjne (je\u017celi skonfigurowali\u015bmy pom.xml).<\/p>\n\n\n\n
      mvn verify<\/code><\/pre>\n\n\n\n
      Mamy ju\u017c skonfigurowanego pom’a oraz wiem jak wywo\u0142ywa\u0107 testy jednostkowe i integracyjne w poszczeg\u00f3lnych konfiguracjach. Ale mo\u017cemy zada\u0107 sobie jeszcze jedno pytanie: „Jak w takim razie uruchomi\u0107 tylko testy integracyjne lub tylko end to end, skoro mvn failsafe:integration-test uruchamia wszystkie zdefiniowne w pom’ie?”. Aby uruchomi\u0107 tylko jeden rodzaj test\u00f3w (np. E2E) skorzystamy z parametru -Dit.test-*E2E.java. Mo\u017cemy poszczeg\u00f3lne testy wywo\u0142a\u0107 albo z posiomu integration-test albo verigy w zale\u017cno\u015bci czego oczekujemy.<\/p>\n\n\n\n
      mvn failsafe:integration-test -Dit.test=*E2E.java<\/code><\/strong>: Gdy chcesz szybko uruchomi\u0107 tylko testy E2E bez potrzeby pe\u0142nej weryfikacji i raportowania.<\/p>\n\n\n\n
      mvn verify -Dit.test=*E2E.java<\/code><\/strong>: Gdy chcesz pe\u0142ny cykl weryfikacyjny, obejmuj\u0105cy uruchomienie test\u00f3w E2E oraz pe\u0142n\u0105 weryfikacj\u0119 wynik\u00f3w test\u00f3w i ich raportowanie.<\/p>\n\n\n\n
      Podsumowanie<\/h2>\n\n\n\n
      Spojrzeli\u015bmy na testy z punktu widzenia Maven. Dowiedzieli\u015bmy si\u0119 jak uruchamia\u0107 poszczeg\u00f3lne rodzaje test\u00f3w, oraz jak konfigurowa\u0107 pom.xml i nazywa\u0107 testy aby by\u0142y uruchamiane w tych fazach projektu w kt\u00f3rych my chcemy aby by\u0142y uruchamiane.<\/p>\n\n\n\n
      Uruchamianie test\u00f3w:<\/p>\n\n\n\n
        \n
      • Jednostkowych\n
          \n
        • mvn test<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • Integracyjnych\n
            \n
          • mvn failsafe:integration-test<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n
          • Wszystkich\n
              \n
            • mvn verify<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n
            • Wybranej grupy test\u00f3w\n
                \n
              • mvn failsafe:integration-test -Dit.test=*E2E.java<\/code><\/li>\n\n\n\n
              • mvn verify -Dit.test=*E2E.java<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n