Основните проблеми, които задачата поставя са:
- Реализация на коректни алгоритми за генерация на решетка Sudoku.
- Реализация на удобен UI с помоща на JavaFX.
- Реализиране на RMI интерфейс и разработка на клиент-сървър приложение чрез Java RMI.
Проектът реализира RMI приложение. Той е разделен на 3 модула - server, client и shared, като в модула server се реализира логиката и се предоставят отдалечени методи. В модула client се съдържа реализацията на JavaFX приложението и всичките помощни функции, които ползват отдалечените методи от server. Mодулът shared cъдържа RMI интерфейс, използван както от клиента, така и от сървъра.
- class MatrixGenerator, който имплементира RMI интерфейса MatrixGenerationService.
- class MatrixGeneratorHelper, който съдържа помощни методи за MatrixGenerator.
- class MatrixGeneratorTest - main метода му стартира RMI регистър, създава отдалечен обект MatrixGenerator и го регистрира в регистъра.
- public int[][] generate(Easy, Medium, Hard)Matrix() throws RemoteException - трите метода ползват generateGrid с различен параметр attempts, което определя сложносста на решетката.
- public void recordGame(String username, String difficulty, boolean solved, String timer) throws IOException, RemoteException - сериализация на игра в файл records.txt.
- public int[][] solveMatrix(int[][] grid) throws RemoteException - приема решетка и я запълва с помоща на метода solveMatrixHelper.
- static int[][] generateGrid(int attempts) - създава матрица 9x9, която се запълва със случайни и валидни за Sudoku числа с помощта на метода fillGrid, attempts е броя на опитите да занули случайно избрано от решетката число, след зануляването се проверява с countSolutions дали все още има само едно решение, и ако решенията са повече от едно - решетката се връща до състоянието си преди последната невалидна промяна.
- static int[][] solveMatrixHelper(int[][] grid) - рекурсивно с backtracking намира първото решение на решетката grid, като при достигане до запълнена решетка я връща.
- static int[][] countSolutions(int[][] grid) - рекурсивно с backtracking намира броя на решенията на решетката grid, работи аналогично на solveMatrixHelper, но при достигане на запълнена решетка увеличава брояча, който на края го връща.
- static boolean fillGrid(int[][] grid) - рекурсивно с backtracking случайно запълва решетката grid така, че да са удовлетворени правилата на Sudoku. Връща false, ако grid не е възможно да се запълни(то ест няма решения).
- class Application, който стартира JavaFX приложението.
- class MainController, който управлява главния прозорец на JavaFX приложението.
- class PopupController, който управлява изкачащия прозорец с избора на сложност.
- class MusicPlayer, който стартира фонова музика.
- class RmiClientProvider, който създава връзка с RMI регистъра и предоставя достъп до отдалечената услуга MatrixGenerationService.
- private ArrayList<int[][]> allGrids - пази всичките решетки от началото на играта до момента, се ползва за метода undo. Малко е по-оптимално да се пазят само промените, а не цялата решетка, но работим с константен размер на матрицата и в моята имплементация е по-удобно да се пазят целите решетки, така че не е проблем.
- private String username private; String difficulty; boolean win - ползват се за сериализацията в файл.
- boolean gameRunning - ползва се за валидация и пази дали върви играта или е спряна.
- private Timeline timeline; private int secondsElapsed - ползват се за таймера.
- private int[][] currGrid = new int[9][9] - пази текущата решетка.
- private int[][] prevGrid = new int[9][9] - пази предишната решетка, ползва се за методите redo и undo.
- private int[][] startGrid = new int[9][9] - пази началната решетка и се ползва да се покаже решението в края на играта, ако е прекъсната без играча да спечели.
- private int[] selectedCell - пази текущата избраната клетка; {-1,-1}: няма избрана.
- public void updateGrid(int el) - прави валидация за състоянието на играта и обновява решетката, като променя currGrid, cъс записване на числото el на позиция selectedCell[0]selectedCell[1], и вика помощният метод loadgrid.
- public void startAndEnd() - метод, който се извиква от бутона btnNewGame, в зависимост от състоянието на играта може както да преключва играта, така и да я започва, викайки методите stopGame и showPopup(метод, отварящ прозорец за начало на игра и избора на сложност) съответно.
- public void setGrid(int difficulty) - създава и зарежда в графическия интерфейс нова решетка в съответсткие с избраната сложност difficulty, като вика RMI методите от интерфейса MatrixGenerationService.
- Основното ограничение е имплементацията на решетка, базирана на директно използване на масиви, без допълнителни колекции. Което на пръв поглед изглежда естественно, защото работим със индекси. Но на края излезе проблем, че постоянно се налага да осигуряваме, че нямаме споделяне на памет. Поне има и плюсове, като константа сложност на доступ до елемент.
- Основнаият преодолян проблем беше създаването на JAR-файловете за лесно стартиране на програмата. Конкретно client.jar, поради ползването на JavaFX в него.
- Основният непреодолян проблем е отсътствието на .exe файл със програмата, който се билдва, но по някаква, все още на мен неизвестна, причина нищо не прави при запуск, дори не дава грешка или изключение.
- За да се стартира програмата е необходим JVM. Няма нужда от JavaFX, тъй като тя вече изцяло лежи в client_jar, заедно със визуалният компонент за JavaFX gridButton.jar, който също се ползва в проекта. Прието е такова решение за да може да се напише работещ скрипт в .bat файловете.
- Първо запуск на Sudoku/Runs/server_jar/run.bat
- После запуск на Sudoku/Runs/client_jar/run.bat
- https://www.sudokuwiki.org/Sudoku_Creation_and_Grading.pdf
- https://www.101computing.net/sudoku-generator-algorithm/
- https://www.chatgpt.com
- https://stackoverflow.com/questions
- https://github.com/uniaodk/sudoku-javafx (с който се запознах доста късно и ,възможно, ако бях се поинтересувал в самото начало щях да постигна по-добър резултат.)