Poprowadzimy blok praktyczny w formie projektu, który w pewnym stopniu będzie symulował rzeczywiste warunki i wymagania, z którymi spotkacie się w pracy jako programiści.
Celem warsztatów niekoniecznie jest ukończenie całego zadania, ale zdobycie doświadczenia w pracy nad otwartym problemem i dyskusji w grupie.
Aparat
Waszym zadaniem jest napisanie kodu dla komponentu prostego aparatu cyfrowego. Aparat ma dwa zewnętrzne przyciski: przycisk zasilania i przycisk migawki.
Głównym komponent PhotoCamera jest odpowiedzialny za reagowanie na działania użytkownika na przełączniki aparatu i koordynowanie transferu danych z sensora do karty pamięci, kiedy jest robione zdjęcie. Powinieneś zaimplementować klasę PhotoCamera w stylu TDD dodając pojedynczo testy w JUnit do wymaganych zachowań.
Klasa PhotoCamera
PhotoCamera musi posiadać następujące zachowania:
-
Włączenie kamery włącza zasilanie sensora.
-
Wyłączenie kamery odcina zasilanie sensora.
-
Naciśnięcie migawki jeśli zasilanie jest odcięte nie robi nic.
-
Naciśnięcie migawki z włączonym zasilaniem, kopiuje dane z sensora do karty pamięci. (Zapisywanie danych do karty pamięci zajmuje nieco czasu.)
-
Jeśli dane są obecnie zapisywane, wyłączenie kamery nie odcina zasilania sensora
-
Kiedy zapis danych się zakończy, aparat odcina zasilanie sensora.
Pracujcie w grupach 2-3 osobowych. Częścią zadania jest przemyślenie decyzji i koncepcji oraz dyskusja na ich temat. Rozmawiajcie jak najwięcej!
Cały czas będę do Waszej dyspozycji - będę podpowiadał, wyjaśniał i odpowiadał na pytania, ale to Wy jesteście programistami i to Wy musicie rozwiązać problem.
Zapisujcie i wypychajcie na serwer postępy (git add, commit i push), żeby ich nie stracić.
Otrzymaliście interfejsy ImageSensor oraz Card (które będą napisane przez inne zespoły). Nie powinniście ich zmieniać!
Aby być powiadomionym kiedy zapisywanie danych się kończy, PhotoCamera powinien implementować interfejs WriteListener. Jeśli kamera go implementuje, wtedy inne komponenty mogą go wywołać i powiadomić o statusie zapisywania danych.
Pytania do przemyślenia
Kiedy jest domyślny stan zasilania nowego aparatu (włączony, wyłączony)? Czy są jakieś powtórzenia kodu w Waszych testach? Czy można je zrefaktoryzować? Czy Wasze testy są rzeczowe i ściśle ukierunkowane? W jakim stopniu testy inspirują Wasz projekt kodu (implementację)? Czy TDD z obiektami mock prowadzi do kodu, który jest łatwiej utrzymywać? W jakim stopniu TDD z obiektami mock pozwala nam lepiej testować oprogramowanie? Co uważasz za dobre i złe praktyki przy używaniu obiektów mock?
Struktura kodu
W projekcie znajdują się 2 foldery src/main/java oraz src/test/java. W każdym z nich znajduje się pakiet com.demo. Piszcie swój kod w tym pakiecie (testy w src/test/java i kod aplikacji w src/main/java). W folderze main znajdują się już jakieś klasy, m.in. PhotoCamera.java, którą będziecie w pełni implementowali. W folderze test znajduje się plik CameraSpec.groovy, gdzie powinniście zamieszczać swoje testy.
Klonowanie projektu
Pracuj na swojej własnej kopii projektu utworzonej przez sforkowanie oryginalnego repozytorium:
- Klinkij w ikonę plusa po lewej stronie witryny projektu na bitbuckecie
- Wybierz ostatnią opcję "Fork this repository"
- Wpisz nazwę i zatwierdź
Importowanie kodu do IntelliJ
Skopiuj adres sforkowanego repozytorium:
- Kliknij w ikonę plusa na stronie sforkowanego przez Ciebie projektu na bitbuckecie
- Wybierz "Clone this repository"
- Skopiuj adres bez komendy "git clone na początku", np. gdzie w oknie pojawia się 'git clone https://[email protected]/krystian_rybarczyk/mocks.git' skopiuj tylko 'https://[email protected]/krystian_rybarczyk/mocks.git'
Zaimportuj kod do Intellij:
- Wybierz opcję New -> Project From Version Control -> Git.
- Wklej skopiowany powyżej link z Bitbucketa.
- Jeśli SDK nie jest ustawione (pliki dziwnie się wyświetlają w drzewie projektu), wybierz Java 1.8.
- Na dolnej belce powinna pojawić się informacja Non-managed pom.xml file found. Klikając na to wyświetli się okienko z wiadomością 'Non-managed pom.xml file found: /home/krystian/code/sda/javalub-mocks/pom.xml Add as Maven Project or Disable notification'. Kliknij 'Add as Maven Project'
Materiały dodatkowe
Przydatny artykuł do dyskusji: https://martinfowler.com/articles/mocksArentStubs.html
Informacje o interaction based testing http://spockframework.org/spock/docs/1.0/interaction_based_testing.html