Skip to content

About

First use of model-view-controller. Backend logic for numberlink

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Wstępny plan projektu

Realizowane zgodnie z wzorcem MVC, Model-View-Controller


Model

class Tile (podstawa kwadracika)

        (Aby mieć jedną duża rozpiske hexów i nie domyślać się co jest co ale używać aliasów)
        String color RED = (hex czerwonego)
        [....]
        String color WHITE = (hex białego)}

        int content = cyfra
        string color = to co przypiszemy w premadeach
        bool isEndpoint = flaga czy to punkt startowy/koncowy, aby nie dalo sie nadpisac

        void ustawKolor(content){        
                jeżeli przez pole jest prowadzony wężyk od jedynki to
                        color = RED
                [....]
                jeżeli content == 7:
                        color= WHITE}

        bool isEndpoint()
        return true; return false
getter dla color (nieporzebny setter bo kkorzystamy z naszych premadeów)
setter i getter dla content

class Board (kwadracik kwadracików)

        int rowCount;
        int columnCount;
        int difficulty - ile par (kolorow) jest do polaczenia lub rozmiar planszy?
        private Tile[][] tiles;
        (wymiary i zgodnie z rozmiarem dwuwymiarowy array pól)

        void clearBoard() - czysci wszytsko procz punktow startowych
        bool isSolved() - sprawdza czy dobrze polączone i czy wygrana
        Tile getTile(int x, int y) - zwraca dane obiketu w danym miejscu

class Move (do obsługi pojedyńczego przesunięcia wężyka i uzyte do cofania)

        int x; int y; - który kwadracik dotykamy
        String previusColor - kolor pola poprzednio (aby undo robić)
        String newColor - kolor na jaki zmienimy, lub na jaki podpowiadamy
gettery dla wszytskiego, settery dla żadnego imo

class MoveHistory (dla cofania)

        Stack<Move> pastMoves - stos bo ma duzo przydatnych wbudowanych funkcji idealnie jak chcemy siegac po cos w kolejnosci od ostatniego
        void addMove(Move lastOne) - dodaje do stosu historii
        void undoMove() - zdejmuje z stosu i przywraca ostatnią plansze

class FileManager (do obslugi zapisu i druku)

        void saveGameState(Board usedBoard, String filePath) - zapisuje do jsona
        void loadGameState(String filePath) - odczytuje i przywraca zapis
        void  exportForPrint(Board board, string filePath) - idk wymog z zadania, lamiglowki maja byc drukowalne

class Generator (klasa z treści zad)

        Board generateAuto(int difficulty) - cos sie dzieje
        Board generateFromUser() - gracz sam wpisuje
        Board loadFromFile(string path) - łąduje JSON lub CSV
        void defineBoardLimits(int rows, int cols) - okresla rozmiar

class Solver (klasa z treści zad)

        Board currentBoard - referencja do planszy rozrgrywki
        MoveHistory history - refrenecja do historii ruchów (do cofania z treści zadania)

bool makeMove(int fromX, int fromY, int toX, int toY) - przesuwa wężyk danego(from) do danego(to) miejsca
        bool isMoveValid(...) - sprawdza czy mozna sie tak przesunac
        Move getHint() - zgodnie z trescia zadania, nie wiem jak to moze dzialac ale zakładam że pasuje do solvera bo validacja

enum TileColor (użyte wyżej w tile, enum deklaruje sie najlepiej w osobnym pliku)

(dostępne kolory i HEX)
RED("#FF0000"),
...
WHITE("#FFFFFF"),
EMPTY("#222222"); (puste pole

String hexCode;

konstruktor domyślny
getter dla hexCode aby robic to w gui


View

interface GameView (zawsze tak sie robi)

void viewBoard(Board board)

void showMessage(string mesage) - od rzeczy typu "Wygrałeś!", "Nie da sie tak ruszyć",

Move getPlayerMove - zbiera od gracza ifnormacje jak chce sie ruszyc, i zwraca w postaciu ruchu. Bedzie pasowac do podejscia CLI i GUI

void showMenu() - Zapisz,Wczytaj,Cofnij,Generuj. Mysle ze moze byc taka metoda od osobnego okienka lub to dalej jako osobna metoda do generowania stale widocznych przyciskow

class CLI/GUIView implements GameView - wybierzemy czy cli czy gui

oprócz implementacji interfeujsu w zaleznosci od podejscia potrzebujemy:
Dla CLI: Scanner do czytania ruchu i displayBoard dzialajacy na ASCII
Dla GUI: JavaSwing/JavaSX poczytać dokumentacje, ale ogolnie beda potrzebne metody tworzenia window, button, event listner


Controller

class NumberlinkController

poprostu referencje do wszytskiego, tak tylko jedna klasa w tym jest

GameView view
Solver gameEngine
Board currentBoard

startGame() - rusza wszystko po kolei
handleButtonAction() - obsługa przyciskow itd

 

About

First use of model-view-controller. Backend logic for numberlink

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages