Introducción

El diseño propuesto para la práctica anterior tenía un problema que se resolverá en la actual: las factorías de naves y visualizadores no estaban completamente abiertas a la extensión, ya que añadir un nuevo tipo de nave o visualizador implicaría añadir una nueva instrucción condicional o una nueva cláusula case a una instrucción switch. En esta práctica, este problema se arreglará introduciendo convenientemente la reflexión. Además, el modelo se ampliará con un sistema de clasificación que será capaz de reflejar las puntuaciones obtenidas después de jugar cada partida y clasificarlas de acuerdo con dos criterios diferentes: la cantidad de posiciones alcanzadas y el valor de las diferentes naves destriudas.  

Diagrama de clases

Este es el diagrama de clases UML que representa las nuevas clases de nuestro modelo:

En las siguientes secciones se indican los métodos que hay que modificar o implementar desde cero para esta práctica. Los atributos o relaciones no se explicarán, ya que ya se muestran en el diagrama UML. Los elementos que no cambian con respecto a la práctica anterior no se explicarán de nuevo. Tampoco se comentarán los setters o getters que simplemente devuelven el valor actual de una propiedad, o establecen una propiedad a un nuevo valor. Tendrás que decidir cuándo usar copia defensiva en un setter o getter mirando el diagrama de clases.

Cuando se indique, tu código debe comprobar que los valores de los argumentos pasados a un método son correctos. Los argumentos que son referencias no necesitan ser comprobados, a menos que se indique lo contrario.

Estructura de paquetes y directorios

Crearemos dos nuevos paquetes:

• model.score para las clases que implementan el sistema de puntuación y clasificación;
• model.exceptions.score para una nueva clase de errores relacionados con la puntuación/clasificación.

Hoja de ruta

Se recomienda encarecidamente que implementes tu solución en el mismo orden que se sigue en este documento.

1. Introducir la reflexión
2. Implementar el sistema de puntuación
3. Introducir los cambios que se explican a continuación en las clases existentes

Clase Score

La nueva clase abstracta Score encapsula el concepto de la puntuación de una partida. Como el objetivo es crear un sistema de clasificación, las puntuaciones deben ser comparables. Esto se logrará haciendo que Score implemente la interfaz de Java Comparable, en particular Comparable<Score<T>>, lo que obliga a la clase a implementar el método compareTo(-):

public abstract class Score<T> implements Comparable<Score<T>>{   
   ...   
}

El tipo T determinará el tipo de puntuación a definir.

Las subclases no abstractas de Score implementarán el método score(-) que, cuando sea apropiado, incrementa el atributo score; valores más altos de esta puntuación significarán un mejor rendimiento del jugador. El atributo score se utilizará en el método Score.compareTo(-) para comparar dos puntuaciones diferentes.

Julia (PlayerFile): 7

Clase HitScore

Esta clase representa un score basado en CellStatus y simplemente lleva la cuenta de las posiciones alcanzadas por el jugador. Debe ser declarado como sigue:

public class HitScore extends Score<CellStatus> {
   ...
}

Clase CraftScore

Esta clase representa un anotador basado en Craft y suma el valor de las diferentes naves destruidas por el jugador. Se declara de forma análoga a la de HitScore pero usando Craft en lugar de CellStatus.

Clase Ranking

Para tener un sistema de clasificación basado en las puntuaciones obtenidas por los diferentes jugadores, se añadirá una nueva clase Ranking. Ranking es una clase genérica que tiene un parámetro de tipo restringido para evitar que puntuaciones de diferentes tipos coexistan en una clasificación particular:

class Ranking<ScoreType extends Score<?>> {
   ...
}

Por lo tanto, un objeto de tipo Ranking tendrá que ser creado de una de dos maneras, ya sea como

Ranking<HitScore> rh = new Ranking<>();

o como

Ranking<CraftScore> rc = new Ranking<>();

Por consiguiente, un error del compilador impedirá que el código del cliente añada puntuaciones de diferentes criterios al mismo objeto de clasificación (pruébalo cuando ya tengas estas clases implementadas). Nótese que a partir de Java 7 los argumentos de tipo requeridos para invocar al constructor de una clase genérica pueden ser reemplazados por un conjunto vacío (el par de corchetes angulares se llama el diamante) siempre que el compilador pueda inferir los tipos a partir del contexto.

private SortedSet<ScoreType> scoreSet;

scoreSet = new TreeSet<>();

Clase Craft y sus subclases

Las diferentes naves y aviones tendrán un valor que será utilizado por los sistemas de puntuación. Para esto tienes que:

• Añadir a Craft un método abstracto getValue(), retornando y int y sin parámetros.
• Implementar el método getValue() en las subclases de Ship y Aircraft. El valor que deben devolver se muestra en la siguiente tabla:

Interfaz IPlayer

Añade el nuevo método getLastShotStatus().

Clase PlayerRandom

Estos son los cambios que se debe introducir:

• El método PlayerRandom.putCrafts() necesita ser modificado para incluir el nombre del subpaquete (ship o aircraft) en las diferentes llamadas a CraftFactory.createCraft(-).
• En PlayerRandom.nextShoot(), el estado devuelto por Board.hit(-) debe ser almacenado en el atributo lastShotStatus.
• Implementar el getter PlayerRandom.getLastShotStatus().

Clase PlayerFile

Cambios que se debe introducir:

• En PlayerFile.nextShoot(), el estado devuelto por Board.hit(-) debe ser almacenado en el atributo lastShotStatus. Si no se realiza ningún disparo, por ejemplo porque se ha leido el comando exit desde el fichero de entrada o porque no hay más líneas que leer, lastShotStatus debe ponerse a null.
• Implementar el getter PlayerFile.getLastShotStatus().

Además, los archivos de entrada usados con PlayerFile deben ser actualizados. Puedes descargar una versión actualizada de los archivos playerfile-john.txt y playerfile-mary.txt que incluyen el prefijo no común cuando se especifica el barco/avión en un comando put.

Clase Game

Estos son los cambios que se introducirán:

• En el constructor de la clase se deben inicializar los atributos hitScore1, hitScore2, craftScore1 y craftScore2.
• En Game.playNext(), después de que el jugador dispare, el correspondiente hitScore se actualiza llamando a HitScore.score(-) con el estado del último disparo realizado por el jugador (utilice el método IPlayer.getLastShotStatus() para obtener este estado). Además, si este estado es DESTROYED, actualizar el correspondiente craftScore llamando a CraftScore.score(-) con la nave que fue destruida.
• Implementar el método Game.getScoreInfo(). Debería devolver una cadena con información sobre las puntuaciones de los dos jugadores. Aquí hay un ejemplo de la salida:

Player 1
HitScore: John (PlayerFile): 9
CraftScore: John (PlayerFile): 11
--------------
Player 2
HitScore: Mary (PlayerFile): 10
CraftScore: Mary (PlayerFile): 6