Instrukcja laboratoryjna z testów funkcjonalnych

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 negatywny1 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