Formación

[luchoxx87]

Formación

Pensar en como poder hacer que los Jugadores puedan tener hasta 3 formaciones para armar. La idea es ofrecer plantillas con 5 formaciones clásicas (aunque a futuro se pueden agregar más). Las formaciones tienen que tener nombre y pensar en una forma potable de encarar el posicionamiento de los jugadores en la táctica. Siguiendo con lo que hablamos, tendríamos una clase Formacion que funciona como contenedora de las Lineas. Formación tendría el nombre y estaría bueno que devolviese una cadena tipo "4-4-2". Linea seria la clase que contiene la PosicionEnCancha, teniendo en cuenta que vamos a leer las posiciones de abajo hacia arriba y de derecha a izquierda, es importante que las Posiciones tengan un numero de linea (dejando el valor 0 para la linea del arquero). Y por ultimo la clase PosicionEnCancha que relaciona a un jugador (puede valer null cuando no hay jugador asignado) junto con una Posición. También podríamos tener un numero de camiseta en esta clase.

Clase PosicionEnCancha

• [x] Propiedad Jugador de la posición (puede ser null).
• [x] Propiedad Posicion que va a cubrir (nunca null).
• [x] Propiedad de solo lectura QuimicaJugador que devuelva la Química ponderada del jugador (devuelve cero si no hay jugador asignado) con valores entre 1 y 10. Esto vamos a tener que ponernos de acuerdo como ponderar cosas como: MismoEquipo(), JuegaDe(), MismoPais(), etc.
• [x] Método EsNumero(byte) que devuelve true si la PosicionEnCancha tiene asignada el número recibido por parámetro.

Clase Linea

• [x] Propiedad de solo lectura QuimicaJugadores que devuelva la sumatoria de las Químicas de los jugadores que la compongan.
• [x] Propiedad de solo lectura CantidadJugadores que devuelva la cantidad de jugadores que componen la linea.
• [x] Propiedad de solo lectura CantidadPosiciones que devuelva la cantidad de posiciones que componen la linea (esta propiedad va a ser importante para poder generar la cadena representativa de la formación).
• [x] Definir el método ExisteNumero(byte) que reciba como parámetro un numero de camiseta y devuelve true si alguna de las posiciones posee tal número.

Clase Formación

• [x] Propiedad de solo lectura QuimicaJugadores que devuelva la sumatoria de las Químicas de los jugadores de las Lineas.
• [x] Redefinir el método ToString() para que devuelva una cadena representativa de la Formación (ejemplos: "4 - 4 - 2", "4 - 3 - 1 - 2", "4 - 3 - 3"). Recordar que no se toma al arquero como parte de la linea. Para redefinir este método podemos usar StringBuilder (se sugiere como buena practica, según la documentación oficial es la forma optimizada para crear cadenas).
• [x] Definir el método ExisteNumero(byte) que reciba como parámetro un numero de camiseta y devuelve true si alguna de las Lineas posee tal número.
• [x] Propiedad de solo lectura byte NumeroDisponible que devuelva el primer numero de camiseta (empezando por el 1). La idea va a ser recorrer con un for preguntando si existe el numero en iteración en la Formación (oh, vamos a consumir el método bool Formacion.ExisteNumero(byte) ¿quién lo diría :smiley:?). Hay que tener en cuenta:
  1. Hasta donde va a ir el for (fíjense las propiedades estáticas que agregué).
  2. En caso de no encontrar un número disponible, devolver una excepción del tipo InvalidOperationException con el mensaje "No hay más dorsales disponibles".

Clase FormacionBuilder

Dado que la formación es un objeto complejo por su composición y correcto orden de creación, es necesario la aplicación de un patrón de creación (el Builder) para simplificar la instanciación de formaciones.

Para esta clase vamos a usar el concepto de Interfaz fluida, por lo cual ES IMPORTANTE que todos los métodos de esta clase, devuelvan una instancia de la misma (es decir, la ultima linea siempre es return this;).

• [x] Para facilitar el estado interno de creación, va a ser importante que esta clase tenga instancias privadas de Formacion (el getter si puede ser publico) y Linea.
• [x] Método IniciarFormacion(): instancia la formación interna del builder.
• [x] Método AgregarLinea(): instancia la linea interna y la agrega a la formación.
• [x] Método AgregarPosicion(Futbolista futbolista, Posicion posicion, byte? nro = null): instancia una PosicionEnCancha (variable interna dentro del método, no hace falta que sea un atributo de la clase) con el futbolista y la posición y la agrega a la linea interna del builder. Con respecto al nro, si tiene un valor se asigna de una, pero si no tiene, la idea es que la formación se lo asigne automáticamente (acá es cuando usamos la propiedad Formacion.NumeroDisponible que ya programamos 😎 y ademas quedaría cheto si usamos el operador ??).
• [x] Método AgregarPosicion(PosicionEnCancha posicionEnCancha): para aprovechar las posiciones que ya tenemos instanciadas, vamos a sobrecargar el anterior método recibiendo PosicionEnCancha. En caso de que la posición recibida por parámetro no tenga asignado un numero de camiseta, se lo tenemos que asignar de forma análoga al punto anterior. ESTARÍA BUENO reutilizar código para las 2 versiones de NuevaPosicion (en la cual una invoque a la otra), pensar en ello.

Les muestro un ejemplo de instanciación cuando tengamos el builder listo.

var builder = new FormacionBuilder();

var formacion = builder.IniciarFormacion()
                        .AgregarLinea()
                            .AgregarPosicion(null, defensorDerecho, 4)
                            .AgregarPosicion(null, defensorCentral, 2)
                            .AgregarPosicion(fMarcosRojo, defensorCentral, 6)
                            .AgregarPosicion(FFrankFabra, defensorIzquierdo)
                        .AgregarLinea()
                            .AgregarPosicion(FEnzoPerez, mediocampistaDefensivo, 5)
                        .AgregarLinea()
                            .AgregarPosicion(FSantiagoSimon, mediocampistaDerecho)
                            .AgregarPosicion(FEnzoFernandez, medioCentro)
                            .AgregarPosicion(FNicoDeLaCruz, medioCentro)
                            .AgregarPosicion(FEsequielBarco, mediocampistaIzquierdo)
                        .AgregarLinea()
                            .AgregarPosicion(FJulianAlvarez, delanteroCentral)
                        .Formacion;

Buenas, hoy en clase (21-06-2023) hablamos de agregar unas clases para ayudar a la persistencia de:

• [ ] La Alineacion (Formación esta agregada por ellas)
• [ ] Y la PosicionFormacion (Formación va a estar compuesta de estas clases).

[luchoxx87]

Buenas chicos, en la actualidad en este Issue (fork "12—formacion" ) no están corriendo los tests; empiecen a investigar que puede ser. Si desarrollan una idea o tienen teorías, pueden usar este foro para comentar la idea y lo vemos entre todos.