Readme.md

Laboratorium 3

Celem laboratorium jest wykorzystanie modelu obiektowego Javy do rozwiązania prostego zadania. Studenci mają w tym celu wykorzystać wcześniej zaimplementowane klasy, dzięki czemu kod rozwiązujący zadanie jest znacznie zwięźlejszy i idiomatyczny (wyrażony w języku domeny).

Najważniejsze zadania:

1. Stworzenie klasy Animal.
2. Stworzenie klasy OptionsParser.
3. Testy integracyjne.

Przydatne informacje

• Początkowe wartości obiektu można określić albo w konstruktorze, albo bezpośrednio przypisując je do pól, np.

class Animal {
  private Vector2d position = new Vector2d(2,2);
}

Zadania do wykonania

1. Wykorzystaj definicje klas Vector2d, MapDirection oraz MoveDirection z laboratorium 2.
2. Utwórz klasę Animal, która:
   • określa początkową orientację zwierzęcia jako NORTH,
   • określa początkowe położenie zwierzęcia na mapie jako Vector2d(2,2) (przyjmij, że zwierzę znajduje się w pierwszej ćwiartce układu współrzędnych, a północ jest tożsama z kierunkiem wyznaczanym przez rosnące wartości na osi OY),
   • definiuje metodę toString(), która w reprezentacji łańcuchowej zawiera informacje o położeniu zwierzęcia (pozycję oraz orientację),
   • definiuje metodą boolean isAt(Vector2d position), która zwraca prawdę, jeśli zwierzę znajduje się na pozycji position.
   • definuje swoje pola jako prywatne.
3. Utwórz lub zmodyfikuj klasę World, która w metodzie main stworzy zwierzę i wyświetli w konsoli jego pozycję.
4. Dodaj do klasy Animal metodę move(MoveDirection direction), która:

• Dla kierunków RIGHT i LEFT zmienia orientację zwierzęcia na mapie, np. kiedy zwierzę jest w pozycji NORTH a zmiana kierunku to RIGHT to orientacja zwierzęcia powinna wynosić EAST.
• Dla kierunków FORWARD i BACKWARD zmienia pozycję zwierzęcia o 1 pole, uwzględniając jego orientację, np. kiedy zwierzę jest na pozycji (2,2) i jego orientacja to NORTH, to po ruchu FORWARD jego pozycja to (2,3).
• Uniemożliwia wyjechanie poza mapę, która ustalona jest od pozycji (0,0) do pozycji (4,4) (pięć na pięć pól). W sytuacji, w której zwierzę miałoby wyjść poza mapę, wywołanie move nie ma żadnego skutku.

5. W metodzie main dodaj wywołania, które przetestują poprawność implementacji, np. po ciągu wywołań: RIGHT, FORWARD, FORWARD, FORWARD pozycja zwierzęcia powinna wynosić (4,2) a orientacja EAST.
6. Utwórz klasę OptionsParser a w niej metodę parse, która:
   • akceptuje tablicę łańcuchów znaków,
   • zwraca tablicę kierunków ruchu MoveDirection,
   • zamienia łańcuchy f oraz forward na kierunek MoveDirection.FORWARD, b oraz backward na kierunek MoveDirection.BACKWARD, itd.
   • dla nieznanych kierunków nie umieszcza ich w tablicy wynikowej (tablica wynikowa powinna zawierać wyłącznie prawidłowe kierunki).
7. Zmodyfikuj metodę main tak, aby korzystając z klasy OptionsParser umożliwiała sterowanie zwierzęciem.
8. Przetestuj zachowanie zwierzęcia dla różnych danych wejściowych.
9. Napisz testy integracyjne weryfiujące poprawność implementacji. Uwzględnij:
   • czy zwierzę ma właściwą orientację,
   • czy zwierzę przemieszcza się na właściwe pozycje,
   • czy zwierzę nie wychodzi poza mapę,
   • czy dane wejściowe podane jako tablica łańcuchów znaków są poprawnie interpretowane.
10. Odpowiedz na pytanie: jak zaimplementować mechanizm, który wyklucza pojawienie się dwóch zwierząt w tym samym miejscu.
11. Otaguj gotowe rozwiązanie jako lab3.