Zaawansowane techniki obiektowe 2016/17 Instrukcja laboratoryjna Testy funkcjonalne Prowadzący: Tomasz Goluch Wersja: 1.0
Testowanie aplikacji z bazą danych Większość współczesnych aplikacji korzysta z bazy danych. Ich testowanie nie należy do najłatwiejszych z wielu powodów. M.in. problemem może być przygotowanie danych testowych w bazie danych oraz zmiana jej zawartości podczas przeprowadzania testów (np. dodanie/zmodyfikowanie rekordu). Celem ćwiczenia jest stworzenie testów dla aplikacji z wykorzystaniem rzeczywistej bazy danych. Dodatkowe zadanie polega na rozszerzeniu istniejącej aplikacji o określoną funkcjonalność oraz automatyzację napisanych testów w oparciu o aplikację TeamCity. Solucja Została przygotowana solucja z dwoma projektami (do pobrania ze strony przedmiotu). Pierwszy projekt jest biblioteką, która zawiera kod produkcyjny, drugi projekt zawiera test (MSTest). Projekty są poprawnie skonfigurowane oraz zawierają wszystkie niezbędne biblioteki (Entity Framework 5.0). Aplikacja skonfigurowana jest tak, że używa bazy danych w folderze D:\Temp\blog-test.mdf, dlatego też należy stworzyć ten folder, lub zmienić konfigurację w projekcie z testami (app.config). Aplikacja korzysta z narzędzia Entity Framework i zawiera klasę z modelem Post, kontekst bazy danych ( Code First ) BlogContext oraz klasę repozytorium PostRepository, która stanowi warstwę abstrakcji nad klasą kontekstu (wzorzec Repozytorium). W pierwszej kolejności należy zbudować całą solucję i uruchomić istniejący test za pomocą narzędzia wbudowanego w Visual Studio 2010 klikając PPM na nazwie testu i wybierając odpowiednią opcję. Wynik testu jest negatywny 1 ponieważ metoda zwróciła 0 rekordów, a oczekiwana liczba to 1. 1 Jeżeli błąd powiązany jest z niemożliwością utworzenia bazy danych najprawdopodobniej będzie to związane z niewłaściwą wartością atrybutu connectionstring w pliku konfiguracyjnym App.config. Aby sprawdzić jaki format jest poprawny można dodać nową pusta bazę do projektu (PPM Add New Item Data Service-based Database). Następnie, korzystając z narzędzia Serwer Explorer odnajdujemy połączenie z naszą bazą w sekcji Data Connection, klikamy na nim PPM, wybieramy z menu podręcznego opcję Property i odszukujemy właściwość DataString.
Można sprawić, żeby test dał wynik pozytywny poprzez dodanie rekordu do tabeli w bazie danych. Aby to zrobić należy otworzyć plik bazy za pomocą Server Explorera w narzędziu Visual Studio 2010 (Tools -> Connect to Database a następnie wpisać dane jak poniżej).
Jeśli plik z bazą nie znajduje się w folderze d:\temp należy się upewnić, że projekt z testami został przebudowany oraz testy zostały uruchomione (ponieważ baza tworzy się podczas wywołania testu). Następnie należy dodać rekord do tabeli Posts (wybierając opcję Show Table Data z menu kontekstowego tabeli) - dane nie są istotne tylko sam fakt istnienia rekordu. NASTĘPNIE NALEŻY ZAMKNĄĆ POŁĄCZENIE Z BAZĄ DANYCH (w Server Exlorere). Po dodaniu rekordów należy ponownie uruchomić testy tak jak poprzednio. Jeśli wszystko zostało wykonane poprawnie należy zgłosić ten fakt prowadzącemu. Przygotowanie danych w ten sposób jest bardzo niewydajne i wymusza aby wszystkie testy bazowały na jednym (niezmiennym) stanie bazy. Dlatego też dużo lepszym rozwiązaniem jest przygotowanie danych w środowisku testowym. Aby to zrobić należy dodać podany poniżej kod na końcu części arrange w teście. // -- prepare data in db context.posts.tolist().foreach(x => context.posts.remove(x)); context.posts.add(new Post Author = "test", Content = "test, test, test..." }); context.savechanges(); Następnie należy uruchomić ponownie test. Wynik powinien być również pozytywny. Należy zgłosić ten fakt prowadzącemu. Ten sposób również jest mało wydajny, ponieważ kod ten musi być kopiowany do każdego testu. Można kod przygotowujący dane wynieść do metody z atrybutem [TestInitialize], ale wtedy również musimy w ten sam sposób przygotowywać wszystkie inne klasy testowe. Do projektu została dołączona biblioteka, która umieszczona jest w folderze packages/dbtesthelpers/ TDD.DbTestHelpers.dll. Aby skorzystać z biblioteki należy dodać klasę bazową DbBaseTest<BlogFixtures> dla klasy RepositoryTests, która znajduje się w namespace ie TDD.DbTestHelpers.Core. Klasę BlogFixtures należy stworzyć w projekcie z testami i powinna ona wyglądać następująco:
public class BlogFixtures : YamlDbFixture<BlogContext, BlogFixturesModel> public BlogFixtures() SetYamlFiles("posts.yml"); } } Należy uzupełnić brakujące usingi, natomiast klasa BlogFixtures powinna wyglądać następująco: public class BlogFixturesModel public FixtureTable<Post> Posts get; set; } } Jeśli wszystko zostało wykonane poprawnie projekt powinien się budować. Ostatnim krokiem jest dodanie danych, w tym celu należy stworzyć folder Fixtures oraz dodać do niego plik posts.yml: Posts: test-post: Author: test Content: test, test, test... Należy zwrócić uwagę na białe znaki. Nie należy używać tabulatorów w plikach yaml lecz dwóch spacji. W ostatnim kroku należy upewnić się, że właściwość Copy to Output Directory tego pliku jest ustawiona na Copy always. Biblioteka jest skonfigurowana poprawnie, należy usunąć kod dodany do testu, który miał przygotowywać bazę danych oraz uruchomić test. Jeśli wynik jest poprawny należy fakt ten zgłosić prowadzącemu. Aby zobaczyć jak działa biblioteka można dodać kolejny post i zmienić test tak, aby weryfikował istnienie dwóch postów.
Zadania do wykonania: 1) Rozszerzyć funkcjonalność repozytorium o możliwość dodawania postów 2) Walidację danych (pola wymagane) 3) (dodatkowe domowe) Dodanie drugiej tabeli (np. komentarze) oraz napisanie obsługi dodawania komentarza i wyświetlenia komentarzy dla konkretnego postu. Uwaga: aby używać relacji pomiędzy tabelami w entity framework należy: 1) Rozszerzyć BlogFixturesModel o kolejną właściwość 2) Użyć albo drugiego pliku dla drugiej tabeli (SetFixtureFiles przyjmuje kolekcję nazw plików) lub dopisać dane dla drugiej kolekcji w już istniejącym stosując tą samą konwencję 3) Używać przypisanych (lokalnie! nie w bazie) kluczy głównych i obcych Np. posts: test-post: Id: 1 Author: test Content: test, test, test... comments: test-post-comment: PostId: 1 Content: ha ha ha