yvesmendes/sudoku-pure-java-implementation

Academic Purpose Sudoku Implementation in Java without external libs

Academic Purpose Sudoku (Pure Java Implementation)

The project was developed using Java 1.6 without external libs. The game has three different difficulties: EASY, NORMAL, and HARD. The score is calculated based on the elapsed time, the number of errors, and the current difficulty.

An example of Sudoku Board in Easy mode:

    (0) (1) (2) (3) (4) (5) (6) (7) (8) 
   |===.===.===|===.===.===|===.===.===|
(0)| 2 |   |   | 5 | 7 |   | 9 |   |   |
   |---.---.---|---.---.---|---.---.---|
(1)|   |   | 9 | 3 |   | 8 |   |   | 1 |
   |---.---.---|---.---.---|---.---.---|
(2)| 5 | 8 |   | 9 |   |   | 3 | 4 |   |
   |===.===.===|===.===.===|===.===.===|
(3)| 6 |   | 8 |   | 1 | 9 |   |   |   |
   |---.---.---|---.---.---|---.---.---|
(4)| 4 | 1 | 7 |   |   | 3 |   | 9 | 5 |
   |---.---.---|---.---.---|---.---.---|
(5)| 9 |   | 2 | 7 | 8 | 5 |   | 1 | 4 |
   |===.===.===|===.===.===|===.===.===|
(6)| 8 |   | 4 | 1 | 9 |   | 5 | 3 | 6 |
   |---.---.---|---.---.---|---.---.---|
(7)|   |   | 5 | 8 | 3 | 6 |   |   | 2 |
   |---.---.---|---.---.---|---.---.---|
(8)| 3 |   |   | 2 | 5 | 4 | 1 | 8 | 9 |
   |===.===.===|===.===.===|===.===.===|

This project demonstrates some of project patterns:

• Facade
• Template Method
• Command
• Strategy
• Factory Method

Only the Console Mode was developed.

Pre-Requisities

• maven
• JDK 1.6

RUN

1. mvn package
2. java -jar target/Sudoku.jar

sudoku-pure-java-implementation's Issues

Principio de responsabilidad única

En el paquete br.poli.model, en la clase Board se están mezclando dos responsabilidades para la clase, para ello, se debería separar las validaciones y los métodos propios de Board en dos clases diferentes.

Principio Open Close

Detalle: En el código algunas clases utilizan score, dándole una responsabilidad mas a la clases

mi propuesta es crear una clase para que se maneje el score, si llegara a darse el caso de un requerimiento , donde se necesita aumentar el score con bonos extras se podría trabajar sin afectar a otras clases.

Principio de Segregación de interfaces (ISP)

Detalle: En la interface SudokuFacade encontré algunos métodos que pueden ser segregados a otra interface para cumplir con el principio SOLID (ISP) Principio de Segregación de interfaces.

Mi propuesta es separar las interfaces con los métodos que tienen relación para que el código este mas modulado

La nueva interface seria esta:
//interface nueva
public interface SudokuFacadeGame {

void init();

void solveGame() throws UnsolvedException;

boolean endGame();

boolean isWin();

}

Principio inversión de dependencia

Detalle: En la clase Game se esta creando el objeto Game y trabajando con él, se está violando el principio que nos dice que los módulos no deben crear los objetos con los que trabajan.

En SudokuFacadeImpl se instancia el objeto Game, y se envía los objetos para que esa clase la utilice.